opensportslib 0.3.1.dev24__tar.gz → 0.3.1.dev25__tar.gz

{opensportslib-0.3.1.dev24/opensportslib.egg-info → opensportslib-0.3.1.dev25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensportslib
-Version: 0.3.1.dev24
+Version: 0.3.1.dev25
 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.dev24 → opensportslib-0.3.1.dev25/opensportslib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensportslib
-Version: 0.3.1.dev24
+Version: 0.3.1.dev25
 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.dev24 → opensportslib-0.3.1.dev25}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opensportslib"
-version = "0.3.1.dev24"
+version = "0.3.1.dev25"
 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.dev25/scripts/release_versions.py

@@ -0,0 +1,181 @@
+"""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==)([^"]+)(")')
+
+
+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 development_version(tag: str) -> str:
+    """Return the initial development version for a stable release tag."""
+    return f"{stable_version(tag)}.dev0"
+
+
+def next_patch_development_version(tag: str) -> str:
+    """Return the next patch's initial development version for a release tag."""
+    major, minor, patch = (int(part) for part in stable_version(tag).split("."))
+    return f"{major}.{minor}.{patch + 1}.dev0"
+
+
+def version_base(version: str) -> str:
+    """Return X.Y.Z from either a stable or development package version."""
+    dev_match = DEV_VERSION.fullmatch(version)
+    if dev_match:
+        return dev_match.group("base")
+    if STABLE_VERSION.fullmatch(version):
+        return version
+    raise ValueError(f"unsupported release version {version!r}")
+
+
+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 read_server_pin(pyproject: Path) -> str:
+    """Return the OpenSportsLib dependency pin from the server metadata."""
+    text = pyproject.read_text()
+    matches = SERVER_PIN.findall(text)
+    if len(matches) != 1:
+        raise ValueError(f"expected one opensportslib dependency pin in {pyproject}")
+    return matches[0][1]
+
+
+def assert_synchronized(root_pyproject: Path, server_pyproject: Path) -> str:
+    """Ensure the package version and server dependency pin are identical."""
+    version = read_project_version(root_pyproject)
+    pin = read_server_pin(server_pyproject)
+    if version != pin:
+        raise ValueError(
+            f"version metadata is not synchronized: {root_pyproject} has {version!r}, "
+            f"but {server_pyproject} pins {pin!r}"
+        )
+    return version
+
+
+def validate_release(tag: str, root_pyproject: Path, server_pyproject: Path) -> str:
+    """Validate that metadata is the prepared prerelease for *tag*."""
+    expected = development_version(tag)
+    current = assert_synchronized(root_pyproject, server_pyproject)
+    if not DEV_VERSION.fullmatch(current) or version_base(current) != stable_version(tag):
+        raise ValueError(
+            f"release tag {tag!r} requires prepared version {expected[:-1]}N, got {current!r}"
+        )
+    return current
+
+
+def prepare_development(tag: str, root_pyproject: Path, server_pyproject: Path) -> str:
+    """Start the requested release line at X.Y.Z.dev0."""
+    target = development_version(tag)
+    current = assert_synchronized(root_pyproject, server_pyproject)
+    if tuple(map(int, stable_version(tag).split("."))) <= tuple(map(int, version_base(current).split("."))):
+        raise ValueError(f"target release {tag!r} must be newer than current version {current!r}")
+    synchronize(target, root_pyproject, server_pyproject)
+    return target
+
+
+def advance_development(tag: str, root_pyproject: Path, server_pyproject: Path) -> str:
+    """Advance a released development line to its next patch development base."""
+    validate_release(tag, root_pyproject, server_pyproject)
+    target = next_patch_development_version(tag)
+    synchronize(target, root_pyproject, server_pyproject)
+    return target
+
+
+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<3>", 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",
+            "prepare-dev",
+            "validate-release",
+            "advance-dev",
+            "assert-synchronized",
+        ),
+    )
+    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(assert_synchronized(args.root, args.server))
+        synchronize(version, args.root, args.server)
+    elif args.command == "set-stable":
+        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)
+    elif args.command == "prepare-dev":
+        if args.value is None:
+            parser.error("prepare-dev requires a vX.Y.Z tag")
+        version = prepare_development(args.value, args.root, args.server)
+    elif args.command == "validate-release":
+        if args.value is None:
+            parser.error("validate-release requires a vX.Y.Z tag")
+        version = validate_release(args.value, args.root, args.server)
+    elif args.command == "advance-dev":
+        if args.value is None:
+            parser.error("advance-dev requires a vX.Y.Z tag")
+        version = advance_development(args.value, args.root, args.server)
+    else:
+        if args.value is not None:
+            parser.error("assert-synchronized does not accept a value")
+        version = assert_synchronized(args.root, args.server)
+    print(version)
+
+
+if __name__ == "__main__":
+    main()

