n&phP%BSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK Jr \RS:aSSKJr OSSKr\R$SSj5r\R$SSSjj5rSSjrS r\"\\5r\R$S 5rS r\R$\R44S j5r\R$SS \4Sj5rSr"SS5r"SS\R>\R@5r"SS\R@5r!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 T/var/www/html/venv/lib/python3.13/site-packages/setuptools/_vendor/jaraco/context.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)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)r rbasenamereplacemkdirurllibrequesturlopenropen extractallstrip_first_componentshutilrmtree)url target_dirreqtfs rtarballr%'s WW%%c*229bAII&RTU HHZ"nn$$S) \\#E 2b MMz2GM H3 j! 3 2  j!s6AC44CC% C1C4 CCC11C4cLURRSS5uo lU$)N/)namesplit)memberr_s rrrGs#[[&&sA.NA{ McHSn[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=f7fN)argskwargssavedresinnerouters rcomposed/_compose..compose_two..composedds8''5%,# 3?'',,''s) A  <+< A  9 < A A ) contextlibcontextmanager)r7r8r9s`` r compose_two_compose..compose_twocs ((22r-) functoolsreducereversed)cmgrsr=s r_composerCOs (3   K% 99r-c/# [R"S[SS9 URS[5n[ U0UD6o2"U5nUv SSS5 SSS5 g!,(df  N=f!,(df  g=f7f)NzBtarball_context is deprecated. Use tarball or tarball_cwd instead. stacklevelr)warningswarnDeprecationWarningpoprr%)r3r4 pushd_ctxtballr s rtarball_contextrNpsa MML  7E*I $ !& !UIe,< -= ! !,<,< ! !s4A-A A- A> A* &A-- A;7A>cz[R"S[SS9 USSn[SSSS 9nUR US5$) 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 replacementrErFNzjJ)gzbzxz)rHrIrJdictget)r!compression_indicatormappings rinfer_compressionr[|sG MM=  Hccc*G ;;,c 22r-c#j# [R"5nUv U"U5 g!U"U5 f=f7f)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 rr`r`s/!Hs3& 3 03Tc#.# SU;aSOSnU"5nUSX/nU(aURSU/5 [[RRS5nU(aUOSn[ R "XhS9 Uv SSS5 g!,(df  g=f7f)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)extendrr rdevnull subprocess check_call) r!branchquietdest_ctxexerepo_dircmdrhrfs r repo_contextrqstC<%TC xGS+  JJ F+ ,rww,!tc1 sBA'B; B BBc`[R"S[SS9 [R"5$)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.nullcontextrErF)rHrIrJr; nullcontextr2r-rnullrts* MM8  ! ! ##r-c\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 )NNNcXlgr1) exceptions)selfrys r__init__ExceptionTrap.__init__s$r-cU$r1r2rzs r __enter__ExceptionTrap.__enter__ r-c URS$Nrexc_infor~s rtypeExceptionTrap.type}}Qr-c URS$)Nr(rr~s rvalueExceptionTrap.valuerr-c URS$)NrErr~s rtbExceptionTrap.tbrr-cfUSnU=(a [X R5nU(aXlU$r) issubclassryr)rzrrmatchess r__exit__ExceptionTrap.__exit__s+{<:dOO< $Mr-c,[UR5$r1)boolrr~s r__bool__ExceptionTrap.__bool__ sDIIr-_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=fr1)rvry)r3r4traprfuncrzs rwrapper%ExceptionTrap.raises..wrapper!s6t/4d%f%0; 0/s 0 >)r?wraps)rzrrrs``` rraisesExceptionTrap.raisess'&      r-c>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_)rzrs rpassesExceptionTrap.passes)s&{{4x}}{55r-)rryN)__name__ __module__ __qualname____firstlineno____doc__r Exceptionr{rpropertyrrrrrrrr__static_attributes__r2r-rrvrvssB H#,,%      %)66r-rvc\rSrSrSrSrg)suppressi?z A version of contextlib.suppress with decorator support. >>> @suppress(KeyError) ... def key_error(): ... {}[''] >>> key_error() r2N)rrrrrrr2r-rrr?sr-rc.\rSrSrSrSSjrSrSrSrg) 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)() cXlX lgr1actioncode)rzrrs rr{on_interrupt.__init__]s   r-cU$r1r2r~s rron_interrupt.__enter__arr-cU[LdURS:XagURS:Xa[UR5UeURS:H$)Nignoreerrorr)KeyboardInterruptr SystemExitr)rzexctypeexcinstexctbs rron_interrupt.__exit__dsE + +t{{h/F  [[G #TYY'W 4{{j((r-rN)rr() rrrrrr{rrrr2r-rrrJs$)r-r)r zstr | os.PathLikereturnIterator[str | os.PathLike]r1)r"zstr | os.PathLike | Nonerr)r+tarfile.TarInforr)" __future__rr;r?rr rrisysr]urllib.requestrrHtypingr version_info backportsrr<rr%rrC tarball_cwdrNr[r r`rqrtrvrContextDecoratorrr2r-rrsO"  g!     04"-" ""> :<ug&  32 ]]$ !$$&n6n6bz""J$?$?):..)r-