mammoth-cli 2.2.82__tar.gz → 2.2.84__tar.gz

{mammoth_cli-2.2.82 → mammoth_cli-2.2.84}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.82
+Version: 2.2.84
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -18,7 +18,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.42
+Requires-Dist: mammoth-io<0.9,>=0.8.43
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

{mammoth_cli-2.2.82 → mammoth_cli-2.2.84}/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.82"
+__version__ = "2.2.84"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.82 → mammoth_cli-2.2.84}/mammoth_cli/bundled_skill/mammoth-cli/references/machine-output.md

@@ -32,8 +32,11 @@ result schema; dashboard and transform result fields remain schema-driven.
 {"schema_version":1,"data":{"output_path":"dataview_12_12_export.csv"},"meta":{"command":"view export csv","profile":"expanded-live","workspace_id":4}}
 ```
 
-For pagination, preserve the returned `meta.pagination`/`data.next` cursor and
-request the next page only with fields accepted by that command's schema. For
+For pagination, preserve the returned `meta.pagination` and, on `view data get`,
+`view export list` and `view pipeline items`, the `paging` block: `offset` is
+0-based (`0` is the first page), and `next_command` / `previous_command` are ready
+to run (null at the ends). Request pages only with fields accepted by that
+command's schema. For
 auth, `auth status` reports profile/endpoint/workspace state but never a
 secret. A rejected mutation remains the error envelope above; use its recovery
 command or a read-back, rather than treating a model/result type as success.
@@ -48,14 +51,16 @@ never emit color or progress.
 | code | meaning |
 |---|---|
 | 0 | success |
-| 1 | API, job, or local artifact error |
+| 1 | API, job, or local artifact error; also a write that did not verify (`status: failed`) |
 | 2 | usage / input / confirmation failure |
+| 3 | partial: a write whose read-back shows only part of it (`status: partial`) |
 | 4 | authentication failure |
 | 5 | not found |
-| 6 | conflict |
+| 6 | conflict, or `file_exists` (pass `--overwrite` to replace a local file) |
 | 7 | retryable read/transport or timed-out known job; inspect the envelope |
 | 130 | interrupted |
 
 Branch on the exit code, stable `error.code`, and `details.operation_state`; never
-parse the message. `outcome_unknown` means a mutation may have committed and
+parse the message. A write still running reports `status: pending` with
+`verify.next_command` and exits 0: it was accepted, so wait on it and do not replay it. `outcome_unknown` means a mutation may have committed and
 must be reconciled before replay.

{mammoth_cli-2.2.82 → mammoth_cli-2.2.84}/mammoth_cli/services/delete_check.py

@@ -44,6 +44,18 @@ def find_dependents(response: Any, resource_id: int) -> Any:
     return None
 
 
+#: Backend codes a get answers for an id that no longer exists, besides a 404: the
+#: dataset get route answers ``400 4DSET001`` for a deleted dataset.
+_GONE_BACKEND_CODES = frozenset({"4DSET001"})
+
+
+def _is_gone(error: CliError) -> bool:
+    return (
+        error.code == CODE_RESOURCE_NOT_FOUND
+        or (error.details or {}).get("backend_code") in _GONE_BACKEND_CODES
+    )
+
+
 def _still_there(record: Any, resource_id: int) -> bool:
     return isinstance(record, dict) and str(record.get("id")) == str(resource_id)
 
@@ -83,7 +95,7 @@ def ensure_deleted(
         try:
             record = service.call(read_symbol, **read_kwargs)
         except CliError as error:
-            if error.code == CODE_RESOURCE_NOT_FOUND:
+            if _is_gone(error):
                 return
             raise
         if not _still_there(record, resource_id):

{mammoth_cli-2.2.82 → mammoth_cli-2.2.84}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.2.82"
+version = "2.2.84"
 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.42,<0.9)",
+    "mammoth-io (>=0.8.43,<0.9)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",