opensportslib-0.3.1.dev25/tests/unit/contracts/test_release_versions.py

@@ -0,0 +1,118 @@
+import importlib.util
+from pathlib import Path
+
+import pytest
+
+
+SCRIPT = Path(__file__).parents[3] / "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_development_version_helpers():
+    assert release_versions.development_version("v0.4.0") == "0.4.0.dev0"
+    assert release_versions.next_patch_development_version("v0.3.1") == "0.3.2.dev0"
+    assert release_versions.version_base("0.3.1.dev5") == "0.3.1"
+    assert release_versions.version_base("0.3.1") == "0.3.1"
+    with pytest.raises(ValueError, match="unsupported release version"):
+        release_versions.version_base("invalid")
+
+
+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
+
+
+def test_assert_synchronized_rejects_mismatched_metadata(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    root.write_text('[project]\nversion = "0.3.1.dev5"\n')
+    server.write_text('dependencies = ["opensportslib==0.3.1.dev4"]\n')
+
+    with pytest.raises(ValueError, match="not synchronized"):
+        release_versions.assert_synchronized(root, server)
+
+
+def test_validate_release_requires_matching_prepared_dev_line(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    root.write_text('[project]\nversion = "0.3.1.dev5"\n')
+    server.write_text('dependencies = ["opensportslib==0.3.1.dev5"]\n')
+
+    assert release_versions.validate_release("v0.3.1", root, server) == "0.3.1.dev5"
+    with pytest.raises(ValueError, match="requires prepared version"):
+        release_versions.validate_release("v0.3.2", root, server)
+
+
+def test_prepare_development_starts_newer_feature_line(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    root.write_text('[project]\nversion = "0.3.2.dev8"\n')
+    server.write_text('dependencies = ["opensportslib==0.3.2.dev8"]\n')
+
+    assert release_versions.prepare_development("v0.4.0", root, server) == "0.4.0.dev0"
+    assert release_versions.assert_synchronized(root, server) == "0.4.0.dev0"
+    with pytest.raises(ValueError, match="must be newer"):
+        release_versions.prepare_development("v0.4.0", root, server)
+
+
+def test_advance_development_moves_to_next_patch_only_from_matching_line(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    root.write_text('[project]\nversion = "0.3.1.dev6"\n')
+    server.write_text('dependencies = ["opensportslib==0.3.1.dev6"]\n')
+
+    assert release_versions.advance_development("v0.3.1", root, server) == "0.3.2.dev0"
+    assert release_versions.assert_synchronized(root, server) == "0.3.2.dev0"
+
+
+def test_advance_development_refuses_a_different_release_line(tmp_path):
+    root = tmp_path / "pyproject.toml"
+    server = tmp_path / "server.toml"
+    root.write_text('[project]\nversion = "0.4.0.dev0"\n')
+    server.write_text('dependencies = ["opensportslib==0.4.0.dev0"]\n')
+
+    with pytest.raises(ValueError, match="requires prepared version"):
+        release_versions.advance_development("v0.3.1", root, server)

opensportslib-0.3.1.dev24/scripts/release_versions.py

@@ -1,84 +0,0 @@
-"""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.dev24/tests/unit/contracts/test_release_versions.py

@@ -1,56 +0,0 @@
-import importlib.util
-from pathlib import Path
-
-import pytest
-
-
-SCRIPT = Path(__file__).parents[3] / "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