exstruct 0.2.71__tar.gz → 0.2.90__tar.gz

{exstruct-0.2.71 → exstruct-0.2.90}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: exstruct
-Version: 0.2.71
+Version: 0.2.90
 Summary: Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines
 Keywords: excel,structure,data,exstruct
 Author: harumiWeb
@@ -61,12 +61,12 @@ Description-Content-Type: text/markdown
 
 ExStruct reads Excel workbooks and outputs structured data (cells, table candidates, shapes, charts, print areas/views, auto page-break areas, hyperlinks) as JSON by default, with optional YAML/TOON formats. It targets both COM/Excel environments (rich extraction) and non-COM environments (cells + table candidates + print areas), with tunable detection heuristics and multiple output modes to fit LLM/RAG pipelines.
 
-[日本版README](README.ja.md)
+[日本版 README](README.ja.md)
 
 ## Features
 
 - **Excel → Structured JSON**: cells, shapes, charts, table candidates, print areas/views, and auto page-break areas per sheet.
-- **Output modes**: `light` (cells + table candidates + print areas; no COM, shapes/charts empty), `standard` (texted shapes + arrows, charts, print areas), `verbose` (all shapes with width/height, charts with size, print areas). Verbose also emits cell hyperlinks. Size output is flag-controlled.
+- **Output modes**: `light` (cells + table candidates + print areas; no COM, shapes/charts empty), `standard` (texted shapes + arrows, charts, print areas), `verbose` (all shapes with width/height, charts with size, print areas). Verbose also emits cell hyperlinks and `colors_map`. Size output is flag-controlled.
 - **Auto page-break export (COM only)**: capture Excel-computed auto page breaks and write per-area JSON/YAML/TOON when requested (CLI option appears only when COM is available).
 - **Formats**: JSON (compact by default, `--pretty` available), YAML, TOON (optional dependencies).
 - **Table detection tuning**: adjust heuristics at runtime via API.
@@ -189,7 +189,7 @@ Use higher thresholds to reduce false positives; lower them if true tables are m
 
 - **light**: cells + table candidates (no COM needed).
 - **standard**: texted shapes + arrows, charts (COM if available), table candidates. Hyperlinks are off unless `include_cell_links=True`.
-- **verbose**: all shapes (with width/height), charts, table candidates, and cell hyperlinks.
+- **verbose**: all shapes (with width/height), charts, table candidates, cell hyperlinks, and `colors_map`.
 
 ## Error Handling / Fallbacks
 
@@ -274,12 +274,14 @@ Below is a **shortened JSON output example** from parsing this Excel workbook.
       ],
       "shapes": [
         {
+          "id": 1,
           "text": "開始",
           "l": 148,
           "t": 220,
           "type": "AutoShape-FlowchartProcess"
         },
         {
+          "id": 2,
           "text": "入力データ読み込み",
           "l": 132,
           "t": 282,
@@ -291,6 +293,8 @@ Below is a **shortened JSON output example** from parsing this Excel workbook.
           "type": "AutoShape-Mixed",
           "begin_arrow_style": 1,
           "end_arrow_style": 2,
+          "begin_id": 1,
+          "end_id": 2,
           "direction": "N"
         },
         ...
@@ -374,14 +378,14 @@ flowchart TD
 
     A --> B
     B --> C
-    C -- no --> D
-    C -- yes --> E
+    C -->|yes| D
+    C --> H
+    D --> E
     E --> F
-    F -- yes --> E
-    F -- no --> G
-    G --> H
-    H -- yes --> I
-    H -- no --> J
+    F --> G
+    G -->|yes| I
+    G -->|no| J
+    H --> J
     I --> J
 ```
 ````
@@ -390,6 +394,12 @@ From this we can see:
 
 **exstruct's JSON is already in a format that AI can read and reason over directly.**
 
+Other LLM inference samples using this library can be found in the following directory:
+
+- [Basic Excel](sample/basic/)
+- [Flowchart](sample/flowchart/)
+- [Gantt Chart](sample/gantt_chart/)
+
 ### 4. Summary
 
 This benchmark confirms exstruct can:
@@ -405,6 +415,19 @@ In short, **exstruct = “an engine that converts Excel into a format AI can und
 - Default JSON is compact to reduce tokens; use `--pretty` or `pretty=True` when readability matters.
 - Field `table_candidates` replaces `tables`; adjust downstream consumers accordingly.
 
+## Enterprise Use
+
+ExStruct is used primarily as a **library**, not a service.
+
+- No official support or SLA is provided
+- Long-term stability is prioritized over rapid feature growth
+- Forking and internal modification are expected in enterprise use
+
+This project is suitable for teams that:
+
+- need transparency over black-box tools
+- are comfortable maintaining internal forks if necessary
+
 ## Print Areas and Auto Page Breaks (PrintArea / PrintAreaView)
 
 - `SheetData.print_areas` holds print areas (cell coordinates) in light/standard/verbose.
@@ -420,3 +443,4 @@ BSD-3-Clause. See `LICENSE` for details.
 ## Documentation
 
 - API Reference (GitHub Pages): https://harumiweb.github.io/exstruct/
+- JSON Schemas: see `schemas/` (one file per model); regenerate via `python scripts/gen_json_schema.py`.

{exstruct-0.2.71 → exstruct-0.2.90}/README.md

@@ -6,12 +6,12 @@
 
 ExStruct reads Excel workbooks and outputs structured data (cells, table candidates, shapes, charts, print areas/views, auto page-break areas, hyperlinks) as JSON by default, with optional YAML/TOON formats. It targets both COM/Excel environments (rich extraction) and non-COM environments (cells + table candidates + print areas), with tunable detection heuristics and multiple output modes to fit LLM/RAG pipelines.
 
-[日本版README](README.ja.md)
+[日本版 README](README.ja.md)
 
 ## Features
 
 - **Excel → Structured JSON**: cells, shapes, charts, table candidates, print areas/views, and auto page-break areas per sheet.
-- **Output modes**: `light` (cells + table candidates + print areas; no COM, shapes/charts empty), `standard` (texted shapes + arrows, charts, print areas), `verbose` (all shapes with width/height, charts with size, print areas). Verbose also emits cell hyperlinks. Size output is flag-controlled.
+- **Output modes**: `light` (cells + table candidates + print areas; no COM, shapes/charts empty), `standard` (texted shapes + arrows, charts, print areas), `verbose` (all shapes with width/height, charts with size, print areas). Verbose also emits cell hyperlinks and `colors_map`. Size output is flag-controlled.
 - **Auto page-break export (COM only)**: capture Excel-computed auto page breaks and write per-area JSON/YAML/TOON when requested (CLI option appears only when COM is available).
 - **Formats**: JSON (compact by default, `--pretty` available), YAML, TOON (optional dependencies).
 - **Table detection tuning**: adjust heuristics at runtime via API.
@@ -134,7 +134,7 @@ Use higher thresholds to reduce false positives; lower them if true tables are m
 
 - **light**: cells + table candidates (no COM needed).
 - **standard**: texted shapes + arrows, charts (COM if available), table candidates. Hyperlinks are off unless `include_cell_links=True`.
-- **verbose**: all shapes (with width/height), charts, table candidates, and cell hyperlinks.
+- **verbose**: all shapes (with width/height), charts, table candidates, cell hyperlinks, and `colors_map`.
 
 ## Error Handling / Fallbacks
 
@@ -219,12 +219,14 @@ Below is a **shortened JSON output example** from parsing this Excel workbook.
       ],
       "shapes": [
         {
+          "id": 1,
           "text": "開始",
           "l": 148,
           "t": 220,
           "type": "AutoShape-FlowchartProcess"
         },
         {
+          "id": 2,
           "text": "入力データ読み込み",
           "l": 132,
           "t": 282,
@@ -236,6 +238,8 @@ Below is a **shortened JSON output example** from parsing this Excel workbook.
           "type": "AutoShape-Mixed",
           "begin_arrow_style": 1,
           "end_arrow_style": 2,
+          "begin_id": 1,
+          "end_id": 2,
           "direction": "N"
         },
         ...
@@ -319,14 +323,14 @@ flowchart TD
 
     A --> B
     B --> C
-    C -- no --> D
-    C -- yes --> E
+    C -->|yes| D
+    C --> H
+    D --> E
     E --> F
-    F -- yes --> E
-    F -- no --> G
-    G --> H
-    H -- yes --> I
-    H -- no --> J
+    F --> G
+    G -->|yes| I
+    G -->|no| J
+    H --> J
     I --> J
 ```
 ````
@@ -335,6 +339,12 @@ From this we can see:
 
 **exstruct's JSON is already in a format that AI can read and reason over directly.**
 
+Other LLM inference samples using this library can be found in the following directory:
+
+- [Basic Excel](sample/basic/)
+- [Flowchart](sample/flowchart/)
+- [Gantt Chart](sample/gantt_chart/)
+
 ### 4. Summary
 
 This benchmark confirms exstruct can:
@@ -350,6 +360,19 @@ In short, **exstruct = “an engine that converts Excel into a format AI can und
 - Default JSON is compact to reduce tokens; use `--pretty` or `pretty=True` when readability matters.
 - Field `table_candidates` replaces `tables`; adjust downstream consumers accordingly.
 
+## Enterprise Use
+
+ExStruct is used primarily as a **library**, not a service.
+
+- No official support or SLA is provided
+- Long-term stability is prioritized over rapid feature growth
+- Forking and internal modification are expected in enterprise use
+
+This project is suitable for teams that:
+
+- need transparency over black-box tools
+- are comfortable maintaining internal forks if necessary
+
 ## Print Areas and Auto Page Breaks (PrintArea / PrintAreaView)
 
 - `SheetData.print_areas` holds print areas (cell coordinates) in light/standard/verbose.
@@ -365,3 +388,4 @@ BSD-3-Clause. See `LICENSE` for details.
 ## Documentation
 
 - API Reference (GitHub Pages): https://harumiweb.github.io/exstruct/
+- JSON Schemas: see `schemas/` (one file per model); regenerate via `python scripts/gen_json_schema.py`.

{exstruct-0.2.71 → exstruct-0.2.90}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "exstruct"
-version = "0.2.71"
+version = "0.2.90"
 description = "Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines"
 readme = "README.md"
 license = { file = "LICENSE" }

{exstruct-0.2.71 → exstruct-0.2.90}/src/exstruct/__init__.py

@@ -7,6 +7,7 @@ from typing import Literal, TextIO
 from .core.cells import set_table_detection_params
 from .core.integrate import extract_workbook
 from .engine import (
+    ColorsOptions,
     DestinationOptions,
     ExStructEngine,
     FilterOptions,
@@ -76,6 +77,7 @@ __all__ = [
     "OutputOptions",
     "FilterOptions",
     "DestinationOptions",
+    "ColorsOptions",
     "serialize_workbook",
     "export_auto_page_breaks",
 ]
@@ -110,8 +112,13 @@ def extract(file_path: str | Path, mode: ExtractionMode = "standard") -> Workboo
         ['A1:B5']
     """
     include_links = True if mode == "verbose" else False
+    include_colors_map = True if mode == "verbose" else None
     engine = ExStructEngine(
-        options=StructOptions(mode=mode, include_cell_links=include_links)
+        options=StructOptions(
+            mode=mode,
+            include_cell_links=include_links,
+            include_colors_map=include_colors_map,
+        )
     )
     return engine.extract(file_path, mode=mode)
 

{exstruct-0.2.71 → exstruct-0.2.90}/src/exstruct/cli/main.py

@@ -2,11 +2,30 @@ from __future__ import annotations
 
 import argparse
 from pathlib import Path
+import sys
 
 from exstruct import process_excel
 from exstruct.cli.availability import ComAvailability, get_com_availability
 
 
+def _ensure_utf8_stdout() -> None:
+    """Reconfigure stdout to UTF-8 when supported.
+
+    Windows consoles default to cp932 and can raise encoding errors when piping
+    non-ASCII characters. Reconfiguring prevents failures without affecting
+    environments that already default to UTF-8.
+    """
+
+    stdout = sys.stdout
+    if not hasattr(stdout, "reconfigure"):
+        return
+    reconfigure = stdout.reconfigure
+    try:
+        reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        return
+
+
 def _add_auto_page_breaks_argument(
     parser: argparse.ArgumentParser, availability: ComAvailability
 ) -> None:
@@ -102,6 +121,7 @@ def main(argv: list[str] | None = None) -> int:
     Returns:
         Exit code (0 for success, 1 for failure).
     """
+    _ensure_utf8_stdout()
     parser = build_parser()
     args = parser.parse_args(argv)