pyproject.toml

[build-system]
requires = ["setuptools>=82.0.1", "setuptools-scm>=10.2.1", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "mdd"
dynamic = ["version"]
description = "Markdown and Quarto document tooling"
readme = "README.md"
requires-python = ">=3.14"
dependencies = [
    "docling>=2.118.0",
    "httpx>=0.28.1",
    "linkify-it-py>=2.1.0",
    "lxml>=6.1.1",
    "markdown-it-py>=4.2.0",
    "mdit-py-plugins>=0.6.1",
    "openai>=2.53.0",
    "pillow>=12.3.0",
    "pydantic>=2.13.4",
    "rank-bm25>=0.2.2",
    "python-docx>=1.2.0",
    "python-pptx>=1.0.2",
    "pyyaml>=6.0.3",
    "pathspec>=1.1.1",
]
authors = [
    { name = "lsimons" }
]
license = "Apache-2.0"
license-files = ["LICENSE"]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "Programming Language :: Python :: 3.14",
    "Topic :: Text Processing :: Markup :: Markdown",
]

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

[tool.setuptools.packages.find]
where = ["src"]
include = ["mdd*"]

[tool.setuptools.package-data]
mdd = [
    "py.typed",
    "templates/*",
    "templates/quarto/*",
    "ai/prompts/*",
    "skills/*/SKILL.md",
]

[tool.setuptools_scm]
# Version is derived from annotated `vX.Y.Z` git tags (S43). The generated
# file is gitignored; editable/dev installs read it so `mdd --version` works
# without a tag present. `fallback_version` covers builds from a tarball with
# no `.git` (sdist), so the package never fails to build.
version_file = "src/mdd/_version.py"
fallback_version = "0.0.0"
# Only consider release tags. The repo also carries a non-version tag
# (`ir-spike-…`) that would otherwise confuse `git describe`.
git_describe_command = [
    "git",
    "describe",
    "--dirty",
    "--tags",
    "--long",
    "--match",
    "v[0-9]*",
]

[tool.ruff]
line-length = 100
target-version = "py314"
extend-exclude = [
    "test-confluence",                  # legacy sibling clone — corpus is now vendored under tests/corpus/
    "tests/corpus/confluence/scripts",  # vendored operational scripts from the test-confluence repo
]
# Ruff's default `include` carries `*.md`, so it lints and formats the Python
# code blocks inside our Markdown. Those blocks are illustrative prose — spec
# snippets with aligned comments and deliberately incomplete bodies, plus test
# fixtures whose exact bytes are the assertion. Restate the default without
# `*.md` so prose stays prose.
include = ["*.py", "*.pyi", "*.pyw", "*.ipynb", "**/pyproject.toml", "**/ruff.toml", "**/.ruff.toml"]

[tool.ruff.lint]
select = [
    "E", "F", "I", "W", "UP", "B", "SIM",
    "C90",
    "PLC0415",
    "PLR0911", "PLR0912", "PLR0913", "PLR0915",
    "RUF",
    "FURB", "PERF", "C4", "PIE", "RET", "PGH",
    "PTH", "TC", "PT", "ARG",
    "T201",
    "S",
]
ignore = [
    "RUF001",  # ambiguous unicode in strings — legitimate markdown content
    "RUF002",  # ambiguous unicode in docstrings — legitimate markdown content
    "RUF003",  # ambiguous unicode in comments — legitimate markdown content
    # flake8-bandit project-level ignores (S34 2026-06-08 amendment). These are
    # intentional, not debt; S602/S506/S113/S324/etc. stay enabled as signals.
    "S404",    # `import subprocess` — we orchestrate external tools by design
    "S603",    # subprocess call — argv lists, never an untrusted shell string
    "S607",    # partial executable path — glab/quarto/rg/op/rsvg-convert via PATH
]

[tool.ruff.lint.mccabe]
max-complexity = 10

[tool.ruff.lint.pylint]
max-args = 6
max-branches = 10
max-statements = 40
max-returns = 6

[tool.ruff.lint.per-file-ignores]
"tests/**" = [
    "ARG001", "ARG002", "ARG005", "PLC0415",
    "S101",          # pytest uses bare assert
    "S105", "S106",  # fixture credentials in tests are not secrets
]
"scripts/**" = ["T201"]      # developer-tooling scripts: print() is the interface
"install.py" = ["T201"]      # installer CLI: print() is the interface

[tool.complexipy]
paths = ["src/mdd"]
max-complexity-allowed = 15
exclude = ["tests/**", "scripts/**", "src/mdd/templates/**"]

[tool.basedpyright]
pythonVersion = "3.14"
typeCheckingMode = "strict"
include = ["src", "tests"]
exclude = [
    "scripts/**",
    "tests/corpus/**",  # vendored corpus and operational scripts
    ".venv/**",
    "**/__pycache__/**",
]

[dependency-groups]
dev = [
    "pytest>=9.1.1",
    "pytest-cov>=7.1.0",
    "ruff>=0.16.1",
    "basedpyright>=1.39.9",
    "lxml-stubs>=0.5.1",
    "complexipy>=6.2.0",
    "reportlab>=5.0.0",
    "setuptools-scm>=10.2.1",
    "pip-audit>=2.10.1",
]

[tool.pytest.ini_options]
testpaths = ["tests"]
pythonpath = ["src", "scripts"]
addopts = "-v --cov=mdd --cov-report=term-missing --cov-fail-under=85 -m 'not integration and not office'"
markers = [
    "integration: requires a live external service (Confluence, SharePoint, GitLab, Anthropic)",
    "office: requires Microsoft Office installed locally (macOS)",
]
# Third-party deprecation noise the suite can't act on; everything else is
# surfaced (warnings get tracked in test output, no implicit filter).
filterwarnings = [
    "ignore::DeprecationWarning:docling.*",
]

[tool.uv]
exclude-newer = "1 week"