licos-dev-cli 0.3.9__tar.gz → 0.4.0__tar.gz

{licos_dev_cli-0.3.9 → licos_dev_cli-0.4.0}/PKG-INFO

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

{licos_dev_cli-0.3.9 → licos_dev_cli-0.4.0}/pyproject.toml

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

{licos_dev_cli-0.3.9 → licos_dev_cli-0.4.0}/src/licos_dev_cli/main.py

@@ -251,16 +251,41 @@ def docx_template(template_path, input_path, data_content, filename, output_dir)
     _echo_path(path)
 
 
+@cli.command("docx-edit")
+@click.option("-s", "--source", "source_path", required=True, type=click.Path(exists=True, dir_okay=False))
+@click.option("-i", "--input", "input_path", help="JSON operation file")
+@click.option("-d", "--data", "data_content", help="JSON operation array")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def docx_edit(source_path, input_path, data_content, filename, output_dir):
+    """Edit native tables in an existing DOCX package."""
+    from licos_dev_sdk import edit_docx
+
+    payload = _read_json(input_path, data_content)
+    operations = payload.get("operations") if isinstance(payload, dict) else payload
+    if not isinstance(operations, list):
+        raise click.BadParameter("operations must be a JSON array or an object containing operations")
+    path = edit_docx(source_path, operations, filename, output_dir=output_dir)
+    _echo_path(path)
+
+
 @cli.command("docx-read")
 @click.option("-f", "--file", "file_path", required=True, type=click.Path(exists=True, dir_okay=False))
 @click.option("--offset", type=click.IntRange(min=1), default=1, show_default=True)
 @click.option("--limit", type=click.IntRange(min=1), default=20, show_default=True)
 @click.option("--max-chars", type=click.IntRange(min=256), default=8_000, show_default=True)
-def docx_read(file_path, offset, limit, max_chars):
+@click.option("--include-styles", is_flag=True, help="Include paragraph, run, row, and cell styles")
+def docx_read(file_path, offset, limit, max_chars, include_styles):
     """Read DOCX paragraphs and table rows as paginated JSON."""
     from licos_dev_sdk import read_docx
 
-    report = read_docx(file_path, offset=offset, limit=limit, max_chars=max_chars)
+    report = read_docx(
+        file_path,
+        offset=offset,
+        limit=limit,
+        max_chars=max_chars,
+        include_styles=include_styles,
+    )
     report["path"] = _path_to_cli_output(report["path"])
     _echo_json(report)
 
@@ -275,11 +300,41 @@ def docx_read(file_path, offset, limit, max_chars):
 @click.option("--sheet-name", default="Sheet1")
 @click.option("--header-color", default="4472C4")
 @click.option("--theme", default="professional-blue", help="Theme: professional-blue|business|neutral")
-def xlsx(input_path, content, filename, output_dir, sheet_name, header_color, theme):
-    """Generate XLSX from JSON data."""
-    from licos_dev_sdk import create_xlsx
-    data = _read_json(input_path, content)
-    path = create_xlsx(data, filename, output_dir=output_dir, sheet_name=sheet_name, header_color=header_color, theme=theme)
+@click.option("--format", "content_type", type=click.Choice(["json", "html", "docx"]), default="json", show_default=True)
+@click.option("--column", "columns", multiple=True, help="Exact DOCX table header; repeat for each output column")
+def xlsx(input_path, content, filename, output_dir, sheet_name, header_color, theme, content_type, columns):
+    """Generate native XLSX from JSON, HTML, or selected DOCX table columns."""
+    if content_type == "docx":
+        from licos_dev_sdk import create_xlsx_from_docx
+
+        if not input_path:
+            raise click.BadParameter("--input is required for DOCX input", param_hint="--input")
+        if content is not None:
+            raise click.BadParameter("--content is not supported for DOCX input", param_hint="--content")
+        if not columns:
+            raise click.BadParameter("at least one --column is required for DOCX input", param_hint="--column")
+        path = create_xlsx_from_docx(
+            input_path,
+            columns,
+            filename,
+            output_dir=output_dir,
+            sheet_name=sheet_name,
+            theme=theme,
+        )
+    elif content_type == "html":
+        from licos_dev_sdk import create_xlsx_from_html
+
+        path = create_xlsx_from_html(
+            _read_input(input_path, content),
+            filename,
+            output_dir=output_dir,
+            sheet_name=sheet_name,
+        )
+    else:
+        from licos_dev_sdk import create_xlsx
+
+        data = _read_json(input_path, content)
+        path = create_xlsx(data, filename, output_dir=output_dir, sheet_name=sheet_name, header_color=header_color, theme=theme)
     _echo_path(path)
 
 
