repolho 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9efc21c49b8e192f0a25b4fd4565e3c503ac68fc3a392e06702490707015ddd
-  data.tar.gz: 46d1538f52bffb72d9cbdbe65cd698bbc68665aceb106a377c35e834866bb5e2
+  metadata.gz: 3e44c3e92b2bf34c0785294e65149968cc4f8ce0c5dd1eabd4eebdb9f200340e
+  data.tar.gz: 4ec8fc094c8da9d07d1cac32ef07ab41908c47cb95419db424c4d8a1c9dc611a
 SHA512:
-  metadata.gz: a6d7d7cd30223e35a25f0d5b67c25d66466cb3c1ea472795d5b440ea3193542df3b853842988aa9cde1e776cff1b17fd9c4974a19363866d5eabbe9ac453ab63
-  data.tar.gz: 4f881bf9c547e9b947829e1256546f6512eff796573e23026294a507e2e6e24e3b7956b52b47efe781556fe4e81ca9dd922e60b844fda5fe91e7e1accc01eedf
+  metadata.gz: b422a100451181e9b6bf1f96cf1fa4255be8c854677e6cb214f1149a175f464990d3b3064e3512c682cad13a8d63f191d347cac92850c5ad62bed1e458584bd9
+  data.tar.gz: f73bc63146708f0ec37c71f5e402c39c0eadec437d6a70f784e23e1bd5b36d46f98b3b011a01f09f995ed8eca3f06ce3cd8aebfa927fe9925c16ac9ce1532fd5

data/README.md

@@ -58,7 +58,7 @@ sections). Everything inside the custom elements is processed as ERB.
 
 | Element | Purpose | Attributes |
 |---------|---------|------------|
-| `<report>` | Root container of the report | — |
+| `<report>` | Root container of the report | `pagination` (optional, `"true"`): enables client-side page navigation. Also accepts `pagination-first`, `pagination-prev`, `pagination-next`, `pagination-last` for custom labels. |
 | `<report-page>` | Defines a page (required, only one) | `rows` (required): max data rows per page |
 | `<report-group>` | Nested grouping | `id` (required), `attr` (required), `reprint-header-on-page-break` (optional, `"true"`) |
 | `<report-header>` | Header of the current container | — |
@@ -95,6 +95,56 @@ Repolho automatically wraps each page like this:
 The `data-page` attribute and the `break-after` style are injected for you.
 You do not need to write the `<tbody>` yourself.
 
