licos-dev-cli 0.4.3__tar.gz → 0.4.4__tar.gz

{licos_dev_cli-0.4.3 → licos_dev_cli-0.4.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: licos-dev-cli
-Version: 0.4.3
+Version: 0.4.4
 Summary: LICOS Dev CLI - generate files and call model capabilities
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: licos-dev-sdk>=0.4.3
+Requires-Dist: licos-dev-sdk>=0.4.4

{licos_dev_cli-0.4.3 → licos_dev_cli-0.4.4}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-cli"
-version = "0.4.3"
+version = "0.4.4"
 description = "LICOS Dev CLI - generate files and call model capabilities"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-dev-sdk>=0.4.3",
+    "licos-dev-sdk>=0.4.4",
     "click>=8.1",
 ]
 

{licos_dev_cli-0.4.3 → licos_dev_cli-0.4.4}/src/licos_dev_cli/docx_commands.py

@@ -70,6 +70,21 @@ def docx_structure(**arguments):
     result(read_docx_structure(**arguments))
 
 
+@click.command("docx-inspect")
+@click.option("--file", "source", required=True, type=click.Path(exists=True, dir_okay=False))
+@click.option("--scope", type=click.Choice(["all", "fields", "images", "tables"]), default="all", show_default=True)
+@click.option("--offset", type=click.IntRange(min=1), default=1, show_default=True)
+@click.option("--limit", type=click.IntRange(1, 200), default=20, show_default=True)
+@sdk_errors
+def docx_inspect(**arguments):
+    """Inspect native TOC fields, embedded/linked images and tables, including headers/footers.
+
+    Reports field update settings, not rendered pages. Continue each scope with next_offset.
+    """
+    from licos_dev_sdk import inspect_docx
+    result(inspect_docx(**arguments))
+
+
 @click.command("docx-target")
 @click.option("--file", "source", required=True, type=click.Path(exists=True, dir_okay=False))
 @target_options
@@ -155,7 +170,7 @@ def docx_table_insert_rows(input_path, **arguments):
 @click.command("docx-verify")
 @click.option("--file", "source", required=True, type=click.Path(exists=True, dir_okay=False))
 @click.option("--original", type=click.Path(exists=True, dir_okay=False), help="Compare non-body package parts (headers, footers, styles, images) and section settings with the original.")
-@click.option("--input", "input_path", type=click.Path(exists=True, dir_okay=False), help="JSON array of target/text assertions and optional mode (equals, contains, absent).")
+@click.option("--input", "input_path", type=click.Path(exists=True, dir_okay=False), help="JSON array: target, exactly one of text/text_file, optional mode. Relative text_file paths use the JSON file's directory.")
 @target_options
 @click.option("--text", default=None, help="Expected text at one target; use this or --text-file instead of --input.")
 @click.option("--text-file", type=click.Path(exists=True, dir_okay=False), help="UTF-8 expected text; preserves whitespace and line breaks.")
@@ -164,7 +179,7 @@ def docx_table_insert_rows(input_path, **arguments):
 def docx_verify(source, original, input_path, paragraph, block, table, row, column, text, text_file, mode):
     """Verify exact positions and optional original parts. No assertions means no content verification.
 
-    Example: [{"target":{"table":1,"row":1,"column":1},"text":"Supplier: A"}]
+    Example: [{"target":{"block":3},"text_file":"expected.txt","mode":"equals"}]
 
     Exits 2 if an assertion or original comparison fails. Does not certify rendered page layout.
     """
@@ -175,8 +190,14 @@ def docx_verify(source, original, input_path, paragraph, block, table, row, colu
         raise click.UsageError("use --input or a single target with --text/--text-file, not both")
     expectations = json.loads(Path(input_path).read_text(encoding="utf-8")) if input_path else None
     if single:
-        expectations = [{"target": position, "text": text_input(text, text_file, "text"), "mode": mode or "equals"}]
-    report = verify_docx(source, original=original, expectations=expectations)
+        expectation = {"target": position, "mode": mode or "equals"}
+        if text is not None:
+            expectation["text"] = text
+        if text_file is not None:
+            expectation["text_file"] = text_file
+        expectations = [expectation]
+    report = verify_docx(source, original=original, expectations=expectations,
+                         base_dir=Path(input_path).resolve().parent if input_path else Path.cwd())
     result(report)
     if not report["verified"]:
         raise click.exceptions.Exit(2)
@@ -184,4 +205,4 @@ def docx_verify(source, original, input_path, paragraph, block, table, row, colu
 
 DOCX_COMMANDS = [docx, docx_template, docx_edit, docx_read, docx_structure, docx_target,
                  docx_replace, docx_delete_blocks, docx_edit_structure, docx_table_set,
-                 docx_table_insert_rows, docx_verify]
+                 docx_table_insert_rows, docx_verify, docx_inspect]

{licos_dev_cli-0.4.3 → licos_dev_cli-0.4.4}/tests/test_docx_commands.py

@@ -24,6 +24,22 @@ def invoke(*arguments):
     return json.loads(result.output)
 
 
+def test_inspect_and_file_assertions_use_cli_contract(source, tmp_path, monkeypatch):
+    report = invoke("docx-inspect", "--file", source)
+    assert report["table_count"] == 1 and report["image_count"] == 0
+    folder = tmp_path / "checks"
+    folder.mkdir()
+    expected = folder / "expected.txt"
+    expected.write_text("账号：123", encoding="utf-8")
+    checks = folder / "assertions.json"
+    checks.write_text(json.dumps([{"target": {"block": 1}, "text_file": "expected.txt"}]), encoding="utf-8")
+    monkeypatch.chdir(tmp_path)
+    assert invoke("docx-verify", "--file", source, "--input", checks)["verified"]
+    assert invoke("docx-verify", "--file", source, "--block", 1, "--text-file", "checks/expected.txt")["verified"]
+    invalid = CliRunner().invoke(cli, ["docx-verify", "--file", str(source), "--block", "1", "--text", "x", "--text-file", str(expected)])
+    assert invalid.exit_code != 0 and "exactly one" in invalid.output
+
+
 def test_focused_commands_complete_read_replace_delete_and_verify(source, tmp_path):
     read = invoke("docx-structure", "--file", source)
     output = tmp_path / "filled.docx"
@@ -75,7 +91,7 @@ def test_bad_revision_reports_original_error_and_leaves_output_absent(source, tm
 def test_command_help_is_focused_and_preserves_constraints():
     runner = CliRunner()
     for name in ("docx-structure", "docx-target", "docx-replace", "docx-delete-blocks", "docx-edit-structure",
-                 "docx-table-set", "docx-table-insert-rows", "docx-verify"):
+                 "docx-table-set", "docx-table-insert-rows", "docx-verify", "docx-inspect"):
         help_text = runner.invoke(cli, [name, "--help"])
         assert help_text.exit_code == 0
         assert len(help_text.output.encode("utf-8")) < 5000