+ xiQ&^RIHt^RIt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI t ^RI t^RIHt] P"R8d^RIHtM^RIt]P(RRl4t]P(RRRll4tR tR R lt]!]P2]4tR t]!]]4tR tRt]P(]P>3Rl4t ]PB!] ]!4R7t"]P(RR]"3RRll4t#!RR4t$!RR]PJ]PL4t%!RR]PL4t'R#)) annotationsN)Iterator)tarfilec V^8dQhRRRR/#)dirzstr | os.PathLikereturnIterator[str | os.PathLike])formats"7lib/python3.14/site-packages/jaraco/context/__init__.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)a Get a URL to a tarball, download, extract, yield, then clean up. Assumes everything in the tarball is prefixed with a common directory. That common path is stripped and the contents are extracted to ``target_dir``, similar to passing ``-C {target} --strip-components 1`` to the ``tar`` command. Uses the streaming protocol to extract the contents from a stream in a single pass without loading the whole file into memory. >>> 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) If the target is not specified, contents are extracted to a directory relative to the current working directory named after the name of the file as extracted from the URL. >>> target = getfixture('tmp_path') >>> with pushd(target), tarball(url): ... target.joinpath('served').is_dir() True Nz.tar.gzz.tgzzr|*)fileobjmode)pathfilter)rrbasenamereplacemkdirurllibrequesturlopenropen extractall_default_filtershutilrmtree)urlrreqtfs&& r tarballr,(sDWW%%c*229bAII&RTU HHZ"nn$$S) \\#E 2 2b MMz/M B3 j! 3 2  j!s6AD?C+C4 C+D C( #C++DDc8Rp\P!WR4#)caaVV3Rl#)c"<S!S!W4V4#Nr )memberrf1f2s&&r ?_compose_tarfile_filters..compose_two..XsBr&'7$>rr )r2r3sffr compose_two-_compose_tarfile_filters..compose_twoWs >>rcV#r0r )r1rs&&r r4*_compose_tarfile_filters..Zsvr) functoolsreduce)filtersr6s* r _compose_tarfile_filtersr=Vs?   K2M NNrc V^8dQhRRRR/#)rr1ztarfile.TarInfor r )r s"r rr]s rcLVPPR^4wq nV#)/)namesplit)r1r_s&& r strip_first_componentrD]s#[[&&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#;i5ir0r )argskwargssavedresinnerouters*, r composed/_compose..compose_two..composed}s@'''5%,,# 3?'',,'''s/A#A< A A# A A A  A#) contextlibcontextmanager)rLrMrNsff r r6_compose..compose_two|s ((22r)r:r;reversed)cmgrsr6s* r _composerUhs (3   K% 99rcfVwr4pV\P\P\P39dyVP\P 8XdZ\P !V\P\P,\P,4V!V4R#h)z6 Add support for removing read-only files on Windows. N) rrmdirremoveunlinkerrnoEACCESchmodstatS_IRWXUS_IRWXGS_IRWXO)funcrexc_inforCexcs&&& r remove_readonlyrdseIAA "))RYY//CII4M t||dll2T\\AB T  rc\P!4R8Xd+\P!\P \ R7#\P #)Windows)onerror)platformsystemr:partialr'r(rdr rr robust_removerrks< ??  ) &--A]]rc#l"\P!4pVxV!V4R# T!T4i;i5i)z 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) >>> assert not os.path.exists(the_dir) N)tempfilemkdtemp)removertemp_dirs& r rprps/!Hs4' 4 14)roTc V^8dQhRRRR/#)rbranchz str | Nonequietboolr )r s"r rrs+/rc#8"RV9dRMRpV!4;_uu_4pVRW.pVPRV.\V4,4V'd\PMRp\P!WgVR7VxRRR4R# +'giR#;i5i)an 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. >>> getfixture('ensure_git') >>> getfixture('needs_internet') >>> repo = repo_context('https://github.com/jaraco/jaraco.context') >>> with repo as dest: ... listing = os.listdir(dest) >>> 'README.rst' in listing True githgclonez--branchN)stdoutstderr)extendrt subprocessDEVNULL check_call)r)rrrsdest_ctxexerepo_dircmdstreams&&&& r repo_contextrsr$C<%TC xGS+ J'$v,67',##$c@ sBAB< B B  Bc]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#r0) exceptions)selfrs&&r __init__ExceptionTrap.__init__s$rc V#r0r rs&r __enter__ExceptionTrap.__enter__ rc (VP^,#rrbrs&r typeExceptionTrap.type}}Qrc (VP^,#)rrs&r valueExceptionTrap.valuerrc (VP^,#)rrrs&r tbExceptionTrap.tbrrc rV^,pT;'d\W P4pV'dWnV#r) issubclassrrb)rrbrmatchess&* r __exit__ExceptionTrap.__exit__s.{<<:dOO< $Mrc ,\VP4#r0)rtrrs&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;ir0)rr)rHrItraprrars*, r wrapper%ExceptionTrap.raises..wrapper%s9t//4d%f%0; 0/s 8 A )r:wraps)rrarrsffd 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_)rras&&r passesExceptionTrap.passes-s&{{4x}}{55r)rbr)NNN)__name__ __module__ __qualname____firstlineno____doc__rb Exceptionrrpropertyrrrrrrtrr__static_attributes__r rr rrsuB H#,,%      D66rrc]tRtRtRtRtR#)suppressiCz A version of contextlib.suppress with decorator support. >>> @suppress(KeyError) ... def key_error(): ... {}[''] >>> key_error() r N)rrrrrrr rr rrCsrrc0]tRtRtRtRRltRtRtRtR#) on_interruptiNa Replace a KeyboardInterrupt with SystemExit(1). Useful in conjunction with console entry point functions. >>> 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#r0actioncode)rrrs""&r ron_interrupt.__init__cs   rc V#r0r rs&r ron_interrupt.__enter__grrc V\JgVPR8XdR#VPR8Xd\VP4VhVPR8H#)ignoreNerrorr)KeyboardInterruptr SystemExitr)rexctypeexcinstexctbs&&&&r ron_interrupt.__exit__jsE + +t{{h/F  [[G #TYY'W 4{{j((rrN)rr) rrrrrrrrrr rr rrNs()rr) r0)( __future__rrPrZr:rrrhr'r]r|sysrmurllib.requestr!collections.abcr version_info backportsrrQrr,r=rD data_filterr&rU tarball_cwdrdrkr(rprjrobust_temp_dirrrrContextDecoratorrr rr rsL"    $g!     *"*"ZO+7+>+>@UV:<ug&   ]]"##Hn6FG "$4n6n6bz""J$?$?!):..!)r