Python Boilerplate

• This repository is meant to be used as a fast starter point.
• The Python version is the 3.12.
• The project has configured a Github Action which runs on every push to the main branch.

Requirements

• You only need to have uv installed.

Folder structure

• There is a tests folder with the tests files.
  • In order to add new tests please follow the pytest recommendations.
• The production code goes inside the src folder.
• Inside the scripts folder you can find the git hooks files.

Project commands

The project uses Makefiles to run the most common tasks:

• add-package package=XXX: Installs the package XXX in the app, ex: make install package=requests.
• build: Builds the app.
• check-format: Checks the code format.
• check-lint: Checks the code style.
• check-typing: Runs a static analyzer over the code in order to find issues.
• format: Formats the code.
• lint: Lints the code.
• help : Shows this help.
• install: Installs the app packages.
• local-setup: Sets up the local environment (e.g. install git hooks).
• run: Runs the app.
• test: Run all the tests.
• update: Updates the app packages.
• watch: Run all the tests in watch mode.

Important: Please run the make local-setup command before starting with the code.

In order to create a commit you have to pass the pre-commit phase which runs the check and test commands.

Packages

This project uses uv as the package manager.

Testing

• pytest: Testing runner.
• doublex: Powerful test doubles framework for Python.
• expects: An expressive and extensible TDD/BDD assertion library for Python..
• doublex-expects: A matchers library for the Expects assertion library.

Code style

• ty: A static type checker.
• ruff: An extremely fast Python linter, written in Rust..

Contributors

Special thanks to:

• GoldraK.
• Alex Lopez