123 lines
3.4 KiB
Plaintext
123 lines
3.4 KiB
Plaintext
==============
|
|
Downloading
|
|
==============
|
|
|
|
.. _`PyPI project page`: http://pypi.python.org/pypi/py/
|
|
|
|
Latest Release, see `PyPI project page`_
|
|
|
|
using setuptools / easy_install
|
|
===================================================
|
|
|
|
With a working `setuptools installation`_ you can type::
|
|
|
|
easy_install -U py
|
|
|
|
to get the latest release of the py lib. The ``-U`` switch
|
|
will trigger an upgrade if you already have an older version installed.
|
|
The py lib and its tools are expected to work well on Linux,
|
|
Windows and OSX, Python versions 2.3, 2.4, 2.5 and 2.6.
|
|
|
|
We provide binary eggs for Windows machines.
|
|
|
|
On other systems you need a working C-compiler in order to
|
|
install the full py lib. If you don't have a compiler available
|
|
you can still install the py lib but without greenlets - look
|
|
below for the ``install_lib`` target.
|
|
|
|
**IMPORTANT NOTE**: if you are using Windows and have
|
|
0.8 versions of the py lib on your system, please download
|
|
and execute http://codespeak.net/svn/py/build/winpathclean.py
|
|
This will check that no previous files are getting in the way.
|
|
You can find out the py lib version with::
|
|
|
|
import py
|
|
print py.version
|
|
|
|
|
|
.. _`checkout`:
|
|
|
|
Installing from version control / develop mode
|
|
=================================================
|
|
|
|
To follow development or help with fixing things
|
|
for the next release, checkout the complete code
|
|
and documentation source with mercurial_::
|
|
|
|
hg clone https://bitbucket.org/hpk42/py-trunk/
|
|
|
|
With a working `setuptools installation`_ you can then issue::
|
|
|
|
python setup.py develop
|
|
|
|
in order to work with your checkout version.
|
|
|
|
.. _mercurial: http://mercurial.selenic.com/wiki/
|
|
|
|
Working without setuptools / from source
|
|
==========================================
|
|
|
|
If you have a checkout_ or a tarball_ it is actually not neccessary to issue
|
|
``setup.py`` commands in order to use py lib and its tools. You can
|
|
simply add the root directory to ``PYTHONPATH`` and ``py/bin`` or
|
|
``py\bin\win32`` to your ``PATH`` settings.
|
|
|
|
There are also helper scripts to set the environment
|
|
on windows::
|
|
|
|
c:\\path\to\checkout\py\env.cmd
|
|
|
|
and on linux/osx you can add something like this to
|
|
your shell initialization::
|
|
|
|
eval `python ~/path/to/checkout/py/env.py`
|
|
|
|
both of which which will get you good settings
|
|
for ``PYTHONPATH`` and ``PATH``.
|
|
|
|
Note also that the command line scripts will look
|
|
for "nearby" py libs, so if you have a layout like this::
|
|
|
|
mypkg/
|
|
subpkg1/
|
|
tests/
|
|
tests/
|
|
py/
|
|
|
|
then issuing ``py.test subpkg1`` will use the py lib
|
|
from that projects root directory.
|
|
|
|
Debian and RPM packages
|
|
===================================
|
|
|
|
As of July 2009 pytest/pylib 1.0 RPMs and Debian packages
|
|
are not yet available. So you will only find older
|
|
versions.
|
|
|
|
On Debian systems look for ``python-codespeak-lib``.
|
|
*But this package is probably outdated - if somebody
|
|
can help with bringing this up to date,
|
|
that would be very much appreciated.*
|
|
|
|
Dwayne Bailey has thankfully put together a Fedora `RPM`_.
|
|
|
|
.. _`RPM`: http://translate.sourceforge.net/releases/testing/fedora/pylib-0.9.2-1.fc9.noarch.rpm
|
|
|
|
.. _`setuptools installation`: http://pypi.python.org/pypi/setuptools
|
|
|
|
.. _tarball:
|
|
|
|
Installing from a TAR archive
|
|
===================================================
|
|
|
|
You need a working `setuptools installation`_.
|
|
|
|
Go to the python package index (pypi) and download a tar file:
|
|
|
|
http://pypi.python.org/pypi/py/
|
|
|
|
and unpack it to a directory, where you then type::
|
|
|
|
python setup.py install
|
|
|