repdav

Development

1. Prerequisites

   • Python > 3.8
   • Docker > 20.10
   • Docker Compose > 1.25

2. Create/activate virtual environment (ensure you use the correct python version!).

   python -m venv venv
   . venv/bin/activate

3. Install requirements.

   pip install $(cat requirements.txt requirements.dev.txt)

4. Configure the service by setting the following variables either in your environment or in the docker-compose.yml file.

   • host
   • port
   • tg_auth_wsdl
   • tg_auth_address

5. Start the service.

   python main.py

For your convenience, a Docker Compose setup is delivered with this repository that configures the service accordingly. Build and start the stack.

docker-compose up --build

Contributing

Commit convention:

• Use conventional commits

Style constraints:

• Code: PEP 8
• Documentation: PEP 287

Coding constraints:

• Objects that are not supposed to be used outside the current scope MUST be named starting with _ (underscore): PEP 316

For your convenience, pre-commit hooks are configured to check against these constraints. Provided, you have installed the development requirements (see above), activate pre-commit to run on every git commit:

pre-commit install

Also, a helper with conventional commits is installed with the development requirements that you could leverage to easily comply with it. Just use cz c instead of git commit