# Pyromania venv Manager
Pyromania helps make venv management straightforward, inspired by `virtualenvwrapper`. By default, Pyromania will create a venv named `venv` in the current directory, and:
* Install the latest versions of `pip` and `wheel`.
* Includes handy options for switching to the `site-packages` folder.
* Creates pre and post activation hook scripts for additional customization.
* Activating your `venv` will automagically move to your project directory with a default pre-activation hook.
## System Wide Installation
To install the `pyro` command for all users on your system with sudo escalation:
```bash
curl -sS https://raw.githubusercontent.com/FlipperPA/pyromania/main/install-sudo.sh | sh
```
[An Ansible role for installation is also available.](https://github.com/FlipperPA/pyromania/tree/main/ansible-role-install)
## User Installation
To install the `pyro` command for the current user only:
```bash
curl -sS https://raw.githubusercontent.com/FlipperPA/pyromania/main/install.sh | sh
```
## Usage
**Options:**
* `--help`, `-h`: Display the help menu.
* `--delete`, `-d`: Delete the venv.
* `--create`, `-c`: Create the venv without prompting.
* `--packages` `-p`: Change to the venv's site-packages directory.
**Examples:**
* `pyro`: Lists the venvs currently managed by pyromania.
* `pyro my_venv`: Activate a venv called `my_venv`, or prompts to create it if it doesn't exist.
* `pyro my_venv -c`: Creates a venv called `my_venv` without prompting.
* `pyro my_venv --delete`: Deletes a venv called `my_venv`.
* `pyro my_venv -p`: Change to to the venv's site-packages directory.
## Settings
* `VENV_DIR` (default: `venv`): default venv directory name.
* `VENV_PYTHON` (default: `python3`): the default version of Python to include.
## Pre and Post Activation Hooks
Pyromania will create two hook files in your `venv` which can be modified for pre and post activation actions:
* `venv/pre_activate.sh`: script is run before the `venv` is activated.
* `venv/post_activate.sh`: script is run after the `venv` is activated.
Raw data
{
"_id": null,
"home_page": "",
"name": "pyromania",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.3",
"maintainer_email": "",
"keywords": "venv,virtualenv,virtual environment,docker,container",
"author": "",
"author_email": "Tim Allen <tallen@wharton.upenn.edu>",
"download_url": "https://files.pythonhosted.org/packages/36/06/248c6d8fcf4b850b306546ea286439b40783631878f3d21e4cb49c8cda8d/pyromania-1.0.0.dev4.tar.gz",
"platform": null,
"description": "# Pyromania venv Manager\n\nPyromania helps make venv management straightforward, inspired by `virtualenvwrapper`. By default, Pyromania will create a venv named `venv` in the current directory, and:\n\n* Install the latest versions of `pip` and `wheel`.\n* Includes handy options for switching to the `site-packages` folder.\n* Creates pre and post activation hook scripts for additional customization.\n* Activating your `venv` will automagically move to your project directory with a default pre-activation hook.\n\n## System Wide Installation\n\nTo install the `pyro` command for all users on your system with sudo escalation:\n\n```bash\ncurl -sS https://raw.githubusercontent.com/FlipperPA/pyromania/main/install-sudo.sh | sh\n```\n\n[An Ansible role for installation is also available.](https://github.com/FlipperPA/pyromania/tree/main/ansible-role-install)\n\n## User Installation\n\nTo install the `pyro` command for the current user only:\n\n```bash\ncurl -sS https://raw.githubusercontent.com/FlipperPA/pyromania/main/install.sh | sh\n```\n\n## Usage\n\n**Options:**\n\n* `--help`, `-h`: Display the help menu.\n* `--delete`, `-d`: Delete the venv.\n* `--create`, `-c`: Create the venv without prompting.\n* `--packages` `-p`: Change to the venv's site-packages directory.\n\n**Examples:**\n\n* `pyro`: Lists the venvs currently managed by pyromania.\n* `pyro my_venv`: Activate a venv called `my_venv`, or prompts to create it if it doesn't exist.\n* `pyro my_venv -c`: Creates a venv called `my_venv` without prompting.\n* `pyro my_venv --delete`: Deletes a venv called `my_venv`.\n* `pyro my_venv -p`: Change to to the venv's site-packages directory.\n\n## Settings\n\n* `VENV_DIR` (default: `venv`): default venv directory name.\n* `VENV_PYTHON` (default: `python3`): the default version of Python to include.\n\n## Pre and Post Activation Hooks\n\nPyromania will create two hook files in your `venv` which can be modified for pre and post activation actions:\n\n* `venv/pre_activate.sh`: script is run before the `venv` is activated.\n* `venv/post_activate.sh`: script is run after the `venv` is activated.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Pyromania creates and manages Python 3 venvs, inspired by virtualenvwrapper.",
"version": "1.0.0.dev4",
"split_keywords": [
"venv",
"virtualenv",
"virtual environment",
"docker",
"container"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d4866cc8e65bd810c6e42a11eab6b92cb0cea4e38e254b049875dee468fc8722",
"md5": "5c98d0779caf9b1d424601683f19553e",
"sha256": "ab2c736e2b2c560d5a06aab3a47174153684bc6249f506ecf2f83d28da0f65a9"
},
"downloads": -1,
"filename": "pyromania-1.0.0.dev4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c98d0779caf9b1d424601683f19553e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.3",
"size": 2228,
"upload_time": "2023-04-03T14:54:46",
"upload_time_iso_8601": "2023-04-03T14:54:46.041091Z",
"url": "https://files.pythonhosted.org/packages/d4/86/6cc8e65bd810c6e42a11eab6b92cb0cea4e38e254b049875dee468fc8722/pyromania-1.0.0.dev4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3606248c6d8fcf4b850b306546ea286439b40783631878f3d21e4cb49c8cda8d",
"md5": "9ba0ff80623562920c16355ffc739413",
"sha256": "b39c62bfe5ba54f44606ed477b4b671e1a7961b153d7ecda6059510ec5b36a99"
},
"downloads": -1,
"filename": "pyromania-1.0.0.dev4.tar.gz",
"has_sig": false,
"md5_digest": "9ba0ff80623562920c16355ffc739413",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.3",
"size": 7039,
"upload_time": "2023-04-03T14:54:47",
"upload_time_iso_8601": "2023-04-03T14:54:47.571169Z",
"url": "https://files.pythonhosted.org/packages/36/06/248c6d8fcf4b850b306546ea286439b40783631878f3d21e4cb49c8cda8d/pyromania-1.0.0.dev4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-03 14:54:47",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "pyromania"
}
JSON