pyproject.toml

[project]
name = "mypackage"
version = "0.1.0"
description = "A short description of your project"
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
    # --- Core runtime dependencies ---
    # Add project-specific dependencies here.
    # Examples:
    # "httpx>=0.27.0",
    "fastapi>=0.110.0",
    "uvicorn[standard]>=0.29.0",
    "typer>=0.12.0",
    "pydantic-settings>=2.0.0",
    "loguru>=0.7.0",
    "rich>=13.0.0",
]

[dependency-groups]
dev = [
    "pytest>=8.0.0",
    "pytest-cov>=5.0.0",
    "httpx>=0.27.0",        # for FastAPI TestClient
    "ruff>=0.4.0",
    "mypy>=1.10.0",
]

# Expose a CLI entry point once you have a real command.
# [project.scripts]
# mypackage = "mypackage.main:app"

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

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

# ---------------------------------------------------------------------------
# pytest
# ---------------------------------------------------------------------------
[tool.pytest.ini_options]
pythonpath = ["src"]
testpaths  = ["tests"]
addopts    = "-ra -q"
markers = [
    "integration: marks tests as slow integration tests requiring real I/O",
    "e2e: marks end-to-end tests that spin up the full stack",
]

# ---------------------------------------------------------------------------
# ruff — lint + format (replaces black, isort, flake8)
# ---------------------------------------------------------------------------
[tool.ruff]
line-length    = 88
target-version = "py311"

[tool.ruff.lint]
select = [
    "E",   # pycodestyle errors
    "W",   # pycodestyle warnings
    "F",   # pyflakes
    "I",   # isort
    "UP",  # pyupgrade
    "B",   # flake8-bugbear
    "C4",  # flake8-comprehensions
    "SIM", # flake8-simplify
]
ignore = [
    "E501", # line length — handled by formatter
]

[tool.ruff.lint.isort]
known-first-party = ["mypackage"]

# ---------------------------------------------------------------------------
# mypy — static type checking
# ---------------------------------------------------------------------------
[tool.mypy]
python_version        = "3.11"
strict                = true
ignore_missing_imports = true
# If you add inline stubs later, remove the line above and add per-module overrides.

# ---------------------------------------------------------------------------
# coverage
# ---------------------------------------------------------------------------
[tool.coverage.run]
source   = ["src"]
branch   = true

[tool.coverage.report]
show_missing = true
fail_under   = 0  # raise once you have a baseline