licos-dev-cli 0.4.2__py3-none-any.whl → 0.4.4__py3-none-any.whl

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/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.dist-info → licos_dev_cli-0.4.4.dist-info}/METADATA

@@ -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.4.dist-info/RECORD

@@ -0,0 +1,10 @@
+licos_dev_cli/__init__.py,sha256=3ppe0RjcWaGGBFyrVGRBMMxJ9JsQ5kGVJQNHnVTiwxE,21
+licos_dev_cli/common.py,sha256=F-QpbA1mgOpUxF6r5WX1081Shv4qT2vXsqQiiHL9QsA,2474
+licos_dev_cli/docx_commands.py,sha256=LBV6sRmRX3RO_IvmdoGnA9vsxirfhMwvbED7Bl9FQP0,10284
+licos_dev_cli/docx_legacy.py,sha256=khbJenMhTAqHqcZvtXLMe2mexEdv_hiO_2B_z4XUEjs,4540
+licos_dev_cli/main.py,sha256=BSWyY5FMfRRA2hDDme-D_3vnJGgPgGYe8-fPlvTRpSY,37598
+licos_dev_cli/ppt_master.py,sha256=CA5W-xvMWV-CAPOnkkXQmsHNm8gRCx2A2ZN4kYNU-dI,24027
+licos_dev_cli-0.4.4.dist-info/METADATA,sha256=oZYgaYcHpDk5os_CnEb5T4MKpgBg92mBvQ41jO4HeTU,211
+licos_dev_cli-0.4.4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+licos_dev_cli-0.4.4.dist-info/entry_points.txt,sha256=DGWCJa7PKnDzqBZ4RHPogHg5tTBM2C6QfWiYHDohN3s,53
+licos_dev_cli-0.4.4.dist-info/RECORD,,

licos_dev_cli-0.4.2.dist-info/RECORD

@@ -1,10 +0,0 @@
-licos_dev_cli/__init__.py,sha256=3ppe0RjcWaGGBFyrVGRBMMxJ9JsQ5kGVJQNHnVTiwxE,21
-licos_dev_cli/common.py,sha256=F-QpbA1mgOpUxF6r5WX1081Shv4qT2vXsqQiiHL9QsA,2474
-licos_dev_cli/docx_commands.py,sha256=AcfkxZtf_N-dBB7MqBFXHXNVrSr403JLi6XYu8NYNbs,7957
-licos_dev_cli/docx_legacy.py,sha256=khbJenMhTAqHqcZvtXLMe2mexEdv_hiO_2B_z4XUEjs,4540
-licos_dev_cli/main.py,sha256=GdK4Q5K41zHuut-B6QS_GE19TLXLindA3OluWOBangM,37546
-licos_dev_cli/ppt_master.py,sha256=CA5W-xvMWV-CAPOnkkXQmsHNm8gRCx2A2ZN4kYNU-dI,24027
-licos_dev_cli-0.4.2.dist-info/METADATA,sha256=EDP_V77-rzl61PK85iSwgEBMa65XWJKE0qJrOYne4rw,211
-licos_dev_cli-0.4.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-licos_dev_cli-0.4.2.dist-info/entry_points.txt,sha256=DGWCJa7PKnDzqBZ4RHPogHg5tTBM2C6QfWiYHDohN3s,53
-licos_dev_cli-0.4.2.dist-info/RECORD,,