+ hP%<^RIHt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI Ht]PR8d^RIHtM^RIt]P$RRl4t]P$RRRll4tR R ltR t]!]]4t]P$R 4tR t]P$]P43Rl4t]P$RR]3Rl4tRt!RR4t!RR]P>]P@4t!RR]P@4t!R#)) annotationsN)Iterator)tarfilec V^8dQhRRRR/#)dirzstr | os.PathLikereturnIterator[str | os.PathLike])formats"C/usr/lib/python3/dist-packages/setuptools/_vendor/jaraco/context.py __annotate__rs   %@ c#"\P!4p\P!V4Vx\P!V4R# \P!T4i;i5i)z >>> tmp_path = getfixture('tmp_path') >>> with pushd(tmp_path): ... assert os.getcwd() == os.fspath(tmp_path) >>> assert os.getcwd() != os.fspath(tmp_path) N)osgetcwdchdir)rorigs& r pushdrs= 99;DHHSM  s,A&A A& A##A&c V^8dQhRRRR/#)r target_dirzstr | os.PathLike | Noner r r )r s"r rr(s""-" "rc#"Vf@\PPV4PRR4PRR4p\P!V4\ P PV4p\P!VRR7;_uu_4pVPV\R7RRR4Vx\P!V4R# +'giL,;i \P!T4i;i5i)av Get a tarball, extract it, yield, then clean up. >>> import urllib.request >>> url = getfixture('tarfile_served') >>> target = getfixture('tmp_path') / 'out' >>> tb = tarball(url, target_dir=target) >>> import pathlib >>> with tb as extracted: ... contents = pathlib.Path(extracted, 'contents.txt').read_text(encoding='utf-8') >>> assert not os.path.exists(extracted) Nz.tar.gzz.tgzzr|*)fileobjmode)pathfilter)rrbasenamereplacemkdirurllibrequesturlopenropen extractallstrip_first_componentshutilrmtree)urlrreqtfs&& r tarballr,'s WW%%c*229bAII&RTU HHZ"nn$$S) \\#E 2 2b MMz2GM H3 j! 3 2  j!s6AD?C+C4 C+D C( #C++DDc V^8dQhRRRR/#)rmemberztarfile.TarInfor r )r s"r rrGs rcLVPPR^4wq nV#)/)namesplit)r.r_s&& r r&r&Gs#[[&&sA.NA{ MrcHRp\P!V\V44#)aQ Compose any number of dependent context managers into a single one. The last, innermost context manager may take arbitrary arguments, but each successive context manager should accept the result from the previous as a single parameter. Like :func:`jaraco.functools.compose`, behavior works from right to left, so the context manager should be indicated from outermost to innermost. Example, to create a context manager to change to a temporary directory: >>> temp_dir_as_cwd = _compose(pushd, temp_dir) >>> with temp_dir_as_cwd() as dir: ... assert os.path.samefile(os.getcwd(), dir) c@aaVV3Rlp\P!V4#)c ?<"S!V/VB;_uu_4pS!V4;_uu_4pVxRRR4RRR4R# +'giL;i +'giR#;i5iNr )argskwargssavedresinnerouters*, r composed/_compose..compose_two..composedds@'''5%,,# 3?'',,'''s/A#A< A A# A A A  A#) contextlibcontextmanager)r<r=r>sff r compose_two_compose..compose_twocs ((22r) functoolsreducereversed)cmgrsrBs* r _composerHOs (3   K% 99rc /2"\P!R\^R7VPR\4p\ V/VB;_uu_4q2!V4;_uu_4pVxRRR4RRR4R# +'giL;i +'giR#;i5i)zBtarball_context is deprecated. Use tarball or tarball_cwd instead. stacklevelrN)warningswarnDeprecationWarningpoprr,)r8r9 pushd_ctxtballrs*, r tarball_contextrRpsj MML  7E*I $ !& ! !UIe,<,< -= ! !,<,< ! ! !s6AB BA0 B& B0 B ;B B  Bc\P!R\^R7VRRp\RRRR7pVP VR4#) z Given a URL or filename, infer the compression code for tar. >>> infer_compression('http://foo/bar.tar.gz') 'z' >>> infer_compression('http://foo/bar.tgz') 'z' >>> infer_compression('file.bz') 'j' >>> infer_compression('file.xz') 'J' z3infer_compression is deprecated with no replacementrJNzjJ)gzbzxz)rLrMrNdictget)r)compression_indicatormappings& r infer_compressionr_|sG MM=  Hccc*G ;;,c 22rc#l"\P!4pVxV!V4R# T!T4i;i5i)a@ Create a temporary directory context. Pass a custom remover to override the removal behavior. >>> import pathlib >>> with temp_dir() as the_dir: ... assert os.path.isdir(the_dir) ... _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents', encoding='utf-8') >>> assert not os.path.exists(the_dir) N)tempfilemkdtemp)removertemp_dirs& r rdrds/!Hs4' 4 14Tc#R"RV9dRMRpV!4;_uu_4pVRW.pV'dVPRV.4\\PPR4pV'dTMRp\ P !WhR7VxRRR4R# +'giR#;i5i)z Check out the repo indicated by url. If dest_ctx is supplied, it should be a context manager to yield the target directory for the check out. githgclonez--branchwN)stdout)extendr$rrdevnull subprocess check_call) r)branchquietdest_ctxexerepo_dircmdrlrjs &&&& r repo_contextrusxC<%TC xGS+  JJ F+ ,rww,!tc1 sB'A,B B' B$  B'cf\P!R\^R7\P!4#)a( A null context suitable to stand in for a meaningful context. >>> with null() as value: ... assert value is None This context is most useful when dealing with two or more code branches but only some need a context. Wrap the others in a null context to provide symmetry across all options. z.null is deprecated. Use contextlib.nullcontextrJ)rLrMrNr@ nullcontextr rr nullrxs* MM8  ! ! ##rc]tRt^tRtRt]33RltRt] R4t ] R4t ] R4t Rt R tR ]/R ltR tR tR#) ExceptionTrapaA A context manager that will catch certain exceptions and provide an indication they occurred. >>> with ExceptionTrap() as trap: ... raise Exception() >>> bool(trap) True >>> with ExceptionTrap() as trap: ... pass >>> bool(trap) False >>> with ExceptionTrap(ValueError) as trap: ... raise ValueError("1 + 1 is not 3") >>> bool(trap) True >>> trap.value ValueError('1 + 1 is not 3') >>> trap.tb >>> with ExceptionTrap(ValueError) as trap: ... raise Exception() Traceback (most recent call last): ... Exception >>> bool(trap) False Nc WnR#r7) exceptions)selfr|s&&r __init__ExceptionTrap.__init__s$rc V#r7r r}s&r __enter__ExceptionTrap.__enter__ rc (VP^,#rexc_infors&r typeExceptionTrap.type}}Qrc (VP^,#)rrs&r valueExceptionTrap.valuerrc (VP^,#)rrrs&r tbExceptionTrap.tbrrc rV^,pT;'d\W P4pV'dWnV#r) issubclassr|r)r}rrmatchess&* r __exit__ExceptionTrap.__exit__s.{<<:dOO< $Mrc ,\VP4#r7)boolrrs&r __bool__ExceptionTrap.__bool__ sDIIr_testc Naaa\P!S4VVV3Rl4pV#)aQ Wrap func and replace the result with the truth value of the trap (True if an exception occurred). First, give the decorator an alias to support Python 3.8 Syntax. >>> raises = ExceptionTrap(ValueError).raises Now decorate a function that always fails. >>> @raises ... def fail(): ... raise ValueError('failed') >>> fail() True c<\SP4;_uu_4pS!V/VBRRR4S!X4# +'giL;ir7)rzr|)r8r9traprfuncr}s*, r wrapper%ExceptionTrap.raises..wrapper!s9t//4d%f%0; 0/s 8 A )rDwraps)r}rrrsffd r raisesExceptionTrap.raisess'&      rc DVPV\PR7#)aJ Wrap func and replace the result with the truth value of the trap (True if no exception). First, give the decorator an alias to support Python 3.8 Syntax. >>> passes = ExceptionTrap(ValueError).passes Now decorate a function that always fails. >>> @passes ... def fail(): ... raise ValueError('failed') >>> fail() False )r)roperatornot_)r}rs&&r passesExceptionTrap.passes)s&{{4x}}{55r)rr|)NNN)__name__ __module__ __qualname____firstlineno____doc__r Exceptionr~rpropertyrrrrrrrr__static_attributes__r rr rzrzsuB H#,,%      D66rrzc]tRtRtRtRtR#)suppressi?z A version of contextlib.suppress with decorator support. >>> @suppress(KeyError) ... def key_error(): ... {}[''] >>> key_error() r N)rrrrrrr rr rr?srrc0]tRtRtRtRRltRtRtRtR#) on_interruptiJa Replace a KeyboardInterrupt with SystemExit(1) >>> def do_interrupt(): ... raise KeyboardInterrupt() >>> on_interrupt('error')(do_interrupt)() Traceback (most recent call last): ... SystemExit: 1 >>> on_interrupt('error', code=255)(do_interrupt)() Traceback (most recent call last): ... SystemExit: 255 >>> on_interrupt('suppress')(do_interrupt)() >>> with __import__('pytest').raises(KeyboardInterrupt): ... on_interrupt('ignore')(do_interrupt)() c WnW nR#r7actioncode)r}rrs""&r r~on_interrupt.__init__]s   rc V#r7r rs&r ron_interrupt.__enter__arrc V\JgVPR8XdR#VPR8Xd\VP4VhVPR8H#)ignoreNerrorr)KeyboardInterruptr SystemExitr)r}exctypeexcinstexctbs&&&&r ron_interrupt.__exit__dsE + +t{{h/F  [[G #TYY'W 4{{j((rrN)rr) rrrrrr~rrrr rr rrJs$)rr) r7)" __future__rr@rDrrr'rmsysraurllib.requestr!rLtypingr version_info backportsrrArr,r&rH tarball_cwdrRr_r(rdrurxrzrContextDecoratorrr rr rs*"  g!     "">:<ug&  32 ]]$ !$$&n6n6bz""J$?$?):..)r