ruff.toml

# ruff.toml Unified Python linter + formatter for void-filter repos
# Replaces: pylint, pycodestyle, pydocstyle, flake8, black, isort
# Docs: https://docs.astral.sh/ruff/

[lint]
select = [
    "E",      # pycodestyle errors
    "W",      # pycodestyle warnings
    "F",      # pyflakes
    "I",      # isort (import ordering)
    "N",      # pep8-naming
    "D",      # pydocstyle
    "UP",     # pyupgrade
    "S",      # bandit (security)
    "B",      # bugbear
    "A",      # builtins shadowing
    "C4",     # comprehensions
    "DTZ",    # datetime timezone
    "T10",    # debugger
    "ISC",    # implicit string concat
    "PIE",    # misc lints
    "PT",     # pytest style
    "RSE",    # raise
    "RET",    # return
    "SIM",    # simplify
    "TCH",    # type checking
    "ARG",    # unused arguments
    "ERA",    # dead code (commented out)
    "PL",     # pylint equivalents
    "RUF",    # ruff-specific
]
ignore = [
    "D401",   # pydocstyle: imperative mood (inaccurate checker)
    "D301",   # pydocstyle: escape sequences
    "E402",   # module level import not at top
    "S101",   # assert usage (OK in tests)
    "PLR0913", # too many arguments (we allow up to 8)
    "D100",   # missing module docstring (too noisy for small files)
    "D104",   # missing package docstring
]

[lint.per-file-ignores]
"tests/**" = ["S101", "D103", "ARG001"]
"**/test_*.py" = ["S101", "D103", "ARG001"]

[lint.pydocstyle]
convention = "google"

[lint.isort]
known-first-party = ["bundler", "unbundler", "common"]

[format]
quote-style = "double"
indent-style = "space"
line-ending = "lf"

line-length = 132
target-version = "py310"

[lint.pylint]
max-args = 8
max-branches = 12
max-returns = 6
max-statements = 50