https://github.com/arteria/virtualenv-mgr
virtualenv-mgr is a tool to manage multiple virtualenvs at once.
https://github.com/arteria/virtualenv-mgr
Last synced: about 2 months ago
JSON representation
virtualenv-mgr is a tool to manage multiple virtualenvs at once.
- Host: GitHub
- URL: https://github.com/arteria/virtualenv-mgr
- Owner: arteria
- License: bsd-3-clause
- Created: 2014-11-11T14:28:53.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-08-22T22:18:52.000Z (almost 8 years ago)
- Last Synced: 2025-03-24T17:52:29.206Z (3 months ago)
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 30
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# virtualenv-mgr
[virtualenv-mgr](https://github.com/arteria/virtualenv-mgr) is a tool to manage multiple [virtualenv](http://www.virtualenv.org/)s at once.
Use a file with paths to the root of multiple virtualenvs to perform operations in all of them at the same time.
## Features
* Install, uninstall or upgrade specific packages in all virtualenvs at once.
* Print statistic, a histogram, about the usage of packages over all environments.
* Find/list virtualenvs for further processing, eg. as input for virtualenv-mgr
* Find all envs having a package installed
## Table of contents
* [Installation](#installation)
* [Usage](#usage)
* [Find environments](#find-environments-with--z--envfreeze)
* [Define environments](#define-environments)
* [Actions](#actions)
* [pip-options](#pip-option)
* [Diff](#env-diff)
* [pip-histo](#pip-histo)
* [Help](#help)
* [supported-platforms](#supported-platforms)
## Installation
pip install virtualenv-mgr
## Usage
### Find environments with -z/--envfreeze
Find all virtualenvs ar your current location / subdictionarys (look for the '/bin/activate' pattern)
virtualenv-mgr --envfreeze
virtualenv-mgr -z
Define a searchroot, where the scrip should search in:
virtualenv-mgr --envfreeze --searchroot /Users/name/workspace/2014
virtualenv-mgr -zs /Users/name/workspace/2014
Save the paths to a file which you can use later.
virtualenv-mgr -zs /Users/name/workspace/2014 > example-env-file.txt
### Define Environments
Environments from a list:
virtualenv-mgr example-env-file.txt
Or input over a pipe:
virtualenv-mgr --envfreeze | virtualenv-mgr
Manualy define environments, use "," to seperate the paths (-m, --multiple)
virtualenv-mgr -m=/absolute/path,relative/path/,../../env
No arguments --> active virtualenv
virtualenv-mgr
### Actions
Install a package / multiple packages
virtualenv-mgr example-env-file.txt -i "django==1.4.16,djangotransmeta"
Uninstall a package / multiple packages
virtualenv-mgr example-env-file.txt -u "django==1.4.16"
Find packages / multiple packages (can look for exact packages '==' or if the package is installed)
virtualenv-mgr example-env-file.txt -f "django==1.4.6"
Install or Uninstall packages in envs where certain other packages are installed.
virtualenv-mgr example-env-file.txt -f "django==1.4.12" -i "django==1.4.16" -u "django-transmeta"
All virtual-environments which have installed django==1.4.12 will install django==1.4.16 and uninstall django-transmeta.
#### Pip Option
pipoption allows you to add options to the pip commands ( install / uninstall ) , use the ',' to separate multiple commands
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
You can print table that displays the differences of the installed packages in multiple virtualenvs (-d, --diff)
virtualenv-mgr compare-envs.txt -d
Filter: Apps that are not installed on all virtualenvs (-n, --notinstalled, -dn)
virtualenv-mgr compare-envs.txt -n
Filter: Apps that dont have the same version in all virtualenvs (-a, -versiondiff, -da)
virtualenv-mgr compare-envs.txt -a
Combine (-an , -dna)
virtualenv-mgr compare-envs.txt -na
*Neglects eggs*
### Pip Histo
print the pip histo (overview over all installed packages) (-p,--piphisto)
virtualenv-mgr example-env-file.txt -p
Distinguishes between different versions (-v,-version ; -pv)
virtualenv-mgr example-env-file.txt -v
Take eggs into the histo (-e,-egg ; -pe)
virtualenv-mgr example-env-file.txt -e
Combine (-ve, -pve)
virtualenv-mgr example-env-file.txt -ve
## Help
Envfreeze:
* `-z, --envfreeze` prints all the envs on .
* `-s SEARCHROOT, --searchroot SEARCHROOT` path for envfreeze, where to search
* `-m MULTIPLE, --multiple MULTIPLE` Add paths to envs, sepereate with ","
Actions
* `-f FIND, --find FIND` find app, use commas to search for more
* `-i INSTALL, --install INSTALL` installes an app, use commas to add more
* `-u UNINSTALL, --uninstall UNINSTALL` uninstalles an app, use commas to add more
Pip Option
* `-o, --pipoption` allows you to add options to the pip command(-i/--install and -u/--uninstall)
Env Diff
* `-d, --diff` commpares the packages installed in envs
* `-n, --notinstalled` lists apps that are not installed on all envs
* `-a, --versiondiff` lists apps that dont have the same version number on all envs
Pip Histo
* `-p, --piphisto` pip histogram
* `-e, --egg ` pip histogram takes eggs into consideration
* `-v, --version` pip histogram takes versions into consideration
## Supported platforms
* OS X
* Linux/UNIX
Windows support was not tested yet. Please feel free to contribute.
| virtualenv-mgr is free software. If you find it useful and would like to give back, please consider to make a donation using [Bitcoin](https://blockchain.info/payment_request?address=1AJkbQdcNkrHzxi91mB1kkPxh4t4BJ4hu4) or [PayPal](https://www.paypal.me/arteriagmbh). Thank you! |
| ----- |