1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-11-30 17:50:07 +00:00
ohmyzsh/plugins/viper-env/README.md
Daniel Kaminski de Souza 78f8066681 Add viper-env plugin.
2021-03-28 16:38:43 +01:00

65 lines
No EOL
1.4 KiB
Markdown

# Viper Env Z-Shel plugin
Automatically activates and deactivates python virtualenv upon cd in and out.
## Inspiration
Based on [blueray](https://stackoverflow.com/users/1772898/blueray)'s [answer](https://stackoverflow.com/a/63955939/11685534), I decided to go one step further and implement it as a Z-Shell plugin.
## Usage
<!-- [![asciicast](https://asciinema.org/a/4iMwcKfBS1dc1EgI1FihrDVxT.svg)](https://asciinema.org/a/4iMwcKfBS1dc1EgI1FihrDVxT) -->
![Alt text](./make_animation/assets/final.svg)
## Example
```zsh
> viper-env help
Description:
Automatically activates and deactivates python virtualenv upon cd in and out.
Dependencies:
- zsh
- python
Example usage:
# Create virtual environment
python -m venv .venv
# Save current dir
current_dir=$(basename $PWD)
# Exit current directory
cd ..
# Reenter it
cd $current_dir
```
## Instalation
### Oh my Zsh
Git clone this repository to the Oh my Zsh custom plugins folder.
Add plugin to plugins directive in `~/.zshrc`
```zsh
plugins=(
# put local oh-my-zsh plugins here
viper-env
)
source $HOME/.oh-my-zsh/oh-my-zsh.sh
```
### Antigen
It is recommended to use a `.antigenrc` file. Then add the following to it:
```zsh
antigen bundle DanielAtKrypton/viper-env
# Apply changes
antigen apply
```
Make sure in your `.zshrc` Antigen is loading the `.antigenrc` file as follows:
```zsh
antigen init ~/.antigenrc
```