pyproject.toml

[build-system]
requires = [
  "hatchling>=1.5.0",
  "jupyterlab>=4.0.0,<5",
  "hatch-nodejs-version>=0.3.2",
  "hatch-vcs>=0.3.0",
]
build-backend = "hatchling.build"

[project]
authors = [{ name = "Pete Bachant", email = "petebachant@gmail.com" }]
classifiers = [
  "Programming Language :: Python",
  "Programming Language :: Python :: 3",
  "Programming Language :: Python :: 3.10",
  "Programming Language :: Python :: 3.11",
  "Programming Language :: Python :: 3.12",
  "Programming Language :: Python :: 3.13",
  "Programming Language :: Python :: 3.14",
  "License :: OSI Approved :: MIT License",
  "Operating System :: OS Independent",
  "Framework :: Jupyter",
  "Framework :: Jupyter :: JupyterLab",
  "Framework :: Jupyter :: JupyterLab :: 4",
  "Framework :: Jupyter :: JupyterLab :: Extensions",
  "Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt",
]
dependencies = [
  "arithmeval",
  "bibtexparser",
  "checksumdir",
  "docx2pdf",
  "dvc[all]==3.67.1",
  "fastapi",
  "gitpython",
  "keyring",
  "nbconvert",
  "pathspec<1.0.0",
  "pillow",
  "pydantic[email]",
  "pydantic-settings",
  "pyjwt",
  "python-dotenv>=1",
  "pywin32; platform_system == 'Windows'",
  "requests",
  "typer==0.25.1",
  "uvicorn",
  "tqdm>=4.67.1",
  "psutil>=7.0.0",
  "papermill>=2.6.0",
  "jupyterlab>=4.4.5",
  "sqlitedict>=2.1.0",
  "json2latex>=0.0.3",
  "toml>=0.10.2",
  "texsoup>=0.3.3",
  "fsspec>=2026.4.0",
]
description = "Reproducibility simplified."
dynamic = ["version"]
name = "calkit-python"
readme = "README.md"
requires-python = ">=3.10"

[project.optional-dependencies]
data = ["pandas>=2.2.3", "polars>=1.18.0"]
xet = ["xet>=0.0.1"]  # For fast large file transfers with XeT protocol

[dependency-groups]
dev = [
  "deptry>=0.22.0",
  "ipykernel",
  "kaleido==0.2.1",
  "numpy",
  "pandas>=2.2.3",
  "polars[all]>=1.36.1",
  "plotly",
  "pre-commit",
  "pyarrow",
  "pytest",
  "pytest-asyncio",
  "pytest-cov",
  "pytest-test-utils",             # For tmp_dir fixture
  "pytest-jupyter[server]>=0.6.0",
  "mkdocs",
  "mkdocs-material",
  "mkdocs-mermaid2-plugin",
  "pytest-env>=1.1.5",
  "pytest-httpserver>=1.0.0",
  "pytest-xdist>=3.8.0",
  # For the hub backend format hook, which runs ruff via uv from the
  # default workspace environment
  "ruff",
  "mkdocs-glightbox>=0.5.2",
  "scipy>=1.15.3",
]

[project.urls]
Homepage = "https://calkit.org"
Issues = "https://github.com/calkit/calkit/issues"
Repository = "https://github.com/calkit/calkit"

[project.entry-points."fsspec.specs"]
ck = "calkit.fs:CalkitFileSystem"

[project.scripts]
calkit = "calkit.cli:run"
calk9 = "calkit.cli:run"
ck = "calkit.cli:run"

[tool.hatch.build.targets.wheel]
packages = ["calkit"]

[tool.hatch.build.targets.wheel.force-include]
"agent-plugin/skills" = "calkit/agent_skills"

[tool.hatch.build.targets.sdist]
artifacts = ["calkit/labextension"]
exclude = [".github"]

