Skip to content

Commit 6f70b14

Browse files
authored
Create copilot-instructions.md
1 parent 04ebff4 commit 6f70b14

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

.github/copilot-instructions.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
QCoDeS is a python library that follows all the best practices of a python package.
2+
3+
All configuration for the package and for the tools we use lives in ``pyproject.toml``.
4+
5+
Documentation, in the ``docs/`` folder, is written using Restructured Text or Jupyter
6+
Notebook formats, and sphinx is used to render the documentation into HTML pages to
7+
be deployed at https://microsoft.github.io/Qcodes/.
8+
9+
The documentation includes Contributor's guide, so please follow that closely.
10+
11+
Before committing anything, run pre-commit hooks with ```pre-commit run --all`` and
12+
make sure they pass, and fix anything that is failing. The pre-commit hooks will ensure
13+
correct formatting of the code and linting as well.
14+
15+
QCoDeS is a typed package, hence all new code should include clear and correct type annotations.
16+
17+
We use ``pyright`` to statically check the correctness of the code with type annotations.
18+
Run it via ``pyright src/``.
19+
20+
For running tests, we use ``pytest``. They can be run with ``pytest tests``.
21+
See pytest markers for additional options of running tests.
22+
23+
We use Dependabot from GitHub to keep our dependencies up to date, we use ``requirements.txt``
24+
as our constraints or "lock" file.

0 commit comments

Comments
 (0)