opensportslib 0.3.1.dev5__tar.gz → 0.3.1.dev6__tar.gz

{opensportslib-0.3.1.dev5/opensportslib.egg-info → opensportslib-0.3.1.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensportslib
-Version: 0.3.1.dev5
+Version: 0.3.1.dev6
 Summary: OpenSportsLib is the professional library, designed for advanced video understanding in sports. It provides state-of-the-art tools for action recognition, spotting, retrieval, and captioning, making it ideal for researchers, analysts, and developers working with sports video data.
 Author: Jeet Vora
 Requires-Python: >=3.12

{opensportslib-0.3.1.dev5 → opensportslib-0.3.1.dev6/opensportslib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensportslib
-Version: 0.3.1.dev5
+Version: 0.3.1.dev6
 Summary: OpenSportsLib is the professional library, designed for advanced video understanding in sports. It provides state-of-the-art tools for action recognition, spotting, retrieval, and captioning, making it ideal for researchers, analysts, and developers working with sports video data.
 Author: Jeet Vora
 Requires-Python: >=3.12

{opensportslib-0.3.1.dev5 → opensportslib-0.3.1.dev6}/opensportslib.egg-info/SOURCES.txt

@@ -142,6 +142,7 @@ opensportslib/tools/_common.py
 opensportslib/tools/hf_transfer.py
 opensportslib/tools/osl_json_to_parquet.py
 opensportslib/tools/parquet_to_osl_json.py
+scripts/release_versions.py
 scripts/run_h5_header_rule_inference.py
 tests/conftest.py
 tests/test_classification_dataset_paths.py
@@ -163,6 +164,7 @@ tests/test_optional_hf_config.py
 tests/test_package_smoke.py
 tests/test_pretrained_config_merge_policy.py
 tests/test_public_apis_smoke.py
+tests/test_release_versions.py
 tests/test_setup_cli.py
 tests/test_spotta_e2e.py
 tests/test_subset_train_infer_integration.py

{opensportslib-0.3.1.dev5 → opensportslib-0.3.1.dev6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opensportslib"
-version = "0.3.1.dev5"
+version = "0.3.1.dev6"
 description = "OpenSportsLib is the professional library, designed for advanced video understanding in sports. It provides state-of-the-art tools for action recognition, spotting, retrieval, and captioning, making it ideal for researchers, analysts, and developers working with sports video data."
 readme = "README.md"
 requires-python = ">=3.12"

opensportslib-0.3.1.dev6/scripts/release_versions.py

@@ -0,0 +1,84 @@
+"""Keep the library version and the server's library pin in sync."""
+
+from __future__ import annotations
+
+import argparse
+import re
+from pathlib import Path
+
+
+STABLE_VERSION = re.compile(r"^(?P<version>\d+\.\d+\.\d+)$")
+DEV_VERSION = re.compile(r"^(?P<base>\d+\.\d+\.\d+)\.dev(?P<number>\d+)$")
+PROJECT_VERSION = re.compile(
+    r'(?ms)(^\[project\]\s*.*?^version\s*=\s*")[^"]+("\s*$)'
+)
+SERVER_PIN = re.compile(r'("opensportslib==)[^"]+("[,\s]*$)', re.MULTILINE)
+
+
+def next_dev_version(current: str) -> str:
+    """Return the next development release for an existing dev version."""
+    match = DEV_VERSION.fullmatch(current)
+    if not match:
+        raise ValueError(f"expected X.Y.Z.devN, got {current!r}")
+    return f"{match.group('base')}.dev{int(match.group('number')) + 1}"
+
+
+def stable_version(tag: str) -> str:
+    """Return a stable version from a vX.Y.Z release tag."""
+    if not tag.startswith("v"):
+        raise ValueError(f"release tag must start with 'v', got {tag!r}")
+    version = tag[1:]
+    if not STABLE_VERSION.fullmatch(version):
+        raise ValueError(f"release tag must have the form vX.Y.Z, got {tag!r}")
+    return version
+
+
+def read_project_version(pyproject: Path) -> str:
+    text = pyproject.read_text()
+    match = PROJECT_VERSION.search(text)
+    if not match:
+        raise ValueError(f"project.version not found in {pyproject}")
+    return text[match.start(0) + len(match.group(1)) : match.end(0) - len(match.group(2))]
+
+
+def synchronize(version: str, root_pyproject: Path, server_pyproject: Path) -> None:
+    """Write one OpenSportsLib version to both release metadata files."""
+    if not (STABLE_VERSION.fullmatch(version) or DEV_VERSION.fullmatch(version)):
+        raise ValueError(f"unsupported release version {version!r}")
+
+    root_text = root_pyproject.read_text()
+    server_text = server_pyproject.read_text()
+    if len(PROJECT_VERSION.findall(root_text)) != 1:
+        raise ValueError(f"expected one project.version in {root_pyproject}")
+    if len(SERVER_PIN.findall(server_text)) != 1:
+        raise ValueError(f"expected one opensportslib dependency pin in {server_pyproject}")
+
+    root_updated = PROJECT_VERSION.sub(rf"\g<1>{version}\g<2>", root_text)
+    server_updated = SERVER_PIN.sub(rf"\g<1>{version}\g<2>", server_text)
+    root_pyproject.write_text(root_updated)
+    server_pyproject.write_text(server_updated)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("command", choices=("bump-dev", "set-stable"))
+    parser.add_argument("value", nargs="?", help="vX.Y.Z tag for set-stable")
+    parser.add_argument("--root", type=Path, default=Path("pyproject.toml"))
+    parser.add_argument("--server", type=Path, default=Path("server/pyproject.toml"))
+    args = parser.parse_args()
+
+    if args.command == "bump-dev":
+        if args.value is not None:
+            parser.error("bump-dev does not accept a value")
+        version = next_dev_version(read_project_version(args.root))
+    else:
+        if args.value is None:
+            parser.error("set-stable requires a vX.Y.Z tag")
+        version = stable_version(args.value)
+
+    synchronize(version, args.root, args.server)
+    print(version)
+
+
+if __name__ == "__main__":
+    main()

opensportslib-0.3.1.dev6/tests/test_release_versions.py

@@ -0,0 +1,56 @@
+import importlib.util
+from pathlib import Path
+
+import pytest
+
+
+SCRIPT = Path(__file__).parents[1] / "scripts" / "release_versions.py"
+SPEC = importlib.util.spec_from_file_location("release_versions", SCRIPT)
+release_versions = importlib.util.module_from_spec(SPEC)
+assert SPEC.loader is not None
+SPEC.loader.exec_module(release_versions)
+
+
+def test_next_dev_version_increments_counter():
+    assert release_versions.next_dev_version("0.3.1.dev5") == "0.3.1.dev6"
+
+
+@pytest.mark.parametrize("version", ["0.3.1", "0.3.1rc1", "invalid"])
+def test_next_dev_version_rejects_non_dev_versions(version):
+    with pytest.raises(ValueError, match="expected X.Y.Z.devN"):
+        release_versions.next_dev_version(version)
+
+
+def test_stable_version_requires_stable_v_tag():
+    assert release_versions.stable_version("v0.3.1") == "0.3.1"
+    with pytest.raises(ValueError, match="vX.Y.Z"):
+        release_versions.stable_version("v0.3.1.dev1")
+
+
+def test_synchronize_updates_root_and_server_pin_only(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    root.write_text('[project]\nname = "opensportslib"\nversion = "0.3.1.dev5"\n')
+    server.write_text(
+        '[project]\nname = "opensportslib-server"\nversion = "0.1.0"\n'
+        'dependencies = [\n  "opensportslib==0.3.1.dev5",\n  "fastapi",\n]\n'
+    )
+
+    release_versions.synchronize("0.3.1.dev6", root, server)
+
+    assert 'version = "0.3.1.dev6"' in root.read_text()
+    assert 'version = "0.1.0"' in server.read_text()
+    assert '"opensportslib==0.3.1.dev6"' in server.read_text()
+
+
+def test_synchronize_fails_before_writing_when_server_pin_is_missing(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    original = '[project]\nversion = "0.3.1.dev5"\n'
+    root.write_text(original)
+    server.write_text('[project]\nversion = "0.1.0"\n')
+
+    with pytest.raises(ValueError, match="dependency pin"):
+        release_versions.synchronize("0.3.1.dev6", root, server)
+
+    assert root.read_text() == original