pyproject.toml

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

[project]
name = "visionapi-client"
version = "1.0.0"
description = "Official Python client for the Vision API — credit-based OCR and visual intelligence. Extract structured JSON from images and PDFs."
readme = "README.md"
requires-python = ">=3.9"
license = { file = "LICENSE" }
authors = [{ name = "Vision API", email = "support@visionapi.io" }]
keywords = [
    "ocr",
    "vision",
    "document-ai",
    "invoice",
    "receipt",
    "pdf",
    "extraction",
    "structured-output",
    "visionapi",
]
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Developers",
    "License :: OSI Approved :: MIT License",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Topic :: Scientific/Engineering :: Image Recognition",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Typing :: Typed",
]

# The client itself is standard library only. typing_extensions is needed on Python < 3.11
# for NotRequired, and is used for type annotations, not at runtime.
dependencies = ["typing_extensions>=4.0; python_version < '3.11'"]

[project.urls]
Homepage = "https://visionapi.io"
Documentation = "https://docs.visionapi.io"
Repository = "https://github.com/devrobotlabs/visionapi-python"
Issues = "https://github.com/devrobotlabs/visionapi-python/issues"
Changelog = "https://github.com/devrobotlabs/visionapi-python/blob/main/CHANGELOG.md"

[project.optional-dependencies]
dev = ["pytest>=7", "mypy>=1.8", "ruff>=0.5,<0.17"]

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

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

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

# Selected explicitly rather than inherited. Ruff's default rule set is not stable across
# releases — 0.16 widened it — so a library that leaves this unset gets its CI broken by a
# linter upgrade that has nothing to do with its own code. This is the historical default
# (pyflakes plus the pycodestyle subsets) with import sorting added.
[tool.ruff.lint]
select = ["E4", "E7", "E9", "F", "I"]

# certifi is an optional import guarded by try/ImportError in _http.py — the package declares
# no runtime dependencies, so in a clean environment there is nothing for mypy to resolve.
[[tool.mypy.overrides]]
module = "certifi"
ignore_missing_imports = true

[tool.mypy]
# The package supports 3.9 at runtime (see requires-python); mypy itself no longer accepts
# a 3.9 target, so the type check runs against the oldest version it will take.
python_version = "3.10"
strict = false
warn_unused_ignores = true