pyproject.toml

[project]
name = "oold"
description = "Linked data class python package"
authors = [{ name = "OpenSemanticWorld", email = "team@opensemantic.world" }]
readme = "README.md"
license = "Apache-2.0"
license-files = ["LICENSE"]
keywords = ['python', 'linked-data', 'json-ld', 'pydantic', 'oo-ld']
requires-python = ">=3.10,<4.0"
# Version is managed by python-semantic-release (see [tool.semantic_release]).
# Do not edit by hand; it is bumped automatically on merge to main.
version = "0.16.3"
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "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",
    "Topic :: Software Development :: Libraries :: Python Modules",
]
dependencies = [
    "pydantic>=2.0.0",
    "datamodel-code-generator>=0.51.0,<0.55.0",
    "typing_extensions",
    "pyld",
    "rdflib",
    "sparqlwrapper",
    "jsondiff",
    "pyyaml",
]

[project.urls]
Homepage = "https://OO-LD.github.io/oold-python/"
Documentation = "https://OO-LD.github.io/oold-python/"
Repository = "https://github.com/OO-LD/oold-python"
Download = "https://pypi.org/project/oold/#files"

[project.optional-dependencies]
UI-panel = [
    "panel",
    "jupyter_bokeh",
    "param",
]
UI-jupyter = [
    "anywidget",
    "ipykernel",
    "traitlets",
    "ipython",
]
UI-nicegui = [
    "nicegui",
]
UI = [
    "panel",
    "jupyter_bokeh",
    "param",
    "anywidget",
    "ipykernel",
    "traitlets",
    "ipython",
    "nicegui",
]
all = [
    "panel",
    "jupyter_bokeh",
    "param",
    "anywidget",
    "ipykernel",
    "traitlets",
    "ipython",
    "nicegui",
]

[dependency-groups]
dev = [
    "pytest",
    "pytest-cov>=7.0.0",
    "pytest-benchmark",
    "pytest-playwright",
    "jsondiff",
    "panel",
    "pre-commit>=4.5.1",
    "tox-uv>=1.33.4",
    "deptry>=0.25.1",
    "ty>=0.0.24",
    "ruff>=0.15.7",
    "zensical>=0.0.26",
    "mkdocstrings-python>=1.0.3",
    "python-semantic-release>=10.0.0",
]

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

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

[tool.semantic_release]
# python-semantic-release owns the version and changelog. On merge to main it
# reads the conventional commits, bumps the static version in the files below,
# updates the changelog, commits, and tags. The v-prefixed tag namespace is
# preserved (matches the existing 32 releases).
commit_parser = "conventional"
tag_format = "v{version}"
commit_message = "chore(release): v{version} [skip ci]"
allow_zero_version = true
build_command = "uv lock"
version_toml = ["pyproject.toml:project.version"]
version_variables = ["CITATION.cff:version"]
exclude_commit_patterns = ['''chore\(release\):.*''']
# uv.lock pins oold's own version, so re-lock (build_command) and include it in
# the release commit to keep `uv sync --frozen` consistent on the next run.
assets = ["uv.lock"]

[tool.semantic_release.changelog]
mode = "update"
insertion_flag = "<!-- version list -->"

[tool.semantic_release.changelog.default_templates]
changelog_file = "CHANGELOG.md"

[tool.ty.environment]
python = "./.venv"
python-version = "3.10"

[tool.ty.src]
# Excluded from type checking:
#  - tests/data: generated (datamodel-code-generator) pydantic models
#  - src/oold/drafts: draft/experimental code (also excluded from ruff)
#  - src/oold/ui: optional UI integrations that import optional, un-installed
#    packages (panel, anywidget, nicegui, traitlets, ...)
#  - examples: illustrative scripts, not part of the distributed package
exclude = [
    "tests/data",
    "src/oold/drafts",
    "src/oold/ui",
    "examples",
]

