Contributing

Found a bug? Want to fix an open issue? Got an idea for an improvement? Please contribute!

All contributions are welcome, from absolutely anyone. Just open a PR, Issue or Discussion (as relevant) - no need to ask beforehand. If you're going to work on an issue, it's a good idea to say so on the issue, to make sure work isn't duplicated.

Development set up

Fork, then clone the repo:

git clone git@github.com:your-username/django-tasks-db.git

Set up a venv:

python -m venv .venv
source .venv/bin/activate
python -m pip install -e . --group dev

Then you can run the tests with the just command runner:

just test

If you don't have just installed, you can look in the justfile for the commands that are run.

To help with testing on different databases, there's a docker-compose.yml file to run PostgreSQL and MySQL in Docker, as well as some additional just commands for testing:

just start-dbs
just test-postgres
just test-mysql
just test-sqlite

# To run all of the above:
just test-dbs

Due to the database worker process tests, tests cannot run using an in-memory database, which makes them run quite slowly locally. If you’re not modifying the worker and want your tests to run faster, run:

just test-fast

Opening the PR

Before opening a PR, ensure all tests and linters pass.

To check for linter issues, run:

just lint