[tool.hatch.build.targets.wheel.shared-data]
"calkit/labextension" = "share/jupyter/labextensions/calkit"
"jupyterlab-ext/jupyter-config/server-config" = "etc/jupyter/jupyter_server_config.d"

[tool.hatch.build.hooks.jupyter-builder]
dependencies = ["hatch-jupyter-builder>=0.5"]
build-function = "hatch_jupyter_builder.npm_builder"
ensured-targets = [
  "calkit/labextension/static/style.js",
  "calkit/labextension/package.json",
]
skip-if-exists = ["calkit/labextension/static/style.js"]

[tool.hatch.build.hooks.jupyter-builder.build-kwargs]
build_cmd = "build:prod"
npm = ["jlpm"]
path = "jupyterlab-ext"

[tool.hatch.build.hooks.jupyter-builder.editable-build-kwargs]
build_cmd = "install:extension"
npm = ["jlpm"]
path = "jupyterlab-ext"
source_dir = "jupyterlab-ext/src"
build_dir = "calkit/labextension"

[tool.jupyter-releaser.options]
version_cmd = "hatch version"

[tool.jupyter-releaser.hooks]
before-build-npm = [
  "python -m pip install 'jupyterlab>=4.0.0,<5'",
  "cd jupyterlab-ext && jlpm",
  "cd jupyterlab-ext && jlpm build:prod",
]
before-build-python = ["cd jupyterlab-ext && jlpm clean:all"]

[tool.check-wheel-contents]
ignore = ["W002"]

[tool.hatch.version]
source = "vcs"
tag-pattern = "^v(?P<version>.+)$"

[tool.hatch.version.raw-options]
git_describe_command = [
    "git", "describe", "--dirty", "--tags", "--long", "--match", "v[0-9]*",
]

[tool.mypy]
files = ["calkit", "hub/backend/app"]
exclude = ["^hub/backend/app/alembic/"]
disallow_untyped_defs = true
disallow_any_unimported = true
no_implicit_optional = true
check_untyped_defs = true
warn_return_any = true
warn_unused_ignores = true
show_error_codes = true

# Third-party modules that ship no type stubs.
[[tool.mypy.overrides]]
module = ["sqlitedict", "networkx"]
ignore_missing_imports = true

# The hub backend is checked strict; mypy can't set ``strict`` per-module,
# so the remainder of its flag bundle is enumerated here (the rest are
# already enabled globally above)
[[tool.mypy.overrides]]
module = ["app", "app.*"]
disallow_any_generics = true
disallow_subclassing_any = true
disallow_untyped_calls = true
disallow_incomplete_defs = true
disallow_untyped_decorators = true
no_implicit_reexport = true
strict_equality = true
extra_checks = true
# The backend's previous config didn't enable this
disallow_any_unimported = false

[tool.ruff]
target-version = "py310"
line-length = 79
fix = true
extend-exclude = ["hub/backend/app/alembic"]

[tool.ruff.per-file-target-version]
"hub/backend/**" = "py312"

[tool.ruff.lint]
# Pin the rule set explicitly (the pre-0.9 defaults plus import sorting)
# so it doesn't drift with ruff's own defaults across versions
select = ["E4", "E7", "E9", "F", "I"]

[tool.ruff.lint.per-file-ignores]
# Defines a yaml-loader helper amid its imports
"hub/backend/app/projects.py" = ["E402"]

[tool.ruff.lint.pyupgrade]
# Preserve runtime typing for pydantic models even if UP rules are enabled
keep-runtime-typing = true

[tool.uv.workspace]
members = ["hub/backend"]

[tool.pytest.ini_options]
env = ["CALKIT_ENV=test", "CALKIT_TEST_OVERLEAF_TOKEN=none"]
# The hub backend's tests need the compose stack and its own environment;
# they run via test-hub.yml, not from the workspace root
addopts = "-n auto -p pytest_jupyter.jupyter_server --ignore=hub"