platform-ci/ruff.toml

# KofTwentyTwo Python lint + format configuration (K22-CODE-PY). Copy to the repo root
# (or merge into [tool.ruff] in pyproject.toml). `ruff format --check` and `ruff check`
# run in CI and pre-commit with zero findings allowed.
target-version = "py313"
# Kingsrook: no practical line-length limit (ruff's maximum is 320).
line-length = 320
# Kingsrook: 3-space indentation. Ruff's formatter supports it fully; pycodestyle's
# "multiple of four" rules (E111/E114) are therefore not selected.
indent-width = 3
# Frozen publication primitives are vendored byte-for-byte (see publisher_frozen/receipts.json); they keep their
# original style and are neither reformatted nor linted. Only platform_ci/delivery/legacy.py imports them.
# source_tools/ holds the captured source-check helpers byte for byte (see source_tools/receipt.json): a reformat would change their receipted hashes.
extend-exclude = ["publisher_frozen", "source_tools"]

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

[lint]
select = [
   "A005",  # Pyright removed reportShadowedImports; retain stdlib-shadow checks in Ruff.
   "F",     # pyflakes
   "E4", "E7", "E9", "W",  # pycodestyle errors that are layout-independent
   "I",     # isort: no wildcard imports, ordered
   "N",     # pep8-naming
   "UP",    # pyupgrade
   "B",     # bugbear
   "S",     # bandit security
   "BLE",   # blind except
   "T20",   # print statements: use logging (Kingsrook logging rule)
   "ERA",   # commented-out code (Kingsrook: no zombie code)
   "FIX",   # FIXME/TODO must be resolved or tracked
   "TD",    # TODO format: author and issue link
   "PTH",   # pathlib over os.path
   "RET", "SIM", "C4", "PIE", "PL", "RUF",
   "ANN",   # type annotations on every function
   "D",     # docstrings on modules, classes, functions
   "LOG", "G",  # logging hygiene
]
ignore = [
   "D203",  # conflicts with D211
   "D213",  # conflicts with D212
   "TD003", # issue link is enforced by review, not regex
]

[lint.per-file-ignores]
"tests/**" = ["S101", "D", "ANN", "PLR2004"]

[lint.pydocstyle]
convention = "pep257"

[lint.flake8-tidy-imports]
ban-relative-imports = "all"