wenv 0.5.1

Description:

wenv 0.5.1

wenv - Running Python on Wine








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): 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
3.x (tested with 3.{7,8,9,10})


Wine
>= 6.x (tested with regular & staging) - expected to be in the user's PATH



Installation



branch
status
installation
documentation




master (release)

pip install wenv



develop

pip install git+https://github.com/pleiszenburg/wenv.git@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:
(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.
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 in the documentation.
Need help?
See section on Getting Help on wenv's documentation.
Bugs & Issues
See section on Bugs and Issues on wenv's documentation.
Miscellaneous

Full project documentation

at Read the Docs
at wenv repository


Authors
Change log (current) (changes in development branch since last release)
Change log (past) (release history)
Contributing (Contributions are highly welcomed!)
FAQ
License (LGPL v2.1)
Upstream issues (relevant bugs in dependencies)