Skip to content

spirit_level spirit_level

spirit_level

spirit_level is a linter for Rust projects of every size, from one crate to a workspace of hundreds. It checks what clippy does not: how a project is put together (manifests, workspace inheritance, the dependency graph, declared layers, crate sizes), how its code shares state, and the rules a team writes down and then forgets to check.

  • Tiers. Lints come in TOML files shipped with the tool: small for one crate, small-workspace, medium, big. Each extends the one before it.
  • One file per project. spirit_level.toml picks a tier (extends = "big") and changes what it needs, every change with a reason, optionally with an expiry. Unknown keys and lint ids are errors.
  • Every lint documented. Each lint page is generated from the lint's own metadata: the rule, why, its parameters and its level in every tier.
  • For people and for CI. Coloured text or a JSON report, exit codes, and --fix where a fix is exact.
spl init --tier small-workspace
spl check