exstruct 0.5.1__tar.gz → 0.5.2__tar.gz

{exstruct-0.5.1 → exstruct-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: exstruct
-Version: 0.5.1
+Version: 0.5.2
 Summary: Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines
 Keywords: excel,structure,data,exstruct
 Author: harumiWeb
@@ -176,9 +176,14 @@ Notes:
   - `com`: force COM (rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`)
   - `openpyxl`: force openpyxl (`.xls` is not supported)
 - `create_chart` is COM-only (`backend="openpyxl"` is not allowed for requests that include it), and it also rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`.
-- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
-- `create_chart` and `apply_table_style` cannot be combined in one request (split into separate calls).
-- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
+- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
+- `create_chart` `data_range` accepts either one range string or `list[str]` (multi-series), and `data_range` / `category_range` both support sheet-qualified ranges (`Sheet2!A1:B10`, `'Sales Data'!A1:B10`).
+- `create_chart` supports optional explicit labels: `chart_title`, `x_axis_title`, `y_axis_title`.
+- `create_chart` and `apply_table_style` can be combined in one request when the backend resolves to COM (`backend="com"` or `backend="auto"` with COM available).
+- For stable `apply_table_style` COM runs on Windows, ensure desktop Excel is installed/runnable and the target `range` is a contiguous header-included A1 range.
+- `exstruct_patch` error detail may include `error_code` / `failed_field` / `raw_com_message`; table-related codes include `table_style_invalid`, `list_object_add_failed`, and `com_api_missing`.
+- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
+- Use `exstruct_make` for new workbook creation and `exstruct_patch` for editing existing workbooks.
 - `exstruct_make` creates a new workbook and applies `ops` in one call (`out_path` required, `ops` optional).
   - Supports `.xlsx` / `.xlsm` / `.xls`
   - Initial sheet is normalized to `Sheet1`

{exstruct-0.5.1 → exstruct-0.5.2}/README.md

@@ -111,9 +111,14 @@ Notes:
   - `com`: force COM (rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`)
   - `openpyxl`: force openpyxl (`.xls` is not supported)
 - `create_chart` is COM-only (`backend="openpyxl"` is not allowed for requests that include it), and it also rejects `dry_run` / `return_inverse_ops` / `preflight_formula_check`.
-- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
-- `create_chart` and `apply_table_style` cannot be combined in one request (split into separate calls).
-- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
+- `create_chart` `chart_type` supports: `line`, `column`, `bar`, `area`, `pie`, `doughnut`, `scatter`, `radar` (aliases: `column_clustered`, `bar_clustered`, `xy_scatter`, `donut`).
+- `create_chart` `data_range` accepts either one range string or `list[str]` (multi-series), and `data_range` / `category_range` both support sheet-qualified ranges (`Sheet2!A1:B10`, `'Sales Data'!A1:B10`).
+- `create_chart` supports optional explicit labels: `chart_title`, `x_axis_title`, `y_axis_title`.
+- `create_chart` and `apply_table_style` can be combined in one request when the backend resolves to COM (`backend="com"` or `backend="auto"` with COM available).
+- For stable `apply_table_style` COM runs on Windows, ensure desktop Excel is installed/runnable and the target `range` is a contiguous header-included A1 range.
+- `exstruct_patch` error detail may include `error_code` / `failed_field` / `raw_com_message`; table-related codes include `table_style_invalid`, `list_object_add_failed`, and `com_api_missing`.
+- `exstruct_patch` response includes `engine` (`com` or `openpyxl`) to show the actual backend used. `restore_design_snapshot` remains openpyxl-only.
+- Use `exstruct_make` for new workbook creation and `exstruct_patch` for editing existing workbooks.
 - `exstruct_make` creates a new workbook and applies `ops` in one call (`out_path` required, `ops` optional).
   - Supports `.xlsx` / `.xlsm` / `.xls`
   - Initial sheet is normalized to `Sheet1`

{exstruct-0.5.1 → exstruct-0.5.2}/pyproject.toml

@@ -1,7 +1,7 @@
-[project]
-name = "exstruct"
-version = "0.5.1"
-description = "Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines"
+[project]
+name = "exstruct"
+version = "0.5.2"
+description = "Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines"
 readme = "README.md"
 license = { file = "LICENSE" }
 keywords = ["excel", "structure", "data", "exstruct"]

{exstruct-0.5.1 → exstruct-0.5.2}/src/exstruct/mcp/op_schema.py

@@ -380,7 +380,6 @@ _PATCH_OP_SCHEMA_BY_NAME: dict[str, PatchOpSchema] = {
             "range must include header row",
             "table name must be unique when provided",
             "range must not intersect existing table",
-            "backend='com' falls back to openpyxl with warning",
         ],
         example={
             "op": "apply_table_style",
@@ -401,9 +400,14 @@ _PATCH_OP_SCHEMA_BY_NAME: dict[str, PatchOpSchema] = {
             "height",
             "titles_from_data",
             "series_from_rows",
+            "chart_title",
+            "x_axis_title",
+            "y_axis_title",
         ],
         constraints=[
             "chart_type in {'line','column','bar','area','pie','doughnut','scatter','radar'}",
+            "data_range accepts A1 range string or list[str] for multi-series input",
+            "data_range/category_range allow sheet-qualified ranges like 'Sheet2!A1:B10'",
             "width/height must be > 0 when provided",
             "chart_name must be unique in sheet when provided",
             "backend='openpyxl' is not supported",
@@ -412,14 +416,17 @@ _PATCH_OP_SCHEMA_BY_NAME: dict[str, PatchOpSchema] = {
             "op": "create_chart",
             "sheet": "Sheet1",
             "chart_type": "line",
-            "data_range": "A1:C10",
-            "category_range": "A2:A10",
+            "data_range": ["A2:A10", "C2:C10", "D2:D10"],
+            "category_range": "B2:B10",
             "anchor_cell": "E2",
             "chart_name": "SalesTrend",
             "width": 360,
             "height": 220,
             "titles_from_data": True,
             "series_from_rows": False,
+            "chart_title": "Sales trend",
+            "x_axis_title": "Month",
+            "y_axis_title": "Amount",
         },
     ),
     "restore_design_snapshot": PatchOpSchema(