pywin 0.3.1

easy_install

easy_install pywin

pip

pip install pywin

from source

git clone git://github.com/davidmarble/pywin.git
cd pywin
python setup.py install

Auto-generate version-specific launchers

pywin can create individual launch scripts to directly access core python installations (e.g. python2.7). These can be called directly with or without arguments from the Windows command prompt and MSYS/MINGW bash prompt. To use this feature, call

pywin genlaunchers

Launchers are created for all machine-wide and user-specific python installations found in the Windows registry. Windows batch files will be added to the directory where pywin is located. MSYS/MINGW32 relies on Windows links created programmatically with mklink, which is why you must have Windows >= Vista installed to make use of this project.

Launch a specific python version using pywin

pywin -2.7  # launch python 2.7
pywin -3.2 test.py  # launch test.py with python 3.2

Automatically invoke the right python with a script header

Add a directive to the first or second line of a source file to have the correct interpreter called. Currently this only supports python launchers created by the pywin genlaunchers command. To use this feature, you must associate the .py extension with pywin.bat using the included pyassoc utility.

pyassoc

genlaunchers

pywin genlaunchers

Search for python installations and create batch files in the same directory where pywin is installed.

Note if you’re using MSYS/MINGW32 this must be run again in the MSYS/MINGW32 shell, and you must have Windows >= Vista.

setdefault

pywin setdefault <version>

Set the default python to <major>.<minor> version. Adds the right python home directory and its associated Scripts directory to the front of PATH. Removes any other existing reference to a python Scripts directory in PATH.

Example

# Existing PATH: C:\Windows\System32;C:\Windows;C:\Python27;C:\Python27\Scripts

pywin setdefault 3.3

# New PATH: C:\Python33;C:\Python33\Scripts;C:\Windows\System32;C:\Windows;C:\Python27;
# C:\Python27 is preserved so that pywin can be found.

pywin setdefault is only active for the current cmd.exe (or MSYS/MINGW32 shell) session. If you want to change the default python permanently, you need to change your system or user PATH and make sure pywin is installed for that python version.

When calling this from MSYS/MINGW32, enter a dot first so the changes to $PATH propagate to your active shell. E.g. . pywin setdefault 3.3

launch with version and/or source

pywin [-<version>] [<source file>]

Launch either a specific <major>.<minor> version of python, or a source file, or both. Note that specifying a version of python on the command line will override any version in the header of the source file.

Example

# launch python 2.7
pywin -2.7

# launch test.py with python 3.2
pywin -3.2 test.py

# launch test.py according to Version Search Order below
pywin test.py

Version Search Order

pywin will launch the first version of python found among:

1. Any version specified after a #! in the first 2 lines of the source. The interpreter will be invoked with any additional parameters.

   examples:

   #! python3.3
   #! /usr/bin/python2.7 -v

2. If the environment variable VIRTUAL_ENV is set, use that virtualenv’s python.exe.

3. If the environment variable PYTHONHOME is set, use its python.exe.

4. If none of the above, fall back to the first python.exe found on the path.

Parameters

• original - restore .py registry settings to launch with %pyhome%\python.exe

• all_users - if administrator, apply changes to HKEY_LOCAL_MACHINE and remove any HKEY_CURRENT_USER python keys. Note that users can override this with their own HKEY_CURRENT_USER values.

%pyhome%

The variable %pyhome% used by pyassoc is set in this manner:

1. If the environment variable PYTHONHOME is set, use it.

2. If the environment variable DEFAULTPYTHON is set, use it. This is set when you call pywin setdefault <version>, but only lasts for the current session.

3. The path the pyassoc.bat script is in.