fleetlint Policy for a fleet of repositories
v0.11 (latest)
Getting started

release/api-compatibility/python

A library checks its API against the previous release

Implements release/api-compatibility for python.

Severityinfo
Tiers1
Stackspython
Scoperoot
Kindoutcome
Sourcelibrary v0.8.0
Selected byfleetlint-recommended@v0.8.0

Requirement

A pyproject [project] without scripts runs griffe check against the previous tag.

Why

A breaking change in a minor release is found by every user at once; the check finds it before the tag.

Applies when

toml("pyproject.toml") != null && has(toml("pyproject.toml").project) && !has(toml("pyproject.toml").project.scripts)

Fix

Run griffe check <package> --against $(git describe --tags --abbrev=0) in the release workflow.

Agent instruction (from release/api-compatibility): Add the stack’s API compatibility tool to the release workflow, comparing against the latest tag; on a breaking change bump the major version instead of silencing the tool.

A finding that names no file points at the first workflow a tag push starts, or .github/workflows/release.yml when there is none.

Sources


Generated by fleetlint docs from catalog v0.8.0.