..
    ===============
    Release History
    ===============

============
リリース履歴
============

dev

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

3.2

  - Make ``project_dir`` a local variable so that
    :ref:`command-cdproject` does not interfere with other variables
    the user might have set. (contributed by :bbuser:`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 :bbuser:`ralphbean` as
    fix for :bbissue:`134`)
  - Extend :ref:`command-rmvirtualenv` to allow removing more than one
    environment at a time. (contributed by :bbuser:`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
    :bbissue:`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. (:bbissue:`122`)
  - Fix a problem with :ref:`command-add2virtualenv` and paths
    containing "special" characters such as ``&``. (:bbissue:`132`)

3.0.1

  - Fix some packaging issues that made it more difficult to run the
    tests directly from the sdist package. (:bbissue:`126`)

3.0

  - Add Python 3 support, thanks in large part to the efforts of
    Daniel Kraus (:bbuser:`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. (:bbissue:`121`)

2.11

  - Add ``-a`` option to :ref:`command-mkvirtualenv` to associate a
    new virtualenv with an existing project directory. Contributed by
    Mike Fogel (:bbuser:`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. (:bbissue:`62`
    reported by :bbuser:`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. (:bbissue:`120`
    reported by :bbuser:`arthuralvim`)

2.10.1

  - Changed arguments to :ref:`command-mktmpenv` so it always creates
    an environment name for you. (:bbissue:`114` reported by
    :bbuser:`alex_gaynor`)

2.10

  - Incorporated patch to add ``-d`` option to
    :ref:`command-add2virtualenv`, contributed by :bbuser:`miracle2k`.
  - Add ``-i`` option to :ref:`command-mkvirtualenv`.
  - Add :ref:`command-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. (:bbissue:`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
    :ref:`command-mkproject`, :ref:`command-cdproject`, and
    :ref:`command-setvirtualenvproject` commands.
  - Add ``-r`` option to :ref:`command-mkvirtualenv` to install
    dependencies using a pip requirements file.

2.8

  - Use VIRTUALENVWRAPPER_VIRTUALENV in `cpvirtualenv` (:bbissue:`104`).
  - Add support for `MSYS <http://www.mingw.org/wiki/MSYS>`_
    environment under Windows. Contributed by Axel
    H. (:bbuser:`noirbizarre`).

2.7.2

  - Move setup code for tab completion later in the startup code so
    all of the needed variables are configured. (:bbissue:`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
    (:bbissue:`94`).
  - Update the :ref:`install-basic` 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 (:bbissue:`79`).
  - Fix problem with argument processing in lsvirtualenv under zsh
    (:bbissue:`86`). Thanks to Nat Williams (:bbuser:`natw`) for the
    bug report and patch.
  - If WORKON_HOME does not exist, create it. Patch from Carl Karsten
    (:bbuser:`CarlFK`). Test updates based on patches from Matt Austin
    (:bbuser:`maafy6`) and Hugo Lopes Tavares (:bbuser:`hltbra`).
  - Merge in contributions from Paul McLanahan (:bbuser:`pmclanahan`)
    to fix the test harness to ensure that the test scripts are
    actually running under the expected shell.
  - Merge in new shell command :ref:`command-toggleglobalsitepackages`
    from Paul McLanahan (:bbuser:`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 :ref:`VIRTUALENVWRAPPER_VIRTUALENV
    <variable-VIRTUALENVWRAPPER_VIRTUALENV>` variable.
  - Implement suggestion by Van Lindberg to have
    :ref:`VIRTUALENVWRAPPER_HOOK_DIR
    <variable-VIRTUALENVWRAPPER_HOOK_DIR>` and
    :ref:`VIRTUALENVWRAPPER_LOG_DIR
    <variable-VIRTUALENVWRAPPER_LOG_DIR>` variables to control the
    locations of hooks and logs.
  - Enabled tab completion for :ref:`command-showvirtualenv`
    (:bbissue:`78`).
  - Fixed a problem with running :ref:`command-rmvirtualenv` from
    within the environment being removed (:bbissue:`83`).
  - Removed use of -e option in calls to grep for better portability
    (:bbissue:`85`).

2.6.3

  .. - Hard-code the version information in the setup.py and conf.py
       scripts so it works for http://readthedocs.org.

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

2.6.2

  .. - Attempted to make the doc build work with http://readthedocs.org.
     - Merged in `Japanese translation of the documentation
           <http://www.doughellmann.com/docs/virtualenvwrapper/ja/>`__ from
                Tetsuya Morimoto.
     - Incorporate a suggestion from Ales Zoulek to let the user specify
       the virtualenv binary through an environment variable
       (:ref:`VIRTUALENVWRAPPER_VIRTUALENV <variable-VIRTUALENVWRAPPER_VIRTUALENV>`).

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

2.6.1

  .. - Fixed virtualenvwrapper_get_python_version (:bbissue:`73`).

  - virtualenvwrapper_get_python_version を修正しました(:bbissue:`73`)。

2.6

  .. - Fixed a problem with hook script line endings under Cygwin
       (:bbissue:`68`).
     - Updated documentation to include a list of the compatible shells
       (:ref:`supported-shells`) and Python versions
       (:ref:`supported-versions`) (:bbissue:`70`).
     - Fixed installation dependency on virtualenv (:bbissue:`60`).
     - Fixed the method for determining the Python version so it works
       under Python 2.4 (:bbissue:`61`).
     - Converted the test infrastructure to use `tox
       <http://codespeak.net/tox/index.html>`_ instead of home-grown
       scripts in the Makefile.

  - Cygwin 環境でフックスクリプトの改行の問題を修正しました(:bbissue:`68`)。
  - 互換シェルのリスト(:ref:`supported-shells`) と Python バージョン(:ref:`supported-versions`)を含むようにドキュメントを更新しました(:bbissue:`70`)。
  - virtualenv のインストールの依存関係を修正しました(:bbissue:`60`)。
  - Python 2.4 で動作するように Python バージョンを決定するメソッドを修正しました(:bbissue:`61`)。
  - Makefile の自作スクリプトの代わりに `tox <http://codespeak.net/tox/index.html>`_ を使用するためにテストインフラを変換しました。

2.5.3

  .. - Point release uploaded to PyPI during outage on doughellmann.com.

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

2.5.2

  .. - Apply patch from Zach Voase to fix :ref:`command-lsvirtualenv`
       under zsh. Resolves :bbissue:`64`.

  - zsh 環境の :ref:`command-lsvirtualenv` を修正する Zach Voase からのパッチを適用しました。 :bbissue:`64` を解決しました。

2.5.1

  .. - Make :ref:`command-workon` list brief environment details when run
       without argument, instead of full details.

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

2.5

  .. - Add :ref:`command-showvirtualenv` command.  Modify
       :ref:`command-lsvirtualenv` to make verbose output the default.

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

2.4

  .. - Add :ref:`command-lsvirtualenv` command with ``-l`` option to run
       :ref:`scripts-get_env_details` hook instead of always running it
       when :ref:`command-workon` has no arguments.

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

2.3

  .. - Added ``get_env_details`` hook.

  - ``get_env_details`` フックを追加しました。

2.2.2

  .. - Integrate Fred Palmer's patch to escape more shell commands to
       avoid aliases.  Resolves :bbissue:`57`.
     - Fix a problem with egrep argument escaping (:bbissue:`55`).
     - Fix a problem with running mkvirtualenv without arguments (:bbissue:`56`).

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

2.2.1

  .. - Escape ``which`` calls to avoid aliases. Resolves :bbissue:`46`.
     - Integrate Manuel Kaufmann's patch to unset GREP_OPTIONS before
       calling grep.  Resolves :bbissue:`51`.
     - Escape ``$`` in regex to resolve :bbissue:`53`.
     - Escape ``rm`` to avoid issues with aliases and resolve
       :bbissue:`50`.

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

2.2

  .. - Switched hook loader execution to a form that works with Python
       2.4 to resolve :bbissue:`43`.
     - Tested under Python 2.7b1.  See :bbissue:`44`.
     - Incorporated performance improvements from David Wolever.  See
       :bbissue:`38`.
     - Added some debug instrumentation for :bbissue:`35`.

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

2.1.1

  .. - Added `Spanish translation for the documentation
       <http://www.doughellmann.com/docs/virtualenvwrapper/es/>`__ via
       Manuel Kaufmann's fork at
       http://bitbucket.org/humitos/virtualenvwrapper-es-translation/
     - Fixed improper use of python from ``$PATH`` instead of the
       location where the wrappers are installed.  See :bbissue:`41`.
     - Quiet spurrious error/warning messages when deactivating a
       virtualenv under zsh.  See :bbissue:`42`.

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

2.1

  .. - Add support for ksh.  Thanks to Doug Latornell for doing the
       research on what needed to be changed.
     - Test import of virtualenvwrapper.hook_loader on startup and report
       the error in a way that should help the user figure out how to fix
       it (:bbissue:`33`).
     - Update :ref:`command-mkvirtualenv` documentation to include the
       fact that a new environment is activated immediately after it is
       created (:bbissue:`30`).
     - Added hooks around :ref:`command-cpvirtualenv`.
     - Made deactivation more robust, especially under ksh.
     - Use Python's ``tempfile`` module for creating temporary filenames
       safely and portably.
     - Fix a problem with ``virtualenvwrapper_show_workon_options`` that
       caused it to show ``*`` as the name of a virtualenv when no
       environments had yet been created.
     - Change the hook loader so it can be told to run only a set of
       named hooks.
     - Add support for listing the available hooks, to be used in help
       output of commands like virtualenvwrapper.project's mkproject.
     - Fix mkvirtualenv -h option behavior.
     - Change logging so the $WORKON_HOME/hook.log file rotates after
       10KiB.

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

2.0.2

  .. - Fixed :bbissue:`32`, making virtualenvwrapper.user_scripts compatible
       with Python 2.5 again.

  - virtualenvwrapper.user_scripts が Python 2.5 互換になるように :bbissue:`32` を修正しました。

2.0.1

  .. - Fixed :bbissue:`29`, to use a default value for ``TMPDIR`` if it
       is not set in the user's shell environment.

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

2.0

  .. - Rewrote hook management using Distribute_ entry points to make it
       easier to share extensions.

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

.. _Distribute: http://packages.python.org/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 :bbissue:`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 :ref:`tips-and-tricks` section.
  - Add link to Rich Leland's screencast to :ref:`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 :bbissue:`21` for complete details.

1.23

  - Resolve a bug with the postmkvirtualenv hook not being run
    properly.  Refer to :bbissue:`19` and :bbissue:`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
    :bbissue:`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. (:bbissue:`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
    <http://shunit2.googlecode.com/>`_

1.13

  - Fix :bbissue:`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
    (:bbchangeset:`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 (:bbissue:`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.