A simple Python project to get you started with web development and testing using Docker and GitHub Actions.

• Python 3.9
• Docker
• Docker Compose
• Poetry

• Getting started
  • Clone the repository
  • Basic env
• Setup
  • Virtual environment
  • Docker setup
  • Testing
  • Stopping containers
• Database
  • Database changes
  • Migrations
• Linting
• Github actions
• License

git clone https://github.com/yourusername/hackathon-starter.git
cd hackathon-starter

DB_USER=postgres
DB_PASS=postgres
DB_HOST=db
DB_NAME=postgres
DB_PORT=5432
POSTGRES_PASSWORD=postgres

poetry shell

docker compose --env-file .env up --build

pytest test/test_api.py  # to test the API
docker exec hackathon-starter-web-1 poetry run pytest tests/test_database.py  # to test the database inside the container

Or run all tests with docker exec -it hackathon-starter-web-1 pytest

docker compose down

To create new table in database just create needed class in src/model/tables.py similar to Example class.
If you want to change table, just look for your table in src/model/tables.py and do needed changes.
After creating or updating tables create new migration.

To create new migration simply run

alembic revision --autogenerate -m "example comment"
alembic upgrade head

We are using following tools:

• black - to run use make black
• isort - to run use make isort
• pylint - to run use make pylint

If you want to lint every file using all at once you can also run make lint

Beside that you can also use pre-commit.

pre-commit install
pre-commit run --all-files

This project uses GitHub Actions for CI. The workflow is defined in .github/workflows/main.yml. It sets up a Python environment, installs the dependencies, runs Docker Compose, and runs the tests. The workflow is triggered on every push to the main branch.

To use GitHub Actions in your repository, you need to add secrets to your repository settings:

• DB_HOST
• DB_USER
• DB_PASS
• DB_NAME

This project is licensed under the terms of the MIT license. See the LICENSE file for details.