pyproject.toml

[build-system]
requires = ["hatchling", "hatch-vcs"]
build-backend = "hatchling.build"

[project]
name = "agctl"
description = "Agent-facing CLI harness for testing distributed systems"
dynamic = ["version"]
readme = "README.md"
requires-python = ">=3.11"
license = "MIT"
authors = [
    { name = "Dmitry Teryaev", email = "doudmitry@gmail.com" },
]
keywords = ["cli", "testing", "agent", "distributed-systems", "kafka", "http", "database"]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "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",
    "Topic :: Software Development :: Testing",
]
dependencies = [
    "click>=8.1",
    "pyyaml>=6.0",
    "pydantic>=2.0",
    "python-dotenv>=1.0",
]

[project.optional-dependencies]
http = ["httpx>=0.27"]
jq = ["jq>=1.6"]
# confluent_kafka.schema_registry (used by agctl/serialization/registry.py)
# imports authlib, cachetools, attrs, certifi, and httpx at module load time.
# confluent-kafka declares these only under its own [schemaregistry] extra —
# NOT as core deps — so a plain `confluent-kafka>=2.4` pin leaves SR broken:
# pip install 'agctl[kafka]' would import-fail with ModuleNotFoundError on the
# first missing module. Requesting confluent-kafka[schemaregistry] makes SR
# work out of the box and tracks future upstream additions automatically.
kafka = ["confluent-kafka[schemaregistry]>=2.4", "jq>=1.6"]
db = ["psycopg[binary]>=3.1", "jq>=1.6"]
mysql = ["PyMySQL>=1.1", "jq>=1.6"]
logs = ["jq>=1.6"]
loki = ["httpx>=0.27", "jq>=1.6"]
grpc = ["grpcio>=1.62", "grpcio-tools>=1.62", "grpcio-health-checking>=1.62", "grpcio-reflection>=1.62", "protobuf>=4.25", "jq>=1.6"]
avro = ["fastavro>=1.8"]
# Standalone: deliberately does NOT pull grpcio — a Kafka-Protobuf user must
# not be forced into the (much heavier) grpc extra.
protobuf = ["protobuf>=4.25"]
# Convenience meta-extra: one pip install pulls every SR codec.
schema-registry = ["agctl[avro,protobuf]"]
dev = ["pytest>=8.0"]
integration = [
    "testcontainers",
    "agctl[db,kafka,http,grpc]",
    # Live SR integration tests must be able to decode Avro/Protobuf payloads.
    "agctl[schema-registry]",
    "pytest>=8.0",
]

[project.urls]
Homepage = "https://github.com/HumanBean17/agctl"
Repository = "https://github.com/HumanBean17/agctl"
Issues = "https://github.com/HumanBean17/agctl/issues"
Changelog = "https://github.com/HumanBean17/agctl/releases"

[project.scripts]
agctl = "agctl.cli:cli"
agt = "agctl.cli:cli"

[project.entry-points."agctl.db_drivers"]
postgresql = "agctl.clients.db_drivers.postgresql:PostgreSQLDriver"
mysql = "agctl.clients.db_drivers.mysql:MySQLDriver"
sqlite = "agctl.clients.db_drivers.sqlite:SQLiteDriver"

[project.entry-points."agctl.plugins"]
# Third-party protocol plugins register here, e.g.:
# grpc = "agctl_grpc:GRPCPlugin"

[project.entry-points."agctl.assertions"]
# Third-party assertion modes register here, e.g.:
# json_schema = "agctl_jsonschema:JSONSchemaAssertion"

[project.entry-points."agctl.logs_backends"]
# Third-party log backends register here, e.g.:
# journald = "agctl_logs_journald:JournaldBackend"

[tool.hatch.build.targets.wheel]
packages = ["agctl"]

# Single source of truth for the version is the git tag. hatch-vcs derives the
# package version from tag history: released tag v3.0.0 -> 3.0.0; between tags a
# dev version (3.0.1.devN). local_scheme=no-local-version keeps dev builds PEP 440
# (pip-installable). See docs/RELEASING.md.
[tool.hatch.version]
source = "vcs"
# local_scheme=no-local-version keeps dev builds PEP 440 (pip-installable);
# the default setuptools-scm tag regex already matches the v<major>.<minor>.<patch> scheme.
raw-options = { local_scheme = "no-local-version" }

[tool.pytest.ini_options]
testpaths = ["tests"]