slopcop

A fast, opinionated Python linter written in Rust that catches anti-patterns commonly produced by language models.

Built on tree-sitter for AST-correct analysis — no false positives on strings or comments.

Install

pip install slopcop
# or
uv tool install slopcop

Or from source:

cargo install --git https://github.com/cm2435/slopcop

Usage

# Lint directories (walks recursively for .py files)
slopcop src/ tests/

# Lint specific files
slopcop path/to/file.py

# Quiet mode (exit code only, for CI)
slopcop --quiet src/

# JSON output
slopcop --format json src/

# Only fail on errors, treat warnings as non-blocking
slopcop --warn-only src/

Exit codes: 0 = clean, 1 = violations found, 2 = fatal error.

Rules

All rules are enabled by default. Disable per-project via pyproject.toml.

Configuration

Add [tool.slopcop] to your pyproject.toml:

[tool.slopcop]
exclude = [
    "no-dataclass",   # this project uses dataclasses
    "no-print",       # CLI app, print is fine
]

Per-file ignores

Disable rules for specific file patterns:

[tool.slopcop.per-file-ignores]
"tests/**" = ["no-print"]
"**/cli/**" = ["no-print"]

Rule-specific config

[tool.slopcop.rules.max-function-params]
max = 10

slopcop walks upward from the target path to find the nearest pyproject.toml.

Inline suppression

x = getattr(obj, name)                     # slopcop: ignore
x = getattr(obj, name)                     # slopcop: ignore[no-hasattr-getattr]
x = getattr(obj, name)                     # slopcop: ignore[no-hasattr-getattr, no-print]

Adding to CI

# GitHub Actions
- run: pip install slopcop
- run: slopcop src/ tests/

Development

cargo test          # run the test suite
cargo run -- src/   # run locally

License

MIT