mirror of
https://github.com/fhswf/aki_prj23_transparenzregister.git
synced 2025-04-24 21:52:34 +02:00
75 lines
2.8 KiB
Markdown
75 lines
2.8 KiB
Markdown
# Contribution guidelines
|
|
|
|
## Dev Setup
|
|
|
|
- [Install Python 3.11](https://www.python.org/downloads/release/python-3111/)
|
|
- [Install Poetry](https://python-poetry.org/docs/#installation)
|
|
- [Install GiT](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
|
|
- [Configure GiT](https://support.atlassian.com/bitbucket-cloud/docs/configure-your-dvcs-username-for-commits/)
|
|
- [Generate an SSH Key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) & [Add SSH Key to GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
|
|
- [Clone the Project (IDE Specific)](https://docs.github.com/de/repositories/creating-and-managing-repositories/cloning-a-repository)
|
|
- [Install the python Project](https://python-poetry.org/docs/basic-usage/#installing-dependencies)
|
|
- [Install pre-commit](https://pre-commit.com/#install)
|
|
|
|
## Setup
|
|
|
|
### Connection strings
|
|
|
|
Create a `secrets.json` in the root of this repo with the following structure (values to be replaces by desired config):
|
|
|
|
```json
|
|
{
|
|
"postgres": {
|
|
"username": "postgres",
|
|
"password": "postgres",
|
|
"host": "localhost",
|
|
"database": "postgres",
|
|
"port": 5432
|
|
},
|
|
"mongo": {
|
|
"username": "username",
|
|
"password": "password",
|
|
"host": "localhost",
|
|
"database": "transparenzregister",
|
|
"port": 27017
|
|
}
|
|
}
|
|
```
|
|
|
|
Example usage see [connector.py](./src/aki_prj23_transparenzregister/utils/postgres/connector.py)
|
|
|
|
## Code style
|
|
|
|
We defined to use the following formats:
|
|
|
|
- Whitespace Formatting by [Black](https://github.com/psf/black)
|
|
- Docstrings Style see the examples provided
|
|
by [sphinx napoleon](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html) Types in the
|
|
docstrings are optional but should be consistent per module.
|
|
- Import Order by [isort](https://pycqa.github.io/isort/)
|
|
- Strict Typing of function headers see the examples provided by
|
|
the [mypy](https://mypy.readthedocs.io/en/stable/cheat_sheet_py3.html) documentation.
|
|
|
|
## Language
|
|
|
|
We decided to use english on everything close to code but will write longer texts that are not close to the code in
|
|
german.
|
|
|
|
## Pre-Commit Usage
|
|
|
|
- the following code format rules are so enforced:
|
|
- Whitespace formatting:
|
|
- Python-[Black](https://github.com/psf/black)
|
|
- leading whitespace in all files
|
|
- Auto format: yaml, toml, ini
|
|
- Import norm by:
|
|
- [isort](https://pycqa.github.io/isort/)
|
|
- absolut module path
|
|
- Validation:
|
|
- yaml, toml, json, xml
|
|
- Secret detection
|
|
- python norms ([pep8](https://peps.python.org/pep-0008/))
|
|
with [ruff](https://github.com/astral-sh/ruff)
|
|
- type checking with ([mypy](https://github.com/python/mypy))
|
|
- for more information read [Python Pre-Commit](https://pre-commit.com/)
|