mammoth-cli 2.2.14__tar.gz → 2.2.15__tar.gz

{mammoth_cli-2.2.14 → mammoth_cli-2.2.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.14
+Version: 2.2.15
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,7 +17,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.12
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.9,>=0.8.14
+Requires-Dist: mammoth-io<0.9,>=0.8.15
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

{mammoth_cli-2.2.14 → mammoth_cli-2.2.15}/mammoth_cli/__init__.py

@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
 
 from __future__ import annotations
 
-__version__ = "2.2.14"
+__version__ = "2.2.15"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.14 → mammoth_cli-2.2.15}/mammoth_cli/commands/activity.py

@@ -26,6 +26,7 @@ from mammoth_cli.manifest.loader import command_by_id
 from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.session import open_service, resolved_project
 from mammoth_cli.services.command_contract import bind_command_inputs
+from mammoth_cli.services.local_time import local_time
 
 HandlerResult = tuple[Any, dict[str, Any]]
 
@@ -164,6 +165,9 @@ def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) ->
 _WORKSPACE_USERS_SYMBOL = "mammoth.api.workspace.WorkspaceAPI.list_users"
 _TIME_FORMAT = "%Y-%m-%d %H:%M:%S"
 _EPOCH = "1970-01-01 00:00:00"
+# The route's default fields carry every entry's full details (tens of KB per page);
+# a change list needs only these. ``path`` names the dataset and view by name and id.
+_LIST_FIELDS = "id,category,name_key,primary_object,result,created_at,user_id,path"
 
 
 def _close_time_window(kwargs: dict[str, Any]) -> str | None:
@@ -184,19 +188,6 @@ def _close_time_window(kwargs: dict[str, Any]) -> str | None:
     return f"start_time was not given; the window starts at {_EPOCH} UTC."
 
 
-def _local_time(stamp: Any) -> str | None:
-    """A ``created_at`` (UTC if it has no offset) as ISO in this machine's timezone."""
-    if not isinstance(stamp, str):
-        return None
-    try:
-        moment = datetime.fromisoformat(stamp)
-    except ValueError:
-        return stamp
-    if moment.tzinfo is None:
-        moment = moment.replace(tzinfo=UTC)
-    return moment.astimezone().isoformat(timespec="seconds")
-
-
 def _user_emails(service: Any) -> dict[Any, str]:
     """Workspace users by id; empty when the caller may not list them."""
     try:
@@ -206,6 +197,11 @@ def _user_emails(service: Any) -> dict[Any, str]:
     return {u["id"]: u["email"] for u in users if isinstance(u, dict) and u.get("email")}
 
 
+def _readable_path(path: Any) -> str | None:
+    """The entry's ``workspace:name:id/project:name:id/dataset:name:id/...`` chain."""
+    return path.strip('{}"') if isinstance(path, str) else None
+
+
 def _change(entry: dict[str, Any], emails: dict[Any, str]) -> dict[str, Any]:
     """One log entry as a line of a change list: when, who, what, on which object."""
     raw_details = entry.get("details")
@@ -214,13 +210,14 @@ def _change(entry: dict[str, Any], emails: dict[Any, str]) -> dict[str, Any]:
     primary: dict[str, Any] = raw_primary if isinstance(raw_primary, dict) else {}
     user_id = entry.get("user_id")
     change = {
-        "when": _local_time(entry.get("created_at")),
+        "when": local_time(entry.get("created_at")),
         "user_id": user_id,
         "user": emails.get(user_id),
         "action": entry.get("name_key"),
         "category": entry.get("category"),
         "object": {"name": primary.get("name"), "resource_id": primary.get("resource_id")},
         "result": entry.get("result"),
+        "path": _readable_path(entry.get("path")),
     }
     if details.get("task_name"):
         change["task"] = details["task_name"]
