virtualenv-mgr 1.0.4

# virtualenv-mgr

[virtualenv-mgr](https://github.com/arteria/virtualenv-mgr) 是一个用于同时管理多个 [virtualenv](http://www.virtualenv.org/) 的工具。

使用包含多个 virtualenv 根路径的文件，在同一时间对它们进行操作。

## 特性

* 一次性安装、卸载或升级所有虚拟环境中的特定包。
* 打印所有环境中包使用的统计信息，包括直方图。
* 查找/列出虚拟环境以进行进一步处理，例如作为 virtualenv-mgr 的输入。
* 查找安装了特定包的所有环境

## 目录

* [安装](#安装)
* [使用方法](#使用方法)
* [使用 -z/--envfreeze 查找环境](#使用--z--envfreeze查找环境)
* [定义环境](#定义环境)
* [操作](#操作)
* [pip选项](#pip选项)
* [差异](#env-diff)
* [pip-histo](#pip-histo)
* [帮助](#帮助)
* [支持的平台](#支持的平台)


## 安装

pip install virtualenv-mgr


## 使用方法

### 使用 -z/--envfreeze 查找环境

查找当前位置/子字典中的所有 virtualenvs（查找 '/bin/activate' 模式）

virtualenv-mgr --envfreeze
virtualenv-mgr -z

定义搜索根目录，脚本应在此目录中搜索

virtualenv-mgr --envfreeze --searchroot /Users/name/workspace/2014
virtualenv-mgr -zs /Users/name/workspace/2014

将路径保存到文件中，您可以稍后使用。

virtualenv-mgr -zs /Users/name/workspace/2014 > example-env-file.txt

### 定义环境

从列表中获取环境

virtualenv-mgr example-env-file.txt

或通过管道输入

virtualenv-mgr --envfreeze | virtualenv-mgr

没有参数 --> 激活虚拟环境

virtualenv-mgr

### 操作

安装包/多个包

virtualenv-mgr example-env-file.txt -i "django==1.4.16,djangotransmeta"

卸载包/多个包

virtualenv-mgr example-env-file.txt -u "django==1.4.16"

查找包/多个包（可以查找精确的包 '==' 或包是否已安装）

virtualenv-mgr example-env-file.txt -f "django==1.4.6"

在已安装了某些其他包的环境中安装或卸载包。

virtualenv-mgr example-env-file.txt -f "django==1.4.12" -i "django==1.4.16" -u "django-transmeta"

所有已安装 django==1.4.12 的虚拟环境都将安装 django==1.4.16 并卸载 django-transmeta。

#### Pip 选项

pipoption 允许您向 pip 命令（安装/卸载）添加选项，使用逗号分隔多个命令

virtualenv-mgr example-env-file.txt -i django==1.4.18 -o='--index-url=http://pypi.example.com/pypi,--extra-index-url=http://pypi.python.org/simple'


### Env Diff

您可以使用 -d, --diff 选项打印显示多个虚拟环境中已安装的包差异的表格

virtualenv-mgr compare-envs.txt -d

过滤器：所有虚拟环境中未安装的应用 (-n, --notinstalled, -dn)

virtualenv-mgr compare-envs.txt -n

过滤器：所有虚拟环境中版本不同的应用 (-a, -versiondiff, -da)

virtualenv-mgr compare-envs.txt -a

组合 (-an, -dna)

virtualenv-mgr compare-envs.txt -na

忽略 eggs


### Pip Histo

打印 pip histo（所有已安装包的概览）(-p,--piphisto)

virtualenv-mgr example-env-file.txt -p

区分不同版本 (-v,-version ; -pv)

virtualenv-mgr example-env-file.txt -v

将 eggs 包含在 histo 中 (-e,-egg ; -pe)

virtualenv-mgr example-env-file.txt -e

组合 (-ve, -pve)

virtualenv-mgr example-env-file.txt -ve


## 帮助

Envfreeze
* `-z, --envfreeze` 在 . 打印所有环境
* `-s SEARCHROOT, --searchroot SEARCHROOT` envfreeze 的路径，用于搜索

操作
* `-f FIND, --find FIND` 查找应用，使用逗号搜索更多
* `-i INSTALL, --install INSTALL` 安装应用，使用逗号添加更多
* `-u UNINSTALL, --uninstall UNINSTALL` 卸载应用，使用逗号添加更多

Pip 选项
* `-o, --pipoption` 允许您向 pip 命令（-i/--install 和 -u/--uninstall）添加选项

Env Diff
* `-d, --diff` 比较环境中安装的包
* `-n, --notinstalled` 列出所有虚拟环境中未安装的应用
* `-a, --versiondiff` 列出所有虚拟环境中版本不同的应用

Pip Histo
* `-p, --piphisto` pip 直方图
* `-e, --egg ` pip 直方图考虑 eggs
* `-v, --version` pip 直方图考虑版本


## 支持的平台

* OS X
* Linux/UNIX

Windows 支持尚未测试。请随时贡献。