Python that is easier to read and review.

A companion linter for Ruff that checks Python definitions, imports, exports and tests.

Fixes

Most rules offer a fix. Apply safe fixes with simplint check --fix. Add --unsafe-fixes to include changes that may affect behavior.

Cross-file checks

Check the whole project, including tests, so rules can see where another module imports a name.

Ruff configuration

simplint uses Ruff’s file exclusions and reads its rule settings to check for conflicting fixes. Both tools recognize # noqa comments.

For example, given a file named module.py containing x = 1:

$ simplint check --select SMP101 --output-format concise module.py
module.py:1:1: SMP101 Single-letter name `x`; use a descriptive name
Found 1 error.

Documentation

How-to guides

Choose rules, configure a hook or suppress a report.

How-to guides

Reference

Look up a rule, setting or command-line option.

Rules

Explanation

Read how cross-file checks work and how simplint handles Ruff findings.

How simplint works