licos-dev-sdk 0.2.6__tar.gz → 0.2.8__tar.gz

{licos_dev_sdk-0.2.6 → licos_dev_sdk-0.2.8}/PKG-INFO

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: licos-dev-sdk
-Version: 0.2.6
+Version: 0.2.8
 Summary: LICOS Dev SDK - file generation and model capability clients
 Requires-Python: >=3.10
+Requires-Dist: docxtpl>=0.16
 Requires-Dist: graphviz>=0.20
 Requires-Dist: jinja2>=3.1
 Requires-Dist: licos-platform-sdk>=0.2.8
@@ -16,3 +17,4 @@ Requires-Dist: python-pptx>=1.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: qrcode[pil]>=8.0
 Requires-Dist: weasyprint>=62.0
+Requires-Dist: xlsxwriter>=3.2

{licos_dev_sdk-0.2.6 → licos_dev_sdk-0.2.8}/pyproject.toml

@@ -4,14 +4,16 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-sdk"
-version = "0.2.6"
+version = "0.2.8"
 description = "LICOS Dev SDK - file generation and model capability clients"
 requires-python = ">=3.10"
 dependencies = [
     "licos-platform-sdk>=0.2.8",
     "weasyprint>=62.0",
-    "python-docx>=1.1",
-    "openpyxl>=3.1",
+    "python-docx>=1.1",
+    "docxtpl>=0.16",
+    "openpyxl>=3.1",
+    "xlsxwriter>=3.2",
     "python-pptx>=1.0",
     "matplotlib>=3.9",
     "graphviz>=0.20",

{licos_dev_sdk-0.2.6 → licos_dev_sdk-0.2.8}/src/licos_dev_sdk/__init__.py

@@ -23,12 +23,14 @@ def __getattr__(name: str):
         "create_html": ("web", "create_html"),
         "create_markdown": ("web", "create_markdown"),
         "markdown_to_html": ("web", "markdown_to_html"),
-        # document
-        "create_pdf": ("document", "create_pdf"),
-        "create_docx": ("document", "create_docx"),
-        # spreadsheet
-        "create_xlsx": ("spreadsheet", "create_xlsx"),
-        "create_csv": ("spreadsheet", "create_csv"),
+        # document
+        "create_pdf": ("document", "create_pdf"),
+        "create_docx": ("document", "create_docx"),
+        "create_docx_from_template": ("document", "create_docx_from_template"),
+        # spreadsheet
+        "create_xlsx": ("spreadsheet", "create_xlsx"),
+        "create_xlsx_workbook": ("spreadsheet", "create_xlsx_workbook"),
+        "create_csv": ("spreadsheet", "create_csv"),
         # chart
         "create_chart": ("chart", "create_chart"),
         # diagram
@@ -41,9 +43,9 @@ def __getattr__(name: str):
         "ModelResult": ("model", "ModelResult"),
         "ApiError": ("model", "ApiError"),
         "ConfigurationError": ("model", "ConfigurationError"),
-        "LLMClient": ("model", "LLMClient"),
-        "create_chat_openai": ("model", "create_chat_openai"),
-        "VisionClient": ("model", "VisionClient"),
+        "LLMClient": ("model", "LLMClient"),
+        "create_chat_openai": ("model", "create_chat_openai"),
+        "VisionClient": ("model", "VisionClient"),
         "VisionUnderstandingClient": ("model", "VisionUnderstandingClient"),
         "ImageGenerationClient": ("model", "ImageGenerationClient"),
         "VideoGenerationClient": ("model", "VideoGenerationClient"),
@@ -85,15 +87,15 @@ __all__ = [
     "create_json", "create_xml", "create_yaml",
     "create_zip", "create_tar_gz",
     "create_qrcode", "create_barcode", "create_watermark",
-    "create_html", "create_markdown", "markdown_to_html",
-    "create_pdf", "create_docx",
-    "create_xlsx", "create_csv",
+    "create_html", "create_markdown", "markdown_to_html",
+    "create_pdf", "create_docx", "create_docx_from_template",
+    "create_xlsx", "create_xlsx_workbook", "create_csv",
     "create_chart",
     "create_diagram",
     "create_pptx",
     "ModelRuntime", "ModelEndpoint", "ModelResult",
     "ApiError", "ConfigurationError",
-    "LLMClient", "create_chat_openai", "VisionClient", "VisionUnderstandingClient", "ImageGenerationClient", "VideoGenerationClient",
+    "LLMClient", "create_chat_openai", "VisionClient", "VisionUnderstandingClient", "ImageGenerationClient", "VideoGenerationClient",
     "SpeechRecognitionClient", "ASRClient",
     "fetch_model_catalogs", "fetch_model_detail", "resolve_llm_endpoint", "resolve_vision_endpoint",
     "resolve_image_generation_endpoint", "resolve_video_generation_endpoint",

{licos_dev_sdk-0.2.6 → licos_dev_sdk-0.2.8}/src/licos_dev_sdk/document.py

@@ -2,11 +2,10 @@
 
 from __future__ import annotations
 
-import mistune
-from weasyprint import HTML
+from typing import Any
+
 from docx import Document
 from docx.shared import Pt, Inches
-from docx.enum.text import WD_ALIGN_PARAGRAPH
 
 from ._utils import resolve_output_path
 
@@ -29,6 +28,9 @@ blockquote { border-left: 3px solid #ccc; margin-left: 0; padding-left: 1em; col
 def create_pdf(content: str, filename: str, *, content_type: str = "markdown",
                output_dir: str | None = None, page_size: str = "A4") -> str:
     """Generate a PDF file from Markdown or HTML. Returns absolute path."""
+    import mistune
+    from weasyprint import HTML
+
     path = resolve_output_path(filename, ".pdf", output_dir)
     html_body = mistune.html(content) if content_type == "markdown" else content
     css = _PDF_CSS.replace("{page_size}", page_size)
@@ -96,3 +98,23 @@ def create_docx(content: str, filename: str, *, content_type: str = "markdown",
 
     doc.save(str(path))
     return str(path.resolve())
+
+
+def create_docx_from_template(template_path: str, data: dict[str, Any], filename: str, *,
+                              output_dir: str | None = None) -> str:
+    """Render a DOCX template with Jinja-style placeholders.
+
+    The template must be a `.docx` file. Placeholders use docxtpl syntax, for example
+    `{{ customer_name }}` or `{% for item in items %}...{% endfor %}`.
+    Returns the absolute path of the generated document.
+    """
+    if not isinstance(data, dict):
+        raise TypeError("data must be a dict")
+
+    from docxtpl import DocxTemplate
+
+    path = resolve_output_path(filename, ".docx", output_dir)
+    doc = DocxTemplate(template_path)
+    doc.render(data)
+    doc.save(str(path))
+    return str(path.resolve())