You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
5. Run ``pre-commit install`` to install pre-commit hooks
13
10
14
11
Code contributions
15
12
------------------
@@ -21,8 +18,7 @@ Workflow
21
18
2. Clone your fork locally with git
22
19
3. `Set up the environment <#setting-up-the-environment>`_
23
20
4. Make your changes
24
-
5. (Optional) Run ``pre-commit run --all-files`` to run linters and formatters. This step is optional and will be executed
25
-
automatically by git before you make a commit, but you may want to run it manually in order to apply fixes
21
+
5. (Optional) Run ``make lint`` to run linters and type checkers, or ``make format`` to auto-format
26
22
6. Commit your changes to git
27
23
7. Push the changes to your fork
28
24
8. Open a `pull request <https://docs.github.com/en/pull-requests>`_. Give the pull request a descriptive title
@@ -37,14 +33,18 @@ Guidelines for writing code
37
33
----------------------------
38
34
39
35
- All code should be fully `typed <https://peps.python.org/pep-0484/>`_. This is enforced via
40
-
`mypy <https://mypy.readthedocs.io/en/stable/>`_.
36
+
`mypy <https://mypy.readthedocs.io/en/stable/>`_ and `pyright <https://github.com/microsoft/pyright>`_.
41
37
- All code should be tested. This is enforced via `pytest <https://docs.pytest.org/en/stable/>`_.
42
-
- All code should be properly formatted. This is enforced via `black <https://black.readthedocs.io/en/stable/>`_ and `Ruff <https://beta.ruff.rs/docs/>`_.
38
+
- All code should be properly formatted. This is enforced via `Ruff <https://docs.astral.sh/ruff/>`_.
43
39
44
40
Writing and running tests
45
41
+++++++++++++++++++++++++
46
42
47
-
.. todo:: Write this section
43
+
Run the test suite with:
44
+
45
+
.. code-block:: shell
46
+
47
+
make test
48
48
49
49
Project documentation
50
50
---------------------
@@ -57,11 +57,7 @@ The documentation is located in the ``/docs`` directory and is `ReST <https://do
57
57
Running the docs locally
58
58
++++++++++++++++++++++++
59
59
60
-
To run or build the docs locally, you need to first install the required dependencies:
61
-
62
-
``pdm install -G:docs``
63
-
64
-
Then you can serve the documentation with ``make docs-serve``, or build them with ``make docs``.
60
+
You can serve the documentation with ``make docs-serve``, or build them with ``make docs``.
0 commit comments