用于生成自定义virtualenv引导脚本的pyutilib实用程序。
pyutilib.virtualenv的Python项目详细描述
开始
概述
vpy_create脚本将python模块集成到virtualenv中 引导脚本。用户在此模块中定义 configure() 函数 控制 virtualenv 安装的配置。例如, 下面的函数声明默认的安装目录,并且 虚拟python存储库包含 virtualenv 和 nose python包:
def configure(installer): installer.default_dirname = 'venv' installer.add_repository('virtualenv', pypi='virtualenv') installer.add_repository('nose', pypi='nose') installer.add_repository( 'pyutilib.subprocess', root='https://software.sandia.gov/svn/public/pyutilib.subprocess', dev=True) return installer
add_repository 方法可以使用 pypi指定一个pypi包 选择权。或者,可以指定subversion存储库的根目录 使用 根 选项。如果指定了 dev 选项,则 存储库已签出并安装在 <;root>;/src 目录中。 此外,此软件包以 开发模式安装。
通过调用 vpy_create 并指定python模块和脚本 姓名::
vpy_create venv.py venv_install
引导脚本"venv_install"创建虚拟python 在指定目录中安装, venv :
< Buff行情> Venv_安装用户还可以指定安装目录:
venv_install venvdir
默认情况下,引导脚本安装最新的软件版本。 在pypi中,这是最新的修订版。在Subversion中,这是最新的 在 标记 或 发布 目录中进行修订。的主干分支 Subversion存储库也可以使用 –trunk 选项安装:
venv_install --trunk venv
类似地,引导脚本识别稳定的分支,这些分支可以 使用"稳定"选项安装。注意,如果稳定的分支是 不可用,则安装最新版本。
互联网连接
默认情况下,引导脚本使用Internet连接下载 已安装的python包。注意,可能需要代理服务器 使引导脚本正常工作。用户可以定义 http_proxy环境变量,用于指定代理服务器的名称。 或者,可以指定 –proxy 选项。
引导脚本还提供了一种机制,用于启用脱机virtualenv 装置。这需要两个阶段的过程。首先, –preinstall 选项用于创建包含python的zip文件 包装。例如,命令:
venv_install --preinstall
创建一个 venv 目录,其中包含文件 venv/venv.zip 。 必须在具有Internet的计算机上执行预安装步骤 连接性。但是,此zip文件可用于执行脱机 使用脱机选项安装。例如,下面 命令将使用 venv.zip文件执行脱机安装 在 temp 目录中:
venv_install --offline --zip=venv.zip test
请注意,此技术还可以脱机安装 setuptools 包。 因此,由vpy创建的引导脚本 支持virtualenv环境的纯脱机设置,这是不受支持的 通过 virtualenv 引导过程。
可配置的安装程序
pyutilib.virtualenv提供的vpy_安装脚本是一个 virtualenv 可以用ini文件配置的引导脚本。例如, 考虑一下INI文件:
; ; This INI file can be used by vpy_install to create a virtual ; Python installation. ; [installer] description=This is an example. README="# # This is a README file created by the bootstrap script. #" [nose] pypi=nose [pyutilib.subprocess] root=https://software.sandia.gov/svn/public/pyutilib/pyutilib.subprocess dev=True
vpy_install的默认安装目录是python。 此ini文件将安装 nose 和 pyutilib.subprocess 包和 pyutilib.subprocess 包将安装在 python/src/pyutilib.subprocess 作为可编辑的开发包。
请注意,vpy_安装不需要用户安装 设置工具 。只有当 –指定了"预安装"选项。因此,默认行为 vpy_install(和其他引导脚本)不需要 安装任何第三方软件包。vpy_安装脚本 可以独立于pyutilib.virtualenv进行分布,并且可以 通常用作独立脚本。
vpy_安装脚本支持一个"更新"选项,该选项允许 用户更新虚拟python安装。此选项执行以下操作 更新:
- PYPI软件包已升级
- 更新并重新安装Subversion软件包
注意,此选项不搜索更新版本的subversion 包裹。这个限制反映了subversion包的方式 在虚拟python安装中签出,该安装可能会被修改 在未来。