[tool.ty.rules]
# oold builds pydantic models dynamically (create_model), exposes runtime-only
# attributes (e.g. __iris__) and offers a dynamic subscript/query API
# (Model["iri"], obj.links[Field == ...]). The following checks fire on these
# intentional, runtime-valid metaprogramming patterns rather than real bugs, so
# they are downgraded to keep `ty check` meaningful without mass inline ignores.
unresolved-attribute = "ignore"
not-subscriptable = "ignore"
invalid-argument-type = "ignore"
invalid-assignment = "ignore"
unknown-argument = "ignore"
invalid-return-type = "ignore"
unsupported-operator = "ignore"
no-matching-overload = "ignore"
invalid-method-override = "ignore"
not-iterable = "ignore"
invalid-type-form = "ignore"
missing-argument = "ignore"
call-non-callable = "ignore"
too-many-positional-arguments = "ignore"
subclass-of-final-class = "ignore"

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "--cov --cov-config=pyproject.toml --cov-report=term-missing"

[tool.deptry]
# The anywidget notebook only runs in the browser (pyodide) and imports
# `micropip`, which is not a project dependency.
extend_exclude = ["src/oold/ui/anywidget/.*\\.ipynb"]

[tool.deptry.package_module_name_map]
# The `ipython` distribution is imported as `IPython`.
ipython = "IPython"
# Optional UI extras are not installed in the lint/type environment, so declare
# their import-module names explicitly instead of letting deptry guess.
jupyter_bokeh = "jupyter_bokeh"
anywidget = "anywidget"
ipykernel = "ipykernel"
traitlets = "traitlets"
nicegui = "nicegui"

[tool.deptry.per_rule_ignores]
# Declared in UI extras and required at runtime by the panel/jupyter
# integrations, but not imported directly from `src`.
DEP002 = ["jupyter_bokeh", "ipykernel"]
# pydantic_core ships with (and is pinned by) pydantic; importing it directly
# is intentional and does not warrant a separate top-level dependency.
DEP003 = ["pydantic_core"]

[tool.ruff]
target-version = "py310"
line-length = 120
fix = true
# Generated (datamodel-code-generator output) and draft/experimental code are
# excluded from linting, mirroring the project's previous flake8 configuration.
extend-exclude = [
    "tests/data",
    "src/oold/drafts",
]

[tool.ruff.lint]
select = [
    # flake8-2020
    "YTT",
    # flake8-bandit
    "S",
    # flake8-bugbear
    "B",
    # flake8-builtins
    "A",
    # flake8-comprehensions
    "C4",
    # flake8-debugger
    "T10",
    # flake8-simplify
    "SIM",
    # isort
    "I",
    # mccabe
    "C90",
    # pycodestyle
    "E", "W",
    # pyflakes
    "F",
    # pygrep-hooks
    "PGH",
    # pyupgrade
    "UP",
    # ruff
    "RUF",
    # tryceratops
    "TRY",
]
ignore = [
    # LineTooLong
    "E501",
    # DoNotAssignLambda
    "E731",
    # Mutable default value for class attribute: false positive on pydantic /
    # param model fields, where ClassVar-annotating would change model semantics.
    "RUF012",
    # Avoid specifying long messages outside the exception class: the "fix" is a
    # large custom-exception-class refactor that would change the public API.
    "TRY003",
    # `<function>` is too complex (mccabe): the schema/model transformation code
    # is inherently branchy; refactoring purely for the metric risks regressions.
    "C901",
    # Variable/argument shadows a Python builtin: `property`, `id`, `input` are
    # used as domain-meaningful local names (JSON-Schema property, JSON-LD id);
    # renaming them reduces readability for no functional benefit.
    "A001",
    "A002",
]

[tool.ruff.lint.per-file-ignores]
# Tests and examples use literal credentials/tokens and broad exception asserts
# on purpose; the bandit/bugbear security rules are noise there.
"tests/*" = ["S101", "S105", "S106", "B017"]
"examples/*" = ["S105", "S106"]

[tool.ruff.format]
preview = true

[tool.coverage.report]
skip_empty = true

[tool.coverage.run]
branch = true
source = ["src"]