pyproject.toml

[tool.uv]
constraint-dependencies = ["filelock>=3.25.2"]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "yokedcache"
dynamic = ["version"]
description = "Async-first multi-backend cache (memory, Redis, Memcached, disk, SQLite); sync helpers for scripts; tag invalidation, optional HTTP middleware, metrics"
readme = "README.md"
license = "MIT"
requires-python = ">=3.10"
authors = [
    { name = "Project Yoked LLC" },
]
keywords = [
    "async cache",
    "sync helpers",
    "cache invalidation",
    "multi-backend cache",
    "redis",
    "memcached",
    "python caching",
    "fastapi",
    "starlette",
    "asgi",
    "sqlalchemy",
    "tag invalidation",
    "prometheus",
    "opentelemetry",
]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: MIT 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",
    "Topic :: Database",
    "Topic :: Database :: Front-Ends",
    "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: System :: Distributed Computing",
    "Topic :: Software Development :: Libraries :: Application Frameworks",
    "Framework :: FastAPI",
    "Framework :: AsyncIO",
    "Environment :: Web Environment",
    "Intended Audience :: System Administrators",
    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
    "Topic :: Software Development :: Libraries",
]
dependencies = [
    "orjson>=3.11.6",
    "pyyaml>=6.0",
    "click>=8.0.0",
    "typing-extensions>=4.0.0",
]

[project.optional-dependencies]
redis = ["redis>=4.0.0"]
web = ["starlette>=0.27.0"]
sqlalchemy = ["sqlalchemy>=1.4.0"]
fuzzy = ["fuzzywuzzy>=0.18.0", "python-levenshtein>=0.12.0"]
memcached = ["aiomcache>=0.8.0,<1.0.0"]
monitoring = [
    "prometheus_client>=0.16.0",
    "statsd>=4.0.0",
]
vector = [
    "numpy>=1.21.0",
    "scipy>=1.7.0",
    "scikit-learn>=1.0.0",
]
disk = [
    "diskcache>=5.0.0",
]
sqlite = [
    "aiosqlite>=0.19.0",
]
tracing = [
    "opentelemetry-api>=1.15.0",
    "opentelemetry-sdk>=1.15.0",
]
backends = [
    "diskcache>=5.0.0",
    "aiosqlite>=0.19.0",
    "aiomcache>=0.8.0,<1.0.0",
]
observability = [
    "prometheus_client>=0.16.0",
    "statsd>=4.0.0",
    "opentelemetry-api>=1.15.0",
    "opentelemetry-sdk>=1.15.0",
]
full = [
    "redis>=4.0.0",
    "fastapi>=0.68.0",
    "sqlalchemy>=1.4.0",
    "fuzzywuzzy>=0.18.0",
    "python-levenshtein>=0.12.0",
    "aiomcache>=0.8.0,<1.0.0",
    "prometheus_client>=0.16.0",
    "statsd>=4.0.0",
    "numpy>=1.21.0",
    "scipy>=1.7.0",
    "scikit-learn>=1.0.0",
    "diskcache>=5.0.0",
    "aiosqlite>=0.19.0",
    "opentelemetry-api>=1.15.0",
    "opentelemetry-sdk>=1.15.0",
]
dev = [
    "build>=1.0.0",
    "twine>=4.0.0",
    "pytest>=7.0.0",
    "pytest-asyncio>=0.21.0",
    "pytest-cov>=4.0.0",
    "black==26.3.1",
    "isort>=5.10.0",
    "flake8>=4.0.0",
    "mypy>=1.0.0",
    "pre-commit>=2.20.0",
    "fakeredis>=2.0.0",
    "httpx>=0.24.0",
    "types-PyYAML>=6.0.0",
    "types-redis>=4.0.0",
    "redis>=4.0.0",
    "fastapi>=0.68.0",
    "fuzzywuzzy>=0.18.0",
    "python-levenshtein>=0.12.0",
    "aiomcache>=0.8.0,<1.0.0",
    "prometheus_client>=0.16.0",
    "statsd>=4.0.0",
    "numpy>=1.21.0",
    "scipy>=1.7.0",
    "scikit-learn>=1.0.0",
    "diskcache>=5.6.0",
    "aiosqlite>=0.19.0",
    "opentelemetry-api>=1.24.0",
    "opentelemetry-sdk>=1.24.0",
]
docs = [
    "jinja2>=3.1.0",
    "markdown>=3.5.0",
    "pdoc>=14.0.0",
    "pygments>=2.14.0",
]

[project.urls]
Homepage = "https://github.com/sirstig/yokedcache"
Documentation = "https://sirstig.github.io/yokedcache"
Repository = "https://github.com/sirstig/yokedcache"
"Bug Tracker" = "https://github.com/sirstig/yokedcache/issues"

[project.scripts]
yokedcache = "yokedcache.cli:main"

[tool.hatch.version]
path = "src/yokedcache/__init__.py"

[tool.hatch.build.targets.wheel]
packages = ["src/yokedcache"]

[tool.black]
line-length = 88
target-version = ["py310"]
include = '\.pyi?$'

[tool.isort]
profile = "black"
multi_line_output = 3
line_length = 88

[tool.mypy]
python_version = "3.10"
warn_return_any = false
warn_unused_configs = true
disallow_untyped_defs = false
disallow_incomplete_defs = false
check_untyped_defs = true
no_implicit_optional = true
warn_redundant_casts = true
warn_unused_ignores = false
show_error_codes = true
ignore_missing_imports = true

[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py", "*_test.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
addopts = [
    "--strict-config",
    "--strict-markers",
    "--cov=yokedcache",
    "--cov-report=term-missing",
    "--cov-report=html",
]
asyncio_mode = "auto"
markers = [
    "integration: marks tests as integration tests",
    "slow: marks tests as slow running",
]

[tool.coverage.run]
source = ["src/yokedcache"]
omit = ["tests/*"]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "if self.debug:",
    "if settings.DEBUG",
    "raise AssertionError",
    "raise NotImplementedError",
    "if 0:",
    "if __name__ == .__main__.:",
    "class .*\\bProtocol\\):",
    "@(abc\\.)?abstractmethod",
]

[tool.flake8]
max-line-length = 88
extend-ignore = ["E203", "E501", "W503"]