Skip to content

Commit 808cf30

Browse files
committed
Add instructions for contributors
1 parent 86b544b commit 808cf30

File tree

3 files changed

+52
-0
lines changed

3 files changed

+52
-0
lines changed

CONTRIBUTING.rst

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
Contributing
2+
============
3+
4+
If you want to improve the code base, add a feature or update the
5+
documentation please open a `pull request`_. Feel free to `open an issue`_
6+
beforehand to discuss your plans.
7+
8+
.. _pull request: https://github.com/painless-software/python-cli-test-helpers/pulls
9+
.. _open an issue: https://github.com/painless-software/python-cli-test-helpers/issues
10+
11+
Development
12+
-----------
13+
14+
This project uses Tox to run its test suite. Install it using Pip like this:
15+
16+
.. code-block:: shell
17+
18+
python3 -m pip install tox
19+
20+
Alternatively, if you use `uv`_, install Tox as a development tool like this:
21+
22+
.. code-block:: shell
23+
24+
uv tool install tox --with tox-uv
25+
26+
Usage:
27+
28+
.. code-block:: shell
29+
30+
tox list # list available environments
31+
tox -e py # run tests with local default Python
32+
tox -e lint,format # run a few environments
33+
tox # run entire suite
34+
35+
.. _uv: https://docs.astral.sh/uv/
36+
37+
Documentation
38+
-------------
39+
40+
Build the documentation locally and view it in your Web browser:
41+
42+
.. code-block:: console
43+
44+
$ tox -e clean,docs
45+
...
46+
$ cd docs/_build/html/
47+
$ python -m http.server
48+
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...
49+
50+
Click on the displayed link to inspect the generated documentation.

docs/contributing.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.. include:: ../CONTRIBUTING.rst

docs/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ Contents
1111
tutorial
1212
other
1313
techniques
14+
contributing
1415

1516
Quotes
1617
------

0 commit comments

Comments
 (0)