Appearance

← Back to fixturfab.com/resources

f3ts-cookiecutter ​

cookiecutter-f3ts-runner is a cookiecutter template that scaffolds a new functional test-plan project for the FixturFab Test Runner. It generates a Poetry-managed Python project pre-wired with pytest-f3ts, linting, GitLab CI, and Docker/Balena packaging, so you can start writing tests instead of configuring tooling.

The template lives on GitLab.

Prerequisites ​

Install cookiecutter:

bash
pip install -U cookiecutter

Generate a project ​

bash
cookiecutter https://gitlab.com/fixturfab/software/cookiecutter-f3ts-runner

Cookiecutter prompts for the project name, organization, Python version, test-plan name, and author details, then writes a ready-to-run project.

What you get ​

  • A Poetry-managed Python 3.10+ project
  • A starter pytest-f3ts test plan
  • Autoformatting and pre-commit hooks
  • GitLab CI configuration
  • A Dockerfile and docker-compose for deploying to the Test Runner via Balena

See the pytest-f3ts documentation for how to write test plans, and the Test Runner documentation for deploying them to the shop floor.