pyproject.toml

[project]
name = "archex"
version = "0.28.0"
description = "Architecture extraction & codebase intelligence for the agentic era"
readme = "README.md"
license = { text = "Apache-2.0" }
requires-python = ">=3.11"
authors = [{ name = "Tom" }]
keywords = ["architecture", "codebase", "retrieval", "rag", "ast", "code-intelligence"]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "Topic :: Software Development :: Libraries",
    "License :: OSI Approved :: Apache Software License",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
]
dependencies = [
    "tree-sitter>=0.23",
    "tree-sitter-python>=0.23",
    "tree-sitter-javascript>=0.23",
    "tree-sitter-typescript>=0.23",
    "tree-sitter-go>=0.23",
    "tree-sitter-rust>=0.23",
    "tree-sitter-java>=0.23",
    "tree-sitter-kotlin>=1.1",
    "tree-sitter-c-sharp>=0.23",
    "tree-sitter-language-pack>=0.13,<1.0",
    "tiktoken>=0.7",
    "pydantic>=2.7",
    "networkx>=3.3",
    "numpy>=1.24",
    "scipy>=1.11.2",
    "click>=8.1",
    "pyyaml>=6.0",
    "rich==14.3.3",
    "mcp>=2.0,<3.0",
    "watchdog>=6.0.0",
]

[project.optional-dependencies]
vector-fast = [
    "fastembed>=0.4",
]
graph = [
    "python-igraph>=0.11",
    "leidenalg>=0.10",
]
vector-torch = [
    "sentence-transformers>=5.2,<6",
    "transformers>=4.41,<5",
]
splade = [
    "transformers>=4.41,<5",
    "torch>=2.0",
]
mcp = [] # Preserved for backwards compatibility with archex[mcp]
langchain = ["langchain-core>=0.2"]
llamaindex = ["llama-index-core>=0.10"]
lsap = ["lsp-client>=0.3; python_version >= '3.12'"]
scip = ["protobuf>=7.35.1"]
toon = ["toons>=0.7.0"]
all = ["archex[vector-fast,graph,vector-torch,splade,mcp,langchain,llamaindex,lsap,scip,toon]"]

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

[project.entry-points."archex.language_adapters"]
# Example: java = "mypackage.adapters:JavaAdapter"

[project.entry-points."archex.pattern_detectors"]
# Example: my_pattern = "mypackage.patterns:detect_my_pattern"

[project.entry-points."archex.benchmark_strategies"]
# Example: custom_strategy = "mypackage.strategies:run_custom"

[project.entry-points."archex.embedders"]
# Example: custom_embedder = "mypackage.embedders:my_embedder_factory"

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

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

[tool.ruff]
target-version = "py311"
line-length = 100
extend-exclude = ["src/archex/integrations/semantic/scip_pb2.py"]

[tool.ruff.lint]
select = ["E", "F", "I", "N", "UP", "B", "SIM", "TCH"]
ignore = ["TC003"]

[tool.pyright]
pythonVersion = "3.11"
typeCheckingMode = "strict"
include = ["src/archex", "tests", "benchmarks/corpus_audit"]
# assets/archex_explainer.py depends on optional Manim rendering packages and is validated by render smoke when edited.
# Generated approval-test state is not repository source and is not type-checked.
# scip_pb2.py is protoc-generated code (regenerate via scip.proto in the same directory),
# not hand-authored source, and is not type-checked.
# benchmarks/replication/ holds standalone operator scripts that drive an external paper's
# harness. They deliberately target that harness's pinned dependency versions (tree_sitter
# 0.20.4's Parser.set_language and Language.build_library, both removed in the 0.23+ this
# project pins) and import the harness itself, which does not exist in a checkout, so strict
# checking here reports intentional version-mismatch errors. Their use of
# archex.benchmark.replication{,_analysis} is covered by tests/benchmark/test_s0_replication_artifacts.py.
exclude = [
    "tests/fixtures/",
    ".venv/",
    "assets/",
    "benchmarks/replication/",
    ".approval_tests_temp/",
    "src/archex/integrations/semantic/scip_pb2.py",
]
venvPath = "."
venv = ".venv"

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "--cov=archex --cov-report=term-missing --cov-fail-under=85 -m 'not slow'"
markers = [
    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
    "network: marks tests that require network access",
]

[tool.coverage.run]
source = ["archex"]
omit = ["src/archex/cli/*"]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "if TYPE_CHECKING:",
    "if __name__ == .__main__.",
    "@overload",
]

[dependency-groups]
dev = [
    "httpx>=0.27",
    "langchain-core>=0.2",
    "llama-index-core>=0.10",
    "mcp>=2.0,<3.0",
    "pre-commit>=3.7",
    "pyright>=1.1",
    "pytest>=9.0.2",
    "pytest-asyncio>=1.3.0",
    "pytest-cov>=7.0.0",
    "ruff>=0.5",
]