An application helping managing band focused around band's music scores.

note: I'm using linux machine with build-essential.

• Setup uv – used for managing dependencies
• Setup PostgreSQL – required for database setup

MacOS: You may need additional dependencies in order to setup the database

# Install WeasyPrint (includes required dependencies)
brew install weasyprint

# Restart PostgreSQL service
brew services restart postgresql

• clone the project:

git clone https://github.com/petrus-v/band-management

• setup git pre-commit hooks outside the current env to launch linter at git commit

uv tool install --with pre-commit-uv pre-commit
uvx pre-commit install --install-hooks

• Install dependencies

make install

• Setup database with demo data

make setup-demo

• Setup tests database with demo data

make setup-tests

• Run tests

make test

• Regenerate translations

make translations
make compile-translations

• Start the application

make run

• launch linters

uvx pre-commit run --all-files

You may want to import music brainz data (work table) downloaded from here to populate the music catalog.

uv run musicbrainz-importer -c app.cfg  --limit 30000 --insert-buffer 1000 ~/path/to/work 

We are using bump-my-version to bump patch / minor / major version and add the git tag. At the moment changelog and github release are done manually. we have no changelog file yet.