From 8a2e1006b3b272126332aa064f3ad95387129544 Mon Sep 17 00:00:00 2001
From: Biswakalyan Bhuyan <biswa@surgot.in>
Date: Thu, 13 Feb 2025 14:13:49 +0530
Subject: new dot files

---
 .../oh-my-zsh/plugins/virtualenvwrapper/README.md  | 38 ++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 .config/zsh/oh-my-zsh/plugins/virtualenvwrapper/README.md

(limited to '.config/zsh/oh-my-zsh/plugins/virtualenvwrapper/README.md')

diff --git a/.config/zsh/oh-my-zsh/plugins/virtualenvwrapper/README.md b/.config/zsh/oh-my-zsh/plugins/virtualenvwrapper/README.md
new file mode 100644
index 0000000..63eb585
--- /dev/null
+++ b/.config/zsh/oh-my-zsh/plugins/virtualenvwrapper/README.md
@@ -0,0 +1,38 @@
+# Virtualenvwrapper plugin
+
+This plugin loads Python's [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/) shell tools.
+
+To use it, add `virtualenvwrapper` to the plugins array in your zshrc file:
+
+```zsh
+plugins=(... virtualenvwrapper)
+```
+
+## Usage
+
+The plugin allows to automatically activate virtualenvs on cd into git repositories with a matching name:
+
+```
+➜  github $ cd ansible
+(ansible) ➜  ansible git:(devel) $ cd docs
+(ansible) ➜  docs git:(devel) $ cd ..
+(ansible) ➜  ansible git:(devel) $ cd ..
+➜  github $
+```
+
+We can override this by having a `.venv` file in the directory containing a differently named virtualenv:
+
+```
+➜  github $ cat ansible/.venv
+myvirtualenv
+➜  github $ cd ansible
+(myvirtualenv) ➜  ansible git:(devel) $ cd ..
+➜  github $
+```
+
+We can disable this behaviour by setting `DISABLE_VENV_CD=1` before Oh My Zsh is sourced:
+```zsh
+DISABLE_VENV_CD=1
+plugins=(... virtualenvwrapper)
+source $ZSH/oh-my-zsh.sh
+```
-- 
cgit v1.2.3-59-g8ed1b