Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install pychoose

How to install pychoose

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install pychoose
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.1.4 Available View build log
0.1.4 Available View build log
Windows (64-bit)
0.1.4 Available View build log
0.1.4 Available View build log
Mac OS X (10.5+)
0.1.4 Failed View build log
0.1.4 Failed View build log
Linux (32-bit)
0.1.4 Failed View build log
0.1.4 Failed View build log
Linux (64-bit)
0.1.4 Failed View build log
0.1.4 Failed View build log
0.1.4 Failed View build log
Lastest release
version 0.1.4 on Jan 5th, 2011

System Message: ERROR/3 (<string>, line 1)

Content block expected for the "line-block" directive; none found.

.. line-block::

PyPI: http://pypi.python.org/pypi/pychoose SVN: http://code.google.com/p/pychoose/


From the Windows command-line, run:

System Message: WARNING/2 (<string>, line 12)

Literal block expected; none found.

pychoose XY

This will make Python version X.Y active, if it is installed, for subsequent commands from the same prompt. The change is local to this shell.

The prompt is modified to indicate the modified environment.

To revert to the previously used version of Python, type 'exit'

This works by starting a new Cmd shell with a modified PATH, by prepending C:\PythonXY and its subdirectories, and importantly by removing any other C:\PythonZZ directories and subdirectories.

Multiple invocations of pychoose can be nested.


MS Windows.

Python itself: Can be used to switch TO any version of Python at all (and then back again with 'exit'.) However, the version of Python you are switching FROM must be from 2.4 to 3.1.

No other dependencies.


Windows users may download and double-click a graphical installer from http://pypi.python.org/pypi/pychoose.

Command-line jockeys with setuptools installed may use:

easy_install pychoose

or, if pip is installed:

pip install pychoose

or download a zip of the source from http://pypi.python.org/pypi/pychoose and use:

python setup.py install

Alternatively, to check out the latest unstable source from subversion, including tests, see:


Experiment on WindowsXP shows that pychoose only needs to be installed once, on your default version of Python, not on all installed versions of Python. After running pychoose, it is no longer on your PATH, however the pychoose.bat file is still found by future invocations - presumably all shells have a shared cache of executable locations, or somesuch.

Known Problems

Only works on Windows. Not in a Cygwin shell, nor if Cygwin Python is first on your path, nor on other platforms.

Should get the install dirs of various Python versions from the registry, insted of assuming they are all variations on C:\PythonXX.

Would be much more reliable if we allow the user to pass the directory of the Python version to switch to, instead of trying to be clever and figure it out ourselves.

Can't switch from versions of Python prior to 2.4, since we use 'subprocess' to launch the new shell.

Doesn't affect Windows .py filetype associations. Perhaps this could be tackled by inserting an environment variable into the registry keys, set the env var in the registry (to persist its default value) and then change that value temporarily and locally in this script.

Haven't tested how it interacts with virtualenv.

Currently adds all subdirectories of PythonXX to the PATH. This is probably overkill. Can we filter out desired subdirectories with any reliability?


Pychoose is distributed under the BSD license. Live long and prosper.

Subscribe to package updates

Last updated Jan 5th, 2011

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.