deriva-ml 1.17.10__py3-none-any.whl

deriva_ml/__init__.py

@@ -0,0 +1,79 @@
+# We will be loading get_version from setuptools_scm and it will emit a UserWarning about it being deprecated.
+
+from importlib.metadata import PackageNotFoundError, version
+from typing import TYPE_CHECKING
+
+# Safe imports - no circular dependencies
+from deriva_ml.core.config import DerivaMLConfig
+from deriva_ml.core.definitions import (
+    RID,
+    BuiltinTypes,
+    ColumnDefinition,
+    DerivaAssetColumns,
+    DerivaSystemColumns,
+    ExecAssetType,
+    ExecMetadataType,
+    FileSpec,
+    FileUploadState,
+    ForeignKeyDefinition,
+    KeyDefinition,
+    MLAsset,
+    MLVocab,
+    TableDefinition,
+    UploadState,
+)
+from deriva_ml.core.exceptions import (
+    DerivaMLException,
+    DerivaMLInvalidTerm,
+    DerivaMLTableTypeError,
+)
+
+# Type-checking only - avoid circular import at runtime
+if TYPE_CHECKING:
+    from deriva_ml.core.base import DerivaML
+
+
+# Lazy import function for runtime usage
+def __getattr__(name):
+    """Lazy import to avoid circular dependencies."""
+    if name == "DerivaML":
+        from deriva_ml.core.base import DerivaML
+
+        return DerivaML
+    elif name == "Execution":
+        from deriva_ml.execution.execution import Execution
+
+        return Execution
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "DerivaML",  # Lazy-loaded
+    "DerivaMLConfig",
+    # Exceptions
+    "DerivaMLException",
+    "DerivaMLInvalidTerm",
+    "DerivaMLTableTypeError",
+    # Definitions
+    "RID",
+    "BuiltinTypes",
+    "ColumnDefinition",
+    "DerivaSystemColumns",
+    "DerivaAssetColumns",
+    "ExecAssetType",
+    "ExecMetadataType",
+    "FileSpec",
+    "FileUploadState",
+    "ForeignKeyDefinition",
+    "KeyDefinition",
+    "MLAsset",
+    "MLVocab",
+    "TableDefinition",
+    "UploadState",
+]
+
+try:
+    __version__ = version("deriva_ml")
+except PackageNotFoundError:
+    # package is not installed
+    pass