+### Client-side pagination
+
+If you set `pagination="true"` on the root `<report>` element, Repolho
+appends a navigation bar just before the `after` section (still inside
+the table) and a small pure-ES6 script at the end of the document
+(inserted before `</body>` when present, otherwise appended). The bar
+is omitted when the report has only one page.
+
+Optional attributes let you customize the labels:
+
+| Attribute | Default | Description |
+|-----------|---------|-------------|
+| `pagination-first` | `First` | First page link text |
+| `pagination-prev` | `<` | Previous page link text |
+| `pagination-next` | `>` | Next page link text |
+| `pagination-last` | `Last` | Last page link text |
+
+```html
+<report pagination="true"
+        pagination-first="Primeira"
+        pagination-prev="«"
+        pagination-next="»"
+        pagination-last="Última">
+  ...
+</report>
+```
+
+The generated controls look like:
+
+```html
+<tbody id="report-pagination" data-max="N">
+  <tr>
+    <td colspan="200" id="report-pagination-links">
+      <a href="#" id="report-first-page">First</a>
+      <a href="#" id="report-prev-page"><</a>
+      <input type="number" id="report-current-page" min="1" max="N" value="1"/>
+      <a href="#" id="report-next-page">></a>
+      <a href="#" id="report-last-page">Last</a>
+    </td>
+  </tr>
+</tbody>
+```
+
+You can restyle the links and the input with normal CSS. The script is
+wrapped in try/catch so a failure does not break the rest of the page.
+
+When pagination is enabled, `page_number` (available in ERB) holds the
+total number of pages after the report has been fully generated.
+
+
 ### Template example
 
 ```erb

data/lib/repolho/main.rb

@@ -6,19 +6,83 @@ require_relative "report"
 require_relative "stats"
 require "nokogiri"
 require "erb"
+require "cgi"
 
 module Repolho
   class Main
+    PAGINATION_TBODY = <<~HTML
+      <tbody id="report-pagination" data-max="<%= page_number %>">
+        <tr>
+          <td colspan="200" id="report-pagination-links">
+            <a href="#" id="report-first-page"><%= @pagination_first %></a>
+            <a href="#" id="report-prev-page"><%= @pagination_prev %></a>
+            <input type="number" id="report-current-page" min="1" max="<%= page_number %>" value="1"/>
+            <a href="#" id="report-next-page"><%= @pagination_next %></a>
+            <a href="#" id="report-last-page"><%= @pagination_last %></a>
+          </td>
+        </tr>
+      </tbody>
+    HTML
+
+    PAGINATION_SCRIPT = <<~HTML
+      <script>
+        function change_report_page(page) {
+          try {
+            const pages = document.querySelectorAll(".repolho-page");
+            page = parseInt(page, 10);
+            if (isNaN(page) || page < 1) page = 1;
+            if (page > pages.length) page = pages.length;
+
+            pages.forEach(function(p) { p.style.display = "none"; });
+            var target = document.querySelector('[data-page="' + page + '"]');
+            if (target) target.style.display = "";
+
+            var input = document.getElementById("report-current-page");
+            if (input) input.value = page;
+          } catch (e) {
+            console.error("Repolho pagination error:", e);
+          }
+        }
+
+        document.addEventListener("DOMContentLoaded", function() {
+          try {
+            var first = document.getElementById("report-first-page");
+            var prev  = document.getElementById("report-prev-page");
+            var next  = document.getElementById("report-next-page");
+            var last  = document.getElementById("report-last-page");
+            var input = document.getElementById("report-current-page");
+
+            if (first) first.addEventListener("click", function(e) { e.preventDefault(); change_report_page(1); });
+            if (prev)  prev.addEventListener("click",  function(e) { e.preventDefault(); change_report_page(parseInt(input && input.value || 1, 10) - 1); });
+            if (next)  next.addEventListener("click",  function(e) { e.preventDefault(); change_report_page(parseInt(input && input.value || 1, 10) + 1); });
+            if (last)  last.addEventListener("click",  function(e) { e.preventDefault(); change_report_page(9999); });
+            if (input) input.addEventListener("change", function(e) { change_report_page(e.target.value); });
+
+            change_report_page(1);
+          } catch (e) {
+            console.error("Repolho pagination init error:", e);
+          }
+        });
+      </script>
+    HTML
+
     def initialize(path, data, locals = {})
-      @path     = path
-      @data     = normalize_data(data)
-      @locals   = locals
-      @columns  = make_columns
-      @page     = Page.new("page", locals, make_stats)
-      @report   = Report.new("report", locals, make_stats)
-      @previous = ""
-      @after    = ""
-      @body     = ""
+      @path        = path
+      @data        = normalize_data(data)
+      @locals      = locals
+      @columns     = make_columns
+      @page        = Page.new("page", locals, make_stats)
+      @report      = Report.new("report", locals, make_stats)
+      @previous    = ""
+      @after       = ""
+      @body        = ""
+      @pagination  = false
+      @pagination_labels = {
+        first: "First",
+        prev:  "<",
+        next:  ">",
+        last:  "Last"
+      }
 
       @report.containers << @page
       @report.page = @page
@@ -39,12 +103,39 @@ module Repolho
       end
 
       @report.call(:finish, nil)
-      @page.append_raw(render_erb(@after))
       @page.finalize
+
+      # After finalize, page_number is one past the last page.
+      # Set it to the real total so ERB (pagination + @after) sees the correct value.
+      total_pages = [@page.page_number - 1, 1].max
+      @page.instance_variable_set(:@page_number, total_pages)
+
+      after_content = render_erb(@after)
+
+      if @pagination && total_pages > 1
+        inject_pagination_labels
+        @page.append_raw(render_erb(PAGINATION_TBODY))
+
+        script = PAGINATION_SCRIPT
+        if after_content =~ /<\/body>/i
+          after_content = after_content.sub(/<\/body>/i, "#{script}</body>")
+        else
+          after_content += script
+        end
+      end
+
+      @page.append_raw(after_content)
     end
 
     private
 
+    def inject_pagination_labels
+      @page.instance_variable_set(:@pagination_first, @pagination_labels[:first])
+      @page.instance_variable_set(:@pagination_prev,  @pagination_labels[:prev])
+      @page.instance_variable_set(:@pagination_next,  @pagination_labels[:next])
+      @page.instance_variable_set(:@pagination_last,  @pagination_labels[:last])
+    end
+
     def make_columns
       return [] if @data.empty?
 
@@ -94,11 +185,11 @@ module Repolho
     end
 
     def extract_sections(content)
-      matches = content.gsub(/\n/, "").match(/(?<previous>\A.*?)(?<body><body[^>]*>.*?)(?<report><report>.*?<\/report>)(?<after>.*)\z/m)
+      matches = content.gsub(/\n/, "").match(/(?<previous>\A.*?)(?<body><body[^>]*>.*?)(?<report><report[^>]*>.*?<\/report>)(?<after>.*)\z/m)
 
-      @body     = matches[:body]
-      @previous = matches[:previous]
-      @after    = matches[:after]
+      @body       = matches[:body]
+      @previous   = matches[:previous]
+      @after      = matches[:after]
       @report_xml = matches[:report]
     end
 
@@ -106,6 +197,19 @@ module Repolho
       parsed = Nokogiri::HTML.parse(@report_xml)
       report = parsed.search("report")
 
+      report_node = report.first
+      @pagination = report_node["pagination"] == "true"
+
+      if @pagination
+        @pagination_labels[:first] = report_node["pagination-first"] if report_node["pagination-first"]
+        @pagination_labels[:prev]  = report_node["pagination-prev"]  if report_node["pagination-prev"]
+        @pagination_labels[:next]  = report_node["pagination-next"]  if report_node["pagination-next"]
+        @pagination_labels[:last]  = report_node["pagination-last"]  if report_node["pagination-last"]
+
+        # Escape for safe HTML output
+        @pagination_labels.transform_values! { |v| CGI.escapeHTML(v.to_s) }
+      end
+
       @report.header = info(report.search("> report-header").first)
       @report.footer = info(report.search("> report-footer").first)
 

data/lib/repolho/version.rb

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

metadata

@@ -1,11 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: repolho
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Eustáquio Rangel
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -36,7 +35,7 @@ cert_chain:
   L0XcRn7yJijWxXFMBrnwp/4PHjPT0l6Qci+zxGly0D7LCTHa5WSyWujq4BZw55Yp
   G13dwkTphaMB
   -----END CERTIFICATE-----
-date: 2026-10-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -77,7 +76,6 @@ licenses:
 metadata:
   homepage_uri: https://github.com/taq/repolho
   source_code_uri: https://github.com/taq/repolho
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -92,8 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Report generator for Ruby and Rails from .rep.erb templates
 test_files: []