Commands

This chapter covers the main modes of usage of wenv.

wenv init

If you have not initialized wenv before, you must initialize the Wine Python environment first by running wenv init. This will configure Wine, install a Windows version of Python and fetch pip.

wenv clean

This command is useful if you want to remove your current Wine Python environment and all related data (including the relevant Wine prefix). wenv’s configuration is left untouched.

wenv help

This command provides help and lists all currently available sub-commands (such as init or python).

wenv python

This command behaves just like the regular python command in a Unix shell, except that it fires up a Windows Python interpreter on top of Wine. It works with all regular parameters and switches, accepts pipes and can be launched in interactive mode.

Note

You can also use it for creating executable Python scripts by adding the following at their top: #!/usr/bin/env _wenv_python. Do not forget chmod +x your_script.py. Notice that there is a difference between the more general wenv python command and its alias _wenv_python, which is meant to be used only with a shebang.

wenv pip

This command behaves just like the regular pip command on Unix, except that it attempts to install Python packages into a dedicated Python environment under Wine. So if you need any specific packages in wenv python, this is how you install them. Most packages written in pure Python should work just fine. Anything requiring a compiler during installation does not work. Packages / wheels with pre-compiled binary components in them might work, although this is largely untested territory. Feel free to report any (positive or negative) results.

wenv {*}

wenv will automatically detect commands installed in the present environment, e.g. by third-party Python packages. Installing pytest (wenv pip install pytest) for instance will make it available via wenv pytest. It will also be listed in the output of wenv help.

wenv init_coverage

This command enables coverage analysis across the entire Wine Python environment. The coverage package must have been installed before running this command.

wenv version

Shows the version of wenv. Can also be used as follows: wenv --version.