orb 0.9.4

pip/virtualenv shell script wrapper

description

A shell script facade for creating virtual python environments via virtualenv and installing packages within the environment via pip.

install

virtualenv must be available, eg. in Ubuntu:

$ sudo apt-get install python-virtualenv

pip need not be available - it is installed every time to a new environment.

To install, use easy_install to install from pypi.python.org:

easy_install -Z orb

or simply copy the orb script from the source distribution, eg.

$ sudo cp orb /usr/local/bin

usage

Create a virtualenv with the command

$ orb init myenv

or

$ orb init2 myenv

to use the latest Python2 as the executable, or

$ orb init3 myenv

to use the latest Python3 as the executable, or

$ orb init?.? myenv

(eg. orb init2.6 or orb init3.2) to specify a particular Python version as the executable.

This creates a virtualenv called 'myenv' and creates an empty '.orb' file within the virtualenv directory. Subsequent orb commands first search for the '.orb' file and from this file's location the virtualenv's bin directory is known.

To install packages to the env, run the 'orb install' command from within the env directory:

cd myenv
orb install Pygments
orb install BeautifulSoup

which calls 'pip' to do the actual downloading and installation.

If passed a python script, orb will call it using the virtualenv's python

eg. orb setup.py install

and if passed any command expression, orb will temporarily alter the environment (ie. pip's source activate step) before eval-ing the command:

eg. (Django): orb django-admin.py startproject myproj
eg. (Python prompt): orb python
eg. (Sphinx quickstart): orb sphinx-quickstart
eg. (Sphinx build): orb make html
eg. (Arbitrary command) orb ./myshellscript

Other options:

orb ls - list contents of env's site-packages directory orb link - symlink from the virtual env's site-packages to a system package orb download PACKAGE [DEST]

• just download package, don't install