You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 6c74aa3
Browse filesBrowse the repository at this point in the historyBrowse files
Scalar placeholders use `{{title}}`. A row containing `{{items.name}}` is repeated once per array item. Exact number, boolean, and null placeholders become native cell values; mixed text becomes an inline string. Missing variables are blank by default and can be rejected with `with_ignore_missing_variables(false)`. Path output refuses existing files unless `with_overwrite_file(true)` is set. `save_as_template_bytes()` supports in-memory templates.
582
582
583
+
Cells in an enumerable row may select one line of content per item with a multiline conditional
584
+
block:
585
+
586
+
```text
587
+
@if(name == Jack)
588
+
{{items.name}}
589
+
@elseif(score >= 10)
590
+
Top {{items.name}}
591
+
@else
592
+
{{items.department}}
593
+
@endif
594
+
```
595
+
596
+
Direct item fields support string `==`/`!=`, numeric comparisons, and boolean `==`/`!=`. Branch
597
+
markers and bodies each occupy one line; every item still emits one row. Malformed blocks and
598
+
missing fields return template errors. Nested blocks, logical expressions, and conditional formula
599
+
branches are not supported.
600
+
583
601
With the optional `async` feature, `save_as_template_async()` and
584
602
`save_as_template_async_with_cancellation()` run blocking template ZIP/XML work on a worker thread
585
603
and atomically publish the validated path output. Pre-cancellation, rendering errors, dropped
586
604
futures, and cancellation before commit preserve an existing destination byte-for-byte or leave a
587
605
missing destination absent. This does not make ZIP/filesystem operations asynchronous and retains
588
606
the current in-memory template rendering model.
589
607
590
-
Version 1 does not implement `@group`, `@if`, parametrized sheet cloning, `$=` formula templates, or formula recalculation.
608
+
Version 1 does not implement `@group`, parametrized sheet cloning, `$=` formula templates, or formula recalculation.
| Versioned grouped analytics | Rust research extension | No |
186
187
| Addressed JSONL/Markdown/manifest RAG export | Rust research extension | No |
@@ -202,4 +203,4 @@ This matrix is the coverage claim: Rust does not yet provide complete API parity
202
203
203
204
## Deferred Work
204
205
205
-
SQL text parsing, `HAVING`, `ORDER BY`, joins, windows, pivots, disk-spill aggregation, vector indexing, model calls, old Excel formats, advanced template directives and sheet cloning, image authoring, merged-cell APIs, formula calculation/dependency expansion, formula authoring, general styling, async template streams, inferred/typed async export sources, async borrowed readers/writers, and borrowed XLSX lazy readers require separate design and acceptance milestones. CSV DataReader/DataTable adapters are intentionally replaced by Rust iterators, and a one-call CSV/XLSX converter is not exposed; callers compose query and save APIs. See the [Insert migration guide](insert-v1-migration.md) for supported workflows and deliberate differences.
206
+
SQL text parsing, `HAVING`, `ORDER BY`, joins, windows, pivots, disk-spill aggregation, vector indexing, model calls, old Excel formats, template grouping, nested/logical conditions, formula templates and sheet cloning, image authoring, merged-cell APIs, formula calculation/dependency expansion, formula authoring, general styling, async template streams, inferred/typed async export sources, async borrowed readers/writers, and borrowed XLSX lazy readers require separate design and acceptance milestones. CSV DataReader/DataTable adapters are intentionally replaced by Rust iterators, and a one-call CSV/XLSX converter is not exposed; callers compose query and save APIs. See the [Insert migration guide](insert-v1-migration.md) for supported workflows and deliberate differences.
The comparison uses the .NET public APIs, their controlling implementations, and focused tests under the sibling `../MiniExcel` checkout. Rust status is based on the public `MiniExcel` facade, options, integration tests, and [compatibility boundary](compatibility.md).
| General save inputs | Partial | Export from general objects/enumerables, dictionaries, `DataTable`, `IDataReader`, and async enumerables, with progress. Rust accepts dynamic or same-type Serde slices and reports per-sheet row counts. |
36
36
| Multi-sheet export | Partial | Rust creates ordered visible, hidden, and very-hidden worksheets, but does not yet accept heterogeneous Serde row types in one call. |
37
37
| Existing-workbook operations | Implemented | Rust atomically appends, strictly replaces, renames, changes visibility, reorders, and performs .NET-style source-workbook copy-and-add while preserving unrelated package parts and worksheet identity. Rename preserves formula text; visibility rejects hiding the final visible sheet; reorder remaps active/view/local-name indices; copy-and-add preserves the source and atomically publishes a separate destination. |
38
-
| Templates | Partial | Rust fills path/byte templates with scalar values and single-row arrays while preserving package parts; path output also has a cancellable async wrapper. Streams, grouping, conditions, parametrized sheets, `$=` formulas, formula-reference updates, and calculation-chain handling remain unsupported. |
38
+
| Templates | Partial | Rust fills path/byte templates with scalars, arrays, and enumerable-cell conditional blocks while preserving package parts; path output also has a cancellable async wrapper. Streams, grouping, nested/logical conditions, parametrized sheets, `$=` formulas, formula-reference updates, and calculation-chain handling remain unsupported. |
39
39
| Pictures and merge processing | Missing | Add anchored pictures and merge adjacent identical cells through the templater surface. Structured reads do not provide authoring parity. |
40
40
| CSV | Implemented | Dynamic/Serde path, byte, and borrowed query/save APIs; column discovery; inferred/explicit-schema append; delimiter/newline/encoding/BOM/null/quoting configuration; and `query-csv` CLI. DataReader/DataTable are replaced by Rust iterators. Async/progress APIs and a one-call CSV/XLSX converter are not exposed. |
41
41
| Comments and notes | Implemented | Path/bytes/borrowed APIs return threaded roots, replies, unresolved person IDs, people/provider/user IDs, resolution state, typed timestamps, and legacy notes. |
| DataReader/DataTable | Rust iterators and borrowed visitors are the native abstraction; no literal .NET tabular adapter is planned |`OpenXmlImporter.GetDataReader`, `GetAsyncDataReader`, `QueryAsDataTableAsync`; `tests/MiniExcel.OpenXml.Tests/DataReader/`|
@@ -69,7 +70,7 @@ The .NET APIs marked with `Async` also have generated synchronous counterparts t
69
70
## Suggested Implementation Order
70
71
71
72
1.**Broader async export/stream APIs**: extend runtime-neutral cancellation to typed/inferred producers and borrowed streams without presenting blocking ZIP work as async I/O.
72
-
2.**Advanced templates and Fluent Mapping**: add grouped/conditional templates, parametrized sheets, and mapping through separate compatibility milestones.
73
+
2.**Advanced templates and Fluent Mapping**: add grouped templates, richer conditional expressions, parametrized sheets, and mapping through separate compatibility milestones.
73
74
3.**Selected-sheet cloning**: not part of .NET `CopyAndAddSheet`; add only for a concrete Rust use case with a relationship-closure cloning contract.
74
75
75
76
DataReader/DataTable are .NET ecosystem abstractions and are intentionally not literal Rust parity requirements. A Rust-native record-batch or tabular adapter is appropriate only when a concrete integration requires it.
0 commit comments