virtualenvwrapper 3.5¶

インストール¶

export WORKON_HOME=$HOME/.virtualenvs
export MSYS_HOME=/c/msys/1.0
source /usr/local/bin/virtualenvwrapper.sh

export WORKON_HOME=$HOME/.virtualenvs
export MSYS_HOME=C:\msys\1.0
source /usr/local/bin/virtualenvwrapper.sh

$ pip install virtualenvwrapper

$ sudo pip install virtualenvwrapper

$ pip install --install-option="--user" virtualenvwrapper

export WORKON_HOME=$HOME/.virtualenvs
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

export PATH=/usr/local/bin:$PATH
source /usr/local/bin/virtualenvwrapper.sh

export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python
export VIRTUALENVWRAPPER_VIRTUALENV=/usr/local/bin/virtualenv
source /usr/local/bin/virtualenvwrapper.sh

export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'

コマンドリファレンス¶

全てのコマンドは次のようにターミナル上で使用されます。

mkvirtualenv [-a project_path] [-i package] [-r requirements_file] [virtualenv options] ENVNAME

$ workon
$ mkvirtualenv mynewenv
New python executable in mynewenv/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(mynewenv)$ workon
mynewenv
(mynewenv)$

mktmpenv [VIRTUALENV_OPTIONS]

$ mktmpenv
Using real prefix '/Library/Frameworks/Python.framework/Versions/2.7'
New python executable in 1e513ac6-616e-4d56-9aa5-9d0a3b305e20/bin/python
Overwriting 1e513ac6-616e-4d56-9aa5-9d0a3b305e20/lib/python2.7/distutils/__init__.py
with new content
Installing distribute...............................................
....................................................................
.................................................................done.
This is a temporary environment. It will be deleted when deactivated.
(1e513ac6-616e-4d56-9aa5-9d0a3b305e20) $

lsvirtualenv [-b] [-l] [-h]

showvirtualenv [env]

rmvirtualenv ENVNAME

(mynewenv)$ deactivate
$ rmvirtualenv mynewenv
$ workon
$

cpvirtualenv ENVNAME TARGETENVNAME

$ workon
$ mkvirtualenv source
New python executable in source/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(source)$ cpvirtualenv source dest
Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/easy_install relative
Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/easy_install-2.6 relative
Making script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/pip relative
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/postactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/postdeactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/preactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
Script /Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/predeactivate cannot be made relative (it's not a normal script that starts with #!/Users/dhellmann/Devel/virtualenvwrapper/tmp/dest/bin/python)
(dest)$ workon
dest
source
(dest)$

workon [environment_name]

$ workon
$ mkvirtualenv env1
  New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ mkvirtualenv env2
New python executable in env2/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env2)$ workon
env1
env2
(env2)$ workon env1
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ workon env2
(env2)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env2
(env2)$

deactivate

$ workon
$ echo $VIRTUAL_ENV

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ deactivate
$ echo $VIRTUAL_ENV

$

cdvirtualenv [subdir]

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ cdvirtualenv
(env1)$ pwd
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ cdvirtualenv bin
(env1)$ pwd
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1/bin

cdsitepackages [subdir]

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ echo $VIRTUAL_ENV
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1
(env1)$ cdsitepackages PyMOTW/bisect/
(env1)$ pwd
/Users/dhellmann/Devel/virtualenvwrapper/tmp/env1/lib/python2.6/site-packages/PyMOTW/bisect

lssitepackages

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ $ workon env1
(env1)$ lssitepackages
distribute-0.6.10-py2.6.egg     pip-0.6.3-py2.6.egg
easy-install.pth                setuptools.pth

add2virtualenv directory1 directory2 ...

toggleglobalsitepackages [-q]

$ mkvirtualenv env1
New python executable in env1/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
(env1)$ toggleglobalsitepackages
Disabled global site-packages
(env1)$ toggleglobalsitepackages
Enabled global site-packages
(env1)$ toggleglobalsitepackages -q
(env1)$

mkproject [-t template] [virtualenv_options] ENVNAME

$ mkproject myproj
New python executable in myproj/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
Creating /Users/dhellmann/Devel/myproj
(myproj)$ pwd
/Users/dhellmann/Devel/myproj
(myproj)$ echo $VIRTUAL_ENV
/Users/dhellmann/Envs/myproj
(myproj)$

