liquid_xlsx 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cdc976c8086895374758eae13fd1006379ffd15f37e3cad03cff012be6986065
+  data.tar.gz: de8e167af7057eb7dfad00991610a3171a30a13b67ed2eda1fa43b1f00bd9358
+SHA512:
+  metadata.gz: c36433b43abf4b17f5a0fdbdcab009f6fb2a2d6d18c5c1c517c99a02f8a0207be1b3d3c2ba37187f57d96e1279083450666a3036d9281e5e7f9c3fa0f734ab34
+  data.tar.gz: 7c8f204d3284aba334ed3f942b0ee34ac3dde5953ad413d8a9847c5d6b588f1aaf754a82f0ada0cf15af0958b15bb3330f4ad49c917cb20644da4cbc3ff75b1b

data/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+## 0.1.0 (2026-08-04)
+
+First public release.
+
+### Templates
+
+- Inline Liquid variable rendering
+- Row-level `{% for %}` / `{% endfor %}` loops, with `for/else` for empty loops
+- Row-level `{% if %}` / `{% elsif %}` / `{% else %}` / `{% endif %}` conditions
+- Nested `for` and `if` blocks
+- In-cell `{% if %}`, `{% unless %}`, `{% case %}`
+- A single Liquid context per worksheet, so `{% assign %}` / `{% capture %}`
+  in one cell is visible in later cells
+- Loop variables and `{% assign %}` shadow same-named top-level data keys,
+  matching Liquid scope semantics
+
+### Workbook fidelity
+
+- Formula row shifting inside loops and total range expansion after loops
+- Merged cells preservation and shifting
+- Cell style preservation, multi-sheet support
+- Shared strings reading; rendered text is written as `inlineStr`
+- Cell type preservation: numbers and booleans stay numeric in Excel
+
+### Structure-generating tags
+
+- `{% sheet %}` — dynamic sheets generated from data, including when the
+  global `data` is a Drop or a `#to_liquid` object (the per-op local variable
+  is injected through a dedicated `extra_scope` channel)
+- `{% image_tag %}` — PNG, JPEG and GIF images with EMU sizing and SHA dedup
+
+### Data
+
+- `data:` accepts a `Hash`, a `Liquid::Drop`, or any object responding to
+  `#to_liquid` (returning a Hash/Drop). Numeric/Boolean methods of a Drop keep
+  Excel cell types, so formulas and number formats continue to work.
+  `Integer`, `Float`, and `BigDecimal` are written as numeric `<v>`;
+  `Rational`, `Complex`, and non-finite `Float` fall back to string rendering
+  (they are not valid OOXML numeric lexemes).
+
+### Options and errors
+
+- `recalculate_formulas`, `strict_variables`, `strict_filters`,
+  `dynamic_sheets`, `hide_control_sheets`, `hide_template_sheets`,
+  `remove_template_comments`, `images`, `liquid_resource_limits`
+- Object API (`LiquidXlsx::Template`)
+- Errors carry sheet/row/cell context. `Liquid::UndefinedVariable` and
+  `Liquid::UndefinedDropMethod` are re-raised as `MissingVariableError` in all
+  render paths (`{{ }}`, `{% if %}`, `{% sheet %}`, `{% image_tag %}`).
+
+### Compatibility
+
+- Ruby >= 3.1
+- rubyzip 2.x and 3.x (rubyzip 3 removed `Zip::File::CREATE`; the archive is
+  opened with whichever form the installed major supports)
+- Liquid >= 5.4, < 6; Nokogiri >= 1.14, < 2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ivan Khlipitkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.