1 # Virtualenvwrapper plugin
3 This plugin loads Python's [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/) shell tools.
5 To use it, add `virtualenvwrapper` to the plugins array in your zshrc file:
8 plugins=(... virtualenvwrapper)
13 The plugin allows to automatically activate virtualenvs on cd into git repositories with a matching name:
17 (ansible) ➜ ansible git:(devel) $ cd docs
18 (ansible) ➜ docs git:(devel) $ cd ..
19 (ansible) ➜ ansible git:(devel) $ cd ..
23 We can override this by having a `.venv` file in the directory containing a differently named virtualenv:
26 ➜ github $ cat ansible/.venv
29 (myvirtualenv) ➜ ansible git:(devel) $ cd ..
33 We can disable this behaviour by setting `DISABLE_VENV_CD=1` before Oh My Zsh is sourced:
36 plugins=(... virtualenvwrapper)
37 source $ZSH/oh-my-zsh.sh