-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b7a79bc
commit ac37f5f
Showing
2 changed files
with
58 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
# Changelog: | ||
|
||
--- | ||
|
||
|
||
### Pre-release status (12.03.2023): | ||
|
||
**Development features:** | ||
|
||
1. Use [Black](https://github.com/psf/black) for formatting the code. | ||
- Local terminal usage: `black .` | ||
- Config in `pyproject.toml` | ||
- Set line-length to `88`, set python versions to `py8`to `py11` | ||
- GitHub Actions: | ||
- Just check with black by running: `black --check .` | ||
|
||
2. Use [Ruff](https://github.com/charliermarsh/ruff) as the Python linter. | ||
- Local terminal usage: `ruff check .` | ||
- Config in `pyproject.toml` | ||
- set line-length, the Rules (*pycodestyle*, *pyflakes*, *pydocstyle*, *isort*), | ||
the source files, and to ignore rule *F401* to not complain about unused imports | ||
in `__init__` files. | ||
- GitHub Actions: | ||
- run `ruff check --format=github .` | ||
|
||
3. Use [MyPy](https://github.com/python/mypy) as for type checking. | ||
- Local terminal usage: `mypy` | ||
- Config in `pyproject.toml` | ||
- Specify files: `src/lorenzpy/` | ||
- Ignore missing imports for `plotly` | ||
- GitHub Actions: | ||
- Just running `mypy` | ||
|
||
4. Testing with [pytest-cov](https://github.com/pytest-dev/pytest-cov) | ||
- Local terminal usage: `pytest` | ||
- Config in `pyproject.toml` | ||
- automatically add the following options when `pytest` is run: | ||
- `--verbose --cov-config=pyproject.toml --cov-report term-missing --cov=lorenzpy` | ||
- Note: This is somehow important for GitHub actions to work fine... | ||
- Omit the `plot` folder for the coverage. | ||
- GitHub Actions: | ||
- simply running `pytest` and then uploading the coverage reports to [Codecov](https://about.codecov.io/) | ||
using the GitHub action: [codecov-action](https://github.com/codecov/codecov-action) | ||
|
||
5. Generating docs with [mkdocs](https://github.com/mkdocs/mkdocs): | ||
- Following [this tutorial](https://realpython.com/python-project-documentation-with-mkdocs/) | ||
- Generate the docs with `mkdocs gh-deploy` | ||
- Use the plugin [mkdocstrings](https://github.com/mkdocstrings/mkdocstrings) to | ||
automatically use the code-docstrings in the documentation. | ||
|
||
**Resources**: | ||
Taking inspiration from: | ||
https://github.com/dkmiller/modern-python-package, and | ||
https://github.com/denkiwakame/py-tiny-pkg. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters