licos-dev-cli 0.3.3__tar.gz → 0.3.5__tar.gz

{licos_dev_cli-0.3.3 → licos_dev_cli-0.3.5}/PKG-INFO

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

{licos_dev_cli-0.3.3 → licos_dev_cli-0.3.5}/pyproject.toml

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

{licos_dev_cli-0.3.3 → licos_dev_cli-0.3.5}/src/licos_dev_cli/main.py

@@ -180,6 +180,20 @@ def pdf_inspect(
         raise click.exceptions.Exit(2)
 
 
+@cli.command("pdf-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 pdf_read(file_path, offset, limit, max_chars):
+    """Read PDF page text as paginated JSON."""
+    from licos_dev_sdk import read_pdf
+
+    report = read_pdf(file_path, offset=offset, limit=limit, max_chars=max_chars)
+    report["path"] = _path_to_cli_output(report["path"])
+    _echo_json(report)
+
+
 # ── DOCX ─────────────────────────────────────────────────────────────────────
 
 @cli.command()
@@ -232,6 +246,20 @@ def docx_template(template_path, input_path, data_content, filename, 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):
+    """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["path"] = _path_to_cli_output(report["path"])
+    _echo_json(report)
+
+
 # ── XLSX ─────────────────────────────────────────────────────────────────────
 
 @cli.command()
@@ -284,6 +312,29 @@ def xlsx_inspect(file_path):
     click.echo(json.dumps(inspect_xlsx(file_path), ensure_ascii=False, indent=2))
 
 
+@cli.command("xlsx-read")
+@click.option("-f", "--file", "file_path", required=True, type=click.Path(exists=True, dir_okay=False))
+@click.option("--sheet", default=None, help="Worksheet name. Omit it to list workbook structure first.")
+@click.option("--range", "cell_range", default=None, help="Cell range in the selected worksheet, for example A1:F100")
+@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):
+    """List XLSX worksheets or read rows from a selected worksheet."""
+    from licos_dev_sdk import read_xlsx
+
+    report = read_xlsx(
+        file_path,
+        sheet=sheet,
+        cell_range=cell_range,
+        offset=offset,
+        limit=limit,
+        max_chars=max_chars,
+    )
+    report["path"] = _path_to_cli_output(report["path"])
+    _echo_json(report)
+
+
 # ── CSV ──────────────────────────────────────────────────────────────────────
 
 @cli.command()
@@ -315,6 +366,62 @@ def pptx(input_path, content, filename, output_dir, content_type):
     _echo_path(path)
 
 
+@cli.command("pptx-deck")
+@click.option("-i", "--input", "input_path", help="JSON presentation specification file")
+@click.option("-c", "--content", help="JSON presentation specification")
+@click.option("-f", "--filename", required=True, help="Output filename without extension")
+@click.option("-o", "--output-dir", default=None, help="Output directory")
+@click.option(
+    "--asset-base-path",
+    default=None,
+    type=click.Path(file_okay=False),
+    help="Base directory for relative image paths; defaults to the JSON file directory",
+)
+def pptx_deck(input_path, content, filename, output_dir, asset_base_path):
+    """Generate a professional PPTX from a structured JSON specification."""
+    from licos_dev_sdk import create_pptx_deck
+
+    spec = _read_json(input_path, content)
+    if not isinstance(spec, dict):
+        raise click.BadParameter("presentation specification must be a JSON object")
+    base_path = asset_base_path or (str(Path(input_path).resolve().parent) if input_path else None)
+    path = create_pptx_deck(
+        spec,
+        filename,
+        output_dir=output_dir,
+        asset_base_path=base_path,
+    )
+    _echo_path(path)
+
+
+@cli.command("pptx-inspect")
+@click.option("-f", "--file", "file_path", required=True, type=click.Path(exists=True, dir_okay=False))
+@click.option("--min-slides", type=click.IntRange(min=1), default=None)
+@click.option("--max-slides", type=click.IntRange(min=1), default=None)
+def pptx_inspect(file_path, min_slides, max_slides):
+    """Inspect PPTX structure, content density, and requested slide-count limits."""
+    from licos_dev_sdk import inspect_pptx
+
+    report = inspect_pptx(file_path, min_slides=min_slides, max_slides=max_slides)
+    _echo_json(report)
+    if not report["quality_passed"]:
+        raise click.exceptions.Exit(2)
+
+
+@cli.command("pptx-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 pptx_read(file_path, offset, limit, max_chars):
+    """Read PPTX slide text, tables, and notes as paginated JSON."""
+    from licos_dev_sdk import read_pptx
+
+    report = read_pptx(file_path, offset=offset, limit=limit, max_chars=max_chars)
+    report["path"] = _path_to_cli_output(report["path"])
+    _echo_json(report)
+
+
 # ── Chart ────────────────────────────────────────────────────────────────────
 
 @cli.command()

licos_dev_cli-0.3.5/tests/test_document_read_cli.py

@@ -0,0 +1,48 @@
+import json
+from pathlib import Path
+
+from click.testing import CliRunner
+
+from licos_dev_cli.main import cli
+
+
+def test_docx_read_command_returns_paginated_json(tmp_path: Path, monkeypatch):
+    from docx import Document
+
+    project = tmp_path / "projects"
+    project.mkdir()
+    path = project / "brief.docx"
+    document = Document()
+    document.add_paragraph("First paragraph")
+    document.add_paragraph("Second paragraph")
+    document.save(path)
+    monkeypatch.setenv("LICOS_PROJECT_PATH", str(project))
+
+    result = CliRunner().invoke(
+        cli,
+        ["docx-read", "--file", str(path), "--offset", "1", "--limit", "1"],
+    )
+
+    assert result.exit_code == 0, result.output
+    payload = json.loads(result.output)
+    assert payload["path"] == "brief.docx"
+    assert payload["items"][0]["text"] == "First paragraph"
+    assert payload["has_more"] is True
+    assert payload["next_offset"] == 2
+
+
+def test_xlsx_read_without_sheet_returns_workbook_structure(tmp_path: Path):
+    from openpyxl import Workbook
+
+    path = tmp_path / "book.xlsx"
+    workbook = Workbook()
+    workbook.active.title = "Overview"
+    workbook.create_sheet("Details")
+    workbook.save(path)
+
+    result = CliRunner().invoke(cli, ["xlsx-read", "--file", str(path)])
+
+    assert result.exit_code == 0, result.output
+    payload = json.loads(result.output)
+    assert payload["mode"] == "workbook_overview"
+    assert payload["sheet_names"] == ["Overview", "Details"]