ml-dash 0.6.15__tar.gz → 0.6.17__tar.gz

{ml_dash-0.6.15 → ml_dash-0.6.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ml-dash
-Version: 0.6.15
+Version: 0.6.17
 Summary: ML experiment tracking and data storage
 Keywords: machine-learning,experiment-tracking,mlops,data-storage
 Author: Ge Yang, Tom Tao
@@ -43,7 +43,7 @@ Requires-Dist: imageio-ffmpeg>=0.4.9
 Requires-Dist: scikit-image>=0.21.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: cryptography>=42.0.0
-Requires-Dist: params-proto>=3.0.0
+Requires-Dist: params-proto>=3.0.0,<3.2.0
 Requires-Dist: keyring>=25.0.0 ; extra == 'auth'
 Requires-Dist: qrcode>=8.0.0 ; extra == 'auth'
 Requires-Dist: pytest>=8.0.0 ; extra == 'dev'

{ml_dash-0.6.15 → ml_dash-0.6.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ml-dash"
-version = "0.6.15"
+version = "0.6.17"
 description = "ML experiment tracking and data storage"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -31,7 +31,7 @@ dependencies = [
     "scikit-image>=0.21.0",
     "rich>=13.0.0",
     "cryptography>=42.0.0",
-    "params-proto>=3.0.0",
+    "params-proto>=3.0.0,<3.2.0",
 ]
 
 [project.scripts]

ml_dash-0.6.17/src/ml_dash/__init__.py

@@ -0,0 +1,121 @@
+"""
+ML-Dash Python SDK
+
+A simple and flexible SDK for ML experiment metricing and data storage.
+
+Prefix format: {owner}/{project}/path.../[name]
+  - owner: First segment (e.g., your username)
+  - project: Second segment (e.g., project name)
+  - path: Remaining segments form the folder structure
+  - name: Derived from last segment (may be a seed/id)
+
+Usage:
+
+    from ml_dash import Experiment
+
+    # Local mode - explicit configuration
+    with Experiment(
+        prefix="ge/my-project/experiments/exp1",
+        dash_root=".dash"
+    ).run as exp:
+        exp.log("Training started")
+        exp.params.set(lr=0.001)
+        exp.metrics("train").log(loss=0.5, step=0)
+
+    # Default: Remote mode (defaults to https://api.dash.ml)
+    with Experiment(prefix="ge/my-project/experiments/exp1").run as exp:
+        exp.log("Training started")
+        exp.params.set(lr=0.001)
+        exp.metrics("train").log(loss=0.5, step=0)
+
+    # Decorator style
+    from ml_dash import ml_dash_experiment
+
+    @ml_dash_experiment(prefix="ge/my-project/experiments/exp1")
+    def train_model(exp):
+        exp.log("Training started")
+"""
+
+from .client import RemoteClient, userinfo
+from .experiment import Experiment, OperationMode, ml_dash_experiment
+from .log import LogBuilder, LogLevel
+from .params import ParametersBuilder
+from .run import RUN
+from .storage import LocalStorage
+
+__version__ = "0.6.17"
+
+
+def _check_version_compatibility():
+    """
+    Enforce strict version requirement by checking against PyPI.
+
+    Raises ImportError if installed version is older than the latest on PyPI.
+    This ensures all users are on the latest version with newest features and bug fixes.
+    """
+    try:
+        from packaging import version
+        import httpx
+    except ImportError:
+        # If packaging or httpx not available, skip check
+        return
+
+    try:
+        # Check PyPI for latest version (with short timeout)
+        response = httpx.get(
+            "https://pypi.org/pypi/ml-dash/json",
+            timeout=2.0,
+            follow_redirects=True
+        )
+
+        if response.status_code == 200:
+            latest_version = response.json()["info"]["version"]
+            current = version.parse(__version__)
+            latest = version.parse(latest_version)
+
+            if current < latest:
+                raise ImportError(
+                    f"\n"
+                    f"{'=' * 80}\n"
+                    f"ERROR: ml-dash version {__version__} is outdated!\n"
+                    f"{'=' * 80}\n"
+                    f"\n"
+                    f"Your installed version ({__version__}) is no longer supported.\n"
+                    f"Latest version on PyPI: {latest_version}\n"
+                    f"\n"
+                    f"Please upgrade to the latest version:\n"
+                    f"\n"
+                    f"  pip install --upgrade ml-dash\n"
+                    f"\n"
+                    f"Or with uv:\n"
+                    f"\n"
+                    f"  uv pip install --upgrade ml-dash\n"
+                    f"  uv sync --upgrade-package ml-dash\n"
+                    f"\n"
+                    f"{'=' * 80}\n"
+                )
+    except (httpx.TimeoutException, httpx.ConnectError, KeyError):
+        # Silently skip check if PyPI is unreachable or response is malformed
+        # Don't block users due to network issues
+        pass
+    except Exception:
+        # Catch any other errors and silently continue
+        # Better to let users work than block on unexpected errors
+        pass
+
+
+# Enforce version check on import
+_check_version_compatibility()
+
+__all__ = [
+  "Experiment",
+  "ml_dash_experiment",
+  "OperationMode",
+  "RemoteClient",
+  "LocalStorage",
+  "LogLevel",
+  "LogBuilder",
+  "ParametersBuilder",
+  "RUN",
+  "userinfo",
+]

{ml_dash-0.6.15 → ml_dash-0.6.17}/src/ml_dash/experiment.py

@@ -381,6 +381,7 @@ class Experiment:
 
         try:
           from rich.console import Console
+          from ml_dash import __version__
 
           console = Console()
           experiment_url = f"https://dash.ml/{self.run.prefix}"
@@ -388,15 +389,19 @@ class Experiment:
             f"[{status_color}]{status_emoji} Experiment {status.lower()}: "
             f"[bold]{self.run.name}[/bold] (project: {self.run.project})[/{status_color}]\n"
             f"[dim]View results, statistics, and plots online at:[/dim] "
-            f"[link={experiment_url}]{experiment_url}[/link]"
+            f"[link={experiment_url}]{experiment_url}[/link]\n"
+            f"[dim]ml-dash version: {__version__}[/dim]"
           )
         except ImportError:
           # Fallback if rich is not available
+          from ml_dash import __version__
+
           experiment_url = f"https://dash.ml/{self.run.prefix}"
           print(
             f"{status_emoji} Experiment {status.lower()}: {self.run.name} (project: {self.run.project})"
           )
           print(f"View results at: {experiment_url}")
+          print(f"ml-dash version: {__version__}")
 
       except Exception as e:
         # Raise on status update failure

ml_dash-0.6.15/src/ml_dash/__init__.py

@@ -1,107 +0,0 @@
-"""
-ML-Dash Python SDK
-
-A simple and flexible SDK for ML experiment metricing and data storage.
-
-Prefix format: {owner}/{project}/path.../[name]
-  - owner: First segment (e.g., your username)
-  - project: Second segment (e.g., project name)
-  - path: Remaining segments form the folder structure
-  - name: Derived from last segment (may be a seed/id)
-
-Usage:
-
-    from ml_dash import Experiment
-
-    # Local mode - explicit configuration
-    with Experiment(
-        prefix="ge/my-project/experiments/exp1",
-        dash_root=".dash"
-    ).run as exp:
-        exp.log("Training started")
-        exp.params.set(lr=0.001)
-        exp.metrics("train").log(loss=0.5, step=0)
-
-    # Default: Remote mode (defaults to https://api.dash.ml)
-    with Experiment(prefix="ge/my-project/experiments/exp1").run as exp:
-        exp.log("Training started")
-        exp.params.set(lr=0.001)
-        exp.metrics("train").log(loss=0.5, step=0)
-
-    # Decorator style
-    from ml_dash import ml_dash_experiment
-
-    @ml_dash_experiment(prefix="ge/my-project/experiments/exp1")
-    def train_model(exp):
-        exp.log("Training started")
-"""
-
-from .client import RemoteClient, userinfo
-from .experiment import Experiment, OperationMode, ml_dash_experiment
-from .log import LogBuilder, LogLevel
-from .params import ParametersBuilder
-from .run import RUN
-from .storage import LocalStorage
-
-__version__ = "0.6.14"
-
-# Required version - MUST match exactly (blocks all older versions)
-# Update this with EVERY release to force users to upgrade
-REQUIRED_VERSION = "0.6.14"
-
-
-def _check_version_compatibility():
-    """
-    Enforce strict version requirement.
-
-    Raises ImportError if installed version doesn't match the required version.
-    This ensures all users are on the latest version with newest features and bug fixes.
-    """
-    try:
-        from packaging import version
-    except ImportError:
-        # If packaging is not available, skip check
-        # (unlikely since it's a common dependency)
-        return
-
-    current = version.parse(__version__)
-    required = version.parse(REQUIRED_VERSION)
-
-    if current < required:
-        raise ImportError(
-            f"\n"
-            f"{'=' * 80}\n"
-            f"ERROR: ml-dash version {__version__} is outdated!\n"
-            f"{'=' * 80}\n"
-            f"\n"
-            f"Your installed version ({__version__}) is no longer supported.\n"
-            f"Required version: {REQUIRED_VERSION}\n"
-            f"\n"
-            f"Please upgrade to the latest version:\n"
-            f"\n"
-            f"  pip install --upgrade ml-dash\n"
-            f"\n"
-            f"Or with uv:\n"
-            f"\n"
-            f"  uv pip install --upgrade ml-dash\n"
-            f"  uv sync --upgrade-package ml-dash\n"
-            f"\n"
-            f"{'=' * 80}\n"
-        )
-
-
-# Enforce version check on import
-_check_version_compatibility()
-
-__all__ = [
-  "Experiment",
-  "ml_dash_experiment",
-  "OperationMode",
-  "RemoteClient",
-  "LocalStorage",
-  "LogLevel",
-  "LogBuilder",
-  "ParametersBuilder",
-  "RUN",
-  "userinfo",
-]