summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/tools/py/doc/install.txt
blob: d0e981def452a2da398eec1b35aad3ec3cc0ba52 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

.. _`py`:
.. _`index page`: http://pypi.python.org/pypi/py/

installation info in a nutshell
===================================================

**PyPI name**: py_

**Pythons**: CPython 2.6, 2.7, 3.3, 3.4, PyPy-2.3

**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.

.. _pytest: http://pytest.org

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.

.. _`no-setuptools`:

.. _`directly use a checkout`:

.. _`setuptools`: http://pypi.python.org/pypi/setuptools


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.

.. _`bitbucket issue tracker`: http://bitbucket.org/hpk42/py/issues/

.. _codespeak: http://codespeak.net/
.. _`py-dev`:
.. _`development mailing list`:
.. _`py-dev developers list`: http://codespeak.net/mailman/listinfo/py-dev
.. _`py-svn`:
.. _`commit mailing list`: http://codespeak.net/mailman/listinfo/py-svn

.. include:: links.inc