prov 3.2.3__tar.gz → 3.3.0__tar.gz

prov-3.3.0/MANIFEST.in

@@ -0,0 +1,2 @@
+graft src/prov/tests
+global-exclude *.py[cod]

prov-3.3.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: prov
+Version: 3.3.0
+Summary: A library for W3C Provenance Data Model supporting PROV-N, PROV-JSON, PROV-XML, PROV-O (RDF) and PROV-JSONLD
+Author-email: Trung Dong Huynh <trungdong@donggiang.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/trungdong/prov
+Project-URL: Documentation, https://prov.readthedocs.io
+Project-URL: Repository, https://github.com/trungdong/prov
+Project-URL: Issues, https://github.com/trungdong/prov/issues
+Project-URL: Changelog, https://prov.readthedocs.io/en/latest/history.html
+Project-URL: Discussions, https://github.com/trungdong/prov/discussions
+Keywords: provenance,graph,model,PROV,PROV-DM,PROV-JSON,W3C,PROV-XML,PROV-N,PROV-O,RDF,PROV-JSONLD,JSON-LD
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Logging
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: rdf
+Requires-Dist: rdflib<8,>=7.0.0; extra == "rdf"
+Provides-Extra: xml
+Requires-Dist: lxml>=3.3.5; extra == "xml"
+Provides-Extra: dot
+Requires-Dist: pydot>=1.2.0; extra == "dot"
+Requires-Dist: networkx>=2.0; extra == "dot"
+Provides-Extra: graph
+Requires-Dist: networkx>=2.0; extra == "graph"
+Provides-Extra: plot
+Requires-Dist: matplotlib>=3.6; extra == "plot"
+Requires-Dist: pydot>=1.2.0; extra == "plot"
+Requires-Dist: networkx>=2.0; extra == "plot"
+Provides-Extra: pygments
+Requires-Dist: pygments>=2.13; extra == "pygments"
+Dynamic: license-file
+
+# prov
+
+[![Latest Release](https://badge.fury.io/py/prov.svg)](https://badge.fury.io/py/prov)
+[![License](https://img.shields.io/pypi/l/prov.svg)](https://pypi.org/project/prov/)
+[![CI Status](https://github.com/trungdong/prov/workflows/CI/badge.svg)](https://github.com/trungdong/prov/actions?workflow=CI)
+[![Coverage Status](https://img.shields.io/coveralls/trungdong/prov.svg)](https://coveralls.io/r/trungdong/prov?branch=main)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/73bdf6dda3884abf9f5e79352c07e66c)](https://app.codacy.com/gh/trungdong/prov/dashboard)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.22696001.svg)](https://doi.org/10.5281/zenodo.22696001)
+[![Supported Python version](https://img.shields.io/pypi/pyversions/prov.svg)](https://pypi.org/project/prov/)
+
+A Python implementation of the [W3C PROV Data Model](https://www.w3.org/TR/prov-dm/), with
+import and export in PROV-N, PROV-JSON, PROV-JSONLD, PROV-XML and PROV-O (RDF). It is
+MIT-licensed, needs Python 3.11 or later, and is documented at <https://prov.readthedocs.io/>.
+
+## Install
+
+```bash
+pip install prov
+```
+
+PROV-JSON, PROV-N and PROV-JSONLD need nothing else; PROV-XML, PROV-O and the graph tools
+each need an extra, listed on the [installation page](https://prov.readthedocs.io/en/latest/installation.html).
+
+## Quick start
+
+```python
+import prov.model as pm
+
+doc = pm.ProvDocument()
+doc.set_default_namespace("https://example.org/")
+doc.entity("report")
+doc.activity("analysis")
+doc.wasGeneratedBy("report", "analysis")
+print(doc.get_provn())
+doc.serialize("report.json")
+```
+
+```provn
+document
+  default <https://example.org/>
+
+  entity(report)
+  activity(analysis, -, -)
+  wasGeneratedBy(report, analysis, -)
+endDocument
+```
+
+The [tutorial](https://prov.readthedocs.io/en/latest/tutorial/getting-started.html) continues from here.
+
+## Features
+
+- In-memory classes for every PROV-DM record type, readable from and printable as
+  [PROV-N](https://www.w3.org/TR/prov-n/).
+- Serialization to and from [PROV-N](https://www.w3.org/TR/prov-n/),
+  [PROV-JSON](https://www.w3.org/submissions/prov-json/),
+  [PROV-JSONLD](https://www.w3.org/submissions/prov-jsonld/),
+  [PROV-XML](https://www.w3.org/TR/prov-xml/) and [PROV-O](https://www.w3.org/TR/prov-o/) (RDF).
+- Export to graphical formats such as PDF, PNG and SVG through Graphviz.
+- Conversion to and from a [NetworkX](https://networkx.org/) `MultiDiGraph`.
+- PROV-N syntax highlighting through a Pygments lexer, with the `pygments` extra.
+- Command-line tools, `prov-convert` and `prov-compare`.
+
+GitHub lists the
+[public repositories that depend on this package](https://github.com/trungdong/prov/network/dependents).
+[What's new in 3](https://prov.readthedocs.io/en/latest/whats-new-3.html) summarises the 3.x
+line, and the [announcement post](https://trungdong.github.io/provpy-3.html) explains the move.
+[ROADMAP.md](https://github.com/trungdong/prov/blob/main/ROADMAP.md) lists the planned releases,
+[SECURITY.md](https://github.com/trungdong/prov/blob/main/SECURITY.md) the supported versions,
+and the [issue tracker](https://github.com/trungdong/prov/issues) takes feedback.

prov-3.3.0/README.md

@@ -0,0 +1,69 @@
+# prov
+
+[![Latest Release](https://badge.fury.io/py/prov.svg)](https://badge.fury.io/py/prov)
+[![License](https://img.shields.io/pypi/l/prov.svg)](https://pypi.org/project/prov/)
+[![CI Status](https://github.com/trungdong/prov/workflows/CI/badge.svg)](https://github.com/trungdong/prov/actions?workflow=CI)
+[![Coverage Status](https://img.shields.io/coveralls/trungdong/prov.svg)](https://coveralls.io/r/trungdong/prov?branch=main)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/73bdf6dda3884abf9f5e79352c07e66c)](https://app.codacy.com/gh/trungdong/prov/dashboard)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.22696001.svg)](https://doi.org/10.5281/zenodo.22696001)
+[![Supported Python version](https://img.shields.io/pypi/pyversions/prov.svg)](https://pypi.org/project/prov/)
+
+A Python implementation of the [W3C PROV Data Model](https://www.w3.org/TR/prov-dm/), with
+import and export in PROV-N, PROV-JSON, PROV-JSONLD, PROV-XML and PROV-O (RDF). It is
+MIT-licensed, needs Python 3.11 or later, and is documented at <https://prov.readthedocs.io/>.
+
+## Install
+
+```bash
+pip install prov
+```
+
+PROV-JSON, PROV-N and PROV-JSONLD need nothing else; PROV-XML, PROV-O and the graph tools
+each need an extra, listed on the [installation page](https://prov.readthedocs.io/en/latest/installation.html).
+
+## Quick start
+
+```python
+import prov.model as pm
+
+doc = pm.ProvDocument()
+doc.set_default_namespace("https://example.org/")
+doc.entity("report")
+doc.activity("analysis")
+doc.wasGeneratedBy("report", "analysis")
+print(doc.get_provn())
+doc.serialize("report.json")
+```
+
+```provn
+document
+  default <https://example.org/>
+
+  entity(report)
+  activity(analysis, -, -)
+  wasGeneratedBy(report, analysis, -)
+endDocument
+```
+
+The [tutorial](https://prov.readthedocs.io/en/latest/tutorial/getting-started.html) continues from here.
+
+## Features
+
+- In-memory classes for every PROV-DM record type, readable from and printable as
+  [PROV-N](https://www.w3.org/TR/prov-n/).
+- Serialization to and from [PROV-N](https://www.w3.org/TR/prov-n/),
+  [PROV-JSON](https://www.w3.org/submissions/prov-json/),
+  [PROV-JSONLD](https://www.w3.org/submissions/prov-jsonld/),
+  [PROV-XML](https://www.w3.org/TR/prov-xml/) and [PROV-O](https://www.w3.org/TR/prov-o/) (RDF).
+- Export to graphical formats such as PDF, PNG and SVG through Graphviz.
+- Conversion to and from a [NetworkX](https://networkx.org/) `MultiDiGraph`.
+- PROV-N syntax highlighting through a Pygments lexer, with the `pygments` extra.
+- Command-line tools, `prov-convert` and `prov-compare`.
+
+GitHub lists the
+[public repositories that depend on this package](https://github.com/trungdong/prov/network/dependents).
+[What's new in 3](https://prov.readthedocs.io/en/latest/whats-new-3.html) summarises the 3.x
+line, and the [announcement post](https://trungdong.github.io/provpy-3.html) explains the move.
+[ROADMAP.md](https://github.com/trungdong/prov/blob/main/ROADMAP.md) lists the planned releases,
+[SECURITY.md](https://github.com/trungdong/prov/blob/main/SECURITY.md) the supported versions,
+and the [issue tracker](https://github.com/trungdong/prov/issues) takes feedback.

prov-3.3.0/pyproject.toml

@@ -0,0 +1,229 @@
+[project]
+name = "prov"
+dynamic = ["version"]
+description = "A library for W3C Provenance Data Model supporting PROV-N, PROV-JSON, PROV-XML, PROV-O (RDF) and PROV-JSONLD"
+readme = "README.md"
+authors = [
+    { name = "Trung Dong Huynh", email = "trungdong@donggiang.com" }
+]
+keywords = ["provenance", "graph", "model", "PROV", "PROV-DM", "PROV-JSON", "W3C", "PROV-XML", "PROV-N", "PROV-O", "RDF", "PROV-JSONLD", "JSON-LD"]
+license = "MIT"
+license-files = ["LICENSE"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Security",
+    "Topic :: System :: Logging",
+]
+requires-python = ">=3.11"
+# No unconditional runtime dependencies as of 3.0.
+dependencies = []
+
+[project.optional-dependencies]
+rdf = [
+    "rdflib>=7.0.0,<8",
+]
+xml = [
+    "lxml>=3.3.5",
+]
+# Graphical export (prov.dot / prov_to_dot); needs a local graphviz binary.
+# prov.dot renders via prov.graph, so this extra carries networkx too.
+dot = [
+    "pydot>=1.2.0",
+    "networkx>=2.0",
+]
+# NetworkX graph interop (prov.graph, prov_to_graph()/graph_to_prov()).
+graph = [
+    "networkx>=2.0",
+]
+# Interactive display path of ProvBundle.plot(); calls prov.dot internally.
+plot = [
+    "matplotlib>=3.6",
+    "pydot>=1.2.0",
+    "networkx>=2.0",
+]
+# Pygments lexer for PROV-N (prov.pygments), found by name through its entry point.
+pygments = [
+    "pygments>=2.13",
+]
+
+[project.scripts]
+prov-convert = "prov.scripts.convert:main"
+prov-compare = "prov.scripts.compare:main"
+
+[project.entry-points."pygments.lexers"]
+provn = "prov.pygments:ProvNLexer"
+
+[project.urls]
+Homepage = "https://github.com/trungdong/prov"
+Documentation = "https://prov.readthedocs.io"
+Repository = "https://github.com/trungdong/prov"
+Issues = "https://github.com/trungdong/prov/issues"
+Changelog = "https://prov.readthedocs.io/en/latest/history.html"
+Discussions = "https://github.com/trungdong/prov/discussions"
+
+[build-system]
+requires = ["setuptools>=40.8.0", "wheel"]  # PEP 508 specifications.
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+# The wheel holds only the package-data listed below; MANIFEST.in grafts src/prov/tests into the sdist alone.
+include-package-data = false
+
+[tool.setuptools.dynamic]
+version = {attr = "prov.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["prov.tests", "prov.tests.*"]
+
+[tool.setuptools.package-data]
+prov = ["py.typed"]
+"prov.serializers" = ["*.jsonld"]
+
+[dependency-groups]
+dev = [
+    "coverage>=7.6.10",
+    "hypothesis>=6.156.1",
+    "jsonschema>=4",
+    "lxml-stubs>=0.5.1",
+    "mypy>=1.19.1",
+    "pre-commit>=4.0.1",
+    "pyld>=2.0.4",
+    "pytest>=8.4.2",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.15.20",
+    "types-networkx>=3.4.2.20250509",
+    "types-Pygments>=2.21.0.20260819",
+]
+bench = [
+    "pytest-benchmark>=5.1.0",
+]
+docs = [
+    "sphinx>=8.1.3",
+    "furo",
+    "myst-parser",
+    "sphinx-copybutton",
+]
+
+[tool.uv]
+# numpy is a transitive typing dependency (via types-networkx/matplotlib), not
+# something prov imports itself. numpy 2.5 switched its inline stubs to
+# unconditional PEP 695 `type` statements, which mypy refuses to parse once
+# `[tool.mypy] python_version` is below 3.12 (see below) regardless of the
+# interpreter actually running mypy. Cap it below that until numpy's stubs
+# gate the new syntax on `python_version`, or this project's mypy floor rises
+# to 3.12. If a Dependabot bump of matplotlib or types-networkx ever fails to
+# resolve, this pin is the likely cause: lift it, run `uv run mypy src`, and
+# keep it lifted only if mypy stays green.
+constraint-dependencies = ["numpy<2.5"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+extend-exclude = ["build"]  # dist/.eggs are already in ruff's default excludes
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "F",   # pyflakes
+    "W",   # pycodestyle warnings
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "I",   # isort (import sorting)
+    "SIM", # flake8-simplify
+    "UP",  # pyupgrade (3.11-safe)
+    "RUF", # ruff-specific rules
+]
+ignore = [
+    "E203",  # whitespace before ':' (black/ruff-format compatible)
+    "E501",  # line length handled by the formatter
+]
+
+[tool.ruff.lint.isort]
+combine-as-imports = true  # keep multi-name `X as X` re-export blocks compact
+
+[tool.ruff.lint.per-file-ignores]
+# These modules intentionally re-export everything from another module with
+# `import *`; pyflakes can't tell which of the resulting names are "used".
+"src/prov/model/__init__.py" = ["F403", "F405"]
+"src/prov/serializers/provjson.py" = ["F403", "F405"]
+"src/prov/serializers/provxml.py" = ["F403", "F405"]
+# types-Pygments (typeshed) types the lexer's class attributes as ClassVar; Pygments' own lexers carry no annotation.
+"src/prov/pygments.py" = ["RUF012"]
+"src/prov/tests/test_statements.py" = ["F403", "F405"]
+"src/prov/tests/test_dot.py" = ["E402"]
+"src/prov/tests/test_graphs.py" = ["E402"]
+
+[tool.pytest.ini_options]
+testpaths = ["src/prov/tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["prov"]
+omit = ["*/prov/tests/*"]
+
+[tool.coverage.report]
+# Coverage ratchet (planning/test-gap-checklist.md). T13 fixed the `omit` glob
+# above (it previously did not exclude src/prov/tests/, inflating TOTAL by
+# ~3.8pt with near-fully-covered test code) and closed the remaining
+# checklist gaps; the honest package-only TOTAL measured after that work is
+# 97.42%, rounded down to this floor. Never lower without a documented
+# reason. Remaining misses are individually annotated as "defer" in the
+# checklist (dead/defensive branches unreachable via the public API, plus
+# the matplotlib-requiring interactive plot() path not installed in the
+# test env).
+fail_under = 97
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+
+# Test modules that do not yet pass strict mypy. The list only shrinks. A PR
+# that makes a module pass deletes its name here and from MYPY_OVERRIDE_LIST in
+# src/prov/tests/test_public_api.py, and a new test module never joins.
+[[tool.mypy.overrides]]
+module = [
+    "prov.tests.test_attribute_merging",
+    "prov.tests.test_chaining",
+    "prov.tests.test_cli_smoke",
+    "prov.tests.test_datetime_parsing",
+    "prov.tests.test_dot",
+    "prov.tests.test_extras",
+    "prov.tests.test_graphs",
+    "prov.tests.test_jsonld",
+    "prov.tests.test_model",
+    "prov.tests.test_namespace_cache",
+    "prov.tests.test_numeric_typing",
+    "prov.tests.test_provn",
+    "prov.tests.test_provn_escaping",
+    "prov.tests.test_provn_lexer",
+    "prov.tests.test_provn_profiles",
+    "prov.tests.test_rdf",
+    "prov.tests.test_read",
+    "prov.tests.test_scripts",
+    "prov.tests.test_statements",
+    "prov.tests.test_xml",
+]
+ignore_errors = true