summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/tools/third_party/py/doc/install.txt
blob: 93c79e3b2d8f39261dc0602d85812fb28e5bb136 (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
89
90
91
.. _`py`:
.. _`index page`: https://pypi.org/project/py/

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

**PyPI name**: py_

**Pythons**: CPython 2.7, 3.5, 3.6, 3.7, PyPy-5.4

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

**Requirements**: setuptools_ or Distribute_

**Installers**: ``easy_install`` and ``pip``

**Code repository**: https://github.com/pytest-dev/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::

    git clone https://github.com/pytest-dev/py

Development takes place on the 'master' branch.

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

   https://pypi.org/project/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`: https://pypi.org/project/setuptools/


Mailing list and issue tracker
--------------------------------------

- `py-dev developers list`_ and `commit mailing list`_.

- ``#pytest`` `on irc.libera.chat <ircs://irc.libera.chat:6697/#pytest>`_ IRC
  channel for random questions (using an IRC client, `via webchat
  <https://web.libera.chat/#pytest>`_, or `via Matrix
  <https://matrix.to/#/%23pytest:libera.chat>`_).

- `issue tracker`_ use the issue tracker to report
  bugs or request features.

.. _`issue tracker`: https://github.com/pytest-dev/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