Skip to content

Commit 7a2ee3f

Browse files
committed
Write basic documentation about the primer
1 parent 9e7eca1 commit 7a2ee3f

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

docs/development.rst

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,3 +42,25 @@ To only run a specific test from that directory, for example
4242
.. code-block:: shell
4343
4444
pytest -k multi_line-class_docstring
45+
46+
47+
Primer
48+
-------
49+
50+
To check if any changes create any unforeseen regressions all pull requests are tested
51+
with our primer. This process is heavily inspired on other open source projects and our
52+
own primer is based on the one used by `mypy <http://mypy-lang.org>`_.
53+
54+
You can also run the primer locally with minimal set-up. First you will need to make
55+
a duplicate of your ``pydocstringformatter`` directory in a new ``./program_to_test``
56+
directory. This is required so that the primer can check out multiple versions of the
57+
program and compare the difference.
58+
59+
The next step is to follow the bash script in the ``Run primer`` step in the ``primer``
60+
workflow file, found at ``.github/workflows/primer.yaml``. This should allow you to run
61+
all necessary steps locally.
62+
63+
The final output of the primer run can be found in ``.pydocstringformatter_primer_tests/fulldiff.txt``
64+
65+
New projects to run the primer over can be added to the ``pydocstringformatter/testutils/primer/packages.py``
66+
file.

0 commit comments

Comments
 (0)