a0bi$ S SK r S SKrS SKrS SKrS SKrS SKrS SKrS SKr\R S 5 r \R SS\ 4S j5 r
S r \R \R 4S j5 r
\R SS\
4S j5 r\R S 5 r " S S
5 r " S S \R" \R$ 5 r " S
S\R$ 5 rg) Nc # # [ R " 5 n[ R " U 5 U v [ 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 ښ/builddir/build/BUILDROOT/alt-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/_vendor/jaraco/context.pypushdr
s= 99;DHHSM
s ,A%A
A%
A""A%c
# # Uc? [ R R U 5 R SS5 R SS5 nUc$ [ R
" [ R SS9nO[ R " S[ 5 U" SR " S0 [ 5 D65 S nS
nS R XE45 nU" UR " SS [ U 5 0[ 5 D65 U" U5 Uv SSS5 U" S
R " S0 [ 5 D65 g! , ( d f N/= f! U" S
R " S0 [ 5 D65 f = f7f)z
Get a tarball, extract it, change to that directory, yield, then
clean up.
`runner` is the function to invoke commands.
`pushd` is a context manager for changing the directory.
Nz.tar.gz z.tgzT)shellz runner parameter is deprecatedzmkdir {target_dir}zwget {url} -O -z7tar x{compression} --strip-components=1 -C {target_dir}z | compressionzrm -Rf {target_dir} )r pathbasenamereplace functoolspartial
subprocess
check_callwarningswarnDeprecationWarningformatvarsjoininfer_compression)url
target_dirrunnerr
getterextractcmds r tarball_contextr$ s WW%%c*229bAII&RTU
~"":#8#8E
68JK
& & 0 017"Kjj&*+szzG&7&<GGH
:
$++5df56
$++5df56s7 B%E(A D0 1D 6D0 >!E
D-)D0 0"EEc F U SS n[ SSSS9nUR 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'
NzjJ)gzbzxz)dictget)r compression_indicatormappings r r r : s0 Hccc*G ;;,c 22 c # j # [ R " 5 n Uv 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')
>>> assert not os.path.exists(the_dir)
N)tempfilemkdtemp)removertemp_dirs r r6 r6 N s/ !Hs 3& 3
03Tc # . # SU ; a SOSnU" 5 nUSX/nU( a UR SU/5 [ [ R R S5 nU( a UOSn[
R " XhS9 Uv SSS5 g! , ( d f 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)extendopenr r devnullr r ) r branchquietdest_ctxexerepo_dirr# r? r< s r repo_contextrE a st C<%TC xGS+ JJ
F+ ,rww, !t c1
s BA'B; B
BBc # # Sv g7f)zw
A null context suitable to stand in for a meaningful context.
>>> with null() as value:
... assert value is None
Nr r r1 r nullrG t s
s c \ rS rSrSrSr\44S jrS r\ S 5 r
\ S 5 r \ S 5 r S r
S
r\S .S jrS
rSrg)
ExceptionTrap aA
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
)NNNc Xl g N)
exceptions)selfrM s r __init__ExceptionTrap.__init__ s $r1 c U $ rL r rN s r __enter__ExceptionTrap.__enter__ r1 c U R S $ Nr exc_inforR s r typeExceptionTrap.type }}Q r1 c U R S $ )N rX rR s r valueExceptionTrap.value r\ r1 c U R S $ )N rX rR s r tbExceptionTrap.tb r\ r1 c f US nU=( a [ X R 5 nU( a Xl U$ rW )
issubclassrM rY )rN rY rZ matchess r __exit__ExceptionTrap.__exit__ s+ {<:dOO< $Mr1 c , [ U R 5 $ rL )boolrZ rR s r __bool__ExceptionTrap.__bool__ s DII r1 _testc N ^ ^^ [ R " T5 UUU 4S j5 nU$ )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 > [ TR 5 nT" U 0 UD6 S S S 5 T" W5 $ ! , ( d f N= frL )rI rM )argskwargstrapro funcrN s r wrapper%ExceptionTrap.raises..wrapper s6 t/4d%f% 0; 0/s 0
>)r wraps)rN ru ro rv s ``` r raisesExceptionTrap.raises s' &
r1 c > U R U[ R S9$ )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
rn )ry operatornot_)rN ru s r passesExceptionTrap.passes s & {{4x}}{55r1 )rY rM N)__name__
__module__ __qualname____firstlineno____doc__rY ExceptionrO rS propertyrZ r_ rc rh rl rk ry r~ __static_attributes__r r1 r rI rI ss B H#,, % %) 66r1 rI c \ rS rSrSrSrg)suppress z
A version of contextlib.suppress with decorator support.
>>> @suppress(KeyError)
... def key_error():
... {}['']
>>> key_error()
r N)r r r r r r r r1 r r r s r1 r c 2 \ rS rSrSr SS jrS rS rSrg) on_interrupt a
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 Xl X l g rL actioncode)rN r r s r rO on_interrupt.__init__ s r1 c U $ rL r rR s r rS on_interrupt.__enter__ rU r1 c U[ Ld U R S:X a g U R S:X a [ U R 5 UeU R S:H $ )Nignoreerrorr )KeyboardInterruptr
SystemExitr )rN exctypeexcinstexctbs r rh on_interrupt.__exit__ sE + +t{{h/F
[[G
# TYY'W 4{{j((r1 r N)r r^ ) r r r r r rO rS rh r r r1 r r r s ( )r1 r )r r
contextlibr r3 shutilr| r contextmanagerr
r$ r rmtreer6 rE rG rI r ContextDecoratorr r r1 r r s
$(U 7 7:3( ]] $ ! $
n6 n6bz""J$?$? %):.. %)r1