bmk
Makefiles are great, and every tool that set out to replace them started by asking you to stop using one. That is the tell. make is fifty years old, sits on every machine, and hands a stranger exactly one thing to type. Whatever is wrong here, it is not make.
It is the shell inside it. A recipe is a string handed to bash, so your build logic is
stringly-typed and OS-specific, and your prose gets parsed as code. Ours once took a commit
message reading fix(cli): tidy up, handed it to bash, and bash did what bash does with a
parenthesis. It committed half the sentence and pushed it.
bmk is a build, test and release runner for Python projects. It keeps the Makefile and
throws out the bash. You still type make test; bmk reads your pyproject.toml, provisions
your venv with uv, and runs the gates. Every command is cross-OS Python with no shell
anywhere, so the same make test runs on Linux, macOS and Windows. We deleted all 78 of our
own .sh and .ps1 files rather than keep two of everything.
uvx bmk install # drops the Makefile in; installs nothing permanent
make test # from here on, just make
Requires uv (there is no pip fallback) and Python 3.10+.
Key features
- One Makefile, versioned, that updates itself. Every project gets the same template, and it regenerates when bmk updates, so your repos cannot drift apart.
- No shell, anywhere. Every command is cross-OS Python, and every stage is an argv list rather than a shell string. Nothing gets handed to bash to re-parse, including your own stages and your commit messages.
- Your dependencies and bmk's never mix. bmk installs once per machine and holds its own
toolchain and nothing of yours. Your packages live in the project's
.venv, and that is the environment your tests, type-checker and audit all run against - the same one, so they cannot disagree. - Staged pipelines, parallel where it is safe. Stages run in order; stages sharing an
order run together. Extend any pipeline from your
pyproject.toml: add, remove or replace stages in TOML. - Quiet until it matters. JSON by default: tool output is captured and shown only when a
stage fails, otherwise you get one summary line. Pass
--humanwhen you want the noise. - Batteries included. Formatting and linting, type-checking, security and vulnerability audits, import-contract checks, tests with coverage, shell and PowerShell linting, version bumping, tagging, GitHub releases (CI publishes to PyPI), and Codecov upload.
Documentation
| Page | What is in it |
|---|---|
| Install | uv, pipx, pip, Poetry/PDM, from git or from build artifacts |
| make targets | every target and its aliases |
| CLI reference | every command, option and exit code |
| pyproject reference | every pyproject.toml section bmk reads, with defaults |
| Pipelines and stages | what runs when, and how to change it |
send-email and send-notification |
|
| Concept | the design |
| ADRs | the decisions, and why |
| Changelog | what changed |
| Contributing | how to work on bmk |
License
MIT - see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bmk-3.17.0.tar.gz.
File metadata
- Download URL: bmk-3.17.0.tar.gz
- Upload date:
- Size: 428.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba81eea8242e90c2567137a7bdb809b348dc69f3bedf84238dd47b2a274644c0
|
|
| MD5 |
bd7c88543ea92fa039e789666f04e12d
|
|
| BLAKE2b-256 |
91b463707966dd1caf5152d41ed34aeaa4f20c6adb1734effbefd3a79d5e4a12
|
File details
Details for the file bmk-3.17.0-py3-none-any.whl.
File metadata
- Download URL: bmk-3.17.0-py3-none-any.whl
- Upload date:
- Size: 214.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eac7ca4879841c7c9a849f15d9979e8260a29cae59e2c8ecc10776c218647499
|
|
| MD5 |
64a2e469a7980e8b145dba97444e162b
|
|
| BLAKE2b-256 |
7f538c6d851a536049b08f26b78d5f9a301b8e9aa11f72f5b0ed2c065b65884a
|