deriva_ml/bump_version.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""
+Release helper: seed initial semver tag if none exists, otherwise bump with bump-my-version.
+
+Usage:
+  python release.py [patch|minor|major]
+
+Env vars:
+  START   - initial version if no tag exists (default: 0.1.0)
+  PREFIX  - tag prefix (default: v)
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from typing import Sequence
+
+
+def run(
+    cmd: Sequence[str], check: bool = True, capture: bool = False, quiet: bool = False
+) -> subprocess.CompletedProcess:
+    if not quiet:
+        print(f"$ {' '.join(cmd)}")
+    return subprocess.run(
+        cmd,
+        check=check,
+        capture_output=capture,
+        text=True,
+    )
+
+
+def in_git_repo() -> bool:
+    try:
+        run(["git", "rev-parse", "--is-inside-work-tree"], capture=True)
+        return True
+    except subprocess.CalledProcessError:
+        return False
+
+
+def has_commits() -> bool:
+    try:
+        run(["git", "log", "-1"], capture=True)
+        return True
+    except subprocess.CalledProcessError:
+        return False
+
+
+def latest_semver_tag(prefix: str) -> str | None:
+    # Use git's matcher to keep parity with Bash: prefix + x.y.z
+    pattern = f"{prefix}[0-9]*.[0-9]*.[0-9]*"
+    try:
+        cp = run(["git", "describe", "--tags", "--abbrev=0", "--match", pattern], capture=True, quiet=True)
+        tag = cp.stdout.strip()
+        return tag or None
+    except subprocess.CalledProcessError:
+        return None
+
+
+def seed_initial_tag(tag: str) -> None:
+    print(f"No existing semver tag found. Seeding initial tag: {tag}")
+    run(["git", "tag", tag, "-m", f"Initial release {tag}"])
+    # Push tags (ignore failure to keep parity with bash's simple flow)
+    run(["git", "push", "--tags"])
+
+
+def require_tool(name: str) -> None:
+    if shutil.which(name) is None:
+        print(f"Error: required tool '{name}' not found on PATH.", file=sys.stderr)
+        sys.exit(1)
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="Set a new version tag for the current repository, and push to remote."
+    )
+    parser.add_argument(
+        "bump", nargs="?", default="patch", choices=["patch", "minor", "major"], help="Which semver part to bump."
+    )
+    args = parser.parse_args()
+
+    start = os.environ.get("START", "0.1.0")
+    prefix = os.environ.get("PREFIX", "v")
+
+    # Sanity checks
+    require_tool("git")
+    require_tool("uv")
+
+    if not in_git_repo():
+        print("Not a git repo.", file=sys.stderr)
+        return 1
+
+    # Ensure tags visible in shallow clones
+    try:
+        run(["git", "fetch", "--tags", "--quiet"], check=False)
+    except Exception:
+        pass  # non-fatal
+
+    if not has_commits():
+        print("No commits found. Commit something before tagging.", file=sys.stderr)
+        return 1
+
+    # Find latest semver tag with prefix
+    tag = latest_semver_tag(prefix)
+    print(f"Latest semver tag: {tag}")
+    if not tag:
+        seed_initial_tag(f"{prefix}{start}")
+        print(f"Seeded {prefix}{start}. Done.")
+        return 0
+
+    print(f"Bumping version: {args.bump}")
+
+    # Bump using bump-my-version via uv
+    # Mirrors: uv run bump-my-version bump $BUMP --verbose
+    try:
+        run(["uv", "run", "bump-my-version", "bump", args.bump, "--verbose"])
+    except subprocess.CalledProcessError as e:
+        print(e.stdout or "", end="")
+        print(e.stderr or "", end="", file=sys.stderr)
+        return e.returncode
+
+    # Push commits and tags
+    print("Pushing changes to remote repository...")
+    run(["git", "push", "--follow-tags"])
+
+    # Retrieve new version tag
+    try:
+        cp = run(["git", "describe", "--tags", "--abbrev=0"], capture=True)
+        new_tag = cp.stdout.strip()
+        print(f"New version tag: {new_tag}")
+    except subprocess.CalledProcessError:
+        print("Warning: unable to determine new tag via git describe.", file=sys.stderr)
+
+    print("Release process complete!")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

deriva_ml/core/__init__.py

@@ -0,0 +1,39 @@
+from deriva_ml.core.base import DerivaML
+from deriva_ml.core.config import DerivaMLConfig
+from deriva_ml.core.definitions import (
+    RID,
+    BuiltinTypes,
+    ColumnDefinition,
+    DerivaSystemColumns,
+    ExecAssetType,
+    ExecMetadataType,
+    FileSpec,
+    FileUploadState,
+    MLAsset,
+    MLVocab,
+    TableDefinition,
+    UploadState,
+)
+from deriva_ml.core.exceptions import DerivaMLException, DerivaMLInvalidTerm, DerivaMLTableTypeError
+
+__all__ = [
+    "DerivaML",
+    "DerivaMLConfig",
+    # Exceptions
+    "DerivaMLException",
+    "DerivaMLInvalidTerm",
+    "DerivaMLTableTypeError",
+    # Definitions
+    "RID",
+    "BuiltinTypes",
+    "ColumnDefinition",
+    "DerivaSystemColumns",
+    "ExecAssetType",
+    "ExecMetadataType",
+    "FileSpec",
+    "FileUploadState",
+    "MLAsset",
+    "MLVocab",
+    "TableDefinition",
+    "UploadState",
+]