This is a Python project that uses pytest for testing and is configured for development in Visual Studio Code or cursor. It also includes a Dockerfile for containerization.
The main application code is located in the src
directory, with the entry point in src/main.py
. The src
directory also contains a core
subdirectory for core functionality and an utils
subdirectory for utilities.
The tests
directory contains some basics stuffs for testing.
The scripts
directory contains a dev tool to bump the version of the project, maybe it will be removed in the future to put it in a external package.
- Python 3.13
- uv
- Clone the repository.
- Install the dependencies:
uv sync
To run the application:
uv run src/main.py
To run the tests:
pytest
A Dockerfile is included for building a Docker image of the application. To build the image:
# Build the image (make sure to include the dot at the end)
docker build -t template-app .
To run the application in a Docker container:
# Basic run
docker run template-app
# Run with volume mount for development
docker run -v ${PWD}:/app template-app
# Interactive mode
docker run -it --rm template-app bash
The project includes a GitHub Actions workflow for continuous integration, which runs tests and security checks on push and pull request events to the main branch.
Contributions are welcome. Please submit a pull request or create an issue to discuss the changes.