rattle-lint 1.2.0

A framework for custom Python linters with auto-fixes and hierarchical configuration

Rattle

Rattle is a Python linting framework built on LibCST with support for autofixes, custom in-repo lint rules, and hierarchical configuration.

Rattle is a fork of Fixit.

Features

• Built-in lint rules for common Python issues
• Autofix support when a rule can safely rewrite code
• Local custom rules that can live inside your repository
• Hierarchical pyproject.toml configuration
• Pre-commit integration for CI and local workflows
• LSP support

Install

Install the CLI from PyPI:

pip install rattle-lint

Install editor/LSP support too:

pip install "rattle-lint[lsp]"

Basic Usage

Rattle runs with no enabled rules until a project enables them in pyproject.toml:

[tool.rattle]
enable = ["fixit"]

rattle lint

Apply available autofixes:

rattle fix

Example Configuration

[tool.rattle]
root = true
enable = ["fixit"]
python-version = "3.10"
output-format = "rattle"
disable = [
    "NoStaticIfCondition",
    "UseLintFixmeComment",
]
per-file-disable = {"tests/generated.py" = ["NoNamedTuple"]}

[[tool.rattle.overrides]]
path = "legacy"
enable = ["fixit_extra"]

[[tool.rattle.overrides]]
path = "tests"
enable = ["NoNamedTuple"]

License

MIT