ž
§ÿ fsA c @ s
d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z e j e ƒ Z Gd d „ d ƒ Z
e e e d d „ Z e
d d „ Z e d k rd
Z y e ƒ d Z Wn< e k
rõ Z z e d e d e j ƒWYd d Z [ Xn Xe j e ƒ n d S(
u5
Virtual environment (venv) package for Python. Based on PEP 405.
Copyright (C) 2011-2012 Vinay Sajip.
Licensed to the PSF under a contributor agreement.
usage: python -m venv [-h] [--system-site-packages] [--symlinks] [--clear]
[--upgrade]
ENV_DIR [ENV_DIR ...]
Creates virtual Python environments in one or more target directories.
positional arguments:
ENV_DIR A directory to create the environment in.
optional arguments:
-h, --help show this help message and exit
--system-site-packages
Give the virtual environment access to the system
site-packages dir.
--symlinks Attempt to symlink rather than copy.
--clear Delete the environment directory if it already exists.
If not specified and the directory exists, an error is
raised.
--upgrade Upgrade the environment directory to use this version
of Python, assuming Python has been upgraded in-place.
i Nc B s¼ | Ee Z d Z d Z d d d d d d „ Z d d „ Z d d „ Z d d „ Z e j
d
k rp d d „ Z n d
d „ Z d d „ Z
d d „ Z d d „ Z d d „ Z d d „ Z d S( u
EnvBuilderu
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 and the target directory exists, it is deleted.
Otherwise, if the target directory exists, an error is
raised.
:param symlinks: If True, attempt to symlink rather than copy files into
virtual environment.
:param upgrade: If True, upgrade an existing virtual environment.
c C s( | | _ | | _ | | _ | | _ d S( N( u system_site_packagesu clearu symlinksu upgrade( u selfu system_site_packagesu clearu symlinksu upgrade( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu __init__= s u EnvBuilder.__init__c C se t j j | ƒ } | j | ƒ } | j | ƒ | j | ƒ | j sa | j | ƒ | j | ƒ n d S( uŠ
Create a virtual environment in a directory.
:param env_dir: The target directory to create an environment in.
N( u osu pathu abspathu ensure_directoriesu create_configurationu setup_pythonu upgradeu
setup_scriptsu
post_setup( u selfu env_diru context( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu createD s
u EnvBuilder.createc
C s d d „ } t j j | ƒ rD | j p- | j rD t d | ƒ ‚ n t j j | ƒ ro | j ro t j | ƒ n t j ƒ } | | _
t j j | ƒ d | _ d | j | _
| | ƒ t j } t j d k rë d | k rë t j d } n t j } t j j t j j | ƒ ƒ \ } } | | _ | | _ | | _ t j d k rid } d
} t j j | d d ƒ }
n8 d
} d } t j j | d d t j d d … d ƒ }
t j j | | ƒ | _ } | | ƒ | |
ƒ t j j | | ƒ | _ } | | _ t j j | | ƒ | _ | | ƒ | S( uª
Create the directories for the environment.
Returns a context object which holds paths in the environment,
for use by subsequent logic.
c S s& t j j | ƒ s" t j | ƒ n d S( N( u osu pathu existsu makedirs( u d( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu create_if_needed[ s u7 EnvBuilder.ensure_directories..create_if_neededu Directory exists: %si u (%s) u darwinu __PYVENV_LAUNCHER__u win32u Scriptsu Includeu Libu
site-packagesu binu includeu libu python%d.%dNi ( u osu pathu existsu clearu upgradeu
ValueErroru shutilu rmtreeu typesu SimpleNamespaceu env_diru splitu env_nameu promptu environu sysu platformu
executableu abspathu
python_diru
python_exeu joinu version_infou inc_pathu bin_pathu bin_nameu env_exe(
u selfu env_diru create_if_neededu contextu envu
executableu dirnameu exenameu binnameu incpathu libpathu pathu binpath( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu ensure_directoriesS sB %
$ ,
u EnvBuilder.ensure_directoriesc C sœ t j j | j d ƒ | _ } t | d d d ƒb } | j d | j ƒ | j r] d } n d } | j d | ƒ | j d t j
d
d … ƒ Wd
QXd
S( uA
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.
u
pyvenv.cfgu wu encodingu utf-8u
home = %s
u trueu falseu" include-system-site-packages = %s
u version = %d.%d.%d
Ni ( u osu pathu joinu env_diru cfg_pathu openu writeu
python_diru system_site_packagesu sysu version_info( u selfu contextu pathu fu incl( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu create_configuration‚ s u EnvBuilder.create_configurationu ntc C s: | j d ƒ r d } n | j d ƒ o3 | j d ƒ } | S( Nu .pydu .dllu pythonu .exe( u .pydu .dllT( u endswithu Trueu
startswith( u selfu fu result( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu include_binary– s u EnvBuilder.include_binaryc C s‡ | j } | sj y) t j j | ƒ s8 t j | | ƒ n Wqj t k
rf t j d | | ƒ d } Yqj Xn | rƒ t j
| | ƒ n d S( uQ
Try symlinking a file, and if that fails, fall back to copying.
u Unable to symlink %r to %rNT( u symlinksu osu pathu islinku symlinku Exceptionu loggeru warningu Trueu shutilu copyfile( u selfu srcu dstu
force_copy( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu symlink_or_copy s
u EnvBuilder.symlink_or_copyc sŒ | j } | j } | j } | j } | | j | ƒ | j } t j d k r¿ t j j | ƒ sq t j
| d ƒ n xd D]@ } t j j | | ƒ } t j j | ƒ sx t j
| | ƒ qx qx WnÉd } | j ‰ ‡ f d d † t j | ƒ Dƒ } xW | D]O }
t j j | |
ƒ } t j j | |
ƒ } | | j k r÷ | | | ƒ q÷ q÷ Wt j j | | ƒ } t j j | ƒ rÞ‡ f d d † t j | ƒ Dƒ } xH | D]= }
t j j | |
ƒ } t j j | |
ƒ } | | | ƒ qšWn x§ t j | j ƒ D]“ \ }
} } d | k rñt j j |
ƒ } t j j | j d
| ƒ } t j | ƒ t j j |
d ƒ } t j j | d ƒ } t j | | ƒ PqñqñWd S(
u·
Set up a Python executable in the environment.
:param context: The information for the environment creation request
being processed.
u ntií u pythonu python3u DLLsc s" g | ] } ˆ | ƒ r | ‘ q S( ( ( u .0u f( u include( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu
à s u+ EnvBuilder.setup_python..c s" g | ] } ˆ | ƒ r | ‘ q S( ( ( u .0u f( u include( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu
Ë s u init.tclu LibN( u pythonu python3( u bin_pathu
python_exeu env_exeu symlink_or_copyu
executableu
python_diru osu nameu pathu islinku chmodu joinu existsu symlinku include_binaryu listdiru isdiru walku basenameu env_diru makedirsu shutilu copyfile( u selfu contextu binpathu exenameu pathu copieru dirnameu suffixu subdiru filesu fu srcu dstu rootu dirsu tcldir( ( u includeu2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu setup_python¬ sJ
"
"
"
u EnvBuilder.setup_pythonc C sG t j j t j j t ƒ ƒ } t j j | d ƒ } | j | | ƒ d S( u×
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.
u scriptsN( u osu pathu abspathu dirnameu __file__u joinu install_scripts( u selfu contextu path( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu
setup_scriptsÛ s u EnvBuilder.setup_scriptsc C s d S( u
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( ( u selfu context( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu
post_setupê s u EnvBuilder.post_setupc C sX | j d | j ƒ } | j d | j ƒ } | j d | j ƒ } | j d | j ƒ } | S( ui
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.
u __VENV_DIR__u
__VENV_NAME__u __VENV_BIN_NAME__u __VENV_PYTHON__( u replaceu env_diru promptu bin_nameu env_exe( u selfu textu context( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu replace_variablesô s
u EnvBuilder.replace_variablesc C s! | j } t | ƒ } xt j | ƒ D]ô\ } } } | | k r† x= | d d … D]+ } | d t j f k rQ | j | ƒ qQ qQ Wq% n x| D]ˆ} t j j | | ƒ }
| | d … j t j ƒ d d … } | sÝ | } n t j j | | Œ } t j j
| ƒ st j | ƒ n t j j | | ƒ }
t |
d ƒ } | j
ƒ } Wd QX|
j d ƒ red } nl d } y% | j d ƒ } | j | | ƒ } Wn> t k
rÐ} z d } t j d |
| ƒ WYd d } ~ Xn X| d k r t |
| ƒ } | j | ƒ Wd QXt j |
|
ƒ q q Wq% Wd S(
us
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.
Nu commoni u rbu .exeu wbu wu utf-8u+ unable to copy script %r, may be binary: %s( u bin_pathu lenu osu walku nameu removeu pathu joinu splitu sepu existsu makedirsu openu readu endswithu decodeu replace_variablesu UnicodeDecodeErroru Noneu loggeru warningu writeu shutilu copymode( u selfu contextu pathu binpathu plenu rootu dirsu filesu du fu srcfileu suffixu dstdiru dstfileu datau modeu e( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu install_scripts sB
& u EnvBuilder.install_scriptsNF( u __name__u
__module__u __qualname__u __doc__u Falseu __init__u createu ensure_directoriesu create_configurationu osu nameu include_binaryu symlink_or_copyu setup_pythonu
setup_scriptsu
post_setupu replace_variablesu install_scripts( u
__locals__( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu
EnvBuilder& s / /
u
EnvBuilderc C s, t d | d | d | ƒ } | j | ƒ d S( u
Create a virtual environment in a directory.
By default, makes the system (global) site-packages dir *un*available to
the created environment, and uses copying rather than symlinking for files
obtained from the source Python installation.
:param env_dir: The target directory to create an environment in.
:param system_site_packages: If True, the system (global) site-packages
dir is available to the environment.
:param clear: If True and the target directory exists, it is deleted.
Otherwise, if the target directory exists, an error is
raised.
:param symlinks: If True, attempt to symlink rather than copy files into
virtual environment.
u system_site_packagesu clearu symlinksN( u
EnvBuilderu create( u env_diru system_site_packagesu clearu symlinksu builder( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu create7 s u createc
C sÈ d$ } t j d% k r d& } n t t d ƒ s6 d& } n | sK t d ƒ ‚ nyd d l } | j d t d d d d ƒ } | j d
d d d
d d d ƒ| j d d d& d d d d d d ƒt
j d k rÑ d& } n d$ } | j d d | d d d d d d ƒ| j d d d& d d d d d d ƒ| j d d d& d d d d d d! ƒ| j | ƒ } | j
rv| j rvt d" ƒ ‚ n t d# | j d | j d | j d | j
ƒ } x | j D] } | j | ƒ qWd S(' Ni u base_prefixu. This script is only for use with Python >= 3.3i u progu descriptionuF Creates virtual Python environments in one or more target directories.u epilogu| Once an environment has been created, you may wish to activate it, e.g. by sourcing an activate script in its bin directory.u dirsu metavaru ENV_DIRu nargsu +u helpu) A directory to create the environment in.u --system-site-packagesu defaultu actionu
store_trueu destu system_siteuD Give the virtual environment access to the system site-packages dir.u ntu
--symlinksu symlinksu[ Try to use symlinks rather than copies, when symlinks are not the default for the platform.u --clearu clearuu Delete the environment directory if it already exists. If not specified and the directory exists, an error is raised.u --upgradeu upgradeul Upgrade the environment directory to use this version of Python, assuming Python has been upgraded in-place.u1 you cannot supply --upgrade and --clear together.u system_site_packagesT( i i F( u Trueu sysu version_infou Falseu hasattru
ValueErroru argparseu ArgumentParseru __name__u add_argumentu osu nameu
parse_argsu upgradeu clearu
EnvBuilderu system_siteu symlinksu dirsu create( u argsu
compatibleu argparseu parseru use_symlinksu optionsu builderu d( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu mainL sD
u mainu __main__i u Error: %su file( u __doc__u loggingu osu shutilu sysu sysconfigu typesu getLoggeru __name__u loggeru
EnvBuilderu Falseu createu Noneu mainu rcu Exceptionu eu printu stderru exit( ( ( u2 /opt/alt/python33/lib64/python3.3/venv/__init__.pyu s& ÿ 8
*