setvirtualenvproject [virtualenv_path project_path]

$ mkproject myproj
New python executable in myproj/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
Creating /Users/dhellmann/Devel/myproj
(myproj)$ mkvirtualenv myproj_new_libs
New python executable in myproj/bin/python
Installing distribute.............................................
..................................................................
..................................................................
done.
Creating /Users/dhellmann/Devel/myproj
(myproj_new_libs)$ setvirtualenvproject $VIRTUAL_ENV $(pwd)

cdproject

virtualenvwrapper をカスタマイズする¶

virtualenvwrapper は仮想環境を作成・削除したり、環境間を移動したりするときに、設定内容、シェル環境またはその他の設定値を変更できる複数のフックポイントを追加します。そういったフック機能は2つの方法で提供されています。

PS1="(`basename \"$VIRTUAL_ENV\"`) $_OLD_VIRTUAL_PS1"

pymotw_root=/Users/dhellmann/Documents/PyMOTW
cd $pymotw_root
PATH=$pymotw_root/bin:$PATH

"""virtualenvwrapper module
"""

__import__('pkg_resources').declare_namespace(__name__)

def function_name(args):
    # args is a list of strings passed to the hook loader

def initialize(args):
    for filename, comment in GLOBAL_HOOKS:
        make_hook(os.path.join('$WORKON_HOME', filename), comment)
    return

def initialize_source(args):
    return """
#
# Run user-provided scripts
#
[ -f "$WORKON_HOME/initialize" ] && source "$WORKON_HOME/initialize"
"""

# Bootstrap installation of Distribute
import distribute_setup
distribute_setup.use_setuptools()

from setuptools import setup

setup(
    name = 'virtualenvwrapper',
    version = '2.0',

    description = 'Enhancements to virtualenv',

    # ... details omitted ...

    namespace_packages = [ 'virtualenvwrapper' ],

    entry_points = {
        'virtualenvwrapper.initialize': [
            'user_scripts = virtualenvwrapper.user_scripts:initialize',
            ],
        'virtualenvwrapper.initialize_source': [
            'user_scripts = virtualenvwrapper.user_scripts:initialize_source',
            ],

        # ... details omitted ...
        },
    )

$ python -m virtualenvwrapper.hook_loader -h
Usage: virtualenvwrapper.hook_loader [options] <hook> [<arguments>]

Manage hooks for virtualenvwrapper

Options:
  -h, --help            show this help message and exit
  -s, --source          Print the shell commands to be run in the current
                        shell
  -l, --list            Print a list of the plugins available for the given
                        hook
  -v, --verbose         Show more information on the console
  -q, --quiet           Show less information on the console
  -n NAMES, --name=NAMES
                        Only run the hook from the named plugin

$ python -m virtualenvwrapper.hook_loader -v initialize

$ python -m virtualenvwrapper.hook_loader --source initialize

$ virtualenvwrapper_run_hook initialize

import logging
log = logging.getLogger(__name__)

def pre_mkvirtualenv(args):
    log.debug('pre_mkvirtualenv %s', str(args))
    # ...

virtualenvwrapper_run_hook project.pre_mkproject $project_name

virtualenvwrapper_run_hook project.post_mkproject

プロジェクト管理¶

project directory は virtualenv に関連付けられますが、開発を支援するために必要とされるコンポーネントをインストールするというより、普通は活発に開発中のソースコードを含みます。例えば、プロジェクトディレクトリは、バージョン管理システムからチェックアウトされたソースコード、まだバージョン管理システムにコミットされていないテストや実験的なファイルから作成された一時的なファイルを含むかもしれません。

プロジェクトディレクトリが作成して、 mkvirtualenv の代わりに mkproject を実行するときに virtualenv を束縛します。既存のプロジェクトディレクトリを virtualenv に束縛するには setvirtualenvproject を使ってください。

$ mkproject -t bitbucket -t django my_site

Tips とトリック¶

これは virtualenv と virtualenvwrapper をさらに使い易くするためにユーザが教えてくれた tips です。あなたが共有したい tip を持っているなら、私にメールを送ってもらうか、 このブログ にコメントをください。私はこのページにその tip を追加します。

