This repository contains boilerplate for a research repository with continuous integration using GitHub actions. To use this code for your own project, make sure to find-and-replace all places where my_package is used with your own package name.
All Python code is under the my_package package. Run
pip install -e .
to install dependencies. Dependencies can be added in pyproject.toml.
When commits are pushed to GitHub, they are checked with the Flake8 linter, Black code formatter, isort import sorter, and Mypy type checker. Tests are also run with pytest. To install these tools locally, run
pip install --upgrade -e .[dev]
Then, they can be run by ./lint.sh. To run tests, run pytest.
This repository is by default configured to target Python 3.9 and test in Python versions 3.8 to 3.10. To change the target Python version, modify the line python_version = 3.9 in mypy.ini and the line target-version = ['py39'] in pyproject.toml (under [tool.black]). To change the versions that are tested in the GitHub workflow, modify the line python_version: ['3.8', '3.9', '3.10'] in .github/workflows/ci.yml.