Go to file
stijndcl ff5de8e88b Update CI & fix broken test 2023-01-11 23:37:39 +01:00
.github Update CI & fix broken test 2023-01-11 23:37:39 +01:00
alembic Check for free games 2022-10-13 20:00:46 +02:00
database Only show upcoming deadlines for courses the user is actually subscribed to 2022-11-05 22:26:48 +01:00
didier Check escaped message length before mocking it 2022-11-21 22:49:23 +01:00
files/dictionaries Fix broken time formatting, remove word field 2022-07-26 21:48:50 +02:00
profile_pictures Typing 2022-09-24 17:01:58 +02:00
tests Update CI & fix broken test 2023-01-11 23:37:39 +01:00
.editorconfig Initialize database stuff & setup didier 2022-06-10 01:48:02 +02:00
.flake8 Fix db script runner 2022-10-19 22:37:17 +02:00
.gitignore Merge migrations, pull schedules daily 2022-09-17 19:22:27 +02:00
.pre-commit-config.yaml Remove mongo & fix tests 2022-08-29 20:24:42 +02:00
.python-version Bump python version 2021-06-20 11:45:34 +02:00
alembic.ini Add missing alembic file 2022-06-16 00:40:37 +02:00
codecov.yaml Urban dictionary commands 2022-07-14 20:28:45 +02:00
docker-compose.test.yml Remove mongo & fix tests 2022-08-29 20:24:42 +02:00
docker-compose.yml Remove mongo & fix tests 2022-08-29 20:24:42 +02:00
main.py Load calendars once on startup (before connecting) 2022-11-02 01:34:52 +01:00
pyproject.toml Fix env variable 2022-09-18 17:29:24 +02:00
readme.md Add OS info to dev readme 2022-08-29 01:17:06 +02:00
requirements-dev.txt Fix announcement timezones 2022-10-05 21:04:06 +02:00
requirements.txt Fix announcement timezones 2022-10-05 21:04:06 +02:00
run_db_scripts.py Fix db script runner 2022-10-19 22:37:17 +02:00
settings.py Check for free games 2022-10-13 20:00:46 +02:00

readme.md

Didier

wakatime

You bet. The time has come.

Development

Didier uses Python 3.9.5, as specified in the .python-version-file. This file will cause pyenv to automatically use the correct version when you're working on Didier.

# Installing Python 3.9.5 through pyenv
pyenv install 3.9.5

# Creating a Virtual Environment and activate it
# PyCharm will automatically activate your venv
python3 -m venv venv
source venv/bin/activate

# Installing dependencies + development dependencies
pip3 install -r requirements.txt -r requirements-dev.txt

# Installing pre-commit hooks
pre-commit install

The database can be managed easily using Docker Compose. If you want to, however, you can run a regular PostgreSQL server and connect to that instead.

A separate database is used in the tests, as it would obviously not be ideal when tests randomly wipe your database.

# Starting the database
docker compose up -d

# Starting the database used in tests
docker compose -f docker-compose.test.yml up -d

Commands

All of these are Python tools. Depending on your OS and configuration, you may have to prefix them with python3 -m.

# Starting Didier
python3 main.py

# Running database migrations
alembic upgrade head

# Creating a new database migration
alembic revision --autogenerate -m "Revision message here"

# Running tests
pytest

# Running tests with Coverage
coverage run -m pytest
# Generating code coverage report
coverage html

# Running code quality checks
black
flake8
mypy

It's also convenient to have code-formatting happen automatically on-save. The Black documentation explains how to set this up for different types of editors.