repolho 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e241b0d81fce8a3b55de4dbf8eccfe3e34a72a95020fd6098bb501a2434257fe
-  data.tar.gz: ebb7296a6025cd82acb5461863f7599f52cfb8494184adc29fd6888004584e23
+  metadata.gz: 2947412a1701b9659d7abb8c24137db2bf71245dcd17dc6c7f2bc5524602e646
+  data.tar.gz: 8bb7baf19c2dff982915c782ddb45699b9b134cb841ca23d5712feca21a019d7
 SHA512:
-  metadata.gz: 773100dbaed0b7d43c0b8ca8139fcbd7c925ef18515ef39d89e8131f3738bfc4edb8070188a64c40cea5ea03532d4b07f1dcfe57ac66890b88954735b1b22a51
-  data.tar.gz: 97150a6758cd926f08efbe920d5be2013cbf5e92d77f4768947086ceb0e333bb0fabe187bf624127a2417f3ed2b99f4cf233dc84029361e5e87dc857e12525ee
+  metadata.gz: dc19d0a464fc9abe19eabcb06ea687b4ead5f401165a137f29ba76d6d3d7f8db422bf749e8627f3054357f93cd04928d928054b2ea2d5bcda4e64de303074122
+  data.tar.gz: 263caa4a89a5fe552b484dc36e4cee55600ce5d63f21c2d279d29e35c8ebb28cb75cc557a574db332a0435431ec49d965f621bbb9313dd6f6c659d2311b208ee

data/README.md

@@ -64,6 +64,37 @@ sections). Everything inside the custom elements is processed as ERB.
 | `<report-header>` | Header of the current container | — |
 | `<report-footer>` | Footer of the current container | — |
 | `<report-row>` | Template for each data row (inside the innermost group) | — |
+| `<report-last-page>` | Optional block rendered only at the end of the report, as additional rows on the last page. Counts toward the page row limit and can force a page break. | — |
+
+### Last page content (`<report-last-page>`)
+
+Optional element that is rendered **only after all data rows** have been processed.  
+Its content is injected as normal rows into the page flow, so:
+
+- It counts toward the `rows` limit of `<report-page>`.
+- If it does not fit on the current page, a new page is opened automatically.
+- The page footer of the final page is rendered **after** this block.
+
+Because the block is only ever emitted at the end, you do not need to check `last_page?` inside it.
+
+Example:
+
+```html
+<report>
+  <report-page rows="40">
+    <report-header>...</report-header>
+    <report-row>...</report-row>
+    <report-footer>
+      <tr><td>Page <%= page_number %></td></tr>
+    </report-footer>
+  </report-page>
+
+  <report-last-page>
+    <tr><td colspan="5">Final notes and signature</td></tr>
+    <tr><td colspan="5">______________________________</td></tr>
+  </report-last-page>
+</report>
+```
 
 ### Allowed HTML inside page content
 

data/lib/repolho/main.rb

@@ -79,6 +79,7 @@ module Repolho
       @pagination  = false
       @orientation = nil
       @paper       = nil
+      @last_page_template = nil
       @pagination_labels = {
         first: "First",
         prev:  "<",
@@ -104,6 +105,8 @@ module Repolho
         @report.call(:row, row)
       end
 
+      inject_last_page_content
+
       @report.call(:finish, nil)
       @page.finalize
 
@@ -140,6 +143,16 @@ module Repolho
 
     private
 
+    def inject_last_page_content
+      return if @last_page_template.nil? || @last_page_template.strip.empty?
+
+      @page.mark_as_last!
+      rendered = render_erb(@last_page_template)
+      @page.inject_as_rows(rendered)
+      # Page footer is rendered later by the normal :finish path,
+      # after any remaining group footers.
+    end
+
     def inject_pagination_labels
       @page.instance_variable_set(:@pagination_first, @pagination_labels[:first])
       @page.instance_variable_set(:@pagination_prev,  @pagination_labels[:prev])
@@ -247,6 +260,9 @@ module Repolho
 
       build_page(report)
       build_groups(report)
+
+      last_page = report.search("report-last-page").first
+      @last_page_template = last_page.inner_html if last_page
     end
 
     def build_page(report)

data/lib/repolho/page.rb

@@ -14,6 +14,7 @@ module Repolho
       @row_number  = 1
       @page_number = 1
       @page_open   = false
+      @last_page   = false
     end
 
     def rows=(number)
@@ -21,6 +22,27 @@ module Repolho
       @valid_rows = @rows
     end
 
+    def last_page?
+      @last_page
+    end
+
+    def mark_as_last!
+      @last_page = true
+    end
+
+    # Injects pre-rendered HTML (expected to contain <tr>s) as additional rows.
+    # Each <tr> is appended individually so normal page-break logic applies.
+    def inject_as_rows(html)
+      return if html.nil? || html.strip.empty?
+
+      Nokogiri::HTML(html).search("tr").each do |tr|
+        check_page_break
+        # After a break, status is FINISHED; reopen so later :finish can still emit the footer
+        @status = STARTED if @status == FINISHED
+        self << tr.to_html
+      end
+    end
+
     def <<(content)
       return unless content
 

data/lib/repolho/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Repolho
-  VERSION = "0.1.6"
+  VERSION = "0.1.7"
 end

data/test/main_test.rb

@@ -370,6 +370,38 @@ module Repolho
       refute_includes columns, "state"
     end
 
+    def test_last_page_content_is_injected_and_counts_as_rows
+      template_html = <<~HTML
+        <!DOCTYPE html>
+        <html><body>
+          <table>
+            <report>
+              <report-page rows="3">
+                <report-header><tr><th>H</th></tr></report-header>
+                <report-row><tr><td><%= attr(:id) %></td></tr></report-row>
+                <report-footer><tr><td>F</td></tr></report-footer>
+              </report-page>
+              <report-last-page>
+                <tr><td>LAST BLOCK LINE 1</td></tr>
+                <tr><td>LAST BLOCK LINE 2</td></tr>
+              </report-last-page>
+            </report>
+          </table>
+        </body></html>
+      HTML
+      template = write_temp_template(template_html)
+      main = Main.new(template.path, @data)  # 3 rows
+      main.run
+      html = main.content.join
+
+      assert_includes html, "LAST BLOCK LINE 1"
+      assert_includes html, "LAST BLOCK LINE 2"
+      # Should have caused a page break because 3 data + 2 last = more than rows=3
+      assert_operator html.scan(/repolho-page/).size, :>=, 2
+    ensure
+      template&.unlink
+    end
+
     def test_page_number_available_in_after_erb
       after_erb = <<~HTML
         <!DOCTYPE html>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: repolho
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Eustáquio Rangel