For using wenv, you need to install Wine first. Depending on your platform, there are different ways of doing that.
- Installation instructions for various Linux distributions
- Installation instructions for Mac OS X
- Installation instructions for FreeBSD
Currently, Wine >= 4.x is supported (tested). If you are limited to an older version of Wine such as 2.x or 3.x, you have one option: Try to set the
pythonversion configuration parameter to
The latest stable release version can be installed with pip:
pip install wenv
If you are interested in testing the latest work from the development branch, you can try it like this:
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
If you are relying on wenv, please notice that it uses semantic versioning. Breaking changes are indicated by increasing the first version number, the major version. Going for example from 0.0.x to 1.0.0 or going from 0.1.y to 1.0.0 therefore indicates a breaking change.
OSError: [WinError 6] Invalid handle¶
On older versions of Linux such as Ubuntu 14.04 alias Trusty Tahr (released 2014), you may observe errors when running
wenv python. Most commonly, they will present themselves as
OSError: [WinError 6] Invalid handle: 'z:\\... triggered by calling
os.listdir on a symbolic link (“symlink”) to a folder.
A clean solution is to upgrade to a younger version of Linux. E.g. Ubuntu 16.04 alias Xenial Xerus (released 2016) is known to work.