PS1="$_OLD_VIRTUAL_PS1"
_OLD_RPROMPT="$RPROMPT"
RPROMPT="%{${fg_bold[white]}%}(env: %{${fg[green]}%}`basename \"$VIRTUAL_ENV\"`%{${fg_bold[white]}%})%{${reset_color}%} $RPROMPT"

RPROMPT="$_OLD_RPROMPT"

export PIP_VIRTUALENV_BASE=$WORKON_HOME

export PIP_RESPECT_VIRTUALENV=true

proj_name=$(echo $VIRTUAL_ENV|awk -F'/' '{print $NF}')
mkdir $HOME/projects/$proj_name
add2virtualenv $HOME/projects/$proj_name
cd $HOME/projects/$proj_name

proj_name=$(echo $VIRTUAL_ENV|awk -F'/' '{print $NF}')
cd ~/projects/$proj_name

$ cat postmkvirtualenv
#!/usr/bin/env bash
curl -O http://python-distribute.org/distribute_setup.p... />python distribute_setup.py
rm distribute_setup.py
easy_install pip==dev
pip install Mercurial

$ cat developer_requirements.txt
ipdb
ipython
pastescript
nose
http://douglatornell.ca/software/python/Nosy-1.0.tar.gz
coverage
sphinx
grin
pyflakes
pep8