@@ -324,7 +379,8 @@ def xlsx_inspect(file_path):
 @click.option("--offset", type=click.IntRange(min=1), default=1, show_default=True)
 @click.option("--limit", type=click.IntRange(min=1), default=20, show_default=True)
 @click.option("--max-chars", type=click.IntRange(min=256), default=8_000, show_default=True)
-def xlsx_read(file_path, sheet, cell_range, offset, limit, max_chars):
+@click.option("--include-styles", is_flag=True, help="Include cell number, font, fill, and alignment styles")
+def xlsx_read(file_path, sheet, cell_range, offset, limit, max_chars, include_styles):
     """List XLSX worksheets or read rows from a selected worksheet."""
     from licos_dev_sdk import read_xlsx
 
@@ -335,11 +391,30 @@ def xlsx_read(file_path, sheet, cell_range, offset, limit, max_chars):
         offset=offset,
         limit=limit,
         max_chars=max_chars,
+        include_styles=include_styles,
     )
     report["path"] = _path_to_cli_output(report["path"])
     _echo_json(report)
 
 
+@cli.command("xlsx-edit")
+@click.option("-s", "--source", "source_path", required=True, type=click.Path(exists=True, dir_okay=False))
+@click.option("-i", "--input", "input_path", help="JSON operation file")
+@click.option("-d", "--data", "data_content", help="JSON operation array")
+@click.option("-f", "--filename", required=True)
+@click.option("-o", "--output-dir", default=None)
+def xlsx_edit(source_path, input_path, data_content, filename, output_dir):
+    """Edit an existing native XLSX workbook."""
+    from licos_dev_sdk import edit_xlsx
+
+    payload = _read_json(input_path, data_content)
+    operations = payload.get("operations") if isinstance(payload, dict) else payload
+    if not isinstance(operations, list):
+        raise click.BadParameter("operations must be a JSON array or an object containing operations")
+    path = edit_xlsx(source_path, operations, filename, output_dir=output_dir)
+    _echo_path(path)
+
+
 # ── CSV ──────────────────────────────────────────────────────────────────────
 
 @cli.command()

{licos_dev_cli-0.3.9 → licos_dev_cli-0.4.0}/tests/test_document_read_cli.py

@@ -46,3 +46,52 @@ def test_xlsx_read_without_sheet_returns_workbook_structure(tmp_path: Path):
     payload = json.loads(result.output)
     assert payload["mode"] == "workbook_overview"
     assert payload["sheet_names"] == ["Overview", "Details"]
+
+
+def test_xlsx_command_extracts_selected_docx_columns(tmp_path: Path, monkeypatch):
+    from docx import Document
+    from openpyxl import load_workbook
+
+    project = tmp_path / "projects"
+    project.mkdir()
+    source = project / "source.docx"
+    document = Document()
+    table = document.add_table(rows=2, cols=4)
+    for column, value in enumerate(["序号", "名称", "单位", "数量"]):
+        table.cell(0, column).text = value
+    for column, value in enumerate(["1", "泵", "台", "2"]):
+        table.cell(1, column).text = value
+    document.save(source)
+    monkeypatch.setenv("LICOS_PROJECT_PATH", str(project))
+
+    result = CliRunner().invoke(
+        cli,
+        [
+            "xlsx",
+            "--format",
+            "docx",
+            "--input",
+            str(source),
+            "--column",
+            "名称",
+            "--column",
+            "单位",
+            "--column",
+            "数量",
+            "--filename",
+            "result",
+            "--output-dir",
+            str(project),
+        ],
+    )
+
+    assert result.exit_code == 0, result.output
+    assert result.output.strip() == "result.xlsx"
+    workbook = load_workbook(project / "result.xlsx")
+    try:
+        assert list(workbook.active.values) == [
+            ("名称", "单位", "数量"),
+            ("泵", "台", "2"),
+        ]
+    finally:
+        workbook.close()