mbake

What it is and what it does

mbake is a Python-based formatter and linter for Makefiles that enforces consistent style—converting spaces to tabs in recipes, normalizing spacing around assignments and colons, and cleaning up line continuations. It includes intelligent .PHONY detection that analyzes recipe commands to identify targets that don't produce files, and can optionally insert .PHONY declarations automatically. The tool validates Makefile syntax before and after formatting, supports CI/CD workflows with a check mode that reports whether formatting is needed without modifying files, and allows customization through a TOML configuration file.

The package is designed for developers and build systems that need to maintain consistent Makefile style across projects. It integrates with VSCode through an extension and provides command-line commands for formatting, validation, and configuration management. Dependencies are minimal—rich for terminal output, tomli for TOML parsing, and typer for CLI argument handling—making it lightweight to add to existing build pipelines.

Use it for:

• Enforce consistent Makefile formatting in CI/CD pipelines using --check mode to validate style compliance before merge
• Auto-format Makefiles in a repository to fix inconsistent spacing, tabs, and line continuations across multiple projects
• Validate Makefile syntax as part of a build validation step to catch errors before deployment
• Automatically insert and manage .PHONY declarations based on recipe analysis to prevent false file-target conflicts
• Integrate with VSCode to format Makefiles on save or on-demand using the mbake extension

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

mbake formats and lints Makefiles, enforcing consistent spacing, tab usage in recipes, and valid syntax while optionally auto-detecting and managing .PHONY declarations.

Yes. mbake fills a genuine gap in Makefile tooling with low install friction, active maintenance, permissive licensing, and no known vulnerabilities. It is well-suited for teams that need consistent Makefile style enforcement or CI/CD validation.

Install

mbake on PyPI

pip install mbake

uv add mbake

poetry add mbake

Installing mbake

Before you install

Low install friction with three lightweight runtime dependencies (rich, tomli, typer). Active maintenance with recent release and steady repository activity.

License in practice

MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal obligations.

Quickstart

pip install mbake
mbake format --check Makefile

Verify before relying

• Whether GNU make must be installed on the system for validation features to work
• Scope of Makefile syntax validation coverage across different make dialects
• Performance characteristics when formatting very large Makefiles

Package facts

Evidence: mbake-1.4.6-py3-none-any.whl

Keywords: build-tools, formatter, linter, makefile

Tags

More Build Tools packages