# Venv-Pack
This is based on [venv-pack](https://github.com/jcrist/venv-pack) but with lots of improvements added by
[mrmathematica](https://github.com/mrmathematica/). It has Windows support. Bin/Scripts generated by venv will
work out-of-box.
Venv-pack is a command-line tool for packaging virtual environments for distribution. This is useful for deploying code
in a consistent environment.
Supports virtual environments created using python3/venv. Venv is part of the python standard library.
## Install from source
venv-pack is available on github and can always be installed from source.
```
pip install git+https://github.com/mrmathematica/venv-pack.git
```
## Install from pypi
venv-pack is available on pypi as `venv-pack2`.
```
pip install venv-pack2
```
## Command-line Usage
One common use case is packing an environment on one machine to distribute to other machines as part of a deployment
process.
### On the source machine
Create venv, and then upgrade pip + setuptools first:
```
python -m venv venv
venv\Scripts\activate
python -m pip install -U pip setuptools
```
Python generates Windows .exe file such as pip.exe on the fly, so on Windows there is restriction that you want to fix a
version of pip and setuptools at the beginning and stick with it. If needed, re-create new venv from a lock file. See
[pip-tools](https://github.com/jazzband/pip-tools).
Install all your python packages, for example
```
pip install -r requirements.txt
```
Pack the current environment into my_env.zip
```
venv-pack -o env.zip
```
Pack an environment located at an explicit path into my_env.zip
```
venv-pack -p explicit\path\to\env -o env.zip
```
### On the target machine
Unpack environment into directory `my_env`
```
md my_env
python -m zipfile -e venv.zip my_env\
```
All features of venv should keep working from my_env folder.
Raw data
{
"_id": null,
"home_page": "https://github.com/mrmathematica/venv-pack",
"name": "venv-pack2",
"maintainer": "mrmathematica",
"docs_url": null,
"requires_python": "",
"maintainer_email": "mrmathematica@yahoo.com",
"keywords": "venv packaging",
"author": "",
"author_email": "",
"download_url": "",
"platform": null,
"description": "# Venv-Pack\n\nThis is based on [venv-pack](https://github.com/jcrist/venv-pack) but with lots of improvements added by\n[mrmathematica](https://github.com/mrmathematica/). It has Windows support. Bin/Scripts generated by venv will\nwork out-of-box.\n\nVenv-pack is a command-line tool for packaging virtual environments for distribution. This is useful for deploying code\nin a consistent environment.\n\nSupports virtual environments created using python3/venv. Venv is part of the python standard library.\n\n## Install from source\n\nvenv-pack is available on github and can always be installed from source.\n\n```\npip install git+https://github.com/mrmathematica/venv-pack.git\n```\n\n## Install from pypi\n\nvenv-pack is available on pypi as `venv-pack2`.\n\n```\npip install venv-pack2\n```\n\n## Command-line Usage\n\nOne common use case is packing an environment on one machine to distribute to other machines as part of a deployment\nprocess.\n\n### On the source machine\n\nCreate venv, and then upgrade pip + setuptools first:\n```\npython -m venv venv\nvenv\\Scripts\\activate\npython -m pip install -U pip setuptools\n```\n\nPython generates Windows .exe file such as pip.exe on the fly, so on Windows there is restriction that you want to fix a\nversion of pip and setuptools at the beginning and stick with it. If needed, re-create new venv from a lock file. See\n[pip-tools](https://github.com/jazzband/pip-tools). \n\nInstall all your python packages, for example\n```\npip install -r requirements.txt\n```\n\nPack the current environment into my_env.zip\n```\nvenv-pack -o env.zip\n```\n\nPack an environment located at an explicit path into my_env.zip\n```\nvenv-pack -p explicit\\path\\to\\env -o env.zip \n```\n\n### On the target machine\n\nUnpack environment into directory `my_env`\n```\nmd my_env\npython -m zipfile -e venv.zip my_env\\ \n```\n\nAll features of venv should keep working from my_env folder. \n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Package virtual environments for redistribution",
"version": "0.7.0",
"project_urls": {
"Homepage": "https://github.com/mrmathematica/venv-pack",
"Source Code": "https://github.com/mrmathematica/venv-pack"
},
"split_keywords": [
"venv",
"packaging"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad7598c37aae6e541ebfe2987ac5492f5dcadbb36d85f50376267d88242e8915",
"md5": "a5748014aa3ce5d7480991d4445668f9",
"sha256": "8e797d12213c0e81a79e666c73651d190d170c87b7636ce6b502899ccf20a4cf"
},
"downloads": -1,
"filename": "venv_pack2-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a5748014aa3ce5d7480991d4445668f9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 21623,
"upload_time": "2023-09-28T20:30:54",
"upload_time_iso_8601": "2023-09-28T20:30:54.147907Z",
"url": "https://files.pythonhosted.org/packages/ad/75/98c37aae6e541ebfe2987ac5492f5dcadbb36d85f50376267d88242e8915/venv_pack2-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-28 20:30:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mrmathematica",
"github_project": "venv-pack",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"lcname": "venv-pack2"
}
JSON
