mmif-python 1.4.0__tar.gz → 1.5.1__tar.gz

mmif_python-1.5.1/.github/workflows/release-check.yml

@@ -0,0 +1,11 @@
+name: "🔖 Release PR check"
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, edited]
+
+jobs:
+  release-check:
+    name: "🤙 Call SDK release-check workflow"
+    uses: clamsproject/.github/.github/workflows/sdk-release-check.yml@main

{mmif_python-1.4.0 → mmif_python-1.5.1}/CHANGELOG.md

@@ -1,4 +1,47 @@
 
+## releasing 1.5.0 (2026-05-27)
+### Overview
+
+Improves image-extraction API in `video_document_helper` for TP source tracking, restores the source-composition prefix in workflow identifiers, and fixes the versioned-docs publishing pipeline.
+
+### Additions
+
+* `extract_images_by_count_with_sources` and `extract_images_by_mode_with_sources`: new public functions in `mmif.utils.video_document_helper` that return per-image source IDs (or sampled timepoints in ms when a fallback path is used), so downstream apps can anchor each extracted image to a specific point in the source media (https://github.com/clamsproject/mmif-python/pull/385, https://github.com/clamsproject/mmif-python/issues/384).
+
+### Changes
+
+* `mmif.utils.video_document_helper`: renamed 
+    * `extract_timepoints_as_images` --> `extract_images_from_timepoints`, 
+    * `extract_target_frames` -->  `extract_images_by_count_with_sources` (alongside new bare `extract_images_by_count`), and 
+    * `extract_frames_by_mode` --> `extract_images_by_mode`. 
+    * The three pre-rename names remain importable as soft-deprecated aliases through 2.0.0 (https://github.com/clamsproject/mmif-python/pull/385).
+* `mmif.utils.workflow_helper.generate_workflow_identifier`: now prefixes a `source_composition` segment (`TextDocument-1-VideoDocument-1/...`) describing the top-level document mix in the input MMIF (https://github.com/clamsproject/mmif-python/pull/386).
+* `build-tools/docs.py`: versioned-docs build now works against pyproject-only tags, restoring docs publishing in the release workflow (https://github.com/clamsproject/mmif-python/pull/388, https://github.com/clamsproject/mmif-python/issues/387).
+
+> [!NOTE]
+> - `mmif describe` (and the underlying `mmif.utils.workflow_helper`) is still experimental and subject to change in future releases without notice. Backward compatibility is not guaranteed.
+> - The new `source_composition` prefix in `generate_workflow_identifier()` changes the format of returned identifiers. Downstream tools parsing the identifier path (e.g. for storage-directory routing) may need to account for the extra leading segment.
+
+
+
+## releasing 1.4.0 (2026-04-22)
+### Overview
+* This is minor level release that 1) replacing simple string enums in `mmif.vocabulary` with fully-fledged pydantic classes in `clams-vocabulary` package 2) deprecating framenum-based image extraction functions in VDH (frame numbers are no longer considered as proper timestamps)
+
+### Additions
+* presentation timestamp-based image extraction functions added to VDH (https://github.com/clamsproject/mmif-python/pull/382 )
+* `pyav` and `clams-vocabulary` as new dependencies
+
+### Changes
+* opencv-based video operations are now based on pyav (ffmpeg backend)
+* all framenum-based functions in VDH are now marked as deprecated, scheduled for removal at 2.0.0
+* `mmif.vocabulary` package is now a thin wrapper around `clams-vocabulary` package (https://github.com/clamsproject/mmif-python/pull/381 )
+* `AnnotationTypes` and `DocumentTypes` classes are no longer simple string enums, but pydantic-based validation-supported python classes 
+
+### Removal 
+* `durationTimeUnit` is no longer written to video documents' `Annotation` property. This is non-API change hence not triggering major version bump. (based on https://github.com/clamsproject/mmif/pull/240/changes/a74dc46245c21dc7a279b3f271cf3e3a2a126f3a, all time notations without explicit unit specification are considered as milliseconds)
+
+
 ## releasing 1.3.1 (2026-03-11)
 ### Overview
 
@@ -8,6 +51,7 @@ Bug-fix release to address broken `as_PIL=True` option in `extract_frames_as_ima
 
 * Fix `PIL.Image` import failure in `_check_cv_dep` by switching from `importlib.__import__` to `importlib.import_module` (https://github.com/clamsproject/mmif-python/pull/377)
 
+
 ## releasing 1.3.0 (2026-03-10)
 ### Overview
 Minor release adding a new `summarize` CLI, pydantic-based workflow descriptors, and various fixes for video document helpers and timestamp handling.
@@ -26,6 +70,7 @@ Minor release adding a new `summarize` CLI, pydantic-based workflow descriptors,
 * Documentation build migrated to "build-once, stay-forever" model via documentation hub (https://github.com/clamsproject/mmif-python/pull/344)
 
 
+
 ## releasing 1.2.1 (2025-11-28)
 ### Overview
 Updated output formats of the experimental `mmif describe` command
@@ -38,6 +83,7 @@ Updated output formats of the experimental `mmif describe` command
 > [!NOTE]
 > `mmif describe` (and the underlying `mmif.utils.workflow_helper`) is still experimental and subject to change in future releases without notice. Backward compatibility is not guaranteed.
 
+
 ## releasing 1.2.0 (2025-11-20)
 ### Overview
 This version is minor release with addition of a new cli (`describe`), lots of in-line documentation updates, and deprecation of some "getter" methods
@@ -57,6 +103,7 @@ mmif.get(some_view_id)
 * many  outdated documentation updates
 
 
+
 ## releasing 1.1.2 (2025-07-28)
 ### Overview
 Patch release with a hotfix of a bug. 
@@ -64,6 +111,7 @@ Patch release with a hotfix of a bug.
 ### Changes
 * Fixed bug with handling "list of ID" props in 1.0.x MMIF. 
 
+
 ## releasing 1.1.1 (2025-07-26)
 ### Overview
 Patch release to support installation on python 3.12 and newer (fixes https://github.com/clamsproject/mmif-python/issues/314). 
@@ -72,6 +120,7 @@ Patch release to support installation on python 3.12 and newer (fixes https://gi
 - `setup.py` is now compatible with the latest setuptools (80) .
 - [Since python 3.12 no longer ship `setuptools` as a part of standard installation](https://docs.python.org/3/whatsnew/3.12.html#ensurepip), added setuptools as a `dev` dependency.
 
+
 ## releasing 1.1.0  (2025-07-23)
 ### Overview
 This is a minor version release, but it includes several significant changes and improvements across the codebase. 
@@ -88,6 +137,7 @@ This is a minor version release, but it includes several significant changes and
 * Miscellaneous cleanup and improvements on documentation and unused code. 
 
 
+
 ## releasing 1.0.19 (2024-07-29)
 ### Overview
 Patch to fix a critical bug. 
@@ -95,6 +145,7 @@ Patch to fix a critical bug.
 ### Changes
 - bugfix when `Annotation` instance and "warnings" view both are involved, MMIF is not properly returned (#299)
 
+
 ## releasing 1.0.18 (2024-07-15)
 ### Overview
 Patch release with a bugfix. 
@@ -104,6 +155,7 @@ Patch release with a bugfix.
 ### Changes
 - fixed bug when adding custom properties to a newly generated `TextDocument` object (https://github.com/clamsproject/mmif-python/issues/290)
 
+
 ## releasing 1.0.17 (2024-06-26)
 ### Overview
 This release adds caching mechanism for annotation alignments (via `Alignment` annotation, the alignment via `targets` property is not yet supported). 
@@ -117,6 +169,7 @@ This release adds caching mechanism for annotation alignments (via `Alignment` a
 - `mmif.utils.text_document_helper.slice_text` received a major speed boost from the alignment caching. 
 
 
+
 ## releasing 1.0.16 (2024-06-14)
 ### Overview
 This release includes an _experimental_ implementation for helpers to slice `text_value` from text documents. 
@@ -125,6 +178,7 @@ This release includes an _experimental_ implementation for helpers to slice `tex
 * `mmif.utils.text_document_helper` module to address https://github.com/clamsproject/mmif-python/issues/280
 
 
+
 ## releasing 1.0.15 (2024-06-07)
 ### Overview
 Minor release to add/improve helper methods.
@@ -136,6 +190,7 @@ Minor release to add/improve helper methods.
 - `Mmif.__getitem__()` now works with short annotation IDs (https://github.com/clamsproject/mmif-python/issues/279)
 
 
+
 ## releasing 1.0.14 (2024-04-10)
 ### Overview
 This release contains small fixes and improvements. 
@@ -151,6 +206,7 @@ This release contains small fixes and improvements.
 ### Changes
 - "empty" annotation property values are correctly retrievable
 
+
 ## releasing 1.0.13 (2024-04-02)
 ### Overview
 This version includes small, but helpful improvements.
@@ -161,6 +217,7 @@ This version includes small, but helpful improvements.
 * video frame sampling can now use fractional sampling rate (in terms of frame numbers)
 
 
+
 ## releasing 1.0.12 (2024-04-01)
 ### Overview
 Hot-fixing a wrong field name. 
@@ -169,6 +226,7 @@ Hot-fixing a wrong field name.
 - `views[].metadata.app_configuration` is renamed to `appConfiguration`, correctly following the MMIF json schema. 
 
 
+
 ## releasing 1.0.11 (2024-03-31)
 ### Overview
 This release includes changes from MMIF spec 1.0.3 and 1.0.4, and a new helper module to handle sequence annotations
@@ -186,6 +244,7 @@ This release includes changes from MMIF spec 1.0.3 and 1.0.4, and a new helper m
 - getting start or end anchor points on annotations objects only with `targets` are no longer require the targets list is already sorted
 - sphinx-based public API documentation for old versions is back
 
+
 ## releasing 1.0.10 (2024-03-01)
 ### Overview
 This version includes minor bug fixes and support for MMIF spec 1.0.2. 
@@ -198,6 +257,7 @@ This version includes minor bug fixes and support for MMIF spec 1.0.2.
 * ISO-like time unit conversion now consistently returns only to third decimal place.
 
 
+
 ## releasing 1.0.9 (2024-02-10)
 ### Overview
 This is a feature-packed release.
@@ -213,6 +273,7 @@ This is a feature-packed release.
 * `Annotation` objects' `properties` attribute is no longer limited to primitives and list of primitives (https://github.com/clamsproject/mmif/issues/215)
 * Fixed annotation URI equivalence checker wasn't working in set-like collections (https://github.com/clamsproject/mmif-python/issues/257)
 
+
 ## releasing 1.0.8 (2023-07-24)
 ### Overview
 This release includes polishing and bug fixes around the `mmif.utils.video_document_helper` module.
@@ -224,6 +285,7 @@ This release includes polishing and bug fixes around the `mmif.utils.video_docum
 * `Annotation.get_property` now provide more intuitive access to "view-level" annotation properties found in `view.metadata.contains.some_at_type` dict 
 
 
+
 ## releasing 1.0.7 (2023-07-20)
 ### Overview
 Minor updates in VideoDucment helper module
@@ -233,6 +295,7 @@ Minor updates in VideoDucment helper module
 
 
 
+
 ## releasing 1.0.6 (2023-07-19)
 ### Overview
 This release relaxes checks for optional CV dependencies in video utils module, so that users don't have install all of `[cv]` dependencies when they don't use them all. 
@@ -241,6 +304,7 @@ This release relaxes checks for optional CV dependencies in video utils module,
 * when any of `[cv]` dependencies is not found during `mmif.utils.video_document_helper` module is being loaded, instead of raising and an error, a warning is issued.
 
 
+
 ## releasing 1.0.5 (2023-07-19)
 ### Overview
 This release contains a minor fix in video_document_helper module
@@ -249,11 +313,13 @@ This release contains a minor fix in video_document_helper module
 * fixed time unit normalization was missing some important string
 
 
+
 ## releasing 1.0.4 (2023-07-19)
 ### Overview
 This release fixes installation error in the previous version. 
 
 
+
 ## releasing 1.0.3 (2023-07-19)
 ### Overview
 This release is primarily about adding `mmif.utils` package and `mmif.utils.video_document_helper` module. The module provides many helper functions to handle frame-based and time-based documents and annotations. 
@@ -266,6 +332,7 @@ This release is primarily about adding `mmif.utils` package and `mmif.utils.vide
 * fixed bug in `Annotation.get_property` (#232)
 
 
+
 ## releasing 1.0.2 (2023-07-11)
 ### Overview
 This release includes support for plugins, and a "magic" helper for using `Annotation` annotations for documents in MMIF. 
@@ -277,6 +344,7 @@ This release includes support for plugins, and a "magic" helper for using `Annot
 
 
 
+
 ## releasing 1.0.1 (2023-05-26)
 ### Overview
 `mmif-python` 1.0.0 included MMIF 0.5.0 instead of  MMIF 1.0.0. This release fixes it
@@ -284,11 +352,13 @@ This release includes support for plugins, and a "magic" helper for using `Annot
 ### Changes
 * now based on MMIF specification 1.0.0
 
+
 ## releasing 1.0.0 (2023-05-25)
 ### Overview
 This release will be numbered as 1.0.0, but actually is re-numbering of 0.5.2, hence no technical changes are included in 1.0.0. 
 
 
+
 ## releasing 0.5.2 (2023-05-19)
 ### Overview
 This release fixes an oversight bug in `__eq__` in `MmifObject`s. Also includes updates of the sphinx documentation. 
@@ -298,6 +368,7 @@ This release fixes an oversight bug in `__eq__` in `MmifObject`s. Also includes
 * Updated sphinx documentation (#215 )
 
 
+
 ## releasing 0.5.1 (2023-05-02)
 ### Overview
 This release includes "fuzzy" matching of at_types and sanitized `serialize` of `Mmif` objects.
@@ -313,6 +384,7 @@ This release includes "fuzzy" matching of at_types and sanitized `serialize` of
 * fixed a small bug in `Mmif.get_alignments` 
 * fixed `view.metadata` serialized into an invalid MMIF due to a *oneOf* condition in jsonschema
 
+
 ## releasing 0.5.0 (2023-04-30)
 ### Overview
 This release is a synchronization of `mmif-python` with the latest [MMIF 0.5.0 release](https://github.com/clamsproject/mmif/pull/199). 
@@ -321,9 +393,11 @@ This release is a synchronization of `mmif-python` with the latest [MMIF 0.5.0 r
 * Enum-like subclasses for annotation `@type`s in the `mmif.vocabulary` package are updated to accommodate the new way of checking I/O compatibility (as `__eq__()` in the SDK).
 
 
+
 ## releasing 0.4.8 (2023-02-10)
 This is a small PR that doesn't include any code in the SDK, but the target MMIF version is bumped up to [0.4.2](https://github.com/clamsproject/mmif/blob/master/CHANGELOG.md#version-042---2023-02-09). 
 
+
 ## releasing 0.4.7 (2023-02-09)
 This release includes
 
@@ -331,12 +405,14 @@ This release includes
 * made `properties` map to behave like a map (#194)
 * updated python dependencies (#196, #198)
 
+
 ## releasing 0.4.6 (2022-03-25)
 This release includes 
 
 * fixes in the development & release pipelines. (#189 #187)
 * upgrade in the text retrieval from TextDocument (#185)
 
+
 ## releasing 0.4.5 (2021-07-11)
 This release contains minor bug fixes
 
@@ -344,23 +420,29 @@ This release contains minor bug fixes
 * fixed how `develop` version of vocab URIs were handled
 * colon (`:`) is now a class constant for gluing view_id and annotation_id
 
+
 ## releasing 0.4.4 (2021-06-19)
 This release contains small but breaking changes. See d5198cb2304ad488975644a87fba51906abc5299 for details. 
 
 
+
 ## releasing 0.4.3 (2021-06-18)
 This release fixes minor bugs from the previous version.
 
 
+
 ## releasing 0.4.2 (2021-06-17)
 This release adds `new_textdocument` helper method to `View` class. 
 
+
 ## releasing 0.4.1 (2021-06-14)
 The release contains a small bug fix in deserialization of `Mmif` object. 
 
+
 ## releasing 0.4.0  (2021-06-10)
 New release to correspond to the MMIF specification 0.4.0. 
 
+
 ## releasing 0.3.5 (2021-06-05)
 The release includes ...
 
@@ -370,19 +452,24 @@ The release includes ...
 * various bug fixes and clean-up
 
 
+
 ## releasing 0.3.4 (2021-05-24)
 This release includes major bug fixes (#131, #164) and a new documentation generation pipeline (#167). 
 
+
 ## releasing 0.3.3 (2021-05-12)
 This release contains various bug fixes. 
 
+
 ## releasing 0.3.2 (2021-05-12)
 A version to match changes in the specification 0.3.1. 
 
+
 ## releasing 0.3.1 (2021-03-30)
 0.3.1 contains mostly small bugfixes.
 
 
+
 ## release candidate for 0.3.0 (2021-03-14)
 release note for mmif-python 0.3.0
 

{mmif_python-1.4.0 → mmif_python-1.5.1}/CONTRIBUTING.md

@@ -13,10 +13,17 @@ We follow a Gitflow-inspired branching model to maintain a stable `main` branch
     - Once work is complete, open a PR targeting the `develop` branch.
     - **Communication**: High-level discussion and planning should occur in the issue thread. The PR conversation is strictly for code review and implementation-specific feedback.
 5. **Releases**:
-    - When `develop` is ready for a new release, open a PR from `develop` to `main` using the "release" PR template.
+    - When `develop` is ready for a new release, open a PR from `develop` to `main` using the "release" PR template. See the **Releases** section below for the required title format and preparation steps.
     - After merging the release candidate into `main`, manually tag the commit with the version number. This tag triggers the automated CI/CD pipeline for publishing.
 6. **Branch Protection**: Both `main` and `develop` are protected branches. Direct pushes are disabled; all changes must be introduced via Pull Requests.
 
+## Releases
+
+Release PRs (from `develop` to `main`) are gated by the `release-check` CI workflow. Before opening one:
+
+1. Title the PR exactly `releasing X.Y.Z` (strict semver); `release-check` reads the version from the title.
+2. Run `python build-tools/prep_release.py X.Y.Z` and commit its changes. See inside the prep script to see what's actually prepared.
+
 ## CLI Scripts
 
 The `mmif` command-line interface supports subcommands (e.g., `mmif source`, `mmif describe`). These are implemented as Python modules in `mmif/utils/cli/`.

{mmif_python-1.4.0/mmif_python.egg-info → mmif_python-1.5.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: mmif-python
-Version: 1.4.0
+Version: 1.5.1
 Summary: Python implementation of MultiMedia Interchange Format specification. (https://mmif.clams.ai)
 License-Expression: Apache-2.0
 Project-URL: homepage, https://mmif.clams.ai
 Project-URL: source, https://github.com/clamsproject/mmif-python
-Project-URL: mmif-spec, https://mmif.clams.ai/1.1.1
+Project-URL: mmif-spec, https://mmif.clams.ai/1.2.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3 :: Only

{mmif_python-1.4.0 → mmif_python-1.5.1}/build-tools/docs.py

@@ -109,10 +109,6 @@ def build_versioned_docs(env: Venv, source_path: Path, version: str):
     print("\n--- Installing sphinx and furo theme ---")
     env.run_pip("install", "sphinx>=7.0,<8.0", "furo", "m2r2", cwd=source_path)
 
-    # Write VERSION file (needed for setup.py and sphinx)
-    version_file = source_path / "VERSION"
-    version_file.write_text(version)
-
     # Inject linkcode_resolve function into conf.py for GitHub source links
     # because some old version of conf.py may not have it
     print("\n--- Injecting linkcode_resolve into conf.py ---")
@@ -148,10 +144,16 @@ def linkcode_resolve(domain, info):
         with open(conf_py, "a") as f:
             f.write(linkcode_snippet)
 
-    # Install package in develop mode to generate code (ver, res, vocabulary)
-    # Uses setup.py develop for compatibility with all versions
-    print("\n--- Installing package in develop mode ---")
-    env.run_python("setup.py", "develop", cwd=source_path)
+    # Install package in editable mode so sphinx-autodoc can import it.
+    # Pre-1.4.0 releases ship setup.py with build-time code generation that
+    # needs a VERSION file; 1.4.0+ releases are pyproject-only and version
+    # themselves from git tags via setuptools-scm.
+    print("\n--- Installing package in editable mode ---")
+    if (source_path / "setup.py").exists():
+        (source_path / "VERSION").write_text(version)
+        env.run_python("setup.py", "develop", cwd=source_path)
+    else:
+        env.run_pip("install", "-e", ".", cwd=source_path)
 
     # Build documentation with sphinx-build
     print("\n--- Building Sphinx documentation ---")
@@ -216,8 +218,8 @@ def build_docs_for_version(version: str, output_base_dir: Path, repo_path: Path
         print(f"\n--- Step 2: Creating and setting up virtual environment ---")
         env = Venv(venv_path)
         env.create()
-        # Use setuptools<80 for compatibility with older setup.py files
-        # that use the old import structure
+        # setuptools<80 pin keeps the legacy `python setup.py develop` path
+        # working for pre-1.4.0 tags; harmless for pyproject-only tags.
         env.run_pip("install", "--upgrade", "pip", "setuptools<80", "wheel")
 
         print(f"\n--- Step 3: Building documentation ---")

mmif_python-1.5.1/build-tools/prep_release.py

@@ -0,0 +1,91 @@
+"""
+Prepare release artifacts for the mmif-python package.
+
+Run while preparing a release PR, passing the version being released::
+
+    python build-tools/prep_release.py X.Y.Z
+
+Currently this adds a row to ``documentation/target-versions.csv`` for
+the release version, resolving the target MMIF spec version from the
+installed package metadata (``mmif.__specver__``). This script is the
+single place that writes the target-versions table; the docs build only
+renders it, and CI verifies (on the release PR) that a row for the PR's
+version exists.
+
+Requires an editable install (``pip install -e .``) so that
+``mmif.__specver__`` is importable.
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).parent.parent
+CSV_PATH = PROJECT_ROOT / 'documentation' / 'target-versions.csv'
+
+VERSION_RE = re.compile(r'^\d+\.\d+\.\d+$')
+TOP_ROW_RE = re.compile(r'`(\d+\.\d+\.\d+) <')
+
+
+def _row(version, specver):
+    return (
+        f'`{version} <https://pypi.org/project/mmif-python/{version}/>`__,'
+        f'`{specver} <https://mmif.clams.ai/{specver}/>`__'
+    )
+
+
+def _version_tuple(v):
+    return tuple(int(x) for x in v.split('.'))
+
+
+def _top_version(data_lines):
+    if not data_lines:
+        return None
+    m = TOP_ROW_RE.match(data_lines[0])
+    return m.group(1) if m else None
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Prepare release artifacts for mmif-python."
+    )
+    parser.add_argument(
+        "version", metavar="X.Y.Z",
+        help="the release version being prepared",
+    )
+    args = parser.parse_args()
+    version = args.version
+
+    if not VERSION_RE.match(version):
+        sys.exit(f"Error: '{version}' is not a valid X.Y.Z version.")
+
+    try:
+        import mmif
+        specver = mmif.__specver__
+    except (ImportError, AttributeError):
+        sys.exit("Error: cannot read mmif.__specver__. "
+                 "Run `pip install -e .` first.")
+
+    lines = CSV_PATH.read_text().splitlines()
+    header, data = lines[0], lines[1:]
+    top = _top_version(data)
+
+    if top is not None and _version_tuple(version) < _version_tuple(top):
+        sys.exit(f"Error: {version} is older than the current top row "
+                 f"{top}; refusing to insert an out-of-order version.")
+
+    new_row = _row(version, specver)
+    if top == version:
+        data[0] = new_row            # update in place (e.g. spec changed)
+        action = "updated"
+    else:
+        data.insert(0, new_row)      # prepend as the new latest
+        action = "added"
+
+    CSV_PATH.write_text('\n'.join([header] + data) + '\n')
+    print(f"target-versions.csv: {action} row "
+          f"{version} -> MMIF spec {specver}")
+
+
+if __name__ == "__main__":
+    main()

{mmif_python-1.4.0 → mmif_python-1.5.1}/documentation/conf.py

@@ -6,7 +6,6 @@ import datetime
 import inspect
 import json
 import os
-import re
 import subprocess
 import sys
 import textwrap
@@ -148,42 +147,6 @@ def linkcode_resolve(domain, info):
         return None
 
 
-def update_target_versions(app):
-    """
-    Update documentation/target-versions.csv with the current version and spec version.
-    This replaces the old logic in setup.py.
-    """
-    # Check if we have __specver__ (it might not be there if not installed via setup.py develop)
-    if not hasattr(mmif, '__specver__'):
-        return
-
-    current_ver = mmif.__version__
-    # Skip dev/dummy versions to avoid dirtying the git-tracked CSV
-    if 'dev' in current_ver or not re.match(r'^\d+\.\d+\.\d+$', current_ver):
-        return
-    spec_ver = mmif.__specver__
-
-    csv_path = proj_root_dir / 'documentation' / 'target-versions.csv'
-    if not csv_path.exists():
-        return
-
-    # Read existing content
-    with open(csv_path, 'r') as f:
-        lines = f.readlines()
-
-    # Check if current version is already in the file (first data line)
-    # lines[0] is header, lines[1] is latest version
-    if len(lines) > 1 and lines[1].startswith(f'{current_ver},'):
-        return
-
-    # Insert new version
-    logger.info(f"Updating target-versions.csv: {current_ver} -> {spec_ver}")
-    lines.insert(1, f'{current_ver},"{spec_ver}"\n')
-
-    with open(csv_path, 'w') as f:
-        f.writelines(lines)
-
-
 def generate_cli_rst(app):
     from mmif import prep_argparser_and_subcmds
 
@@ -292,7 +255,6 @@ def run_apidoc(app):
 def setup(app):
     try:
         app.connect('builder-inited', run_apidoc)
-        app.connect('builder-inited', update_target_versions)
         app.connect('builder-inited', generate_cli_rst)
         app.connect('builder-inited', generate_whatsnew_rst)
     except ImportError:

mmif_python-1.5.1/documentation/target-versions.csv

@@ -0,0 +1,52 @@
+"``mmif-python`` version","Target MMIF Specification"
+`1.5.1 <https://pypi.org/project/mmif-python/1.5.1/>`__,`1.2.0 <https://mmif.clams.ai/1.2.0/>`__
+`1.5.0 <https://pypi.org/project/mmif-python/1.5.0/>`__,`1.2.0 <https://mmif.clams.ai/1.2.0/>`__
+`1.4.0 <https://pypi.org/project/mmif-python/1.4.0/>`__,`1.1.1 <https://mmif.clams.ai/1.1.1/>`__
+`1.3.1 <https://pypi.org/project/mmif-python/1.3.1/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.3.0 <https://pypi.org/project/mmif-python/1.3.0/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.2.1 <https://pypi.org/project/mmif-python/1.2.1/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.2.0 <https://pypi.org/project/mmif-python/1.2.0/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.1.2 <https://pypi.org/project/mmif-python/1.1.2/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.1.1 <https://pypi.org/project/mmif-python/1.1.1/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.1.0 <https://pypi.org/project/mmif-python/1.1.0/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.0.19 <https://pypi.org/project/mmif-python/1.0.19/>`__,`1.0.5 <https://mmif.clams.ai/1.0.5/>`__
+`1.0.18 <https://pypi.org/project/mmif-python/1.0.18/>`__,`1.0.5 <https://mmif.clams.ai/1.0.5/>`__
+`1.0.17 <https://pypi.org/project/mmif-python/1.0.17/>`__,`1.0.5 <https://mmif.clams.ai/1.0.5/>`__
+`1.0.16 <https://pypi.org/project/mmif-python/1.0.16/>`__,`1.0.4 <https://mmif.clams.ai/1.0.4/>`__
+`1.0.15 <https://pypi.org/project/mmif-python/1.0.15/>`__,`1.0.4 <https://mmif.clams.ai/1.0.4/>`__
+`1.0.14 <https://pypi.org/project/mmif-python/1.0.14/>`__,`1.0.4 <https://mmif.clams.ai/1.0.4/>`__
+`1.0.13 <https://pypi.org/project/mmif-python/1.0.13/>`__,`1.0.4 <https://mmif.clams.ai/1.0.4/>`__
+`1.0.12 <https://pypi.org/project/mmif-python/1.0.12/>`__,`1.0.4 <https://mmif.clams.ai/1.0.4/>`__
+`1.0.11 <https://pypi.org/project/mmif-python/1.0.11/>`__,`1.0.4 <https://mmif.clams.ai/1.0.4/>`__
+`1.0.10 <https://pypi.org/project/mmif-python/1.0.10/>`__,`1.0.2 <https://mmif.clams.ai/1.0.2/>`__
+`1.0.9 <https://pypi.org/project/mmif-python/1.0.9/>`__,`1.1.0 <https://mmif.clams.ai/1.1.0/>`__
+`1.0.8 <https://pypi.org/project/mmif-python/1.0.8/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.7 <https://pypi.org/project/mmif-python/1.0.7/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.6 <https://pypi.org/project/mmif-python/1.0.6/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.5 <https://pypi.org/project/mmif-python/1.0.5/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.4 <https://pypi.org/project/mmif-python/1.0.4/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.3 <https://pypi.org/project/mmif-python/1.0.3/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.2 <https://pypi.org/project/mmif-python/1.0.2/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.1 <https://pypi.org/project/mmif-python/1.0.1/>`__,`1.0.0 <https://mmif.clams.ai/1.0.0/>`__
+`1.0.0 <https://pypi.org/project/mmif-python/1.0.0/>`__,`0.5.0 <https://mmif.clams.ai/0.5.0/>`__
+`0.5.2 <https://pypi.org/project/mmif-python/0.5.2/>`__,`0.5.0 <https://mmif.clams.ai/0.5.0/>`__
+`0.5.1 <https://pypi.org/project/mmif-python/0.5.1/>`__,`0.5.0 <https://mmif.clams.ai/0.5.0/>`__
+`0.5.0 <https://pypi.org/project/mmif-python/0.5.0/>`__,`0.5.0 <https://mmif.clams.ai/0.5.0/>`__
+`0.4.8 <https://pypi.org/project/mmif-python/0.4.8/>`__,`0.4.2 <https://mmif.clams.ai/0.4.2/>`__
+`0.4.7 <https://pypi.org/project/mmif-python/0.4.7/>`__,`0.4.1 <https://mmif.clams.ai/0.4.1/>`__
+`0.4.6 <https://pypi.org/project/mmif-python/0.4.6/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.4.5 <https://pypi.org/project/mmif-python/0.4.5/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.4.4 <https://pypi.org/project/mmif-python/0.4.4/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.4.3 <https://pypi.org/project/mmif-python/0.4.3/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.4.2 <https://pypi.org/project/mmif-python/0.4.2/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.4.1 <https://pypi.org/project/mmif-python/0.4.1/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.4.0 <https://pypi.org/project/mmif-python/0.4.0/>`__,`0.4.0 <https://mmif.clams.ai/0.4.0/>`__
+`0.3.5 <https://pypi.org/project/mmif-python/0.3.5/>`__,`0.3.1 <https://mmif.clams.ai/0.3.1/>`__
+`0.3.4 <https://pypi.org/project/mmif-python/0.3.4/>`__,`0.3.1 <https://mmif.clams.ai/0.3.1/>`__
+`0.3.3 <https://pypi.org/project/mmif-python/0.3.3/>`__,`0.3.1 <https://mmif.clams.ai/0.3.1/>`__
+`0.3.2 <https://pypi.org/project/mmif-python/0.3.2/>`__,`0.3.1 <https://mmif.clams.ai/0.3.1/>`__
+`0.3.1 <https://pypi.org/project/mmif-python/0.3.1/>`__,`0.3.0 <https://mmif.clams.ai/0.3.0/>`__
+`0.3.0 <https://pypi.org/project/mmif-python/0.3.0/>`__,`0.3.0 <https://mmif.clams.ai/0.3.0/>`__
+`0.2.2 <https://pypi.org/project/mmif-python/0.2.2/>`__,`0.2.1 <https://mmif.clams.ai/0.2.1/>`__
+`0.2.1 <https://pypi.org/project/mmif-python/0.2.1/>`__,`0.2.1 <https://mmif.clams.ai/0.2.1/>`__
+`0.2.0 <https://pypi.org/project/mmif-python/0.2.0/>`__,`0.2.1 <https://mmif.clams.ai/0.2.1/>`__