pyproject.toml

[project]
name = "vkra-protocol"
dynamic = ["version"]
description = "VKRA Protocol - Open Source LLMA Framework for Contextual Product Matching"
readme = "README.md"
summary = "Modular framework for commission-based monetization in LLM applications. Enables contextual product matching with affiliate revenue optimization while maintaining user trust through the Polite Ad Network approach."
authors = [
    { name = "VKRA", email = "hello@vkra.org" }
]
license = { text = "MIT" }
maintainers = [
    { name = "VKRA", email = "hello@vkra.org" }
]

classifiers = [
    "License :: OSI Approved :: MIT License",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Operating System :: OS Independent",
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
    "Topic :: Office/Business :: Financial",
    "Topic :: Office/Business :: Financial :: Investment",
    "Typing :: Typed",
    "Framework :: AsyncIO",
]
keywords = [
    "llm",
    "llma",
    "rag",
    "vector-search",
    "product-matching",
    "affiliate-marketing",
    "contextual-ads",
    "embeddings",
    "personalization",
    "recommendation-system",
    "ai-agents",
    "monetization",
    "agentic-monetization",
    "polite-ad-network",
    "commission-based",
    "conversion-optimization",
    "autonomous-agents",
    "llm-applications",
    "product-recommendations",
    "affiliate-commission",
    "revenue-optimization",
    "gdpr-compliant",
    "privacy-first",
]
requires-python = ">=3.11"
dependencies = [
    "httpx>=0.28.1",
    "pydantic>=2.0.0",
]

[project.urls]
"Home Page" = "https://www.vkra.org"
"Documentation" = "https://vkra.org/docs"
"Repository" = "https://github.com/vkra/vkra-protocol"
"Issues" = "https://github.com/vkra/vkra-protocol/issues"
"Changelog" = "https://github.com/vkra/vkra-protocol/blob/main/CHANGELOG.md"

[tool.hatch.version]
path = "src/vkra_protocol/__about__.py"

[tool.hatch.envs.default]
installer = "uv"

[tool.hatch.envs.test]
dependencies = [
    "pytest>=9.0.2",
    "pytest-asyncio>=1.3.0",
    "pytest-cov>=7.0.0",
]
scripts = [
    "test = pytest {args:tests}",
    "test:unit = pytest tests/unit {args}",
    "test:integration = pytest tests/integration -m integration {args}",
    "test:coverage = pytest tests --cov=src/vkra_protocol --cov-report=term-missing --cov-report=html {args}",
]

[tool.hatch.envs.lint]
dependencies = [
    "ruff>=0.1.0",
    "mypy>=1.0.0",
]
scripts = [
    "ruff = ruff {args:.}",
    "ruff:check = ruff check {args:.}",
    "ruff:format = ruff format {args:.}",
    "mypy = mypy {args:src/vkra_protocol}",
]

[tool.hatch.envs.types]
dependencies = [
    "mypy>=1.0.0",
]
scripts = [
    "mypy = mypy {args:src/vkra_protocol}",
]

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

[tool.hatch.build.targets.wheel]
# Only package the source code - exclude docs, examples, tests, etc.
packages = ["src/vkra_protocol"]
exclude = [
    "/docs",
    "/examples",
    "/tests",
    "/postman",
    "/.github",
    "*.md",
    "*.yaml",
    "*.json",
    "*.sh",
    "*.js",
    "*.ts",
]

[tool.hatch.build.targets.sdist]
# For source distributions, include data but exclude examples/docs
include = [
    "/src",
    "/data",
    "/README.md",
    "/LICENSE",
    "/pyproject.toml",
]
exclude = [
    "/docs",
    "/examples",
    "/tests",
    "/postman",
    "/.github",
    "*.yaml",
    "*.json",
    "*.sh",
    "*.js",
    "*.ts",
]

[tool.ruff]
line-length = 100
target-version = "py314"

[tool.mypy]
python_version = "3.14"
warn_return_any = true
warn_unused_configs = true

[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py"]
python_classes = ["Test*"]
python_functions = ["test_*"]
markers = [
    "unit: Unit tests for core logic (mocked adapters)",
    "integration: Integration tests for vertical slices (real core, mocked adapters)",
]
asyncio_mode = "auto"
addopts = [
    "--strict-markers",
    "--cov=src/vkra_protocol",
    "--cov-report=term-missing",
    "--cov-report=html",
    "-v",
]

[tool.coverage.run]
source = ["src/vkra_protocol"]
omit = [
    "*/tests/*",
    "*/test_*.py",
    "*/__pycache__/*",
]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "raise AssertionError",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "if TYPE_CHECKING:",
    "@abstractmethod",
]

[dependency-groups]
dev = [
    "pytest>=9.0.2",
    "pytest-asyncio>=1.3.0",
    "pytest-cov>=7.0.0",
    "ruff>=0.1.0",
    "mypy>=1.0.0",
]