o
0iSb
@ s d Z ddlZddlZddlZddlZddlZddlZddlZddlZdZ e
e Z G dd dZ
dddZdd d
Ze d krld Zze dZW n eyd Z zed
e ejd W Y dZ[ndZ[ww ee dS dS )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)pipZ
setuptoolsc @ s e Zd ZdZ d"ddZdd Zdd Zd
d Zd d
Ze j
dkr)d#ddZ nd#ddZ dd Z dd Z
dd Zdd Zdd Zd d Zd d Zd d! ZdS )$
EnvBuildera
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
FNc C sF || _ || _|| _|| _|| _|dkrtjt }|| _ || _
d S )N.) system_site_packagesclearsymlinksupgradewith_pipospathbasenamegetcwdprompt upgrade_deps)selfr r r r r r r r 4/opt/alt/python310/lib64/python3.10/venv/__init__.py__init__/ s
zEnvBuilder.__init__c C s t j|}| |}| j}d| _| | | | | jr#| | | j s0|
| | | |r:d| _| | | j rD|
| dS dS )z
Create a virtual environment in a directory.
:param env_dir: The target directory to create an environment in.
FTN)r
r abspathensure_directoriesr create_configuration setup_pythonr
_setup_pipr
setup_scripts
post_setupr upgrade_dependencies)r env_dircontextZtrue_system_site_packagesr r r create< s"
zEnvBuilder.createc C s\ t |D ]&}t j||}t j|st j|r t | qt j|r+t | qd S N)
r
listdirr joinislinkisfileremoveisdirshutilZrmtree)r r fnr r r clear_directoryX s
zEnvBuilder.clear_directoryc C s dd }t j|r| jr| | t }||_t j|d |_ | j
dur*| j
n|j }d| |_
|| t j }|s?t
dt jt j|\}}||_||_||_t jdkrfd}d } t j|d
d }
nd }d
} t j|ddt jdd d }
t j|| |_} || ||
t jdkrt jdkrt jdkrt j|d} t j| st d| t j|| |_}
||_t j|
||_||
|j|_ t jdkrt j |j}t j |t j |jkrt d|j| ||_ |S )z
Create the directories for the environment.
Returns a context object which holds paths in the environment,
for use by subsequent logic.
c S sB t j| s
t | d S t j| st j| r td| d S )Nz Unable to create directory %r)r
r existsmakedirsr" r#
ValueError)dr r r create_if_neededh s
z7EnvBuilder.ensure_directories..create_if_needed Nz(%s) zUnable to determine path to the running Python interpreter. Provide an explicit path or check that your PATH environment variable is correctly set.Zwin32ZScriptsZIncludeLibz
site-packagesbinZincludelibz python%d.%d l posixdarwinZlib64zActual environment location may have moved due to redirects, links or junctions.
Requested location: "%s"
Actual location: "%s")!r
r r) r r( typesSimpleNamespacer splitenv_namer sys_base_executabler+ r
executable
python_dirZ
python_exeplatformr! version_infoZinc_pathmaxsizenamesymlinkbin_pathbin_nameenv_exe env_exec_cmdrealpathnormcaseloggerwarning)r r r- r r r; dirnameZexenameZbinnameZincpathZlibpathr Z link_pathbinpathZ real_env_exer r r r ` s^
z EnvBuilder.ensure_directoriesc C s t j|jd |_}t|dddC}|d|j | jr!d}nd}|d| |d t j
d
d | j d
urM|d | j d
W d
d
S W d
d
S 1 sXw Y d
S )aA
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-8)encodingz
home = %s
trueZfalsez"include-system-site-packages = %s
zversion = %d.%d.%d
N z prompt =
) r
r r! r Zcfg_pathopenwriter< r r9 r> r )r r r fZinclr r r r s
"z EnvBuilder.create_configurationntc C s | j }|sBz)tj|s.|r(tj|tj|ks J ttj|| nt|| W n tyA t d|| d}Y nw |rLt
|| dS dS )Y
Try symlinking a file, and if that fails, fall back to copying.
Unable to symlink %r to %rTN) r r
r r" rJ rA r ExceptionrH rI r& copyfile)r srcdstrelative_symlinks_okZ
force_copyr r r symlink_or_copy s zEnvBuilder.symlink_or_copyc C sr t j|o t j| }| jrO|sOt j|sOz&|r6t j|t j|ks)J t t j|| W dS t || W dS t yN t
d|| Y nw t j t j|\}}t j
t jtdd|| }tdsut j|s|drd| }|dd }|dkrd }n|d
krd }t j
t j||| }n|}t j|s|st
d | dS t|| dS )
rV NrW scriptsrU TZ_dpythonZ venvlauncherZpythonwZ
venvwlauncherzUnable to copy %r)r
r lexistsr) r r" rJ rA r rX rH rI splitextr! __file__ sysconfigis_python_buildr# endswithr& rY )r rZ r[ r\ Zbad_srcr ZextZsrcfnr r r r] sB
c C s |j }|j}| j}|j}tjdkrT||j| tj|s#t |d dddt
j d fD ]#}tj ||}tj
|sQ||j|dd tj|sQt |d q.dS | jrnd d
t|D }tdrmd d
|D }nh d }tj|j}|| |D ]}tj ||} tj| r|| tj || qtdrt|jD ]<\}
} } d
| v rtj|
}
tj |jd|
}
tj
|
st|
tj |
d
} tj |
d
}t| | dS qdS dS )z
Set up a Python executable in the environment.
:param context: The information for the environment creation request
being processed.
rU i r` Zpython3zpython3.r. T)r\ c S s, g | ]}t jt j|d dv r|qS )r. ).exez.dll)r
r rG rb .0rT r r r
s
z+EnvBuilder.setup_python..c S s" g | ]
}t j|d r|qS ))r` Z vcruntime)r
r rG
startswithrh r r r rj s > z python_d.exez pythonw.exez
python.exez
pythonw_d.exezinit.tclr/ N)rB rD r] r< r
r@ r; r r" chmodr9 r> r! r) r r rd re r addra walkr r* r& rY )r r rK r ZcopierrJ suffixsuffixesZbase_exerZ rootdirsfilesZtcldirr[ r r r r s^
zEnvBuilder.setup_pythonc O sj |j g|}tj |d< }|j|d< |dd |dd |j|d< |j |d< tj|fi | dS )z8Executes the newly created Python using safe-ish optionsenvZ VIRTUAL_ENVZ
PYTHONHOMENZ
PYTHONPATHcwdr; )rE r
environcopyr pop
subprocessZ check_output)r r Zpy_argskwargsargsrt r r r _call_new_python8 s
zEnvBuilder._call_new_pythonc C s | j |ddddtjd dS )z1Installs or upgrades pip in a virtual environment-mZ ensurepip --upgradez
--default-pip)stderrN)r| ry ZSTDOUTr r r r r r G s
zEnvBuilder._setup_pipc C s2 t jt jt}t j|d}| || dS )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.
r^ N)r
r r rJ rc r! install_scripts)r r r r r r r L s zEnvBuilder.setup_scriptsc C s dS )a
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.
Nr r r r r r [ s zEnvBuilder.post_setupc s |j |j|j|j|jd}dd }dd }tj |j}|dr#| n |dr+| ntj fdd | D }| D ]
\}}|
||}q=|S )
ai
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.
)Z __VENV_DIR__Z
__VENV_NAME__Z__VENV_PROMPT__Z__VENV_BIN_NAME__Z__VENV_PYTHON__c S s | dd} d| dS )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'')replacesr r r quote_ps1x s z/EnvBuilder.replace_variables..quote_ps1c S s | S r r r r r r quote_bat s z/EnvBuilder.replace_variables..quote_batz.ps1z.batc s i | ] \}}| |qS r r )ri keyr quoter r
s z0EnvBuilder.replace_variables..) r r8 r rC rD shlexr script_pathrf itemsr ) r textr Z replacementsr r r r Zquotedr r r replace_variablese s&
z EnvBuilder.replace_variablesc C s |j }t|}t|D ]\}}}||kr+|dd D ]}|dtjfvr)|| qq |D ]} tjdkr?| dr?| dr?q-tj || }
||d
tj dd } | sY|} n
tjj |g| R } tj | snt
| tj | | }
t|
d } | }W d n1 sw Y |
ds|
|_z|d}| ||}|d}W n ty } zd}td |
| W Y d}~nd}~ww |durt|
d
} | | W d n1 sw Y t|
|
q-q dS ) as
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.
NcommonrU r` )rg z.pdbr2 rbrM z+unable to copy script %r, may be binary: %swb)rB lenr
rn r@ r$ rk rf r r! r7 sepr) r* rR readr decoder encode UnicodeErrorrH rI rS r& Zcopymode)r r r rK Zplenrq rr rs r, rT Zsrcfilero ZdstdirZdstfiledataer r r r s\
zEnvBuilder.install_scriptsc C s6 t dt d|j | j|ddddgtR d S )Nz
Upgrading z
packages in r} r Zinstallr~ )rH debugCORE_VENV_DEPSrB r| r r r r r s z EnvBuilder.upgrade_dependencies)FFFFFNF)F)__name__
__module__ __qualname____doc__r r r( r r r
r@ r] r r| r r r r r r r r r r r s*
G
+=
0 3r Fc C s" t ||||||d}|| dS )z,Create a virtual environment in a directory.)r r r r r r N)r r )r r r r r r r builderr r r r s
r c
C sx d}t jdk r
d}ntt dsd}|stddd l}|jtddd }|jd
d d d
d |jdddddd tj dkr>d}nd}|
}|jd|dddd |jd| dddd |jdddd d d |jd ddd d d |jd!d"ddd#d$ |jd%d&d' |jd(ddd)d* d+ t
d || }|jr|jrtd,t|j|j|j|j|j|j|jd-}|jD ]}|| qd S ).NT)rP rP F base_prefixz.This script is only for use with Python >= 3.3r zFCreates virtual Python environments in one or more target directories.z|Once an environment has been created, you may wish to activate it, e.g. by sourcing an activate script in its bin directory.)prog descriptionZepilogrr ZENV_DIR+z)A directory to create the environment in.)metavarnargshelpz--system-site-packages
store_true system_sitezDGive the virtual environment access to the system site-packages dir.)defaultactiondestr rU z
--symlinksr z[Try to use symlinks rather than copies, when symlinks are not the default for the platform.z--copiesZ store_falsez\Try to use copies rather than symlinks, even when symlinks are the default for the platform.z--clearr zcDelete the contents of the environment directory if it already exists, before environment creation.r~ r zlUpgrade the environment directory to use this version of Python, assuming Python has been upgraded in-place.z
--without-pipr z]Skips installing or upgrading pip in the virtual environment (pip is bootstrapped by default))r r r r z--promptz;Provides an alternative prompt prefix for this environment.)r z--upgrade-depsr z;Upgrade core dependencies: {} to the latest version in PyPI z1you cannot supply --upgrade and --clear together.)r r r r r r r )r9 r> hasattrr+ argparseArgumentParserr add_argumentr
r@ Z add_mutually_exclusive_groupformatr! r
parse_argsr r r r r r r r rr r ) r{ Z
compatibler parserZ use_symlinksgroupZoptionsr r, r r r main s
r __main__r. z Error: %s)file)FFFFNFr )r Zloggingr
r& ry r9 rd r5 r r Z getLoggerr rH r r r ZrcrX r printr exitr r r r s<
>
N