diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 988743f..ba97315 100644 Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ diff --git a/svgs/viv-exe-help.svg b/svgs/viv-exe-help.svg new file mode 100644 index 0000000..c700033 --- /dev/null +++ b/svgs/viv-exe-help.svg @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv exe --help + + + + + + + + + + usage: viv exe [-h] <sub-cmd> ... + +run python/pip in existing vivenv + +options: +-h, --help    show this help message and exit + +subcommand: +<sub-cmd> +python      run command with python +pip         run command with pip + + + + diff --git a/svgs/viv-exe-pip-help.svg b/svgs/viv-exe-pip-help.svg new file mode 100644 index 0000000..e75cd99 --- /dev/null +++ b/svgs/viv-exe-pip-help.svg @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv exe pip --help + + + + + + + + + + usage: viv exe pip [-h] vivenv [cmd ...] + +positional arguments: +vivenv        name/hash of vivenv +cmd           command to to execute + +options: +-h, --help    show this help message and exit + + + + diff --git a/svgs/viv-exe-python-help.svg b/svgs/viv-exe-python-help.svg new file mode 100644 index 0000000..480d51d --- /dev/null +++ b/svgs/viv-exe-python-help.svg @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv exe python --help + + + + + + + + + + usage: viv exe python [-h] vivenv [cmd ...] + +positional arguments: +vivenv        name/hash of vivenv +cmd           command to to execute + +options: +-h, --help    show this help message and exit + + + + diff --git a/svgs/viv-freeze-help.svg b/svgs/viv-freeze-help.svg new file mode 100644 index 0000000..4d473e1 --- /dev/null +++ b/svgs/viv-freeze-help.svg @@ -0,0 +1,113 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv freeze --help + + + + + + + + + + usage: viv freeze [-h] [-p {abs,rel}] [-r <path>] [-k] [-s] [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 +-r, --requirements <path>    path/to/requirements.txt file +-k, --keep                   preserve environment +-s, --standalone             generate standalone activation function + + + + diff --git a/svgs/viv-help.svg b/svgs/viv-help.svg new file mode 100644 index 0000000..3ca7ddb --- /dev/null +++ b/svgs/viv-help.svg @@ -0,0 +1,146 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv  --help + + + + + + + + + + usage: viv [-h] [-V] <sub-cmd> ... + +vivisn'tvenv! +to create/activate a vivenv: +- from command line: `viv -h` +- within python script: __import__("viv").use("typer", "rich-click") + +options: +-h, --help       show this help message and exit +-V, --version    show program's version number and exit + +subcommands: +<sub-cmd> +list (l)       list all vivenvs +exe (e)        run python/pip in existing vivenv +remove (rm)    remove a vivenv +freeze (f)     create import statement from package spec +info (i)       get metadata about a vivenv +manage (m)     manage viv itself +shim (s)       generate viv-powered cli apps +run (r)        run an app with an on-demand venv + + + + diff --git a/svgs/viv-list-help.svg b/svgs/viv-list-help.svg new file mode 100644 index 0000000..ffb4aea --- /dev/null +++ b/svgs/viv-list-help.svg @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv list --help + + + + + + + + + + usage: viv list [-h] [-v] [-q] + +list all vivenvs + +options: +-h, --help       show this help message and exit +-v, --verbose    show full metadata for vivenvs +-q, --quiet      suppress non-essential output + + + + diff --git a/svgs/viv-manage-help.svg b/svgs/viv-manage-help.svg new file mode 100644 index 0000000..075e969 --- /dev/null +++ b/svgs/viv-manage-help.svg @@ -0,0 +1,112 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv manage --help + + + + + + + + + + usage: viv manage [-h] <sub-cmd> ... + +manage viv itself + +options: +-h, --help     show this help message and exit + +subcommand: +<sub-cmd> +install (i)  install viv +update (u)   update viv version +show (s)     show current installation info +purge (p)    remove traces of viv + + + + diff --git a/svgs/viv-manage-install-help.svg b/svgs/viv-manage-install-help.svg new file mode 100644 index 0000000..734bdb0 --- /dev/null +++ b/svgs/viv-manage-install-help.svg @@ -0,0 +1,89 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv manage install --help + + + + + + + + + + usage: viv manage install [-h] [-r <ref>] [-s <src>] [-c <cli>] + +options: +-h, --help         show this help message and exit +-r, --ref <ref>    git reference (branch/tag/commit) +-s, --src <src>    path/to/source_file +-c, --cli <cli>    path/to/cli (symlink to src) + + + + diff --git a/svgs/viv-manage-purge-help.svg b/svgs/viv-manage-purge-help.svg new file mode 100644 index 0000000..e230ae4 --- /dev/null +++ b/svgs/viv-manage-purge-help.svg @@ -0,0 +1,89 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv manage purge --help + + + + + + + + + + usage: viv manage purge [-h] [-r <ref>] [-s <src>] [-c <cli>] + +options: +-h, --help         show this help message and exit +-r, --ref <ref>    git reference (branch/tag/commit) +-s, --src <src>    path/to/source_file +-c, --cli <cli>    path/to/cli (symlink to src) + + + + diff --git a/svgs/viv-manage-show-help.svg b/svgs/viv-manage-show-help.svg new file mode 100644 index 0000000..96aa69f --- /dev/null +++ b/svgs/viv-manage-show-help.svg @@ -0,0 +1,80 @@ + + + + + + + + + + + + + + + + + + + + + + + viv manage show --help + + + + + + + + + + usage: viv manage show [-h] [-p] + +options: +-h, --help          show this help message and exit +-p, --pythonpath    show the path/to/install + + + + diff --git a/svgs/viv-manage-update-help.svg b/svgs/viv-manage-update-help.svg new file mode 100644 index 0000000..becad89 --- /dev/null +++ b/svgs/viv-manage-update-help.svg @@ -0,0 +1,89 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv manage update --help + + + + + + + + + + usage: viv manage update [-h] [-r <ref>] [-s <src>] [-c <cli>] + +options: +-h, --help         show this help message and exit +-r, --ref <ref>    git reference (branch/tag/commit) +-s, --src <src>    path/to/source_file +-c, --cli <cli>    path/to/cli (symlink to src) + + + + diff --git a/svgs/viv-remove-help.svg b/svgs/viv-remove-help.svg new file mode 100644 index 0000000..a594881 --- /dev/null +++ b/svgs/viv-remove-help.svg @@ -0,0 +1,108 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv remove --help + + + + + + + + + + usage: viv remove [-h] [vivenv ...] + +remove a vivenv + +To remove all viv venvs: +`viv rm $(viv l -q)` + +positional arguments: +vivenv        name/hash of vivenv + +options: +-h, --help    show this help message and exit + + + + diff --git a/svgs/viv-run-help.svg b/svgs/viv-run-help.svg new file mode 100644 index 0000000..b84985c --- /dev/null +++ b/svgs/viv-run-help.svg @@ -0,0 +1,125 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv run --help + + + + + + + + + + usage: viv run [-h] [-r <path>] [-k] [-b <bin>] [reqs ...] + +run an app with an on-demand venv + +examples: +  viv r pycowsay -- "viv isn't venv\!" +  viv r rich -b python -- -m rich + +positional arguments: +reqs                         requirements specifiers + +options: +-h, --help                   show this help message and exit +-r, --requirements <path>    path/to/requirements.txt file +-k, --keep                   preserve environment +-b, --bin <bin>              console_script/script to invoke + + + + diff --git a/svgs/viv-shim-help.svg b/svgs/viv-shim-help.svg new file mode 100644 index 0000000..87f951f --- /dev/null +++ b/svgs/viv-shim-help.svg @@ -0,0 +1,145 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + viv shim --help + + + + + + + + + + usage: viv shim [-h] [-p {abs,rel}] [-r <path>] [-k] [-s] [-f] [-o  +<path>] [-b <bin>] [reqs ...] + +generate viv-powered cli apps + +examples: +  viv shim black +  viv shim yartsu -o ~/bin/yartsu --standalone + +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 +-r, --requirements <path>    path/to/requirements.txt file +-k, --keep                   preserve environment +-s, --standalone             generate standalone activation function +-f, --freeze                 freeze/resolve all dependencies +-o, --output <path>          path/to/output file +-b, --bin <bin>              console_script/script to invoke + + + + diff --git a/viv.py b/viv.py index d1369ab..7a22508 100644 --- a/viv.py +++ b/viv.py @@ -50,7 +50,7 @@ from typing import ( from urllib.error import HTTPError from urllib.request import urlopen -__version__ = "23.5a4-15-gdf54955-dev" +__version__ = "23.5a4-21-gf5c91fe-dev" class Config: