pyproject.toml

[build-system]
build-backend = "hatchling.build"
requires = ["hatchling", "uv-dynamic-versioning"]

[dependency-groups]
dev = [
    "black~=26.0",
    "pre-commit~=4.0",
]
docs = [
    "mkdocs-material~=9.6",
    "mkdocstrings[python]>=0.29,<2.0",
    "mkdocs~=1.6",
]
test = [
    "coverage~=7.3",
    "mypy~=2.0",
    "pytest-asyncio~=1.0",
    "pytest~=9.0",
]

[project]
authors = [
    {email = "zoola969@gmail.com", name = "Alexander Dmitriev"},
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: Apache Software License",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Programming Language :: Python",
    "Topic :: Software Development :: Libraries",
    "Typing :: Typed",
]
dependencies = [
    "ttlru-map~=1.1",
    "typing-extensions~=4.0",
]
description = "Sync and async cache with TTL and LRU support."
dynamic = ["version"]
keywords = ["cache", "lru", "lru-cache", "time-to-live", "ttl"]
license = {file = "LICENSE"}
name = "cachium"
readme = "README.md"
requires-python = ">=3.10"

[project.urls]
Changelog = "https://github.com/zoola969/cachium/blob/main/CHANGELOG.md"
Documentation = "https://zoola969.github.io/cachium/"
Homepage = "https://github.com/zoola969/cachium"
Issues = "https://github.com/zoola969/cachium/issues"
Repository = "https://github.com/zoola969/cachium.git"

[tool.black]
color = true
line-length = 120

[tool.coverage.report]
exclude_also = [
    "def __repr__",
    "if sys.version_info",
    "if TYPE_CHECKING",
    "if typing.TYPE_CHECKING",
]
omit = [
    "tests/*",
]

[tool.hatch.version]
source = "uv-dynamic-versioning"

[tool.mypy]
enable_error_code = [
    "exhaustive-match",
    "explicit-override",
    "ignore-without-code",
    "possibly-undefined",
    "redundant-expr",
    "redundant-self",
    "truthy-bool",
    "unused-awaitable",
]
strict = true
warn_unreachable = true

[tool.pytest.ini_options]
addopts = [
    "--code-highlight=yes",
    "--color=yes",
    "--log-cli-level=DEBUG",
    "--strict-config",
    "--strict-markers",
    "-vv",
]
asyncio_default_fixture_loop_scope = "session"
asyncio_mode = "auto"

[tool.ruff]
line-length = 120
output-format = "full"
show-fixes = true

[tool.ruff.lint]
allowed-confusables = ["ρ", "−", "∗"]
extend-safe-fixes = [
    "ANN204",
    "EM101",
    "EM102",  # f-string-in-exception
    "TC002",  # Move third-party imports into a type-checking block
    "TC003",  # Move standard imports into a type-checking block
    "TCH001",
    "UP007",
]
fixable = ["ALL"]
ignore = [
    "A003",  # Class attribute {name} is shadowing a python builtin
    "AIR",  # airflow
    "COM812",  # conflicts with ruff-format trailing comma management
    "CPY",  # flake8-copyright
    "D100",  # Missing docstring in public module
    "D104",  # Missing docstring in public package
    "D107",  # Missing docstring in __init__
    "D203",  # 1 blank line required before class docstring
    "D213",  # Multi-line docstring summary should start at the second line
    "PLC1901",  # compare-to-empty-string
    "PYI041",  # redundant-numeric-union. Use `float` instead of `int | float`
]
select = ["ALL"]

[tool.ruff.lint.flake8-comprehensions]
allow-dict-calls-with-keyword-arguments = true

[tool.ruff.lint.flake8-pytest-style]
parametrize-values-type = "list"

[tool.ruff.lint.flake8-type-checking]
strict = true

[tool.ruff.lint.flake8-unused-arguments]
ignore-variadic-names = true

[tool.ruff.lint.per-file-ignores]
"__init__.py" = [
    "F401",  # imported but unused
]
"docs/source/conf.py" = [
    "A001",  # variable is shadowing a python builtin
    "INP001",  # __init__ is missing
]
"tests/*" = [
    "ANN201",  # Missing return type annotation for public function
    "ANN401",  # Dynamically typed expressions are disallowed
    "ARG001",  # Unused function argument
    "ARG005",  # Unused lambda argument
    "D101",  # Missing docstring in public class
    "D103",  # Missing docstring in public function
    "FBT001",  # Boolean-typed positional argument in function definition
    "PLR2004",  # Magic value in comparison
    "S101",  # Use of assert detected
    "S311",  # Standard pseudo-random generators are not suitable for security/cryptographic purposes
    "SLF001",  # Private member accessed
]

[tool.ruff.lint.pylint]
allow-magic-value-types = []
max-args = 10

[tool.tomlsort]
all = true
ignore_case = true
in_place = true
no_block_comments = false
no_comments = false
no_footer_comments = false
no_header_comments = false
no_inline_comments = false
no_sort_tables = false
sort_inline_arrays = true
sort_inline_tables = true
sort_table_keys = true
spaces_before_inline_comment = 2
spaces_indent_inline_array = 4
trailing_comma_inline_array = true

[tool.uv]
default-groups = ["dev", "docs", "test"]

[tool.uv-dynamic-versioning]
fallback-version = "0.0.0"