|
| 1 | +What is virtualenvwrapper |
| 2 | +========================= |
| 3 | + |
| 4 | +virtualenvwrapper_ is a set of extensions to Ian Bicking's virtualenv_ |
| 5 | +tool. The extensions include wrappers for creating and deleting |
| 6 | +virtual environments and otherwise managing your development workflow, |
| 7 | +making it easier to work on more than one project at a time without |
| 8 | +introducing conflicts in their dependencies. |
| 9 | + |
| 10 | +What's New in 2.0 |
| 11 | +================= |
| 12 | + |
| 13 | +This new version uses a significantly rewritten version of the |
| 14 | +hook/callback subsystem to make it easier to share extensions. For |
| 15 | +example, released at the same time is virtualenvwrapper-emacs-desktop_, |
| 16 | +a plugin to switch emacs project files when you switch virtualenvs. |
| 17 | + |
| 18 | +Existing user scripts should continue to work as-written. Any failures |
| 19 | +are probably a bug, so please report them on the bitbucket |
| 20 | +tracker. Documentation for the new plugin system is available in the |
| 21 | +virtualenvwrapper docs_. |
| 22 | + |
| 23 | +I also took this opportunity to change the name of the shell script |
| 24 | +containing most of the virtualenvwrapper functionality from |
| 25 | +virtualenvwrapper_bashrc to virtualenvwrapper.sh. This reflects the |
| 26 | +fact that several shells other than bash are supported (bash, sh, ksh, |
| 27 | +and zsh are all reported to work). You'll want to update your shell |
| 28 | +startup file after upgrading to 2.0. |
| 29 | + |
| 30 | +The work to create the plugin system was triggered by a couple of |
| 31 | +recent feature requests for environment templates and for a new |
| 32 | +command to create a sub-shell instead of simply changing the settings |
| 33 | +of the current shell. The new, more powerful, plugin capabilities will |
| 34 | +make it easier to develop these and similar features. |
| 35 | + |
| 36 | +I'm looking forward to seeing what the community comes up with. I |
| 37 | +especially want someone to write a plugin to start a copy of a |
| 38 | +development server for a Django project if one is found in a |
| 39 | +virtualenv. You'll get bonus points if it opens the home page of the |
| 40 | +server in a web browser. |
| 41 | + |
| 42 | + |
| 43 | + |
| 44 | +.. _virtualenv: http://pypi.python.org/pypi/virtualenv |
| 45 | + |
| 46 | +.. _virtualenvwrapper: http://www.doughellmann.com/projects/virtualenvwrapper/ |
| 47 | + |
| 48 | +.. _virtualenvwrapper-emacs-desktop: http://www.doughellmann.com/projects/virtualenvwrapper-emacs-desktop/ |
| 49 | + |
| 50 | +.. _docs: http://www.doughellmann.com/docs/virtualenvwrapper/ |
0 commit comments