maxc-cli 0.4.0__tar.gz → 0.4.2__tar.gz

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxc-cli
-Version: 0.4.0
+Version: 0.4.2
 Summary: Agent-native MaxCompute CLI for external coding agents
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/setup.py

@@ -9,7 +9,7 @@ README = ROOT / "README.md"
 
 setup(
     name="maxc-cli",
-    version="0.4.0",
+    version="0.4.2",
     description="Agent-native MaxCompute CLI for external coding agents",
     long_description=README.read_text(encoding="utf-8"),
     long_description_content_type="text/markdown",

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/src/maxc_cli/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/src/maxc_cli/app.py

@@ -607,6 +607,7 @@ class MaxCApp:
         cost_check: 'float | None' = None,
         idempotency_key: 'str | None' = None,
         force: 'bool' = False,
+        dry_run: 'bool' = False,
     ) -> 'Envelope':
         return self.query(
             command="job.submit",
@@ -617,6 +618,7 @@ class MaxCApp:
             cost_check=cost_check,
             idempotency_key=idempotency_key,
             force=force,
+            dry_run=dry_run,
         )
 
     def job_status(self, job_id: 'str') -> 'Envelope':
@@ -2465,6 +2467,7 @@ class MaxCApp:
         block_size: 'int' = 10000,
         project: 'str | None' = None,
         schema: 'str | None' = None,
+        dry_run: 'bool' = False,
     ) -> 'Envelope':
         target_project = project or self.config.default_project
         result = self.backend.upload_table(
@@ -2473,6 +2476,7 @@ class MaxCApp:
             delimiter=delimiter, has_header=has_header,
             null_marker=null_marker, block_size=block_size,
             project=project, schema=schema,
+            dry_run=dry_run,
         )
         metadata = {
             "project": target_project,
@@ -2480,16 +2484,21 @@ class MaxCApp:
             "delimiter": delimiter,
             "block_size": block_size,
         }
+        if dry_run:
+            actions = [action("data.upload", data=result, metadata=metadata)]
+            insights = ["Dry-run validated table schema and CSV file. Re-run without --dry-run to upload."]
+        else:
+            actions = [action("data.sample", data=result, metadata=metadata)]
+            insights = []
         envelope = Envelope(
             command="data.upload",
             status="success",
             data=result,
             metadata=metadata,
             agent_hints=AgentHints(
-                actions=[
-                    action("data.sample", data=result, metadata=metadata),
-                ],
+                actions=actions,
                 warnings=result.get("warnings", []),
+                insights=insights,
             ),
         )
         self.log("data.upload", envelope.status, envelope.metadata)

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/src/maxc_cli/backend/data.py

@@ -228,6 +228,7 @@ class DataMixin:
         block_size: 'int' = 10000,
         project: 'str | None' = None,
         schema: 'str | None' = None,
+        dry_run: 'bool' = False,
     ) -> 'dict[str, Any]':
         """Upload a CSV/TSV file into an existing table or partition via Tunnel.
 
@@ -295,6 +296,36 @@ class DataMixin:
             )
 
         bytes_read = os.path.getsize(file_path)
+
+        if dry_run:
+            warnings: list[str] = []
+            rows_found = 0
+            with open(file_path, encoding="utf-8", newline="") as fh:
+                reader = csv.reader(fh, delimiter=delimiter)
+                if has_header:
+                    try:
+                        header = next(reader)
+                    except StopIteration:
+                        header = []
+                    column_mapping = _resolve_header_mapping(header, data_columns, warnings)
+                else:
+                    column_mapping = [c.name for c in data_columns]
+                for _ in reader:
+                    rows_found += 1
+            warnings.append("Dry-run: file and table schema validated, no data was uploaded.")
+            return {
+                "table": definition.name,
+                "applied_partition": partition,
+                "rows_written": 0,
+                "rows_found": rows_found,
+                "bytes_read": bytes_read,
+                "column_mapping": column_mapping,
+                "blocks": 0,
+                "overwrite": overwrite,
+                "dry_run": True,
+                "warnings": warnings,
+            }
+
         block_ids: list[int] = []
         rows_written = 0
         warnings: list[str] = []

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/src/maxc_cli/cli.py

@@ -250,6 +250,7 @@ def build_parser() -> argparse.ArgumentParser:
     job_submit.add_argument("--max-rows", type=positive_int, default=100, help="Maximum rows to return (default: 100)")
     job_submit.add_argument("--cost-check", type=float, help="Abort if estimated cost exceeds threshold (CU)")
     job_submit.add_argument("--idempotency-key", help="Deduplication key for retries")
+    job_submit.add_argument("--dry-run", action="store_true", help="Estimate cost without submitting")
     job_submit.add_argument("--force", action="store_true", default=False, help=argparse.SUPPRESS)
     job_submit.set_defaults(handler=_handle_job_submit)
 
@@ -453,6 +454,7 @@ def build_parser() -> argparse.ArgumentParser:
     data_upload.add_argument("--schema", help="Schema name (overrides session default)")
     data_upload.add_argument("--block-size", type=positive_int, default=10000,
                              help="Rows per Tunnel block (default: 10000)")
+    data_upload.add_argument("--dry-run", action="store_true", help="Validate table and CSV without uploading")
     data_upload.add_argument("--project", help="Target MaxCompute project")
     data_upload.add_argument("--json", action="store_true", help="Output as JSON envelope")
     data_upload.set_defaults(handler=_handle_data_upload)
@@ -775,8 +777,20 @@ def _configure_stdio_encoding() -> None:
             pass
 
 
+def _configure_user_agent() -> None:
+    from . import __version__
+    try:
+        from odps import options
+    except ImportError:
+        return
+    options.user_agent_pattern = (
+        f"maxc-cli/{__version__} $pyodps_version $python_version $os_version"
+    )
+
+
 def main(argv: Sequence[str] | None = None) -> int:
     _configure_stdio_encoding()
+    _configure_user_agent()
     return run(argv=argv)
 
 
@@ -1088,6 +1102,7 @@ def _handle_job_submit(app: MaxCApp, args: argparse.Namespace, stdout: TextIO) -
         cost_check=args.cost_check,
         idempotency_key=args.idempotency_key,
         force=args.force,
+        dry_run=args.dry_run,
     )
     _emit_envelope(envelope, args=args, stdout=stdout, default_format="json")
 
@@ -1360,6 +1375,7 @@ def _handle_data_upload(app: MaxCApp, args: argparse.Namespace, stdout: TextIO)
         block_size=args.block_size,
         project=args.project,
         schema=getattr(args, "schema", None),
+        dry_run=args.dry_run,
     )
     _emit_envelope(envelope, args=args, stdout=stdout, default_format="json")
 

{maxc_cli-0.4.0 → maxc_cli-0.4.2}/src/maxc_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maxc-cli
-Version: 0.4.0
+Version: 0.4.2
 Summary: Agent-native MaxCompute CLI for external coding agents
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9