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

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

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: licos-dev-cli
-Version: 0.4.2
+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.2
+Requires-Dist: licos-dev-sdk>=0.4.4

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

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

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

@@ -55,7 +55,7 @@ def text_input(value, path, name):
 
 @click.command("docx-structure")
 @click.option("--file", "source", required=True, type=click.Path(exists=True, dir_okay=False))
-@click.option("--scope", type=click.Choice(["blocks", "paragraphs"]), default="blocks", show_default=True)
+@click.option("--scope", type=click.Choice(["blocks", "paragraphs", "tables"]), default="blocks", 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)
 @click.option("--max-chars", type=click.IntRange(1, 8000), default=200, show_default=True)
@@ -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
@@ -141,7 +156,8 @@ def docx_table_set(text, text_file, **arguments):
 @click.command("docx-table-insert-rows")
 @edit_options
 @click.option("--table", required=True, type=click.IntRange(min=1))
-@click.option("--before", required=True, type=click.IntRange(min=1), help="One-based insertion position; row_count+1 appends.")
+@click.option("--before", type=click.IntRange(min=1), help="Insert before this one-based row. Choose --before or --append.")
+@click.option("--append", is_flag=True, help="Append after the last row; no row count calculation needed.")
 @click.option("--template-row", required=True, type=click.IntRange(min=1), help="Existing styled row; must not intersect a vertical merge.")
 @click.option("--input", "input_path", required=True, type=click.Path(exists=True, dir_okay=False), help="Two-dimensional JSON array of scalar values. Fill a merged cell once; count is inferred.")
 @sdk_errors
@@ -153,17 +169,35 @@ 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("--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("--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: 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.")
+@click.option("--mode", type=click.Choice(["equals", "contains", "absent"]), help="Single-target comparison; defaults to equals.")
 @sdk_errors
-def docx_verify(source, input_path):
-    """Verify exact positions. Without assertions only structure is checked, not content.
+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 fails. Does not certify rendered page layout.
+    Exits 2 if an assertion or original comparison fails. Does not certify rendered page layout.
     """
     from licos_dev_sdk import verify_docx
-    report = verify_docx(source, expectations=json.loads(Path(input_path).read_text(encoding="utf-8")) if input_path else None)
+    position = target(paragraph, block, table, row, column)
+    single = bool(position) or text is not None or text_file is not None or mode is not None
+    if input_path is not None and single:
+        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:
+        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)
@@ -171,4 +205,4 @@ def docx_verify(source, input_path):
 
 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.2 → licos_dev_cli-0.4.4}/src/licos_dev_cli/main.py

@@ -14,6 +14,7 @@ from .common import _read_input, _read_json, _json_option, _echo_json, _path_to_
 # ── CLI Group ────────────────────────────────────────────────────────────────
 
 @click.group()
+@click.version_option(package_name="licos-dev-cli")
 def cli():
     """LICOS Dev - file generation and model CLI for AI agents."""
     pass

{licos_dev_cli-0.4.2 → 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,9 +91,52 @@ 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
     help_text = runner.invoke(cli, ["docx-table-insert-rows", "--help"]).output
     assert "--revision" in help_text and "--template-row" in help_text and "--count" not in help_text
+
+
+def test_append_and_verify_with_original_and_text_file(source, tmp_path):
+    rows = tmp_path / "rows.json"
+    rows.write_text('[["pump",2]]', encoding="utf-8")
+    output = tmp_path / "rows.docx"
+    read = invoke("docx-structure", "--file", source, "--scope", "tables")
+    assert read["items"][0]["row_count"] == 1
+    invoke("docx-table-insert-rows", "--source", source, "--output", output, "--revision", read["revision"],
+           "--table", 1, "--append", "--template-row", 1, "--input", rows)
+    assert invoke("docx-verify", "--file", output, "--original", source, "--table", 1, "--row", 2, "--column", 1, "--text", "pump")["verified"]
+    replacement = tmp_path / "text.txt"
+    text = "  中文🙂\t空格\n" * 100 + "  "
+    replacement.write_text(text, encoding="utf-8")
+    invoke("docx-replace", "--source", output, "--output", output, "--overwrite",
+           "--revision", invoke("docx-structure", "--file", output)["revision"],
+           "--block", 1, "--search", "账号：123", "--replace-file", replacement)
+    verified = invoke("docx-verify", "--file", output, "--original", source, "--block", 1, "--text-file", replacement)
+    assert verified["content_verified"] and verified["preservation_verified"]
+
+
+@pytest.mark.parametrize("arguments", [
+    ["--block", "1"], ["--text", "x"], ["--mode", "contains"],
+    ["--block", "1", "--text", "x", "--input", "checks.json"],
+    ["--block", "1", "--text", "x", "--text-file", "text.txt"],
+])
+def test_invalid_verification_options_are_reported(source, tmp_path, monkeypatch, arguments):
+    monkeypatch.chdir(tmp_path)
+    (tmp_path / "checks.json").write_text("[]", encoding="utf-8")
+    (tmp_path / "text.txt").write_text("x", encoding="utf-8")
+    result = CliRunner().invoke(cli, ["docx-verify", "--file", str(source), *arguments])
+    assert result.exit_code != 0
+    assert "Error:" in result.output
+
+
+def test_original_comparison_failure_exits_two(source, tmp_path):
+    changed = tmp_path / "changed.docx"
+    doc = Document(source)
+    doc.sections[0].footer.paragraphs[0].text = "changed footer"
+    doc.save(changed)
+    failure = CliRunner().invoke(cli, ["docx-verify", "--file", str(changed), "--original", str(source)])
+    assert failure.exit_code == 2
+    assert not json.loads(failure.output)["preservation_verified"]