pyproject.toml

[project]
name = "a2a-handler"
version = "0.4.0"
description = "An A2A Protocol client TUI and CLI."
readme = "README.md"
requires-python = ">=3.11"
license = "GPL-3.0-or-later"
license-files = ["LICENSE"]
authors = [
    { name = "Al Duncanson", email = "alDuncanson@proton.me" }
]
keywords = [
    "a2a",
    "a2a-protocol",
    "agent",
    "agent-to-agent",
    "ai",
    "cli",
    "tui",
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Environment :: Console",
    "Intended Audience :: Developers",
    "Operating System :: OS Independent",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Typing :: Typed",
]
dependencies = [
    "a2a-sdk[http-server]>=1.0.0,<2.0.0",
    "click>=8.0.0",
    "httpx>=0.27.0",
    "python-dotenv>=1.0.0",
    "rich>=13.0.0",
    # Imported directly by the push notification webhook server. Declared rather
    # than relied upon transitively via a2a-sdk[http-server].
    "starlette>=0.37.0",
    "textual>=0.47.0",
    "uvicorn>=0.30.0",
    "textual-serve>=1.1.0",
    "mcp[cli]>=1.27.1,<2",
    "truststore>=0.9.0",
    "platformdirs>=4.0.0",
]

[project.optional-dependencies]
# Talking to gRPC-only agents needs the SDK's gRPC transport and its
# grpcio dependencies, which are heavy enough to keep out of the default
# install.
grpc = ["a2a-sdk[grpc]>=1.0.0,<2.0.0"]

[dependency-groups]
dev = [
    "ruff>=0.8.0",
    "textual-dev>=1.8.0",
    "pytest>=8.0.0",
    "pytest-asyncio>=0.23.0",
    "ty>=0.0.1a27",
    "pytest-cov>=7.1.0",
    "pytest-textual-snapshot>=1.0.0",
]

[project.urls]
Homepage = "https://github.com/alDuncanson/handler"
Repository = "https://github.com/alDuncanson/handler"
Documentation = "https://github.com/alDuncanson/handler/tree/main/docs"
Issues = "https://github.com/alDuncanson/handler/issues"
Changelog = "https://github.com/alDuncanson/handler/releases"

[project.scripts]
handler = "a2a_handler.cli:main"

[build-system]
requires = ["uv_build>=0.9.15,<0.14.0"]
build-backend = "uv_build"

[tool.uv.build-backend]
module-root = "src"

# This is a public package published to PyPI, so its lockfile must resolve from
# pypi.org. Pinned explicitly because an ambient UV_INDEX_URL (e.g. a corporate
# mirror) would otherwise rewrite every source URL in uv.lock on the next
# `uv lock`, leaking internal infrastructure and breaking CI for contributors.
[[tool.uv.index]]
name = "pypi"
url = "https://pypi.org/simple"
default = true

[tool.pytest.ini_options]
asyncio_mode = "auto"

[tool.ruff.lint]
select = [
    "E", "W",   # pycodestyle
    "F",        # pyflakes
    "I",        # isort
    "UP",       # pyupgrade
    "B",        # bugbear
    "A",        # shadowed builtins
    "C4",       # comprehensions
    "SIM",      # simplify
    "PT",       # pytest style
    "ASYNC",    # async pitfalls
    "S",        # bandit
    "LOG", "G", # logging
    "PERF",     # perflint
    "N",        # pep8-naming
    "ERA",      # commented-out code
    "RUF",      # ruff-specific
]
ignore = [
    "E501", # line length is ruff format's job
    "S101", # asserts narrow types for ty; Handler never runs under -O
]

[tool.ruff.lint.per-file-ignores]
"src/a2a_handler/cli/__init__.py" = ["E402"]
# Textual widgets take `id`, like their base classes.
"src/a2a_handler/tui/**" = ["A002"]
# Tests monkeypatch with setattr and hold fixture secrets, paths, and bind addresses.
"tests/**" = ["B009", "B010", "S104", "S105", "S106", "S108"]

[tool.coverage.run]
source = ["a2a_handler"]

[tool.coverage.report]
fail_under = 88
show_missing = true
skip_empty = true
exclude_lines = [
    "pragma: no cover",
    "if TYPE_CHECKING:",
    "if __name__ == .__main__.",
]