mammoth-cli 2.0.57__tar.gz → 2.0.58__tar.gz

{mammoth_cli-2.0.57 → mammoth_cli-2.0.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.57
+Version: 2.0.58
 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.8,>=0.7.27
+Requires-Dist: mammoth-io<0.8,>=0.7.28
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.13
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.0.57 → mammoth_cli-2.0.58}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.57
+version: 2.0.58
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.0.57 → mammoth_cli-2.0.58}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/exports.md

@@ -8,7 +8,10 @@ mammoth view export list VIEW_ID DATASET_ID --project PROJECT_ID
 ```
 
 `view export csv` takes one positional (the view); `dataset_id` and
-`output_path` go in `--input`. It is a download, not a pipeline step.
+`output_path` go in `--input`. It is a download, not a pipeline step. When
+embedded (see `mammoth_cli.embed.invoke`), it writes no local file and returns
+`download_url` instead, for the host to hand to its user; `output_path` is
+refused in that case.
 
 If the export or its source dataset/view is requested as a deliverable, mark
 both as retained before starting. Wait/reconcile returned jobs. Verify local

{mammoth_cli-2.0.57 → mammoth_cli-2.0.58}/mammoth_cli/commands/view.py

@@ -39,7 +39,7 @@ from mammoth_cli.errors.envelope import (
     CliError,
 )
 from mammoth_cli.manifest.loader import command_by_id
-from mammoth_cli.runtime import parents
+from mammoth_cli.runtime import embedded, parents
 from mammoth_cli.runtime.confirm import (
     POLICY_CONFIRM_TARGET,
     POLICY_PROMPT_OR_YES,
@@ -1965,9 +1965,15 @@ def view_export_csv(invocation: Invocation) -> HandlerResult:
     With no --input the file is written to the current directory under an
     auto-generated name; the dataset is resolved from the view. Override with
     ``--input '{"output_path": "path.csv"}'``.
+
+    Embedded (see ``mammoth_cli.runtime.embedded``), no file is written: the
+    signed download URL is returned instead so the host can hand it to its
+    user. ``output_path`` is refused in that case.
     """
     dataview_id = _require_int_positional_at(invocation, 0, "dataview id")
     document = invocation.load_input() or {}
+    if embedded.active():
+        return _view_export_csv_embedded(invocation, dataview_id, document)
     kwargs: dict[str, Any] = {"dataview_id": dataview_id}
     _forward_optional(document, kwargs, ("output_path", "timeout", "dataset_id"))
     with open_service(invocation) as (service, auth):
@@ -1977,6 +1983,24 @@ def view_export_csv(invocation: Invocation) -> HandlerResult:
     return {"output_path": str(data)}, _meta(invocation, auth.workspace_id, None)
 
 
+def _view_export_csv_embedded(
+    invocation: Invocation, dataview_id: int, document: dict[str, Any]
+) -> HandlerResult:
+    """``view.export.csv`` for an embedded call: never writes a local file."""
+    if "output_path" in document:
+        raise CliError(
+            code=CODE_UNSUPPORTED_CONTRACT,
+            message="output_path is not supported here; files are not written in embedded mode.",
+            exit_status=EXIT_USAGE,
+            hint="Drop output_path -- an embedded call returns a download_url instead.",
+        )
+    kwargs: dict[str, Any] = {"dataview_id": dataview_id}
+    _forward_optional(document, kwargs, ("timeout", "dataset_id"))
+    with open_service(invocation) as (service, auth):
+        data = service.call("mammoth.api.exports.ExportsAPI.to_csv_url", **kwargs)
+    return {"download_url": data["url"]}, _meta(invocation, auth.workspace_id, None)
+
+
 def view_export_delete(invocation: Invocation) -> HandlerResult:
     """Delete one export by id. Always requires ``--yes``."""
     project_id = require_project(invocation)

{mammoth_cli-2.0.57 → mammoth_cli-2.0.58}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.57"
+version = "2.0.58"
 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.7.27,<0.8)",
+    "mammoth-io (>=0.7.28,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.0.57 → mammoth_cli-2.0.58}/spec/manifests/sdk-methods.yaml

@@ -3973,6 +3973,19 @@ methods:
   pagination_policy: none
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth.api.exports.ExportsAPI.to_csv_url
+  implementation_origin: mammoth.api.exports.ExportsAPI.to_csv_url
+  signature: 'to_csv_url(self, dataview_id: ''int'', timeout: ''int'' = 300, dataset_id: ''int | None'' = None) -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: null
+  alias_of: null
+  no_command_reason: SDK-only seam view.export.csv dispatches to instead of to_csv for an embedded
+    call (mammoth_cli.runtime.embedded); returns the signed URL without downloading a local file.
+  mutation_class: benign_mutation
+  wait_policy: always_wait
+  pagination_policy: none
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth.api.exports.ExportsAPI.to_dataset
   implementation_origin: mammoth.api.exports.ExportsAPI.to_dataset
   signature: 'to_dataset(self, dataview_id: ''int'', dataset_name: ''str'', column_mapping: ''dict[str, Any] | None'' = None, sequence: ''int | None'' = None, trigger_id: ''int | None'' = None, end_of_pipeline: ''bool'' = True, trigger_type: ''TriggerType'' = <TriggerType.PIPELINE: ''pipeline''>, condition: ''dict[str, Any] | None'' = None, run_immediately: ''bool'' = True, validate_only: ''bool'' = False, additional_properties: ''dict[str, Any] | None'' = None) -> ''PipelineExportsModificationResp | JobResponse'''