@@ -248,7 +245,7 @@ def activity_list(invocation: Invocation) -> HandlerResult:
     """
     document = _bound_document(invocation)
     _refuse_bare_resource_id(document)
-    kwargs: dict[str, Any] = {}
+    kwargs: dict[str, Any] = {"fields": _LIST_FIELDS}
     _forward_optional(document, kwargs, _LIST_OPTIONAL)
     note = _close_time_window(kwargs)
     with open_service(invocation) as (service, auth):

{mammoth_cli-2.2.14 → mammoth_cli-2.2.15}/mammoth_cli/commands/view.py

@@ -57,6 +57,7 @@ from mammoth_cli.services.conditions import CONDITION_KWARG, compile_condition
 from mammoth_cli.services.dashboard_review import UPLOAD_NOTE, upload_hints
 from mammoth_cli.services.data_quality import column_warnings, duplicate_rows_fact
 from mammoth_cli.services.listing import DATASET_LIST_FIELDS, compact_view_list
+from mammoth_cli.services.local_time import local_time
 from mammoth_cli.services.read_queries import ReadContext
 
 HandlerResult = tuple[Any, dict[str, Any]]
@@ -2604,10 +2605,30 @@ def view_version_list(invocation: Invocation) -> HandlerResult:
     _forward_optional(document, kwargs, ("fields", "sort", "limit", "offset", "name"))
     with open_service(invocation) as (service, auth):
         kwargs["dataset_id"] = _resolve_dataset_id(service, invocation, dataview_id, document)
-        data = service.call(_symbol(invocation), **kwargs)
+        data = _with_version_times(service.call(_symbol(invocation), **kwargs))
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def _with_version_times(data: Any) -> Any:
+    """Give each version a ``when`` with an explicit offset.
+
+    ``created_at`` is naive UTC and the server-made ``name`` ("30-Sep-2026 11:17 AM")
+    is that same UTC wall time, so neither can be shown to a user as local time.
+    """
+    versions = data.get("versions") if isinstance(data, dict) else None
+    if not isinstance(versions, list):
+        return data
+    stamped = [
+        {**v, "when": local_time(v.get("created_at"))} if isinstance(v, dict) else v
+        for v in versions
+    ]
+    return {
+        **data,
+        "versions": stamped,
+        "time_note": "created_at and the version name are UTC; `when` carries its offset.",
+    }
+
+
 def view_version_update(invocation: Invocation) -> HandlerResult:
     """Update one pipeline version by id. ``body`` is required."""
     project_id = require_project(invocation)

mammoth_cli-2.2.15/mammoth_cli/services/local_time.py

@@ -0,0 +1,19 @@
+"""Timestamps from the backend are naive UTC; show them with an explicit offset."""
+
+from __future__ import annotations
+
+from datetime import UTC, datetime
+from typing import Any
+
+
+def local_time(stamp: Any) -> str | None:
+    """A timestamp (UTC if it has no offset) as ISO in this machine's timezone."""
+    if not isinstance(stamp, str):
+        return None
+    try:
+        moment = datetime.fromisoformat(stamp)
+    except ValueError:
+        return stamp
+    if moment.tzinfo is None:
+        moment = moment.replace(tzinfo=UTC)
+    return moment.astimezone().isoformat(timespec="seconds")

{mammoth_cli-2.2.14 → mammoth_cli-2.2.15}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.2.14"
+version = "2.2.15"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.12,<3.15"
 dependencies = [
-    "mammoth-io (>=0.8.14,<0.9)",
+    "mammoth-io (>=0.8.15,<0.9)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.2.14 → mammoth_cli-2.2.15}/spec/manifests/sdk-methods.yaml

@@ -428,8 +428,8 @@ methods:
     ''int | None'' = None, categories: ''list[Any] | None'' = None, activities: ''list[Any] | None''
     = None, resource_id: ''str | None'' = None, result: ''str | None'' = None, start_time: ''str |
     None'' = None, end_time: ''str | None'' = None, origin: ''str | None'' = None, user_ids: ''list[Any]
-    | None'' = None, parent_id: ''int | None'' = None, search_text: ''str | None'' = None) -> ''dict[str,
-    Any]'''
+    | None'' = None, parent_id: ''int | None'' = None, search_text: ''str | None'' = None, fields: ''str | None'' = None)
+    -> ''dict[str, Any]'''
   openapi_operation_ids: []
   canonical_command: activity.list
   alias_of: null