diff --git a/docs/index.md b/docs/index.md
deleted file mode 100644
index 52a0a25..0000000
--- a/docs/index.md
+++ /dev/null
@@ -1,130 +0,0 @@
-# viv
-
-
-
-Try before you buy!
-```sh
-python3 <(curl -fsSL viv.dayl.in/viv.py) run pycowsay -- "viv isn't venv\!"
-```
----
-
-`Viv` is a standalone dependency-free `venv` creator.
-
-These `venvs` can be identified by name or by their specification.
-In any case they will be re-used across scripts (and generated on-demand, if needed).
-
-**Importantly**, `viv` will also remove your user site directory.
-(view with: `python -m 'import site;print(site.USER_SITE)'`).
-
-`Viv`'s uncompromising insistence on portability means that it will always (1) only use the standard library (2) never exceed a single script.
-
-For that reason any usage of the `CLI` can be accomplished using a remote copy as seen in the below install command.
-
-## Setup
-
-Run the below command to install `viv`.
-
-```sh
-python3 <(curl -fsSL viv.dayl.in/viv.py) manage install
-```
-
-To access `viv` from within scripts you should add it's location to your `PYTHONPATH`.
-By default `viv` will be installed to `$XDG_DATA_HOME/viv` or `~/.local/share/viv` you can customize this with `--src`.
-
-```sh
-export PYTHONPATH="$PYTHONPATH:$HOME/.local/share/viv"
-```
-
-Advanced users may recognize that principally,
-the module just needs to be recognized at run time
-and the single script [`viv.py`](https://github.com/daylinmorgan/viv/blob/main/src/viv/viv.py) can be invoked directly for the CLI.
-How you accomplish these options is ultimately up to you but the above instructions can get you started.
-
-### Pypi (Not Recommended)
-
-```sh
-pip install viv
-```
-
-Why is this *not recommended*? Mainly, because `viv` is all about hacking your `sys.path`.
-Placing it in it's own virtual environment or installing in a user site directory may complicate this endeavor.
-
-## Usage
-
-In any python script with external dependencies you can add this line,
-to automate `vivenv` creation and installation of dependencies.
-
-```python
-__import__("viv").use("click")
-```
-
-To remove all `vivenvs` you can use the below command:
-
-```sh
-viv remove $(viv list -q)
-```
-
-To remove `viv` all together you can use the included `purge` command:
-
-```sh
-python3 <(curl -fsSL viv.dayl.in/viv.py) manage purge
-```
-
-## Additional Features
-
-An experimental feature of `viv` is generating shim's that leverage the principles of `viv`.
-These shims would operate similar to `pipx` in which you can specify a command line app to "install".
-
-*Note* that `--standalone` will auto-generate a code-golfed minified version of `viv` to accomplish the same basic task as using a local copy of `viv`.
-After generating this a standalone `shim` you can freely use this script across unix machines which have `python>3.8`.
-See [examples/black](https://github.com/daylinmorgan/viv/blob/dev/examples/black) for output of below command.
-
-```sh
-python3 <(curl -fsSL viv.dayl.in/viv.py) shim black -o ./black --standalone --freeze
-```
-
-## Alternatives
-
-### [pip-run](https://github.com/jaraco/pip-run)
-
-```sh
-pip-run (10.0.5)
-├── autocommand (2.2.2)
-├── jaraco-context (4.3.0)
-├── jaraco-functools (3.6.0)
-│ └── more-itertools (9.1.0)
-├── jaraco-text (3.11.1)
-│ ├── autocommand (2.2.2)
-│ ├── inflect (6.0.2)
-│ │ └── pydantic>=1.9.1 (1.10.5)
-│ │ └── typing-extensions>=4.2.0 (4.5.0)
-│ ├── jaraco-context>=4.1 (4.3.0)
-│ ├── jaraco-functools (3.6.0)
-│ │ └── more-itertools (9.1.0)
-│ └── more-itertools (9.1.0)
-├── more-itertools>=8.3 (9.1.0)
-├── packaging (23.0)
-├── path>=15.1 (16.6.0)
-├── pip>=19.3 (23.0.1)
-└── platformdirs (3.1.0)
-```
-
-### [pipx](https://github.com/pypa/pipx/)
-
-```sh
-pipx (1.1.0)
-├── argcomplete>=1.9.4 (2.1.1)
-├── packaging>=20.0 (23.0)
-└── userpath>=1.6.0 (1.8.0)
- └── click (8.1.3)
-```
diff --git a/docs/svgs/viv-exe-help.svg b/docs/svgs/viv-exe-help.svg
index 5d16aa5..cbf6eaf 100644
--- a/docs/svgs/viv-exe-help.svg
+++ b/docs/svgs/viv-exe-help.svg
@@ -19,14 +19,14 @@
font-weight: 700;
}
- .terminal-2174466350-matrix {
+ .terminal-3409362442-matrix {
font-family: Fira Code, monospace;
font-size: 20px;
line-height: 24.4px;
font-variant-east-asian: full-width;
}
- .terminal-2174466350-title {
+ .terminal-3409362442-title {
font-size: 18px;
font-weight: bold;
font-family: arial;
@@ -36,80 +36,80 @@
-webkit-filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
}
- .terminal-2174466350-r1 { fill: #94e2d5;font-weight: bold }
-.terminal-2174466350-r2 { fill: #c6d0f5 }
-.terminal-2174466350-r3 { fill: #f9e2af;font-weight: bold }
+ .terminal-3409362442-r1 { fill: #94e2d5;font-weight: bold }
+.terminal-3409362442-r2 { fill: #c6d0f5 }
+.terminal-3409362442-r3 { fill: #f9e2af;font-weight: bold }
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
- viv exe --help
+ viv exe --help
-
+
-
- usage: viv exe [-h] vivenv cmd
-
-run binary/script in existing vivenv
-
-examples:
- viv exe <vivenv> pip -- list
- viv exe <vivenv> python -- script.py
-
-positional arguments:
-vivenv name/hash of vivenv
-cmd command to to execute
-
-options:
--h, --help show this help message and exit
+
+ usage: viv exe [-h] vivenv cmd
+
+run binary/script in existing vivenv
+
+examples:
+ viv exe <vivenv> python -- script.py
+ viv exe <vivenv> python -- -m http.server
+
+positional arguments:
+vivenv name/hash of vivenv
+cmd command to to execute
+
+options:
+-h, --help show this help message and exit
diff --git a/docs/svgs/viv-exe-pip-help.svg b/docs/svgs/viv-exe-pip-help.svg
index 2f3721d..7c99d23 100644
--- a/docs/svgs/viv-exe-pip-help.svg
+++ b/docs/svgs/viv-exe-pip-help.svg
@@ -19,14 +19,14 @@
font-weight: 700;
}
- .terminal-1793440407-matrix {
+ .terminal-3354443635-matrix {
font-family: Fira Code, monospace;
font-size: 20px;
line-height: 24.4px;
font-variant-east-asian: full-width;
}
- .terminal-1793440407-title {
+ .terminal-3354443635-title {
font-size: 18px;
font-weight: bold;
font-family: arial;
@@ -36,80 +36,80 @@
-webkit-filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
}
- .terminal-1793440407-r1 { fill: #94e2d5;font-weight: bold }
-.terminal-1793440407-r2 { fill: #c6d0f5 }
-.terminal-1793440407-r3 { fill: #f9e2af;font-weight: bold }
+ .terminal-3354443635-r1 { fill: #94e2d5;font-weight: bold }
+.terminal-3354443635-r2 { fill: #c6d0f5 }
+.terminal-3354443635-r3 { fill: #f9e2af;font-weight: bold }
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
- viv exe pip --help
+ viv exe pip --help
-
+
-
- usage: viv exe [-h] vivenv cmd
-
-run binary/script in existing vivenv
-
-examples:
- viv exe <vivenv> pip -- list
- viv exe <vivenv> python -- script.py
-
-positional arguments:
-vivenv name/hash of vivenv
-cmd command to to execute
-
-options:
--h, --help show this help message and exit
+
+ usage: viv exe [-h] vivenv cmd
+
+run binary/script in existing vivenv
+
+examples:
+ viv exe <vivenv> python -- script.py
+ viv exe <vivenv> python -- -m http.server
+
+positional arguments:
+vivenv name/hash of vivenv
+cmd command to to execute
+
+options:
+-h, --help show this help message and exit
diff --git a/docs/svgs/viv-exe-python-help.svg b/docs/svgs/viv-exe-python-help.svg
index f81638f..b8ffb80 100644
--- a/docs/svgs/viv-exe-python-help.svg
+++ b/docs/svgs/viv-exe-python-help.svg
@@ -19,14 +19,14 @@
font-weight: 700;
}
- .terminal-2696068080-matrix {
+ .terminal-207667404-matrix {
font-family: Fira Code, monospace;
font-size: 20px;
line-height: 24.4px;
font-variant-east-asian: full-width;
}
- .terminal-2696068080-title {
+ .terminal-207667404-title {
font-size: 18px;
font-weight: bold;
font-family: arial;
@@ -36,80 +36,80 @@
-webkit-filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
}
- .terminal-2696068080-r1 { fill: #94e2d5;font-weight: bold }
-.terminal-2696068080-r2 { fill: #c6d0f5 }
-.terminal-2696068080-r3 { fill: #f9e2af;font-weight: bold }
+ .terminal-207667404-r1 { fill: #94e2d5;font-weight: bold }
+.terminal-207667404-r2 { fill: #c6d0f5 }
+.terminal-207667404-r3 { fill: #f9e2af;font-weight: bold }
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
- viv exe python --help
+ viv exe python --help
-
+
-
- usage: viv exe [-h] vivenv cmd
-
-run binary/script in existing vivenv
-
-examples:
- viv exe <vivenv> pip -- list
- viv exe <vivenv> python -- script.py
-
-positional arguments:
-vivenv name/hash of vivenv
-cmd command to to execute
-
-options:
--h, --help show this help message and exit
+
+ usage: viv exe [-h] vivenv cmd
+
+run binary/script in existing vivenv
+
+examples:
+ viv exe <vivenv> python -- script.py
+ viv exe <vivenv> python -- -m http.server
+
+positional arguments:
+vivenv name/hash of vivenv
+cmd command to to execute
+
+options:
+-h, --help show this help message and exit
diff --git a/docs/svgs/viv-freeze-help.svg b/docs/svgs/viv-freeze-help.svg
index f9d0949..f15f337 100644
--- a/docs/svgs/viv-freeze-help.svg
+++ b/docs/svgs/viv-freeze-help.svg
@@ -19,14 +19,14 @@
font-weight: 700;
}
- .terminal-3188460144-matrix {
+ .terminal-1818495600-matrix {
font-family: Fira Code, monospace;
font-size: 20px;
line-height: 24.4px;
font-variant-east-asian: full-width;
}
- .terminal-3188460144-title {
+ .terminal-1818495600-title {
font-size: 18px;
font-weight: bold;
font-family: arial;
@@ -36,77 +36,77 @@
-webkit-filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
filter: drop-shadow( 2px 5px 2px rgba(0, 0, 0, .7));
}
- .terminal-3188460144-r1 { fill: #94e2d5;font-weight: bold }
-.terminal-3188460144-r2 { fill: #c6d0f5 }
-.terminal-3188460144-r3 { fill: #f9e2af;font-weight: bold }
-.terminal-3188460144-r4 { fill: #f9e2af }
+ .terminal-1818495600-r1 { fill: #94e2d5;font-weight: bold }
+.terminal-1818495600-r2 { fill: #c6d0f5 }
+.terminal-1818495600-r3 { fill: #f9e2af;font-weight: bold }
+.terminal-1818495600-r4 { fill: #f9e2af }
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
- viv freeze --help
+ viv freeze --help
-
+
-
- usage: viv freeze [-h] [-p {abs,rel}] [-s] [-k] [-r <path>] [reqs ...]
-
-create import statement from package spec
-
-positional arguments:
-reqs requirements specifiers
-
-options:
--h, --help show this help message and exit
--p, --path {abs,rel} generate line to add viv to sys.path
--s, --standalone generate standalone activation function
--k, --keep preserve environment
--r, --requirements <path> path/to/requirements.txt file
+
+ usage: viv freeze [-h] [-p {abs,rel}] [-s] [-r <path>] [-k] [reqs ...]
+
+create import statement from package spec
+
+positional arguments:
+reqs requirements specifiers
+
+options:
+-h, --help show this help message and exit
+-p, --path {abs,rel} generate line to add viv to sys.path
+-s, --standalone generate standalone activation function
+-r, --requirements <path> path/to/requirements.txt file
+-k, --keep preserve environment
diff --git a/docs/svgs/viv-help.svg b/docs/svgs/viv-help.svg
index 8a22a00..be33cdd 100644
--- a/docs/svgs/viv-help.svg
+++ b/docs/svgs/viv-help.svg
@@ -1,4 +1,4 @@
-
-
-