
installation info in a nutshell
*******************************

**PyPI name**: py

**Pythons**: 2.5, 2.6, 2.7, 3.2, 3.3, Jython-2.5.1, PyPy-2.0

**Operating systems**: Linux, Windows, OSX, Unix

**Requirements**: setuptools or Distribute

**Installers**: "easy_install" and "pip"

**hg repository**: https://bitbucket.org/hpk42/py


easy install or pip "py"
========================

Both Distribute and setuptools provide the "easy_install" installation
tool with which you can type into a command line window:

   easy_install -U py

to install the latest release of the py lib.  The "-U" switch will
trigger an upgrade if you already have an older version installed.

Note: As of version 1.4 py does not contain py.test anymore - you need to
  install the new >>`pytest`_<< distribution.


Working from version control or a tarball
=========================================

To follow development or start experiments, checkout the complete code
and documentation source with mercurial:

   hg clone https://bitbucket.org/hpk42/py

Development takes place on the 'trunk' branch.

You can also go to the python package index and download and unpack a
TAR file:

   http://pypi.python.org/pypi/py/


activating a checkout with setuptools
=====================================

With a working Distribute or setuptools installation you can type:

   python setup.py develop

in order to work inline with the tools and the lib of your checkout.


Mailing list and issue tracker
==============================

* py-dev developers list and commit mailing list.

* #pylib on irc.freenode.net IRC channel for random questions.

* bitbucket issue tracker use this bitbucket issue tracker to report
  bugs or request features.
