File tree Expand file tree Collapse file tree 1 file changed +22
-0
lines changed Expand file tree Collapse file tree 1 file changed +22
-0
lines changed Original file line number Diff line number Diff 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.
You can’t perform that action at this time.
0 commit comments