pyproject.toml

[tool.ruff]
line-length = 88
target-version = "py313"
src = ["custom_components", "tests"]

[tool.ruff.lint]
select = [
    "E",      # pycodestyle
    "W",      # pycodestyle warnings
    "F",      # pyflakes
    "I",      # import sorting
    "UP",     # pyupgrade
    "B",      # bugbear
    "C4",     # comprehensions
    "SIM",    # simplify
    "RUF",    # ruff-specific
    "ASYNC",  # async correctness
    "D",      # docstrings
    "T20",    # no stray print()
]
ignore = [
    "D203",  # conflicts with D211
    "D213",  # conflicts with D212
    "E501",  # line length is the formatter's job
]

[tool.ruff.lint.per-file-ignores]
# Tests read better with plain asserts, long fixture literals and private
# access into the object under test.
"tests/*" = ["D100", "D103", "SIM117"]
"scripts/*" = ["D", "T20"]

[tool.ruff.lint.pydocstyle]
convention = "pep257"

[tool.mypy]
# The current test lane's interpreter. Home Assistant's own annotations use
# syntax the older mode cannot parse, so typing runs on the newer one while
# the code itself still has to work on the supported floor - which is what
# ruff's target-version keeps honest.
python_version = "3.14"
strict = true
packages = ["custom_components.boilerjuice"]
# Home Assistant ships py.typed but its own annotations are not complete
# enough for a downstream strict run; these are the seams where that shows.
disallow_untyped_decorators = false
warn_unused_ignores = false

[[tool.mypy.overrides]]
module = ["bs4.*"]
ignore_missing_imports = true

[tool.pytest.ini_options]
testpaths = ["tests"]
asyncio_mode = "auto"
# Set explicitly rather than left to the default, which pytest-asyncio warns
# about on the minimum lane. Every test gets its own loop.
asyncio_default_fixture_loop_scope = "function"
addopts = "-p no:randomly"

[tool.coverage.run]
source = ["custom_components/boilerjuice"]
branch = false

[tool.coverage.report]
show_missing = true
fail_under = 95
exclude_also = [
    "if TYPE_CHECKING:",
    "raise NotImplementedError",
]