pyproject.toml

[project]
name = "druks"
version = "0.3.0"
description = "Autonomous software delivery; the self-hosted home for durable agent apps."
readme = "README.md"
license = "MIT"
license-files = ["LICENSE"]
authors = [{ name = "Paulo Alvarado Garcia" }]
keywords = ["agents", "dbos", "durable-execution", "orchestration", "workflows"]
classifiers = [
    "Development Status :: 3 - Alpha",
    "License :: OSI Approved :: MIT License",
    "Operating System :: POSIX :: Linux",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
]
requires-python = ">=3.11"
dependencies = [
    "asyncssh>=2.22",
    "drukbox-python-sdk>=0.0.6",
    # 0.138 adds app.frontend(), which serves an app's shipped dist/.
    "fastapi>=0.138.0",
    "githubkit[auth-app]>=0.15.5",
    "httpx>=0.28.0",
    "jinja2>=3.1",
    "pydantic>=2.12.0",
    "pydantic-settings>=2.14.2",
    "pyyaml>=6.0",
    "sqlalchemy>=2.0",
    "uvicorn>=0.38.0",
    "uuid-utils>=0.16.0",
    "psycopg[binary]>=3.2",
    "alembic>=1.13",
    "dbos>=2.26",
    "croniter>=6.2.2",
    "redis>=8",
    "tomlkit>=0.13",
    "blinker>=1.9",
    "apprise>=1.9",
    "cryptography>=48.0.1",
    "fastmcp>=3.4.4,<4",
]

[project.urls]
Documentation = "https://github.com/czpython/druks/tree/main/docs"
Issues = "https://github.com/czpython/druks/issues"
Repository = "https://github.com/czpython/druks"

[dependency-groups]
dev = [
    "pyjwt[crypto]>=2.13.0",
    "pyright>=1.1.411",
    "pytest>=9.1.1",
    "pytest-asyncio>=1.4.0",
    "pytest-timeout>=2.4.0",
    "ruff>=0.16.1",
]

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

[project.entry-points.pytest11]
druks = "druks.testing"

# Apps are discovered here. An app (in-tree today, a separate package
# tomorrow) registers one App subclass; the platform loads them at startup and
# walks each one's package for capabilities. Adding an app is one entry, not
# edits across the platform wiring.
[project.entry-points."druks.apps"]
core = "druks.core.app:Core"
review = "druks.contrib.review.app:Review"
ship = "druks.contrib.ship.app:Ship"
usage = "druks.usage.app:Usage"

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

[tool.hatch.build.targets.wheel]
packages = ["backend/druks"]

[tool.hatch.build.targets.sdist]
include = [
    "/backend/druks",
    "/LICENSE",
    "/pyproject.toml",
    "/README.md",
]

[tool.ruff]
line-length = 100
target-version = "py311"
# Alembic-generated revisions are machine-written; don't hand-lint them.
extend-exclude = ["backend/migrations/versions"]

[tool.ruff.lint]
select = ["E", "F", "I", "UP", "B", "SIM"]
# SIM108 rewrites if/else into a ternary; formatter-wrapped ternaries are banned here, and plain if/else is the house form.
ignore = ["SIM108"]

[tool.ruff.lint.flake8-bugbear]
# FastAPI dependency markers are the documented way to declare injected
# parameters; B008 (no function calls in argument defaults) is a false
# positive for them.
extend-immutable-calls = ["fastapi.Depends", "fastapi.Query"]

[tool.pytest.ini_options]
testpaths = ["backend/tests"]
asyncio_mode = "auto"
pythonpath = ["backend", "backend/tests"]
# A parked await hangs a run silently (the suite normally finishes in ~90s).
# thread method: dump EVERY thread's stack — DBOS workers included — then
# exit from inside the process, so CI ends the step normally and keeps the
# dump. Covers fixture setup, re-arms per test, survives pytest's own
# faulthandler cancellations.
timeout = 180
timeout_method = "thread"

[tool.pyright]
pythonVersion = "3.11"
include = ["backend"]
# Test code stays on extraPaths for import resolution but out of the checked set:
# its loose mocks (call_args, SimpleNamespace-as-Request) are false-positive noise
# that drowns the real signal in backend/druks.
exclude = ["backend/tests"]
# The proof app (backend/tests/druks-field_notes) is a standalone package; its
# root is on the path so its intra-package imports and the tests that load it resolve.
extraPaths = ["backend", "backend/tests", "backend/tests/druks-field_notes"]
typeCheckingMode = "standard"
reportAssignmentType = "warning"