xiQ&SSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK rSSKJr \ R"S:aSSKJr OSSKr\R(SSj5r\R(SSSjj5rSrSS jr\"\R2\5rS r\"\\5rS rS r\R(\R>4S j5r \RB"\ \"5S9r"\R(SS\"4SSjj5r#"SS5r$"SS\RJ\RL5r%"SS\RL5r'g)) annotationsN)Iterator) )tarfilec## [R"5n[R"U5 Uv [R"U5 g![R"U5 f=f7f)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)dirorigs 7lib/python3.13/site-packages/jaraco/context/__init__.pypushdrs= 99;DHHSM  s,A%A A% A""A%c## Uc?[RRU5RSS5RSS5n[R"U5 [ R RU5n[R"USS9nURU[S9 SSS5 Uv [R"U5 g!,(df  N)=f![R"U5 f=f7f)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)r rbasenamereplacemkdirurllibrequesturlopenropen extractall_default_filtershutilrmtree)url target_dirreqtfs rtarballr%(sDWW%%c*229bAII&RTU HHZ"nn$$S) \\#E 2b MMz/M B3 j! 3 2  j!s6AC44CC% C1C4 CCC11C4c8Sn[R"XS5$)Nc^^UU4Sj$)Nc">T"T"X5U5$N)memberrf1f2s r?_compose_tarfile_filters..compose_two..XsBr&'7$>r*)r,r-s``r compose_two-_compose_tarfile_filters..compose_twoWs >>r0cU$r)r*)r+rs rr.*_compose_tarfile_filters..Zsvr0) functoolsreduce)filtersr1s r_compose_tarfile_filtersr8Vs?   K2M NNr0cLURRSS5uo lU$)N/)namesplit)r+r_s rstrip_first_componentr?]s#[[&&sA.NA{ Mr0cHSn[R"U[U55$)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@^^UU4Sjn[R"U5$)Nc?># T"U0UD6nT"U5nUv SSS5 SSS5 g!,(df  N=f!,(df  g=f7fr)r*)argskwargssavedresinnerouters rcomposed/_compose..compose_two..composed}s8''5%,# 3?'',,''s) A  <+< A  9 < A A ) contextlibcontextmanager)rGrHrIs`` rr1_compose..compose_two|s ((22r0)r5r6reversed)cmgrsr1s r_composerPhs (3   K% 99r0cPUup4nU[R[R[R4;anUR[R :XaP[R "U[R[R-[R-5 U"U5 ge)z6 Add support for removing read-only files on Windows. N) r rmdirremoveunlinkerrnoEACCESchmodstatS_IRWXUS_IRWXGS_IRWXO)funcrexc_infor>excs rremove_readonlyr_seIAA "))RYY//CII4M t||dll2T\\AB T  r0c[R"5S:Xa'[R"[R [ S9$[R $)NWindows)onerror)platformsystemr5partialrr r_r*r0rrobust_removerrfs< ??  ) &--A]]r0c#j# [R"5nUv U"U5 g!U"U5 f=f7f)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 rrkrks/!Hs3& 3 03)rjTc## SU;aSOSnU"5nUSX/nURSU/[U5-5 U(a[ROSn[R"XgUS9 Uv SSS5 g!,(df  g=f7f)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)extendbool subprocessDEVNULL check_call)r!branchquietdest_ctxexerepo_dircmdstreams r repo_contextr~sn$C<%TC xGS+ J'$v,67',##$c@ sBAA4+ B4 B>Bc\rSrSrSrSr\44SjrSr\ S5r \ S5r \ S5r S r S r\S .S jrS rSrg) 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 )NNNcXlgr)) exceptions)selfrs r__init__ExceptionTrap.__init__s$r0cU$r)r*rs r __enter__ExceptionTrap.__enter__ r0c URS$Nrr]rs rtypeExceptionTrap.type}}Qr0c URS$)Nr;rrs rvalueExceptionTrap.valuerr0c URS$)Nrrs rtbExceptionTrap.tbrr0cfUSnU=(a [X R5nU(aXlU$r) issubclassrr])rr]rmatchess r__exit__ExceptionTrap.__exit__s+{<:dOO< $Mr0c,[UR5$r))rsrrs r__bool__ExceptionTrap.__bool__sDIIr0_testcN^^^[R"T5UUU4Sj5nU$)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>[TR5nT"U0UD6 SSS5 T"W5$!,(df  N=fr))rr)rCrDtraprr\rs rwrapper%ExceptionTrap.raises..wrapper%s6t/4d%f%0; 0/s 0 >)r5wraps)rr\rrs``` rraisesExceptionTrap.raisess'&      r0c>URU[RS9$)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_)rr\s rpassesExceptionTrap.passes-s&{{4x}}{55r0)r]rN)__name__ __module__ __qualname____firstlineno____doc__r] Exceptionrrpropertyrrrrrrsrr__static_attributes__r*r0rrrssB H#,,%      %)66r0rc\rSrSrSrSrg)suppressiCz A version of contextlib.suppress with decorator support. >>> @suppress(KeyError) ... def key_error(): ... {}[''] >>> key_error() r*N)rrrrrrr*r0rrrCsr0rc.\rSrSrSrSSjrSrSrSrg) 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)() cXlX lgr)actioncode)rrrs rron_interrupt.__init__cs   r0cU$r)r*rs rron_interrupt.__enter__grr0cU[LdURS:XagURS:Xa[UR5UeURS:H$)Nignoreerrorr)KeyboardInterruptr SystemExitr)rexctypeexcinstexctbs rron_interrupt.__exit__jsE + +t{{h/F  [[G #TYY'W 4{{j((r0rN)rr;) rrrrrrrrrr*r0rrrNs()r0r)r zstr | os.PathLikereturnIterator[str | os.PathLike]r))r"zstr | os.PathLike | Nonerr)r+tarfile.TarInforr)rwz str | Nonerxrs)( __future__rrKrUr5rr rcrrXrtsysrhurllib.requestrcollections.abcr version_info backportsrrLrr%r8r? data_filterrrP tarball_cwdr_rfr rkrerobust_temp_dirr~rrContextDecoratorrr*r0rrs"    $g!     04*"-*" *"*"ZO +7+>+>@UV:<ug&   ]]"##Hn6FG "$+/4n6n6bz""J$?$?!):..!)r0