Skip to main content

brumby

Analyzes fresh Python releases for worsening aspects.

Usage

uv venv .venv
. .venv/bin/activate
uv sync
scripts/poll_updates.py --include-first --interval 5 | xargs -n1 -P4 brumby assess

Library API

Use brumby.api to run the same operations as the CLI without parsing terminal output. Each operation accepts a loaded config dict and returns a result object:

import tomllib

from brumby import api

with open("brumby.toml", "rb") as config_file:
    config = tomllib.load(config_file)

result = api.check("example-package", config=config)
for difference in result.diffs:
    print(difference)

Pass config=None to use built-in defaults. Unlike the CLI, the library API does not search for a config file; callers that need non-default settings should load and pass them explicitly.

Only the names listed in brumby.api.__all__ carry a compatibility guarantee. Every other module and package-root convenience import is an implementation detail and may change without notice.

Export for review

brumby export PACKAGE extracts release artifacts and writes a PROMPT.md for an LLM to review. With two selected versions, old/ and new/ contain the extracted artifacts for comparison. If the package has only one release, the export contains that release in new/ and the prompt asks for a standalone inspection. A wheel is used for that inspection when one is available. In a single-release API result, old and old_dir are None.

Assessment results

Brumby rates change, not safety. For the usual two-release assessment, average means the new release looks no worse than yesterday's baseline. high means it has enough newly introduced signals to look plausibly worse than that baseline. There is no low result: failing to find a regression does not prove that either release is safe.

The sus and informational thresholds set how many changed findings are enough to report high. Assessments without a usable baseline report too new rather than treating one release as evidence of improvement. Callers must handle too new as a third result; a conservative admission policy should treat it like high while preserving the distinct reason.

Test

uv run pytest tests/

Version Compat

This library is compatible with Python 3.11+, but should be linted under the newest stable version.

Versioning

This library follows meanver which basically means semver along with a promise to rename when the major version changes.

License

brumby is copyright Tim Hatch, and licensed under the MIT license. See the LICENSE file for details.

Metadata

Release files for brumby 0.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for brumby 0.7.2
File Size Uploaded Provenance Actions
brumby-0.7.2.tar.gz 127.4 kB With provenance Details for brumby-0.7.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for brumby 0.7.2
File Interpreter ABI Platform Actions
brumby-0.7.2-py3-none-any.whl Python 3 none any Details for brumby-0.7.2-py3-none-any.whl

Total release size: 176.0 kB

Release files / brumby-0.7.2.tar.gz

Download URL brumby-0.7.2.tar.gz
Size 127.4 kB
Tags Source
SHA-256 checksum
How to use checksums
669bfb07c600d17bb432ccdaf408380d95890485c3fc74a31b6f19be0cde98fc
BLAKE2b-256 checksum
How to use checksums
baff27e58f0c9b6d2b2c276223eb502921bce5b5b0112f2aeff216493c8d96da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Release files / brumby-0.7.2-py3-none-any.whl

Download URL brumby-0.7.2-py3-none-any.whl
Size 48.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ad72cce092fdde57668ffe47024162cc6eb2c3689ef58780bfe0bb9fa35ec758
BLAKE2b-256 checksum
How to use checksums
5e56aa988a64472e2fdbc0b651af3cc81da586616f48db58812231011303dcd9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Security for brumby 0.7.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for brumby-0.7.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page