xlsx_composer 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb4ddd7e108efe7858b8c3ef358a003e9a0b5d94f3be1500aacee95cd7c9c9ca
-  data.tar.gz: ff4408f5e1a9edf7fdbcaf9eeb9d935cb6e907fdddb80e12e5310395e0fd0521
+  metadata.gz: e8a8b859d4ff8cf802aeb76d3e69f3393ed64663a7f849ed1b4a3792840b1970
+  data.tar.gz: 5ca4e3c5b0655a7c5afa666cb68a32396822606eddb18852478642a3565b24f4
 SHA512:
-  metadata.gz: ac1e35c9a14f3d0a8ea9f6cf9f4b61b2d7cba0dee6d21885676a205f748c9d72ab735b04fb4af9bfb3b782865d2ee5b933e7b90505c1cb4b6ef28a917b09ffdc
-  data.tar.gz: 1bf88f371a14a58e2160958fbf4518204d4c9ac724ec7460aedd4eef636edb11b66f6b3ba6e9909e1c08f1e4d405e794942b59aa57e5de2f1c0a12b0e62f77ca
+  metadata.gz: 697eac8a82072c7768bbf34d4d2aa4b28f9b2052e7cbdc1e88d419b100a7b34009e6530eaff8d2f37e27ce87f335aefa5f6e7bd89503d3a4d5aff97663458fb2
+  data.tar.gz: 72b044903424f8a6e5ec198d8966925c53612c92689b47d7d0dd4a576038bd66b27ccee4ecd0b1278ac9bdcb64db91e1c579a5f70eb18f85b9a673c27378bfae

data/CHANGELOG.md

@@ -5,3 +5,8 @@
 - Cursor-based navigation helpers (`go_to`, `next_row`, `next_col`, etc.).
 - Built-in reusable formats and per-class custom formats via `add_format`.
 - Base composer class for worksheet templates.
+
+## [0.1.1] - 2026-02-06
+
+- Fixed a missing argument in the `bold_rotation_ninety` format definition.
+- Exposed `composer_worksheet` reader on `XlsxComposer::Base` to allow safe composition of multiple services writing to the same worksheet.

data/README.md

@@ -1,6 +1,6 @@
 # XlsxComposer
 
-**XlsxComposer** is a small Ruby library built on top of **WriteXLSX** that makes the creation of **complex and dynamic Excel spreadsheets** easier, more readable, and more maintainable.
+**XlsxComposer** is a small Ruby library built on top of **WriteXLSX** that makes the creation of **complex and dynamic Excel spreadsheets** easier, more readable, and more maintainable through cursor-based navigation and composition.
 
 It does **not** try to replace WriteXLSX.  
 Instead, it provides a higher-level abstraction focused on **navigation, composition, and formatting**, which are usually the hardest parts when spreadsheets stop being static.
@@ -118,6 +118,81 @@ end
 The same template works regardless of how many years the contract has.
 
 
+## Composing a worksheet using multiple templates
+
+For more complex spreadsheets, it is common to split a single worksheet into
+multiple logical sections, each one handled by a dedicated service or template.
+
+XlsxComposer supports this by allowing multiple composers to write into the
+same worksheet instance.
+
+### Orchestrating a worksheet
+
+The main composer is responsible for creating the worksheet and coordinating
+the order in which sections are written.
+
+```ruby
+class ReportWorksheet < XlsxComposer::Base
+  def initialize(workbook, report)
+    @report = report
+    super(workbook: workbook)
+  end
+
+  def worksheet_name
+    "Report"
+  end
+
+  def run
+    write_header
+    write_summary
+    write_details
+  end
+
+  private
+
+  attr_reader :report
+
+  def write_header
+    HeaderSection.new(composer_worksheet, report).run
+  end
+
+  def write_summary
+    SummarySection.new(composer_worksheet, report).run
+  end
+
+  def write_details
+    DetailsSection.new(composer_worksheet, report).run
+  end
+end
+```
+
+### Writing a section using an existing worksheet
+
+Each section receives the same `XlsxComposer::Worksheet` instance and writes
+to it using the same cursor-based API.
+
+```ruby
+class HeaderSection < XlsxComposer::Base
+  def initialize(worksheet, report)
+    @report = report
+    super(worksheet: worksheet)
+  end
+
+  def run
+    go_to("1", "A")
+    write_row(["Report title"], bold)
+
+    next_row
+    write_row([report.title])
+  end
+
+  private
+
+  attr_reader :report
+end
+```
+
+
 ## Formatting
 
 ### Built-in formats

data/lib/xlsx_composer/base.rb

@@ -27,6 +27,8 @@ module XlsxComposer
       end
     end
 
+    attr_reader :composer_worksheet
+
     def initialize(workbook: nil, worksheet: nil)
       raise ArgumentError, "Provide workbook: or worksheet:" if workbook.nil? && worksheet.nil?
 
@@ -50,8 +52,6 @@ module XlsxComposer
 
     private
 
-    attr_reader :composer_worksheet
-
     def define_class_formats!
       self.class.extra_formats.each do |name, spec|
         args = spec.is_a?(Proc) ? instance_exec(&spec) : spec

data/lib/xlsx_composer/formatter.rb

@@ -10,7 +10,7 @@ module XlsxComposer
 
     def bold_percent = format(:percent_bold, bold: 1, num_format: "0%")
 
-    def bold_rotation_ninety = format(bold: 1, rotation: 90, align: "vcenter")
+    def bold_rotation_ninety = format(:bold_rotation_ninety, bold: 1, rotation: 90, align: "vcenter")
 
     def thousands_mark = format(:thousands_mark, num_format: "#,##0")
 

data/lib/xlsx_composer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module XlsxComposer
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xlsx_composer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Hugo Passos
@@ -94,5 +94,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.3
 specification_version: 4
-summary: A composition layer on top of WriteXLSX for dynamic spreadsheets
+summary: A cursor-based composition layer on top of WriteXLSX for dynamic Excel spreadsheets
 test_files: []