pyproject.toml

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

[project]
name = "superbooks"
version = "0.1.0"
description = "Official SuperBooks SDK for Python"
readme = "README.md"
license = "MIT"
license-files = ["LICENSE"]
requires-python = ">=3.10"
authors = [{ name = "SuperBooks", email = "support@superbooks.io" }]
keywords = ["superbooks", "accounting", "finance", "sdk"]
classifiers = [
  "Development Status :: 3 - Alpha",
  "Intended Audience :: Developers",
  "License :: OSI Approved :: MIT License",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3.10",
  "Programming Language :: Python :: 3.11",
  "Programming Language :: Python :: 3.12",
  "Programming Language :: Python :: 3.13",
  "Topic :: Office/Business :: Financial :: Accounting",
  "Typing :: Typed",
]
dependencies = ["httpx>=0.27"]

[project.urls]
Homepage = "https://superbooks.io"
Documentation = "https://docs.superbooks.io"
Source = "https://github.com/DevinoSolutions/superbooks-python"
Changelog = "https://github.com/DevinoSolutions/superbooks-python/blob/main/CHANGELOG.md"

[project.optional-dependencies]
dev = ["pytest>=8", "pytest-asyncio>=0.23", "ruff>=0.6", "mypy>=1.11"]

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

[tool.hatch.build.targets.sdist]
include = ["/src", "/tests", "/scripts", "/sdk-manifest.json", "/README.md", "/CHANGELOG.md", "/LICENSE"]

[tool.ruff]
line-length = 88
target-version = "py310"
src = ["src", "tests", "scripts"]

[tool.ruff.lint]
select = ["E", "F", "I", "UP", "B", "SIM", "N"]
# A001/A002 (builtin shadowing) are not enabled: generated methods intentionally
# expose the API's own parameter names, several of which shadow builtins (`id`,
# `type`). Renaming them would break the wire contract.

[tool.ruff.format]
# Generated files are byte-compared by `codegen.py --check`. Letting the
# formatter rewrite them would make that gate fail on every ruff upgrade, so
# they are linted but not formatted.
exclude = ["src/superbooks/_generated/*"]

[tool.ruff.lint.per-file-ignores]
# Generated namespaces mirror the remote tool surface verbatim: `global_` and
# friends are keyword-mangled API names, and the files are machine-written.
"src/superbooks/_generated/*" = ["E501", "N802", "N803", "N815"]

[tool.mypy]
python_version = "3.10"
files = ["src/superbooks"]
strict = true
warn_unused_configs = true

[[tool.mypy.overrides]]
module = "superbooks._generated.*"
# Generated code returns the API's untyped structured content.
disallow_any_explicit = false

[tool.pytest.ini_options]
testpaths = ["tests"]
asyncio_mode = "auto"
filterwarnings = ["error"]