licos-dev-cli 0.2.21__tar.gz → 0.3.1__tar.gz

{licos_dev_cli-0.2.21 → licos_dev_cli-0.3.1}/PKG-INFO

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

{licos_dev_cli-0.2.21 → licos_dev_cli-0.3.1}/pyproject.toml

@@ -1,14 +1,14 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling>=1.27,<1.31"]
 build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-cli"
-version = "0.2.21"
+version = "0.3.1"
 description = "LICOS Dev CLI - generate files and call model capabilities"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-dev-sdk>=0.2.22",
+    "licos-dev-sdk>=0.3.1",
     "click>=8.1",
 ]
 

{licos_dev_cli-0.2.21 → licos_dev_cli-0.3.1}/src/licos_dev_cli/main.py

@@ -123,14 +123,63 @@ def credit_check(estimated_points, resource_type, resource_code, request_id):
 @click.option("-o", "--output-dir", default=None, help="Output directory")
 @click.option("--format", "content_type", default="markdown", help="Content type: markdown|html")
 @click.option("--page-size", default="A4", help="Page size: A4|LETTER")
-def pdf(input_path, content, filename, output_dir, content_type, page_size):
+@click.option("--theme", default="formal-blue", help="Theme: formal-blue|business|neutral")
+@click.option("--title", default=None, help="Document title")
+@click.option("--margin", default="20mm", help="Page margin CSS length, e.g. 20mm")
+def pdf(input_path, content, filename, output_dir, content_type, page_size, theme, title, margin):
     """Generate PDF from Markdown or HTML."""
     from licos_dev_sdk import create_pdf
     text = _read_input(input_path, content)
-    path = create_pdf(text, filename, content_type=content_type, output_dir=output_dir, page_size=page_size)
+    path = create_pdf(
+        text,
+        filename,
+        content_type=content_type,
+        output_dir=output_dir,
+        page_size=page_size,
+        theme=theme,
+        title=title,
+        margin=margin,
+    )
     _echo_path(path)
 
 
+@cli.command("pdf-inspect")
+@click.option("-f", "--file", "file_path", required=True, type=click.Path(exists=True, dir_okay=False))
+@click.option("--min-pages", type=click.IntRange(min=1), default=None)
+@click.option("--max-pages", type=click.IntRange(min=1), default=None)
+@click.option(
+    "--sparse-text-threshold",
+    type=click.IntRange(min=0),
+    default=300,
+    show_default=True,
+    help="Flag non-cover pages with fewer extracted text characters; 0 disables the check.",
+)
+@click.option("--allow-sparse-cover/--check-sparse-cover", default=True, show_default=True)
+@click.option("--check-orphan-headings/--allow-orphan-headings", default=True, show_default=True)
+def pdf_inspect(
+    file_path,
+    min_pages,
+    max_pages,
+    sparse_text_threshold,
+    allow_sparse_cover,
+    check_orphan_headings,
+):
+    """Inspect PDF structure, page density, and requested page-count limits."""
+    from licos_dev_sdk import inspect_pdf
+
+    report = inspect_pdf(
+        file_path,
+        min_pages=min_pages,
+        max_pages=max_pages,
+        sparse_text_threshold=sparse_text_threshold,
+        allow_sparse_cover=allow_sparse_cover,
+        check_orphan_headings=check_orphan_headings,
+    )
+    click.echo(json.dumps(report, ensure_ascii=False, indent=2))
+    if not report["quality_passed"]:
+        raise click.exceptions.Exit(2)
+
+
 # ── DOCX ─────────────────────────────────────────────────────────────────────
 
 @cli.command()
@@ -139,13 +188,31 @@ def pdf(input_path, content, filename, output_dir, content_type, page_size):
 @click.option("-f", "--filename", required=True)
 @click.option("-o", "--output-dir", default=None)
 @click.option("--format", "content_type", default="markdown")
-@click.option("--font", default="Arial")
+@click.option("--font", default="Microsoft YaHei")
 @click.option("--font-size", default=11, type=int)
