2.2 KiB
2.2 KiB
Python plugin
The plugin adds several aliases for useful Python commands.
To use it, add python
to the plugins array in your zshrc file:
plugins=(... python)
Aliases
Command | Description |
---|---|
py |
Runs python3 . Only set if py is not installed. |
ipython |
Runs the appropriate ipython version according to the activated virtualenv |
pyfind |
Finds .py files recursively in the current directory |
pyclean [dirs] |
Deletes byte-code and cache files from a list of directories or the current one |
pygrep <text> |
Looks for text in *.py files in the current directory, recursively |
pyuserpaths |
Add user site-packages folders to PYTHONPATH , for Python 2 and 3 |
pyserver |
Starts an HTTP server on the current directory (use --directory for a different one) |
Virtual environments
The plugin provides three utilities to manage Python 3.3+ venv virtual environments:
-
mkv [name]
: make a new virtual environment calledname
(default: if set$PYTHON_VENV_NAME
, elsevenv
) in the current directory. -
vrun [name]
: Activate the virtual environment calledname
(default: if set$PYTHON_VENV_NAME
, elsevenv
) in the current directory. -
auto_vrun
: Automatically activate the venv virtual environment when entering a directory containing<venv-name>/bin/activate
, and automatically deactivate it when navigating out of it (keeps venv activated in subdirectories).- To enable the feature, set
export PYTHON_AUTO_VRUN=true
before sourcing oh-my-zsh. - Plugin activates first virtual environment in lexicographic order whose name begins with
<venv-name>
. The default virtual environment name isvenv
. To use a different name, setexport PYTHON_VENV_NAME=<venv-name>
. For example:export PYTHON_VENV_NAME=".venv"
- To enable the feature, set