baseline-py

Structural linter and config scaffolder for Python: atomic files, placement, size caps, no inline SQL. Brings the same discipline as @busirocket/eslint-config and cargo-baseline to Python projects.

Design spec: docs/superpowers/specs/2026-08-31-python-baseline-design.md.

Install

uv add --dev busirocket-baseline-py

Usage

baseline-py init [--check|--apply|--force]  # scaffold ruff, mypy, deptry,
                                            # pytest, coverage and CI config
baseline-py check [PATH...]                 # run the structural rules
baseline-py gate                            # run the whole quality chain
baseline-py baseline create|update|check    # track migration debt

init never overwrites: it merges into existing configuration, or reports a conflict. check never writes. gate fails when a required tool is absent rather than skipping it.

Rules

Code	Rule	Enforces
`BPY000`	`parse-error`	A file that fails to parse is a finding, never a silent skip.
`BPY001`	`one-primary-unit`	Exactly one primary declaration per ordinary module.
`BPY002`	`file-matches-unit`	File name is the snake_case of its primary declaration.
`BPY003`	`no-grab-bag-names`	No `utils`, `helpers`, `misc` or `common` in any path segment.
`BPY004`	`max-file-lines`	Code-line cap per file; tests get their own, looser cap.
`BPY005`	`barrel-only-init`	`__init__.py` holds imports, `__all__` and nothing else.
`BPY006`	`no-inline-sql`	SQL lives in resource files, not in string literals.

Exit codes

Code	Meaning
0	All blocking checks passed.
1	Policy findings.
2	Invalid usage or invalid configuration.
3	Infrastructure failure: a required tool is missing or unusable.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

busirocket_baseline_py-0.1.7.tar.gz (164.0 kB view details)

Uploaded Sep 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

busirocket_baseline_py-0.1.7-py3-none-any.whl (88.3 kB view details)

Uploaded Sep 1, 2026 Python 3

File details

Details for the file busirocket_baseline_py-0.1.7.tar.gz.

File metadata

Download URL: busirocket_baseline_py-0.1.7.tar.gz
Upload date: Sep 1, 2026
Size: 164.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for busirocket_baseline_py-0.1.7.tar.gz
Algorithm	Hash digest
SHA256	`e442758188123481ad9c7f2b5e884e287e3cd115211dc8b47facc463d280b345`
MD5	`046bd77d3defec241808366d4c44547c`
BLAKE2b-256	`269d9540b7525fcec9c9aa11438d53a67d7042ff8cd2ef84269c6478a7f04198`

See more details on using hashes here.

Provenance

The following attestation bundles were made for busirocket_baseline_py-0.1.7.tar.gz:

Publisher: publish-python.yml on BusiRocket/baseline

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: busirocket_baseline_py-0.1.7.tar.gz
- Subject digest: e442758188123481ad9c7f2b5e884e287e3cd115211dc8b47facc463d280b345
- Sigstore transparency entry: 2669820827
- Sigstore integration time: Sep 1, 2026
Source repository:
- Permalink: BusiRocket/baseline@862a3b25aef777a7e2e14d97fd3edfb9c9ee2d15
- Branch / Tag: refs/heads/main
- Owner: https://github.com/BusiRocket
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-python.yml@862a3b25aef777a7e2e14d97fd3edfb9c9ee2d15
- Trigger Event: workflow_dispatch