mammoth-cli 2.2.57__tar.gz → 2.2.58__tar.gz

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.57
+Version: 2.2.58
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk

{mammoth_cli-2.2.57 → mammoth_cli-2.2.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.2.57"
+__version__ = "2.2.58"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/mammoth_cli/app.py

@@ -762,6 +762,18 @@ def _shared_option_params() -> list[inspect.Parameter]:
                 ),
             ],
         ),
+        opt(
+            "standing",
+            False,
+            Annotated[
+                bool,
+                typer.Option(
+                    "--standing",
+                    help="Stage a step that changes no row today, as a rule for future data.",
+                    rich_help_panel="Safety",
+                ),
+            ],
+        ),
         opt(
             "input_file",
             None,

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/transforms.md

@@ -90,7 +90,8 @@ states `duplicates` (`exact_duplicate_rows` over `rows_checked` of `row_count`;
 on a later page it names the table-wide check). When it is 0, report "none,
 no change needed" and add no step. Only then inspect its optional
 `ignore_columns` field and submit; `--dry-run` reports `predicted_impact` or
-fails `no_op`. For a join, verify both schemas and expected multiplicity:
+fails `no_op`. A rule that removes nothing today but the user wants kept for future data
+("keep only rows where region is not empty") takes `--standing`; ask for it only on that intent. For a join, verify both schemas and expected multiplicity:
 
 ```bash
 mammoth schema get view.transform.discard-duplicates

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/mammoth_cli/commands/view_ops.py

@@ -78,8 +78,11 @@ from mammoth_cli.services.view_variants import (
     variants_result,
 )
 from mammoth_cli.services.write_impact import (
+    STANDING_HINT,
+    STANDING_NOTE,
     ImpactRead,
     Measure,
+    Measured,
     empties_view_error,
     measure_bulk_replace,
     measure_duplicates,
@@ -450,10 +453,12 @@ def _dispatch_view(
                 service, int(dataset_id), view_id, invocation.project, write_result=data
             )
             data["row_check"] = {"rows_before": rows_before, "rows_after": rows_after}
-            if reduces_rows:
+            if reduces_rows and not invocation.standing_noop:
                 data["row_check"]["expected_row_decrease"] = True
             if pipeline_error is not None:
                 data["pipeline_error"] = pipeline_error
+    if invocation.standing_noop and isinstance(data, dict):
+        data["standing_rule"] = {"removed_now": 0, "note": STANDING_NOTE}
     return data, _meta(invocation, auth.workspace_id)
 
 
@@ -1504,13 +1509,23 @@ def view_transform_discard_duplicates(invocation: Invocation) -> HandlerResult:
     )
 
 
+def _stage_standing(invocation: Invocation, measured: Measured) -> None:
+    """Let a step that changes no row today go ahead, and say so in the envelope."""
+    if invocation.dry_run:
+        report = {**measured.report, "standing": True, "note": STANDING_NOTE}
+        object.__setattr__(invocation, "predicted_impact", report)
+    else:
+        object.__setattr__(invocation, "standing_noop", True)
+
+
 def _impact_check(
     invocation: Invocation, view_id: int, measure: Measure
 ) -> Callable[[Any, int, dict[str, Any]], Any]:
     """A ``prepare`` hook: measure what the step would change, by a read.
 
     A count of zero is a no-op: ``--dry-run`` fails with ``no_op`` and a real run
-    adds no task (``status: no_change``, like a same-type convert). Otherwise a
+    adds no task (``status: no_change``, like a same-type convert) unless
+    ``--standing`` stages the step as a rule for future rows. Otherwise a
     dry run reports the count as ``predicted_impact``. A keep filter no row matches
     fails a dry run with ``empties_view`` unless ``--allow-empty`` is set. A count that cannot run
     is reported as unchecked in a dry run, never as zero, and never blocks a write.
@@ -1541,9 +1556,16 @@ def _impact_check(
         if measured.empties_message and invocation.dry_run and not invocation.allow_empty:
             raise empties_view_error(measured.empties_message, view_id=view_id)
         if measured.changes == 0:
+            if invocation.standing:
+                _stage_standing(invocation, measured)
+                return None
             if invocation.dry_run:
                 raise no_op_error(measured.no_op_message, view_id=view_id)
-            return {"status": "no_change", "note": f"{measured.no_op_message} No task was added."}
+            return {
+                "status": "no_change",
+                "note": f"{measured.no_op_message} No task was added.",
+                "hint": STANDING_HINT,
+            }
         if invocation.dry_run:
             object.__setattr__(invocation, "predicted_impact", measured.report)
         return None

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/mammoth_cli/runtime/invocation.py

@@ -63,6 +63,7 @@ class Invocation:
     confirm: str | None = None
     dry_run: bool = False
     allow_empty: bool = False
+    standing: bool = False
     input_file: str | None = None
     input_format: str | None = None
     positionals: dict[str, Any] = field(default_factory=dict)
@@ -81,6 +82,7 @@ class Invocation:
     #: What a dry-run transform predicted it would change; set by its handler,
     #: added to the dry-run report.
     predicted_impact: dict[str, Any] | None = field(default=None, repr=False, compare=False)
+    standing_noop: bool = field(default=False, repr=False, compare=False)
     # Set on the read a write's ``state`` block issues: that read confirms the
     # write, so a command's extra evaluation (a board's numbers) is skipped.
     readback: bool = field(default=False, repr=False, compare=False)

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/mammoth_cli/services/write_impact.py

@@ -118,13 +118,20 @@ def _rows(result: Mapping[str, Any]) -> list[dict[str, Any]]:
     return [row for row in result.get("data") or [] if isinstance(row, dict)]
 
 
+#: Said wherever a step is refused or skipped for changing no row today.
+STANDING_HINT = "To keep it as a standing rule for future data, add --standing to stage it anyway."
+#: What a staged zero-change step tells the caller.
+STANDING_NOTE = "Staged as a standing rule: it changes no row today and will apply to future rows."
+
+
 def no_op_error(message: str, *, view_id: int) -> CliError:
     """The dry-run failure for a step that would change nothing."""
     return CliError(
         code=CODE_NO_OP,
         message=message,
         exit_status=EXIT_USAGE,
-        hint="Nothing was changed and nothing needs to be; tell the user there is no work.",
+        hint="Nothing was changed and nothing needs to be; tell the user there is no work. "
+        + STANDING_HINT,
         details={"view_id": view_id},
     )
 

{mammoth_cli-2.2.57 → mammoth_cli-2.2.58}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mammoth-cli"
-version = "2.2.57"
+version = "2.2.58"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"