mammoth-cli 2.2.37__tar.gz → 2.2.39__tar.gz

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.37
+Version: 2.2.39
 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.37 → mammoth_cli-2.2.39}/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.37"
+__version__ = "2.2.39"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/mammoth_cli/commands/file.py

@@ -22,6 +22,7 @@ from mammoth_cli.errors.envelope import (
     CODE_MISSING_ARGUMENT,
     CODE_MISSING_FIELD,
     CODE_SDK_SYMBOL_UNRESOLVED,
+    CODE_UPLOAD_REFUSED,
     EXIT_USAGE,
     CliError,
 )
@@ -330,7 +331,7 @@ def _upload_refused_error(errors: dict[str, Any], refused: list[str]) -> CliErro
     """The error for an upload whose files were all refused (no dataset made)."""
     workbook = any(name.lower().endswith(_WORKBOOK_SUFFIXES) for name in refused)
     return CliError(
-        code=CODE_INVALID_ARGUMENT,
+        code=CODE_UPLOAD_REFUSED,
         message=_upload_refused_message(errors, refused) + " No dataset was created.",
         exit_status=EXIT_USAGE,
         hint=_WORKBOOK_HINT if workbook else "Upload a supported file type (CSV, Excel, JSON).",

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/mammoth_cli/commands/project.py

@@ -281,6 +281,9 @@ def project_copy(invocation: Invocation) -> HandlerResult:
     ``PROJECT_ID NAME`` are positional; ``dataset_ids``, ``include_dashboards`` and
     ``exclude_data`` come from ``--input``. The result is the job's:
     ``project_id``, ``dataset_map``, ``view_map``, ``skipped`` and ``dashboards``.
+
+    A taken NAME is not an error: the server names the copy with the next free suffix
+    ("NAME 2", "NAME 3", ...), so there is no need to check the name first.
     """
     source_id = _int_positional(invocation, "project id")
     name = invocation.extra_args[1] if len(invocation.extra_args) > 1 else None

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/mammoth_cli/errors/envelope.py

@@ -32,6 +32,7 @@ CODE_MISSING_ARGUMENT = "missing_argument"
 CODE_MISSING_FIELD = "missing_field"
 CODE_SDK_SYMBOL_UNRESOLVED = "sdk_symbol_unresolved"
 CODE_INVALID_ARGUMENT = "invalid_argument"
+CODE_UPLOAD_REFUSED = "upload_refused"
 CODE_INVALID_ARGUMENTS = "invalid_arguments"
 CODE_INVALID_CONFIG_VALUE = "invalid_config_value"
 CODE_INVALID_INPUT_DOCUMENT = "invalid_input_document"
@@ -180,6 +181,7 @@ ERROR_SUMMARIES: dict[str, str] = {
     "unsupported_contract": _S_UNAVAILABLE,
     "unsupported_profile_base_url": _S_SETUP,
     "unsupported_shell": _S_UNAVAILABLE,
+    "upload_refused": "Mammoth doesn't accept this kind of file, so nothing was uploaded.",
     "upgrade_failed": "The update didn't complete.",
     "usage_error": _S_BAD_REQUEST,
     "view_in_draft": "This view is still a draft and can't be used yet.",

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/mammoth_cli/services/positionals.py

@@ -445,7 +445,15 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
         PositionalSpec(
             name="project_id", type=int, required=True, help="ID of the project to copy."
         ),
-        PositionalSpec(name="name", type=str, required=True, help="Name of the new project."),
+        PositionalSpec(
+            name="name",
+            type=str,
+            required=True,
+            help=(
+                "Name of the new project. If it is already taken, the copy is named with the next "
+                'free suffix ("NAME 2", "NAME 3", ...); no need to check the name first.'
+            ),
+        ),
     ),
     # project ensure: exact name to find or create, positional or ``name`` field.
     "project.ensure": (

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/pyproject.toml

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

{mammoth_cli-2.2.37 → mammoth_cli-2.2.39}/spec/manifests/commands/project.yaml

@@ -1041,7 +1041,7 @@ commands:
     required: true
     metavar: NAME
     falls_back_to_field: null
-    help: Name of the new project.
+    help: Name of the new project. If it is already taken, the copy is named with the next free suffix ("NAME 2", "NAME 3", ...); no need to check the name first.
   options: []
   sdk_symbol: mammoth.api.projects.ProjectsAPI.copy
   sdk_conversion: Call mammoth.api.projects.ProjectsAPI.copy with validated request fields.