carmine 2026.7.7

An opinionated Python toolchain.

Carmine toolchain

An opinionated Python toolchain.

Usage

Add carmine as a developer dependency, and all the included tools will be available for linting and testing. For documentation on individual tools, see the links below.

usage: carmine [-h]
               {commitver,commitver-prompt,versions} ...

positional arguments:
  {commitver,commitver-prompt,versions}
    commitver           Generate current CommitVer from
                        Git history.
    commitver-prompt    Check branch and status, show
                        CommitVer, and prompt to continue.
    versions            List versions of all packages
                        managed by Carmine.

options:
  -h, --help            show this help message and exit

Documentation toolchain

• flowmark-rs

Linter toolchain

• prek (lint hook manager)

• basedpyright

• reuse

• ruff

Testing toolchain

• coverage

• pytest

Under consideration

• griffe

Publishing

To publish a release:

glab auth login
just publish

The new release is automatically delivered to PyPI via Trusted Publishing.

You may update the release notes in GitLab after the fact.

Sharing and contributions

Carmine toolchain
https://lofidevops.neocities.org
Copyright 2023 David Seaward and contributors
SPDX-License-Identifier: 0BSD

Shared under 0BSD. We adhere to the Contributor Covenant 2.1, and certify origin per DCO 1.1 with a signed-off-by line. Contributions under the same terms are welcome.

Submit security and conduct issues as private tickets. Sign commits with git commit --signoff. For a software bill of materials run reuse spdx. For more details see CONDUCT, COPYING and CONTRIBUTING.

Colophon

Carmine lake is a vivid pigment made by crushing bugs.