ruff.toml

# Ruff configuration
# Comprehensive Python linting and formatting

target-version = "py311"
line-length = 120
extend-exclude = [
    ".venv",
    "venv",
    "__pycache__",
    ".pytest_cache",
    ".mypy_cache",
    ".ruff_cache",
    "*.pyc",
]

[lint]
select = [
    "E",      # pycodestyle errors
    "W",      # pycodestyle warnings
    "F",      # pyflakes
    "I",      # isort
    "B",      # flake8-bugbear
    "C4",     # flake8-comprehensions
    "UP",     # pyupgrade
    "ARG",    # flake8-unused-arguments
    "SIM",    # flake8-simplify
    "TCH",    # flake8-type-checking
    "PTH",    # flake8-use-pathlib
    "ERA",    # eradicate
    "PL",     # pylint
    "RUF",    # ruff-specific rules
]
ignore = [
    "E501",   # line too long (handled by formatter)
    "PLR0913", # too many arguments
    "PLR0912", # too many branches
    "PLR0915", # too many statements (complex functions are intentional)
    "PLR0911", # too many return statements
    "PLR2004", # magic value comparison
    "SIM108",  # use ternary operator
    "PLC0415", # late imports (needed for optional dependencies)
]

[lint.per-file-ignores]
"tests/**/*.py" = [
    "ARG001",  # unused function argument
    "ARG002",  # unused method argument (common in test mocks)
    "S101",    # use of assert
    "PLR2004", # magic values in tests
    "SIM117",  # nested with statements (clearer in test fixtures)
]
"__init__.py" = ["F401"]

[lint.isort]
known-first-party = ["src"]
force-single-line = false
lines-after-imports = 2