*jw F S r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSr \R " \ 5 r " S S5 r
S
\" 5 S.S jjrSS jr\ S :X a S
r \" 5 Sr\R, " \5 gg! \ a r\" S \- \R* S 9 SrCN3SrCff = f)z
Virtual environment (venv) package for Python. Based on PEP 405.
Copyright (C) 2011-2014 Vinay Sajip.
Licensed to the PSF under a contributor agreement.
N)pipc \ rS rSrSr S\" 5 S.S jjrS rS rS r \
S 5 r S
r S r
SS jrS
r\R" S:w a S rOS rS rS rS rS rS rS rS rSrg)
EnvBuilder a
This class exists to allow virtual environment creation to be
customized. The constructor parameters determine the builder's
behaviour when called upon to create a virtual environment.
By default, the builder makes the system (global) site-packages dir
*un*available to the created environment.
If invoked using the Python -m option, the default is to use copying
on Windows platforms but symlinks elsewhere. If instantiated some
other way, the default is to *not* use symlinks.
:param system_site_packages: If True, the system (global) site-packages
dir is available to created environments.
:param clear: If True, delete the contents of the environment directory if
it already exists, before environment creation.
:param symlinks: If True, attempt to symlink rather than copy files into
virtual environment.
:param upgrade: If True, upgrade an existing virtual environment.
:param with_pip: If True, ensure pip is installed in the virtual
environment
:param prompt: Alternative terminal prefix for the environment.
:param upgrade_deps: Update the base venv modules to the latest on PyPI
:param scm_ignore_files: Create ignore files for the SCMs specified by the
iterable.
Nscm_ignore_filesc $ Xl X l X0l X@l XPl X`l US:X a2 [ R R [ R " 5 5 nX`l
Xpl [ [ [ R U5 5 U l g )N.)system_site_packagesclearsymlinksupgradewith_pip orig_promptospathbasenamegetcwdprompt upgrade_deps frozensetmapstrlowerr ) selfr r r
r r r r r s 4/opt/alt/python313/lib64/python3.13/venv/__init__.py__init__EnvBuilder.__init__1 si %9!
! S=WW%%biik2F ( )#cii9I*J K c N [ R R U5 nU R U5 nU R H n[ U SU S35 " U5 M U R nSU l U R U5 U R U5 U R ( a U R U5 U R ( d" U R U5 U R U5 U( a SU l U R U5 U R ( a U R U5 gg)zr
Create a virtual environment in a directory.
:param env_dir: The target directory to create an environment in.
create_ _ignore_fileFTN)r r abspathensure_directoriesr getattrr create_configuration setup_pythonr
_setup_pipr
setup_scripts
post_setupr upgrade_dependencies)r env_dircontextscmtrue_system_site_packagess r createEnvBuilder.create@ s ''//'*))'2((C DGC5 5 6w ? ) %)$=$=!$)! !!'* '" == OOG $|| w ' OOG $ $ )-D % % %g . % %g . r c [ R " U5 H n[ R R X5 n[ R R U5 ( d$ [ R R U5 ( a [ R " U5 M [ R R U5 ( d M [ R " U5 M g N)
r listdirr joinislinkisfileremoveisdirshutilrmtree)r r fns r clear_directoryEnvBuilder.clear_directory^ sv **T"B d'Bww~~b!!RWW^^B%7%7 "
r""
b! #r c < UUUUS.n[ R " USUS9$ )N)baseplatbaseinstalled_baseinstalled_platbasevenv)schemevars) sysconfigget_path)r r, namerF s r
_venv_pathEnvBuilder._venv_pathf s, %")
!!$vDAAr c [ R S:X a [ R R U5 [ R R U5 :X a gSSKn UR
[ R " U5 5 n UR
[ R " U5 5 n[ R R U5 [ R R U5 :X a ggX:H $ ! [ a Nxf = f! [ a Nbf = f)zCheck whether two paths appear the same.
Whether they refer to the same file is irrelevant; we're testing for
whether a human reader would look at the path string and easily tell
that they're the same file.
win32Tr NF) sysplatformr r normcase_winapiGetLongPathNamefsdecodeOSError)clspath1path2rQ s r
_same_pathEnvBuilder._same_patho s <<7 "ww &"''*:*:5*AA
// E0BC
// E0BC ww &"''*:*:5*AA> !
s$ %C, %C< ,
C98C9<
D D c D S n[ R [ R " U5 ; a [ SU S[ R S35 e[ R R U5 ( a" U R ( a U R U5 [ R " 5 nXl
[ R R U5 S Ul U R b U R O UR Ul
U" U5 [ R nU( d [ S5 e[ R R [ R R! U5 5 u pV[ R" S:X a@ [ R R% U5 S R' S 5 ( a S OS
nS U S 3nXCl XSl Xcl U R/ US
5 nU R/ US5 n U R/ US5 n
Xl U" U 5 Xl U" U
5 [ R4 S: a [ R6 S:X ao [ R" S:w a[ [ R R9 US5 n [ R R U 5 ( d [ R: " SU 5 Xl [ R R? X5 Ul [ R R9 X5 Ul! U" U5 URB Ul" [ R" S:X ap [ R RG URB 5 n U RI XRB 5 ( d' [J RM SURB U 5 Xl" U$ )z
Create the directories for the environment.
Returns a context object which holds paths in the environment,
for use by subsequent logic.
c & [ R R U 5 ( d [ R " U 5 g [ R R U 5 ( d$ [ R R U 5 ( a [
SU - 5 eg )Nz Unable to create directory %r)r r existsmakedirsr6 r7
ValueError)ds r create_if_needed7EnvBuilder.ensure_directories..create_if_needed s[ 77>>!$$ A ""bggnnQ&7&7 !@1!DEE '8r z Refusing to create a venv in z( because it contains the PATH separator r
zUnable to determine path to the running Python interpreter. Provide an explicit path or check that your PATH environment variable is correctly set.rM r _d python.exescriptsincludepurelibl posixdarwinlib64libzActual environment location may have moved due to redirects, links or junctions.
Requested location: "%s"
Actual location: "%s")'r pathsepfspathr^ r r\ r r= typesSimpleNamespacer, splitenv_namer rN _base_executabler# rO splitextendswith
executable
python_dir
python_exerJ inc_pathlib_pathmaxsizerI r5 symlinkbin_pathrelpathbin_nameenv_exe env_exec_cmdrealpathrX loggerwarning)
r r, r` r- rw dirnameexenamerc binpathincpathlibpath link_path real_env_exes
r r$ EnvBuilder.ensure_directories s F ::7+ + >' " "tzz )'')! 77==1!4(, (?WEUEU!))
. /
/ 77== )DE <<7 " ))'215>>tDD"B rd$'G ' $ $//'95//'95//'95"!"!
[[5
rww''9
\\X
% Wg6I77>>),,
5)," 77??7< '',,w8! ' <<7 " 77++GOO
(4$r c [ R R UR S5 =Ul n[ USSS9 nUR
SUR - 5 U R ( a SnOSnUR
SU- 5 UR
S [ R S
S - 5 U R b UR
S U R < S
35 UR
S[ R R [ R 5 - 5 / n[ R S:H nU( a" U R ( a UR! S5 U( d" U R ( d UR! S5 U R" ( d UR! S5 U R ( a UR! S5 U R$ ( a UR! S5 U R& ( a UR! S5 U R( ( a UR! S5 U R* b UR! SU R* S35 U R, ( d UR! S5 UR! UR 5 SR U5 nUR
S[ R S U S
35 S
S
S
5 g
! , ( d f g
= f) a
Create a configuration file indicating where the environment's Python
was copied from, and whether the system site-packages should be made
available in the environment.
:param context: The information for the environment creation request
being processed.
z
pyvenv.cfgwutf-8encodingz
home = %s
truefalsez"include-system-site-packages = %s
zversion = %d.%d.%d
N z prompt =
zexecutable = %s
nt
--symlinks--copies
--without-pip--system-site-packages--clear --upgrade--upgrade-depsz
--prompt=""--without-scm-ignore-files z
command = z -m venv )r r r5 r, cfg_pathopenwriterx r rN version_infor r rw rI r
appendr r r r r r )r r- r finclargsr s r r& EnvBuilder.create_configuration s #%'',,w "MM4
$g
.!
GGMG$6$66 7((
GG9D@ A
GG*S-=-=bq-AA B{{&)DKK?"56
GG'"''*:*:3>>*JJ KDD Bdmm L)dmm J'== O,(( 45zz I&|| K( ,- + j)9)9(:! <=(( 89 KK (88D>D
GGj 0 $rB CE /
.
.s J K
K c U R ( + nU( dw [ R R U5 ( dR U( a5 [ R " [ R R U5 U5 O[ R " X5 U( a [ R " X5 gg! [ a [ R SX5 Sn NCf = f)z
Try symlinking a file, and if that fails, fall back to copying.
(Unused on Windows, because we can't just copy a failed symlink file: we
switch to a different set of files instead.)
Unable to symlink %r to %rTN) r
r r r6 r} r Exceptionr r r: copyfile)r srcdstrelative_symlinks_ok
force_copys r symlink_or_copyEnvBuilder.symlink_or_copy s &
"ww~~c**+
277#3#3C#8#>
3, OOC %
" ;SF !
"s A B/ :B/ /"CCc [ R R UR S5 n[ USSS9 nUR S5 UR S5 SSS5 g! , ( d f g= f)z
Create a .gitignore file in the environment directory.
The contents of the file cause the entire environment directory to be
ignored by git.
z
.gitignorer r r zC# Created by venv; see https://docs.python.org/3/library/venv.html
z*
N)r r r5 r, r r )r r- gitignore_pathfiles r create_git_ignore_file!EnvBuilder.create_git_ignore_file sU goo|D
.#
8D JJ K
L JJu 9
8
8s #A""
A0r c h UR nUR nU R nUR nU" UR U5 [
R R U5 ( d [
R " US5 SSS[ R S 34 H n[
R R X&5 n[
R R U5 ( a MH U" UR USS9 [
R R U5 ( a M [
R " US5 M g)
Set up a Python executable in the environment.
:param context: The information for the environment creation request
being processed.
i re python3zpython3.rb T)r N)
r~ r r rx rw r r r6 chmodrN r r5 r\ )r r- r r copierr suffixs r r' EnvBuilder.setup_python% s &&G??D))F ((G 7%%t ,77>>$''u%#Y %c&6&6q&9%:;=ww||G4ww~~d++ 7??DtL 77>>$//u-=r c UR nUR n[ R R UR
5 n[ R R
U5 S n[ R R U5 R S5 ( a SOSn[ R " 5 ( a UnOB[ R R [ R R [ 5 SS5 n[ R " S5 ( d [ R R USU S35 n[ R R US U S35 n S
USU S3US U S U S3U 0n
[ R R US U S35 n[ R R US
U S35 n S
USU S3US U S U S3U 0n GOS[ R S S3n [ R R USU U S35 n[ R R US U U S35 n S
USU S3USU S3USU U S3US U S U S3U S U S3U S U U S3U 0n
[ R R USU S35 n[ R R USU S35 n S
USU S3USU S3USU U S3US U S U S3U S U S3U S U U S3U 0n Sn
U R" ( Ga5 Sn
U
R% [ R& " U5 Vs0 s H n[ R R U5 R) S5 ( d M8 [ R R [ R R
U5 S 5 S:X d M} U[ R R X>5 _M sn5 / nU
R+ 5 HO u nn[ R R UU5 n [ R, " UU5 UR/ U5 MQ U
( aR U R+ 5 H> u nn[ R R UU5 n [8 R: " UU5 M@ [ R " 5 ( Ga [ R< " UR 5 H u nnnSU; d M [ R R U5 n[ R R UR> S U5 n[ R RA U5 ( d [ RB " U5 [ R R US5 n[ R R US5 n[8 RD " UU5 g g g s snf ! [0 a{ [2 R5 SUU5 Sn
U HA n [ R6 " U5 M ! [0 a [2 R5 SU5 M? f = f [2 R5 S5 GM
f = f! [0 a [2 R5 SUU5 GM f = f) r r rc rd rg r Py_GIL_DISABLEDre rf pythonwz
python.exez pythonw.exe venvlauncher
venvwlauncherz3.rb t
venvlaunchertvenvwlaunchertTF)re vcruntimez.dllr z Failed to clean up symlink %rzRetrying with copieszUnable to copy %r to %rzinit.tclLibN)#r~ rx r r r r ru rP rv rG is_python_buildr5 r __file__get_config_varrN r r
updater4
startswithitemsr} r rT r r unlinkr: copy2walkr, r\ r] r )r r- r r r exe_stemexe_drg ry pythonw_exe link_sources copy_sourcesexe_t do_copiesr to_unlinkdestr rootdirsfilestcldirr s r r' r > s &&G ((Ggg&&w7Gww''03H GG , ,X 6 ? ? E ED2E((**! '',,rwwx'@'0$8 ++,=>> WW\\'VE7$3G H
ggll7geWD4I J * UG4(*!; eWD); WW\\'\%3M N
ggll7mE7$4O P * UG4(*!; eWD); S - -a 0 13 WW\\'VE75'3N O
ggll7geWUG44P Q * UG4(* UG4(* UGE7$/!; eWD); eWD); eWUG40+ WW\\']5'3N O
ggll7nUG44P Q * UG4(* UG4(* UGE7$/!; eWD); eWD); eWUG40+ I}}} ! ##9;G9L%9LAww''*556MN 0(()9)9!) S1 *E +A% #
'CS$O$( !*A 2 " ! #* 2 &/N/0!2 2 "+ '=>
" # M '@#tLLMs[ 7V AV $V /(V$X,$(X)
W%#X)% X X)X X)(X),!YYc 8 UR /UQn[ R R 5 =US' nUR US' UR SS5 UR SS5 UR US' UR US' [ R " U40 UD6 g)z8Executes the newly created Python using safe-ish optionsenv VIRTUAL_ENV
PYTHONHOMEN
PYTHONPATHcwdrw )r r environcopyr, pop
subprocess check_output)r r- py_argskwargsr r s r _call_new_pythonEnvBuilder._call_new_python s $$/w/ jjoo //u
$__M d# d# u
& 3 3| //r c H U R USSSS[ R S9 g)z1Installs or upgrades pip in a virtual environment-m ensurepipr z
--default-pip)stderrN)r r STDOUTr r- s r r( EnvBuilder._setup_pip s) gt[+ -j6G6G Ir c [ R R [ R R [ 5 5 n[ R R US5 nU R
X5 g)a
Set up scripts into the created environment from a directory.
This method installs the default scripts into the environment
being created. You can prevent the default installation by overriding
this method if you really need to, or if you need to specify
a different location for the scripts to install. By default, the
'scripts' directory in the venv package is used as the source of
scripts to install.
rg N)r r r# r r r5 install_scripts)r r- r s r r) EnvBuilder.setup_scripts sE wwrwwx 89ww||D), W+r c g)z
Hook for post-setup modification of the venv. Subclasses may install
additional packages or scripts here, add activation shell scripts, etc.
:param context: The information for the environment creation request
being processed.
N r s r r* EnvBuilder.post_setup s
r c UR UR UR UR UR S.nS nS n[
R nUR nUR S5 ( a UnO)UR S5 ( a UnO[
R nUR 5 VV s0 s H
u pX" U 5 _M nnn UR 5 H u pUR X5 nM U$ s sn nf )a1
Replace variable placeholders in script text with context-specific
variables.
Return the text passed in , but with variables replaced.
:param text: The text in which to replace placeholder variables.
:param context: The information for the environment creation request
being processed.
) __VENV_DIR__
__VENV_NAME____VENV_PROMPT____VENV_BIN_NAME____VENV_PYTHON__c 2 U R SS5 n SU S3$ )a
This should satisfy PowerShell quoting rules [1], unless the quoted
string is passed directly to Windows native commands [2].
[1]: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_quoting_rules
[2]: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_parsing#passing-arguments-that-contain-quote-characters
'z'')replacess r quote_ps1/EnvBuilder.replace_variables..quote_ps1 s! #t$Aqc8Or c U $ r3 r r s r quote_bat/EnvBuilder.replace_variables..quote_bat s Hr z.ps1z.bat) r, rs r r r shlexquote script_pathrv r r ) r textr- replacementsr r r r keyr quoteds r replace_variables EnvBuilder.replace_variables s $OO $ - - &~~!(!1!1 &
)) ' ' E
!
!&
)
) E KKE4@4F4F4HI4H&#U1X
4H I'--/KC<<,D 0 Js 2C5c ~ UR n[ U5 n[ R S:X a S nOS n[ R " U5 GH u pgnXb:X a7 USS H, n U S[ R 4; d M UR U 5 M. MC U GH n
U" U
5 ( a M [ R R Xj5 n XdS R [ R 5 SS n U ( d Un
O![ R R " U/U Q76 n
[ R R U
5 ( d [ R " U
5 [ R R X5 n[ R S:X a/ U R S5 ( a [ R " X5 GM [ U S5 n
U
R! 5 nSSS5 Xl U R% WR' S 5 U5 R) S 5 nUU:X a [ R0 " X5 GM [ US 5 n
U
R3 U5 SSS5 [ R4 " X5 GM GM! g! , ( d f N= f! [* a# n[, R/ S
U U5 SnAGM SnAff = f! , ( d f Np= f) a#
Install scripts into the created environment from a directory.
:param context: The information for the environment creation request
being processed.
:param path: Absolute pathname of a directory containing script.
Scripts in the 'common' subdirectory of this directory,
and those in the directory named for the platform
being run on, are installed in the created environment.
Placeholder variables are replaced with environment-
specific values.
r c [ R R U 5 n U R S5 =( a U R S5 $ )N)re rD rf z.pdb)r r rP r rv r s r skip_file-EnvBuilder.install_scripts..skip_file s: GG$$Q' %78 9 JJ'7 8:r c g)NFr r s r r r s r Ncommon r rbr z+unable to copy script %r, may be binary: %swb)r~ lenr rI r r8 r r5 rr sepr\ r] rv r: r r readr r decodeencode UnicodeErrorr r r r copymode)r r- r r plenr r r r r_ r srcfiler dstdirdstfiledatanew_dataes r r EnvBuilder.install_scripts
s ""4y
77d?
:
!# D| aA277 33 A ! Q<< '',,t/ e**2662126 $F WW\\' ;F ;Fww~~f--KK' '',,v177d?w'7'78H'I'ILL2 '4(A 668D ) *1' ..t{{7/CWM #VG_ t#KK1 gt,) -OOG5A
"/* )( $ NN $78?D -,s0 7I-6I>2J.-
I; >
J+J&&J+.
J< c [ R S[ SUR 35 U R " USSSS/[ Q76 g )Nz
Upgrading z
packages in r r installr )r debugCORE_VENV_DEPSr~ r r s r r+ EnvBuilder.upgrade_dependenciesI sH (
g6F6F5G H
gtUI{ / - /r ) r r r r r
r r r r )FFFFFNF)F)__name__
__module__ __qualname____firstlineno____doc__r r r0 r= rJ classmethodrX r$ r& r r r rI r' r r( r) r* r r r+ __static_attributes__r r r r r s 6 :?GK #
L9B
L /<"B " "4GR,D\&,
ww$ .2m ^
0 I
,
.`=6~/r r r c
@ [ UX#UXVUS9nUR U 5 g)z,Create a virtual environment in a directory.)r r r
r r r r N)r r0 ) r, r r r
r r r r builders r r0 r0 Q s* .B $( &*: 4;M ,IK )5' 2 H I
%G7==LMMg.A.A &}}")"2"2!( ")"2"2 '&-&:&:*1*B*BDG \\q r __main__rb z Error: %s)r )FFFFNFr3 )r9 loggingr r: r rN rG rp r
r3 getLoggerr5 r r r r0 rX rcr r. printr exitr r r r_ s
8 $y/ y/x 7