| Name | wenv JSON |
| Version |
0.5.1
JSON |
| download |
| home_page | |
| Summary | Running Python on Wine |
| upload_time | 2022-12-26 22:06:46 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.7 |
| license | |
| keywords |
wine
cross platform
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# wenv - Running Python on Wine
[](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml)
[](https://wenv.readthedocs.io/en/latest/)
[](https://github.com/pleiszenburg/wenv/blob/master/LICENSE)
[](https://github.com/pleiszenburg/wenv/issues)
[](https://pypi.python.org/pypi/wenv)
[](https://pypi.python.org/pypi/wenv)
[](https://matrix.to/#/#zugbruecke:matrix.org)
[](https://groups.io/g/zugbruecke-dev)
## Synopsis
**wenv** is a **Python package** (currently in development **status 4/beta**). It allows to **run Python on top of Wine** on Linux, MacOS or BSD. It handles required plumbing related to making Python and a number of Python modules work on Wine. `wenv` creates isolated virtual environments which can be transparently used from a Unix command line and which seamlessly integrate into Unix Python virtual environments.
About Wine (from [winehq.org](https://www.winehq.org/)): *Wine (originally an acronym for "Wine Is Not an Emulator") is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, MacOS and BSD. Instead of simulating internal Windows logic like a virtual machine or emulator, Wine translates Windows API calls into POSIX calls on-the-fly, eliminating the performance and memory penalties of other methods and allowing you to cleanly integrate Windows applications into your desktop.*
**This project is NEITHER associated NOR affiliated in any way or form with the Wine project.**
## Prerequisites
| prerequisite | version |
| --- | --- |
| [CPython](https://www.python.org/) | 3.x (tested with 3.{7,8,9,10}) |
| [Wine](https://www.winehq.org/) | >= 6.x (tested with regular & [staging](https://wine-staging.com/)) - expected to be in the user's [`PATH`](https://en.wikipedia.org/wiki/PATH_(variable)) |
## Installation
| branch | status | installation | documentation |
| --- | --- | --- | --- |
| master (release) | [](https://github.com/pleiszenburg/wenv/tree/master) | `pip install wenv` | [](https://wenv.readthedocs.io/en/latest/) |
| develop | [](https://github.com/pleiszenburg/wenv/tree/develop) | `pip install git+https://github.com/pleiszenburg/wenv.git@develop` | [](https://wenv.readthedocs.io/en/develop/) |
After installing the package with `pip`, you must initialize the *Wine Python environment* by running `wenv init`.
## Examples
Fire up a shell and try the following:
```bash
(env) user@comp:~> uname
Linux
(env) user@comp:~> python -m platform
Linux
(env) user@comp:~> wenv python -m platform
Windows
```
`wenv pip` works just like one would expect. Have a look at the output of `wenv help` for more commands and information. For use as a shebang, `wenv python` has an alias: One can write `#!/usr/bin/env _wenv_python` at the top of scripts.
``wenv python`` can also be used as a **Jupyter kernel**, side-by-side with a Unix-version of Python. Have a look at the [wenv-kernel project](https://github.com/pleiszenburg/wenv-kernel).
## Security
Just like Wine, `wenv` can run malicious Windows software on Unix. **Never, ever, run `wenv` with root / super users privileges!** For details, check the section on [security](https://wenv.readthedocs.io/en/stable/security.html) in the documentation.
## Need help?
See section on [Getting Help](https://wenv.readthedocs.io/en/latest/support.html) on `wenv`'s documentation.
## Bugs & Issues
See section on [Bugs and Issues](https://wenv.readthedocs.io/en/stable/bugs.html) on `wenv`'s documentation.
## Miscellaneous
- Full project documentation
- at [Read the Docs](https://wenv.readthedocs.io/en/latest/)
- at [`wenv` repository](https://github.com/pleiszenburg/wenv/blob/master/docs/source/index.rst)
- [Authors](https://github.com/pleiszenburg/wenv/blob/master/AUTHORS.md)
- [Change log (current)](https://github.com/pleiszenburg/wenv/blob/develop/CHANGES.md) (changes in development branch since last release)
- [Change log (past)](https://github.com/pleiszenburg/wenv/blob/master/CHANGES.md) (release history)
- [Contributing](https://github.com/pleiszenburg/wenv/blob/master/CONTRIBUTING.md) (**Contributions are highly welcomed!**)
- [FAQ](https://wenv.readthedocs.io/en/stable/faq.html)
- [License](https://github.com/pleiszenburg/wenv/blob/master/LICENSE) (**LGPL v2.1**)
- [Upstream issues](https://github.com/pleiszenburg/wenv/issues?q=is%3Aissue+is%3Aopen+label%3Aupstream) (relevant bugs in dependencies)
Raw data
{
"_id": null,
"home_page": "",
"name": "wenv",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "\"Sebastian M. Ernst\" <ernst@pleiszenburg.de>",
"keywords": "wine,cross platform",
"author": "",
"author_email": "\"Sebastian M. Ernst\" <ernst@pleiszenburg.de>",
"download_url": "https://files.pythonhosted.org/packages/db/9c/913ae45ca54b9d5843be07a4b6bf6dc1dafa979b93f0a3dd797715765ef0/wenv-0.5.1.tar.gz",
"platform": null,
"description": "![wenv](docs/source/_static/logo.png \"wenv logo\")\n\n# wenv - Running Python on Wine\n\n[![build_master](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml/badge.svg?branch=master \"Build Status: master / release\")](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml)\n[![docs_master](https://readthedocs.org/projects/wenv/badge/?version=latest&style=flat-square \"Documentation Status: master / release\")](https://wenv.readthedocs.io/en/latest/)\n[![license](https://img.shields.io/pypi/l/wenv.svg?style=flat-square \"GNU Lesser General Public License v2.1\")](https://github.com/pleiszenburg/wenv/blob/master/LICENSE)\n[![status](https://img.shields.io/pypi/status/wenv.svg?style=flat-square \"Project Development Status\")](https://github.com/pleiszenburg/wenv/issues)\n[![pypi_version](https://img.shields.io/pypi/v/wenv.svg?style=flat-square \"Project Development Status\")](https://pypi.python.org/pypi/wenv)\n[![pypi_versions](https://img.shields.io/pypi/pyversions/wenv.svg?style=flat-square \"Available on PyPi - the Python Package Index\")](https://pypi.python.org/pypi/wenv)\n[![chat](https://img.shields.io/matrix/zugbruecke:matrix.org.svg?style=flat-square \"Matrix Chat Room\")](https://matrix.to/#/#zugbruecke:matrix.org)\n[![mailing_list](https://img.shields.io/badge/mailing%20list-groups.io-8cbcd1.svg?style=flat-square \"Mailing List\")](https://groups.io/g/zugbruecke-dev)\n\n## Synopsis\n\n**wenv** is a **Python package** (currently in development **status 4/beta**). It allows to **run Python on top of Wine** on Linux, MacOS or BSD. It handles required plumbing related to making Python and a number of Python modules work on Wine. `wenv` creates isolated virtual environments which can be transparently used from a Unix command line and which seamlessly integrate into Unix Python virtual environments.\n\nAbout Wine (from [winehq.org](https://www.winehq.org/)): *Wine (originally an acronym for \"Wine Is Not an Emulator\") is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, MacOS and BSD. Instead of simulating internal Windows logic like a virtual machine or emulator, Wine translates Windows API calls into POSIX calls on-the-fly, eliminating the performance and memory penalties of other methods and allowing you to cleanly integrate Windows applications into your desktop.*\n\n**This project is NEITHER associated NOR affiliated in any way or form with the Wine project.**\n\n## Prerequisites\n\n| prerequisite | version |\n| --- | --- |\n| [CPython](https://www.python.org/) | 3.x (tested with 3.{7,8,9,10}) |\n| [Wine](https://www.winehq.org/) | >= 6.x (tested with regular & [staging](https://wine-staging.com/)) - expected to be in the user's [`PATH`](https://en.wikipedia.org/wiki/PATH_(variable)) |\n\n## Installation\n\n| branch | status | installation | documentation |\n| --- | --- | --- | --- |\n| master (release) | [![build_master](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml/badge.svg?branch=master \"Build Status: master / release\")](https://github.com/pleiszenburg/wenv/tree/master) | `pip install wenv` | [![docs_master](https://readthedocs.org/projects/wenv/badge/?version=latest&style=flat-square \"Documentation Status: master / release\")](https://wenv.readthedocs.io/en/latest/) |\n| develop | [![build_develop](https://github.com/pleiszenburg/wenv/actions/workflows/test.yaml/badge.svg?branch=develop \"Build Status: development branch\")](https://github.com/pleiszenburg/wenv/tree/develop) | `pip install git+https://github.com/pleiszenburg/wenv.git@develop` | [![docs_develop](https://readthedocs.org/projects/wenv/badge/?version=develop&style=flat-square \"Documentation Status: development branch\")](https://wenv.readthedocs.io/en/develop/) |\n\nAfter installing the package with `pip`, you must initialize the *Wine Python environment* by running `wenv init`.\n\n## Examples\n\nFire up a shell and try the following:\n\n```bash\n(env) user@comp:~> uname\nLinux\n(env) user@comp:~> python -m platform\nLinux\n(env) user@comp:~> wenv python -m platform\nWindows\n```\n\n`wenv pip` works just like one would expect. Have a look at the output of `wenv help` for more commands and information. For use as a shebang, `wenv python` has an alias: One can write `#!/usr/bin/env _wenv_python` at the top of scripts.\n\n``wenv python`` can also be used as a **Jupyter kernel**, side-by-side with a Unix-version of Python. Have a look at the [wenv-kernel project](https://github.com/pleiszenburg/wenv-kernel).\n\n## Security\n\nJust like Wine, `wenv` can run malicious Windows software on Unix. **Never, ever, run `wenv` with root / super users privileges!** For details, check the section on [security](https://wenv.readthedocs.io/en/stable/security.html) in the documentation.\n\n## Need help?\n\nSee section on [Getting Help](https://wenv.readthedocs.io/en/latest/support.html) on `wenv`'s documentation.\n\n## Bugs & Issues\n\nSee section on [Bugs and Issues](https://wenv.readthedocs.io/en/stable/bugs.html) on `wenv`'s documentation.\n\n## Miscellaneous\n\n- Full project documentation\n - at [Read the Docs](https://wenv.readthedocs.io/en/latest/)\n - at [`wenv` repository](https://github.com/pleiszenburg/wenv/blob/master/docs/source/index.rst)\n- [Authors](https://github.com/pleiszenburg/wenv/blob/master/AUTHORS.md)\n- [Change log (current)](https://github.com/pleiszenburg/wenv/blob/develop/CHANGES.md) (changes in development branch since last release)\n- [Change log (past)](https://github.com/pleiszenburg/wenv/blob/master/CHANGES.md) (release history)\n- [Contributing](https://github.com/pleiszenburg/wenv/blob/master/CONTRIBUTING.md) (**Contributions are highly welcomed!**)\n- [FAQ](https://wenv.readthedocs.io/en/stable/faq.html)\n- [License](https://github.com/pleiszenburg/wenv/blob/master/LICENSE) (**LGPL v2.1**)\n- [Upstream issues](https://github.com/pleiszenburg/wenv/issues?q=is%3Aissue+is%3Aopen+label%3Aupstream) (relevant bugs in dependencies)\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Running Python on Wine",
"version": "0.5.1",
"split_keywords": [
"wine",
"cross platform"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "a367b2c731acda8958774a31e7597e68",
"sha256": "70f27af56cc01bea3607fc11dda1c69b58758ecc9624a1973d9e724c6002baf4"
},
"downloads": -1,
"filename": "wenv-0.5.1-py3-none-any.whl",
"has_sig": true,
"md5_digest": "a367b2c731acda8958774a31e7597e68",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 33428,
"upload_time": "2022-12-26T22:06:42",
"upload_time_iso_8601": "2022-12-26T22:06:42.778570Z",
"url": "https://files.pythonhosted.org/packages/99/c3/5c2b600127fd4df00711f81730acc6d3177658fff7f9cfd6a53549826d45/wenv-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "051ec42b9ff577415ef4f22e3d61bc8f",
"sha256": "f1960b798d6490239b3994acfed24d362f45889d5f6adb186faf08db570a6149"
},
"downloads": -1,
"filename": "wenv-0.5.1.tar.gz",
"has_sig": true,
"md5_digest": "051ec42b9ff577415ef4f22e3d61bc8f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 73645,
"upload_time": "2022-12-26T22:06:46",
"upload_time_iso_8601": "2022-12-26T22:06:46.238986Z",
"url": "https://files.pythonhosted.org/packages/db/9c/913ae45ca54b9d5843be07a4b6bf6dc1dafa979b93f0a3dd797715765ef0/wenv-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-26 22:06:46",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "wenv"
}
