Skip to content

Commit

Permalink
Added changelog and updated README.
Browse files Browse the repository at this point in the history
  • Loading branch information
DuncDennis committed Mar 12, 2023
1 parent b7a79bc commit ac37f5f
Show file tree
Hide file tree
Showing 2 changed files with 58 additions and 4 deletions.
54 changes: 54 additions & 0 deletions CHANGELOG.md
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.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@
[![license: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](LICENSE)
[![Python versions](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)


## Under development:
Slowly adding tools, taking https://github.com/dkmiller/modern-python-package, and
https://github.com/denkiwakame/py-tiny-pkg as examples.
## 🚧 Under construction 🚧
There is no release of the package yet and most of the functionalities are missing.
For now only the basic functionalities are implemented in order to build up the
developing workflow.

## Installation:

Expand Down

0 comments on commit ac37f5f

Please sign in to comment.