-def docx(input_path, content, filename, output_dir, content_type, font, font_size):
+@click.option("--theme", default="formal-blue", help="Theme: formal-blue|business|neutral")
+@click.option("--title", default=None, help="Document title used when content has no H1")
+@click.option("--header", default=None, help="Header text")
+@click.option("--footer", default=None, help="Footer text placed before the page number")
+@click.option("--toc/--no-toc", default=False, help="Insert an updatable Word table of contents")
+def docx(input_path, content, filename, output_dir, content_type, font, font_size, theme, title, header, footer, toc):
     """Generate DOCX from Markdown or HTML."""
     from licos_dev_sdk import create_docx
     text = _read_input(input_path, content)
-    path = create_docx(text, filename, content_type=content_type, output_dir=output_dir, font_name=font, font_size=font_size)
+    path = create_docx(
+        text,
+        filename,
+        content_type=content_type,
+        output_dir=output_dir,
+        font_name=font,
+        font_size=font_size,
+        theme=theme,
+        title=title,
+        header=header,
+        footer=footer,
+        include_toc=toc,
+        asset_base_path=str(Path(input_path).resolve().parent) if input_path else None,
+    )
     _echo_path(path)
 
 
@@ -174,11 +241,12 @@ def docx_template(template_path, input_path, data_content, filename, output_dir)
 @click.option("-o", "--output-dir", default=None)
 @click.option("--sheet-name", default="Sheet1")
 @click.option("--header-color", default="4472C4")
-def xlsx(input_path, content, filename, output_dir, sheet_name, header_color):
+@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)
+    path = create_xlsx(data, filename, output_dir=output_dir, sheet_name=sheet_name, header_color=header_color, theme=theme)
     _echo_path(path)
 
 
@@ -190,7 +258,8 @@ def xlsx(input_path, content, filename, output_dir, sheet_name, header_color):
 @click.option("--header-color", default="4472C4")
 @click.option("--freeze-header/--no-freeze-header", default=True)
 @click.option("--autofilter/--no-autofilter", default=True)
-def xlsx_workbook(input_path, content, filename, output_dir, header_color, freeze_header, autofilter):
+@click.option("--theme", default="professional-blue", help="Theme: professional-blue|business|neutral")
+def xlsx_workbook(input_path, content, filename, output_dir, header_color, freeze_header, autofilter, theme):
     """Generate multi-sheet XLSX from JSON workbook data."""
     from licos_dev_sdk import create_xlsx_workbook
     data = _read_json(input_path, content)
@@ -201,10 +270,20 @@ def xlsx_workbook(input_path, content, filename, output_dir, header_color, freez
         header_color=header_color,
         freeze_header=freeze_header,
         autofilter=autofilter,
+        theme=theme,
     )
     _echo_path(path)
 
 
+@cli.command("xlsx-inspect")
+@click.option("-f", "--file", "file_path", required=True, type=click.Path(exists=True, dir_okay=False))
+def xlsx_inspect(file_path):
+    """Inspect generated XLSX formulas, charts, formatting, and validation features."""
+    from licos_dev_sdk import inspect_xlsx
+
+    click.echo(json.dumps(inspect_xlsx(file_path), ensure_ascii=False, indent=2))
+
+
 # ── CSV ──────────────────────────────────────────────────────────────────────
 
 @cli.command()

{licos_dev_cli-0.2.21 → licos_dev_cli-0.3.1}/tests/test_credit_check.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+from pathlib import Path
 from unittest import mock
 
 from click.testing import CliRunner
@@ -37,3 +38,28 @@ def test_credit_check_forwards_structured_options() -> None:
         resource_code="IMAGE_GENERATE",
         request_id="request-1",
     )
+
+
+def test_docx_uses_input_directory_as_asset_base_path(tmp_path: Path) -> None:
+    source_dir = tmp_path / "source"
+    source_dir.mkdir()
+    input_path = source_dir / "report.html"
+    input_path.write_text('<img src="chart.png">', encoding="utf-8")
+
+    with mock.patch(
+        "licos_dev_sdk.create_docx",
+        return_value=str(tmp_path / "report.docx"),
+    ) as create:
+        result = CliRunner().invoke(
+            cli,
+            [
+                "docx",
+                "--input",
+                str(input_path),
+                "--filename",
+                "report.docx",
+            ],
+        )
+
+    assert result.exit_code == 0
+    assert create.call_args.kwargs["asset_base_path"] == str(source_dir.resolve())