cd () {
    if (( $# == 0 ))
    then
        builtin cd $VIRTUAL_ENV
    else
        builtin cd "$@"
    fi
}

cd

開発者向け¶

あなたが直接 virtualenvwrapper に貢献したいなら、次の説明が役に立つでしょう。パッチ、バグレポートや機能要求は BitBucket サイト で歓んで受け付けます。パッチや pull リクエストによる貢献はその修正を取り込んだり、優先度の配慮も行い易いでしょう。

$ make html
rm -rf virtualenvwrapper/docs
(cd docs && make html SPHINXOPTS="-c sphinx/pkg")
sphinx-build -b html -d build/doctrees  -c sphinx/pkg source build/html
Running Sphinx v0.6.4
loading pickled environment... done
building [html]: targets for 2 source files that are out of date
updating environment: 0 added, 2 changed, 0 removed
reading sources... [ 50%] command_ref
reading sources... [100%] developers

looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 33%] command_ref
writing output... [ 66%] developers
writing output... [100%] index

writing additional files... search
copying static files... WARNING: static directory '/Users/dhellmann/Devel/virtualenvwrapper/plugins/docs/sphinx/pkg/static' does not exist
done
dumping search index... done
dumping object inventory... done
build succeeded, 1 warning.

Build finished. The HTML pages are in build/html.
cp -r docs/build/html virtualenvwrapper/docs

$ tox tests/test_cd.sh

$ tox -e py27

$ tox -e py27 tests/test_cd.sh

既存の拡張機能¶

次に virtualenvwrapper で利用できる拡張機能を紹介します。

リリース履歴¶

dev

• Clean up file permissions and remove shebangs from scripts not intended to be executed on the command line. (contributed by ralphbean)
• Worked on some brittle tests.

3.2

• Make project_dir a local variable so that cdproject does not interfere with other variables the user might have set. (contributed by slackorama)
• Fix typo in documentation reported by Nick Martin.
• Change trove classifier for license “MIT” to reflect the license text presented in the documentation. This does not indicate a change in the license, just a correction to the expression of that intent. See :ref:`license` (contributed by ralphbean as fix for issue 134)
• Extend rmvirtualenv to allow removing more than one environment at a time. (contributed by ciberglo)
• Change the definition of virtualenvwrapper_get_site_packages_dir to ask distutils for the site-packages directory instead of trying to build the path ourselves in the shell script. This should resolve issue 112 and improve support for Python interpreters other than C Python. Thanks to Carl Meyer and Dario Bertini for their contributions toward the fix.

3.1

• Fix a problem with activation hooks when associating a new virtualenv with an existing project directory. (issue 122)
• Fix a problem with command-add2virtualenv and paths containing “special” characters such as &. (issue 132)

3.0.1

• Fix some packaging issues that made it more difficult to run the tests directly from the sdist package. (issue 126)

3.0

• Add Python 3 support, thanks in large part to the efforts of Daniel Kraus (dakra). Tested under Python 2.6, 2.7, and 3.2.

2.11.1

• Remove the initialization shortcut because it breaks tab completion in sub-shell environments like screen and tmux. (issue 121)

2.11

• Add -a option to mkvirtualenv to associate a new virtualenv with an existing project directory. Contributed by Mike Fogel (mfogel).
• Drops support for Python 2.4 and 2.5. The tools may still work, but I no longer have a development environment set up for testing them, so I do not officially support them.
• Shortcut initialization if it has run before.
• Set hook log file permissions to be group-writable. (issue 62 reported by hedgeddown)
• Add VIRTUALENVWRAPPER_PROJECT_FILENAME variable so the .project file used to link a virtualenv to a project can be renamed to avoid conflicts with other tools. (issue 120 reported by arthuralvim)

2.10.1

• Changed arguments to mktmpenv so it always creates an environment name for you. (issue 114 reported by alex_gaynor)

2.10

• Incorporated patch to add -d option to command-add2virtualenv, contributed by miracle2k.
• Add -i option to mkvirtualenv.
• Add mktmpenv command for creating temporary environments that are automatically removed when they are deactivated.
• Fixed a problem with hook_loader that prevented it from working under Python 2.5 and 2.4.
• Fix a problem with the way template names were processed under zsh. (issue 111)

2.9

• Change the shell function shell definition syntax so that ksh will treat typeset-declared variables as local. No kidding.
• Merge the “project directory” features of the virtualenvwrapper.project plugin into the main project, adding mkproject, cdproject, and setvirtualenvproject commands.
• Add -r option to mkvirtualenv to install dependencies using a pip requirements file.

2.8

• Use VIRTUALENVWRAPPER_VIRTUALENV in cpvirtualenv (issue 104).
• Add support for MSYS environment under Windows. Contributed by Axel H. (noirbizarre).

2.7.2

• Move setup code for tab completion later in the startup code so all of the needed variables are configured. (issue 97)
• Expand tab completion for zsh to work for all commands.

2.7.1

• When testing for WORKON_HOME during startup, dereference any symlink to make sure it is a directory.
• Set VIRTUALENVWRAPPER_HOOK_DIR and VIRTUALENV_WRAPPER_LOG DIR in virtualenvwrapper_initialize after WORKON_HOME is set (issue 94).
• Update the 基本的なインストール instructions to be more explicit about needing to install virtualenvwrapper globally (or at least outside of a virtualenv).

2.7

• Fix problem with space in WORKON_HOME path (issue 79).
• Fix problem with argument processing in lsvirtualenv under zsh (issue 86). Thanks to Nat Williams (natw) for the bug report and patch.
• If WORKON_HOME does not exist, create it. Patch from Carl Karsten (CarlFK). Test updates based on patches from Matt Austin (maafy6) and Hugo Lopes Tavares (hltbra).
• Merge in contributions from Paul McLanahan (pmclanahan) to fix the test harness to ensure that the test scripts are actually running under the expected shell.
• Merge in new shell command toggleglobalsitepackages from Paul McLanahan (pmclanahan). The new command changes the configuration of the active virtualenv to enable or disable the global site-packages directory.
• Fixed some tests that were failing under ksh on Ubuntu 10.10.
• Document the VIRTUALENVWRAPPER_VIRTUALENV variable.
• Implement suggestion by Van Lindberg to have VIRTUALENVWRAPPER_HOOK_DIR and VIRTUALENVWRAPPER_LOG_DIR variables to control the locations of hooks and logs.
• Enabled tab completion for showvirtualenv (issue 78).
• Fixed a problem with running rmvirtualenv from within the environment being removed (issue 83).
• Removed use of -e option in calls to grep for better portability (issue 85).

2.6.3

• http://readthedocs.org でドキュメントを生成するために setup.py や conf.py スクリプトのバージョン情報をハードコードしました。

2.6.2

• http://readthedocs.org でドキュメントを生成してみました。
• Tetsuya Morimoto からの 日本語の翻訳ドキュメント を取り込みました。
• 環境変数 (VIRTUALENVWRAPPER_VIRTUALENV) で virtualenv バイナリをユーザが指定できるように Ales Zoulek からの提案を取り入れました。

2.6.1

• virtualenvwrapper_get_python_version を修正しました(issue 73)。

2.6

• Cygwin 環境でフックスクリプトの改行の問題を修正しました(issue 68)。
• 互換シェルのリスト(サポートシェル) と Python バージョン(Python バージョン)を含むようにドキュメントを更新しました(issue 70)。
• virtualenv のインストールの依存関係を修正しました(issue 60)。
• Python 2.4 で動作するように Python バージョンを決定するメソッドを修正しました(issue 61)。
• Makefile の自作スクリプトの代わりに tox を使用するためにテストインフラを変換しました。

2.5.3

• doughellmann.com の休止期間中に PyPI へアップロードしたポイントリリースです。

2.5.2

• zsh 環境の lsvirtualenv を修正する Zach Voase からのパッチを適用しました。 issue 64 を解決しました。

2.5.1

• 数無しで実行したときに command-workon に完全な環境詳細ではなく簡潔な詳細を表示するようにしました。

2.5

• showvirtualenv コマンドを追加しました。デフォルトで冗長な出力を行うように lsvirtualenv を変更しました。

2.4

• command-workon が引数無しで実行されるときに get_env_details フックを実行するために -l オプションを持つ lsvirtualenv コマンドを追加しました。

2.3

• get_env_details フックを追加しました。

2.2.2

• エイリアスを避けてシェルコマンドをさらにエスケープ処理する Fred Palmer のパッチを取り込みました。 issue 57 を解決しました。
• egrep 引数のエスケープ処理の問題を修正しました(issue 55)。
• 引数無しで mkvirtualenv を実行するときの問題を修正しました(issue 56)。

2.2.1

• which 呼び出しがエイリアスを避けるようにエスケープしました。 issue 46 を解決しました。
• grep を呼び出す前に GREP_OPTIONS をアンセットする Manuel Kaufmann のパッチを取り込みました。 issue 51 を解決しました。
• issue 53 を解決する正規表現の $ をエスケープしました。
• rm のエイリアスに関する問題をエスケープして issue 50 を解決しました。

2.2

• issue 43 を解決するために Python 2.4 で動作する形でフックローダの実行を切り替えました。
• Python 2.7b1 でテストしました。 issue 44 を参照してください。
• David Wolever からのパフォーマンス改善を取り込みました。 issue 38 を参照してください。
• issue 35 のためにデバッグ命令を追加しました。

2.1.1

• Manuel Kaufmann の http://bitbucket.org/humitos/virtualenvwrapper-es-translation/ から スペイン語の翻訳ドキュメント を追加しました。
• ラッパーがインストールされる場所ではなく $PATH から Python の不適切な利用を修正しました。 issue 41 を参照してください。
• zsh で仮想環境を非アクティブ化したときの誤ったエラー/ワーニングメッセージをなだめました。 issue 42 を参照してください。

2.1

• ksh サポートを追加しました。変更する箇所を調査してくれた Doug Latornell に感謝します。
• 起動時に virtualenvwrapper.hook_loader のインポートテストをして、ユーザへ修正方法を理解するのに役立つようにエラーを報告します(issue 33)。
• 新しい仮想環境が作成された後ですぐにアクティブ化することについて mkvirtualenv ドキュメントを更新しました(issue 30)。
• cpvirtualenv に関連するフックを追加しました。
• 特に ksh 環境で、非アクティブ化をより堅牢にしました。
• 安全で移植性の高い一時ファイル名を作成するために Python の tempfile モジュールを使用しました。
• 仮想環境がまだ1つも作成されていないときに仮想環境の名前として * を表示することで発生する virtualenvwrapper_show_workon_options の問題を修正しました。
• 名前付きフックのみを実行できるようにフックローダを変更しました。
• virtualenvwrapper.project の mkproject のようにコマンドのヘルプ出力を使用して利用可能なフックの取得サポートを追加しました。
• mkvirtualenv の -h オプションの振る舞いを修正しました。
• $WORKON_HOME/hook.log ファイルを 10KiB でローテートするように logging を変更しました。

2.0.2

• virtualenvwrapper.user_scripts が Python 2.5 互換になるように issue 32 を修正しました。

2.0.1

• TMPDIR がユーザのシェル環境でセットされていないときにデフォルト値を使用するように issue 29 を修正しました。

2.0

• 拡張機能を共有し易くするために Distribute エントリポイントを使用してフック管理を書き直しました。

1.27

• Added cpvirtualenv command [Thomas Desvenain]

1.26

• Fix a problem with error messages showing up during init for users with the wrappers installed site-wide but who are not actually using them. See issue 26.
• Split up the tests into multiple files.
• Run all tests with all supported shells.

1.25

• Merged in changes to cdsitepackages from William McVey. It now takes an argument and supports tab-completion for directories within site-packages.

1.24.2

• Add user provided Tips とトリック section.
• Add link to Rich Leland’s screencast to references section.

1.24.1

• Add license text to the header of the script.

1.24

• Resolve a bug with the preactivate hook not being run properly. Refer to issue 21 for complete details.

1.23

• Resolve a bug with the postmkvirtualenv hook not being run properly. Refer to issue 19 and issue 20 for complete details.

1.22

• Automatically create any missing hook scripts as stubs with comments to expose the feature in case users are not aware of it.

1.21

• Better protection of $WORKON_HOME does not exist when the wrapper script is sourced.

1.20

• Incorporate lssitepackages feature from Sander Smits.
• Refactor some of the functions that were using copy-and-paste code to build path names.
• Add a few tests.

1.19

• Fix problem with add2virtualenv and relative paths. Thanks to Doug Latornell for the bug report James Bennett for the suggested fix.

1.18.1

• Incorporate patch from Sascha Brossmann to fix a issue 15. Directory normalization was causing WORKON_HOME to appear to be a missing directory if there were control characters in the output of pwd.

1.18

• Remove warning during installation if sphinxcontrib.paverutils is not installed. (issue 10)
• Added some basic developer information to the documentation.
• Added documentation for deactivate command.

1.17

• Added documentation updates provided by Steve Steiner.

1.16

• Merged in changes to cdvirtualenv from wam and added tests and docs.
• Merged in changes to make error messages go to stderr, also provided by wam.

1.15

• Better error handling in mkvirtualenv.
• Remove bogus VIRTUALENV_WRAPPER_BIN variable.

1.14

• Wrap the virtualenv version of deactivate() with one that lets us invoke the predeactivate hooks.
• Fix virtualenvwrapper_show_workon_options for colorized versions of ls and write myself a note so I don’t break it again later.
• Convert test.sh to use true tests with shunit2

1.13

• Fix issue 5 by correctly handling symlinks and limiting the list of envs to things that look like they can be activated.

1.12

• Check return value of virtualenvwrapper_verify_workon_home everywhere, thanks to Jeff Forcier for pointing out the errors.
• Fix instructions at top of README, pointed out by Matthew Scott.
• Add cdvirtualenv and cdsitepackages, contributed by James Bennett.
• Enhance test.sh.

1.11

• Optimize virtualenvwrapper_show_workon_options.
• Add global postactivate hook.

1.10

• Pull in fix for colorized ls from Jeff Forcier (changeset b42a25f7b74a).

1.9

• Add more hooks for operations to run before and after creating or deleting environments based on changes from Chris Hasenpflug.

1.8.1

• Corrected a problem with change to mkvirtualenv that lead to release 1.8 by using an alternate fix proposed by James in comments on release 1.4.

1.8

• Fix for processing the argument list in mkvirtualenv from jorgevargas (issue 1)

1.7

• Move to bitbucket.org for hosting
• clean up TODO list and svn keywords
• add license section below

1.6.1

• More zsh support (fixes to rmvirtualenv) from Byron Clark.

1.6

• Add completion support for zsh, courtesy of Ted Leung.

1.5

• Fix some issues with spaces in directory or env names. They still don’t really work with virtualenv, though.
• Added documentation for the postactivate and predeactivate scripts.

1.4

• Includes a new .pth management function based on work contributed by James Bennett and Jannis Leidel.

1.3.x

• Includes a fix for a nasty bug in rmvirtualenv identified by John Shimek.