pyproject.toml

[project]
name = "chapkit"
version = "0.1.0"
description = "Async SQLAlchemy database library for Python 3.13+ with FastAPI integration and ML workflow support"
readme = "README.md"
authors = [{ name = "Morten Hansen", email = "morten@winterop.com" }]
license = { text = "AGPL-3.0-or-later" }
requires-python = ">=3.13"
keywords = [
    "fastapi",
    "sqlalchemy",
    "async",
    "database",
    "ml",
    "machine-learning",
    "rest-api",
    "crud",
    "vertical-slice",
]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.13",
    "Framework :: FastAPI",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Database",
]
dependencies = [
    "aiosqlite>=0.21.0",
    "alembic>=1.17.0",
    "fastapi[standard]>=0.119.0",
    "geojson-pydantic>=2.1.0",
    "gunicorn>=23.0.0",
    "opentelemetry-api>=1.37.0",
    "opentelemetry-exporter-prometheus>=0.58b0",
    "opentelemetry-instrumentation-fastapi>=0.58b0",
    "opentelemetry-instrumentation-sqlalchemy>=0.58b0",
    "opentelemetry-sdk>=1.37.0",
    "pandas>=2.3.3",
    "pydantic>=2.12.0",
    "python-ulid>=3.1.0",
    "scikit-learn>=1.7.2",
    "sqlalchemy[asyncio]>=2.0.43",
    "structlog>=24.4.0",
]

[project.urls]
Homepage = "https://github.com/winterop-com/chapkit"
Repository = "https://github.com/winterop-com/chapkit"
Issues = "https://github.com/winterop-com/chapkit/issues"
Documentation = "https://github.com/winterop-com/chapkit#readme"

[dependency-groups]
dev = [
    "coverage[toml]>=7.6.0",
    "mypy>=1.18.2",
    "pandas-stubs>=2.2.3.250101",
    "pytest>=8.4.2",
    "pytest-cov>=5.0.0",
    "pytest-asyncio>=1.2.0",
    "ruff>=0.14.0",
    "pyright>=1.1.406",
    "scikit-learn>=1.7.2",
    "mkdocs-material>=9.6.21",
    "mkdocstrings>=0.30.1",
    "mkdocstrings-python>=1.18.2",
]

[build-system]
requires = ["uv_build>=0.9.0,<0.10.0"]
build-backend = "uv_build"

[tool.ruff]
target-version = "py313"
line-length = 120

[tool.ruff.lint]
fixable = ["ALL"]
select = [
    "E",   # pycodestyle errors
    "W",   # pycodestyle warnings
    "F",   # pyflakes
    "I",   # isort
    "D",   # pydocstyle (docstring checking)
]
ignore = [
    "D203",  # one-blank-line-before-class (conflicts with D211)
    "D213",  # multi-line-summary-second-line (conflicts with D212)
]

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

[tool.ruff.lint.per-file-ignores]
# Tests don't need docstrings
"tests/**/*.py" = ["D"]
# Alembic migrations are autogenerated
"alembic/**/*.py" = ["D"]
# Allow missing docstrings in __init__ files if they're just exports
"**/__init__.py" = ["D104"]
# Internal source - allow some missing docstrings for now
"src/**/*.py" = [
    "D102",  # Missing docstring in public method (TODO: fix gradually)
    "D105",  # Missing docstring in magic method
    "D107",  # Missing docstring in __init__ (TODO: fix gradually)
]
# Examples must have all docstrings (strictest enforcement)
"examples/**/*.py" = []

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
docstring-code-format = true
docstring-code-line-length = "dynamic"

[tool.pytest.ini_options]
asyncio_mode = "auto"
testpaths = ["tests"]
norecursedirs = ["examples", ".git", ".venv", "__pycache__"]
filterwarnings = [
    "ignore:Pydantic serializer warnings:UserWarning",
    "ignore:Remove.*format_exc_info.*:UserWarning",
]

[tool.coverage.run]
branch = true
dynamic_context = "test_function"
relative_files = true
source = ["chapkit"]

[tool.coverage.report]
exclude_also = [
    "if TYPE_CHECKING:",
]
precision = 2
show_missing = true
skip_covered = true

[tool.mypy]
python_version = "3.13"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
check_untyped_defs = true
disallow_any_unimported = true
no_implicit_optional = true
warn_unused_ignores = true
strict_equality = true
mypy_path = ["src", "typings"]

[[tool.mypy.overrides]]
module = "tests.*"
disallow_untyped_defs = false

[tool.pyright]
include = ["src", "tests", "examples", "alembic"]
pythonVersion = "3.13"
typeCheckingMode = "strict"
diagnosticMode = "workspace"
useLibraryCodeForTypes = true
reportPrivateUsage = false  # Tests need to access protected members
reportUnusedFunction = false  # Decorated functions (pytest fixtures, routes) flagged incorrectly
reportUnusedTypeParameters = true  # Catch unused type parameters in generic classes
reportUnknownMemberType = false  # Third-party libraries (pandas) have incomplete stubs
reportUnknownArgumentType = false  # Related to third-party stub issues
reportUnknownParameterType = false  # Test helpers don't need full annotations
reportUnknownVariableType = false  # Related to third-party stub issues
reportMissingTypeArgument = false  # Allow dict without type args in tests
reportMissingTypeStubs = false  # Third-party libraries (OpenTelemetry) missing stubs