RubyGems - pagy - Versions diffs - 3.8.2 → 9.4.0 - Mend

pagy 3.8.2 → 9.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (152) hide show

checksums.yaml +4 -4
data/LICENSE.txt +1 -1
data/apps/calendar.ru +737 -0
data/apps/demo.ru +449 -0
data/apps/index.rb +7 -0
data/apps/keyset_ar.ru +228 -0
data/apps/keyset_s.ru +220 -0
data/apps/rails.ru +217 -0
data/apps/repro.ru +182 -0
data/bin/pagy +98 -0
data/config/pagy.rb +220 -0
data/javascripts/pagy.d.ts +5 -0
data/javascripts/pagy.min.js +4 -0
data/javascripts/pagy.min.js.map +10 -0
data/javascripts/pagy.mjs +100 -0
data/lib/optimist.rb +1022 -0
data/lib/pagy/b64.rb +33 -0
data/lib/pagy/backend.rb +30 -19
data/lib/pagy/calendar/day.rb +41 -0
data/lib/pagy/calendar/month.rb +42 -0
data/lib/pagy/calendar/quarter.rb +49 -0
data/lib/pagy/calendar/unit.rb +103 -0
data/lib/pagy/calendar/week.rb +39 -0
data/lib/pagy/calendar/year.rb +35 -0
data/lib/pagy/calendar.rb +84 -0
data/lib/pagy/console.rb +23 -0
data/lib/pagy/countless.rb +27 -22
data/lib/pagy/exceptions.rb +16 -13
data/lib/pagy/extras/arel.rb +11 -14
data/lib/pagy/extras/array.rb +12 -16
data/lib/pagy/extras/bootstrap.rb +83 -41
data/lib/pagy/extras/bulma.rb +79 -46
data/lib/pagy/extras/calendar.rb +79 -0
data/lib/pagy/extras/countless.rb +20 -25
data/lib/pagy/extras/elasticsearch_rails.rb +59 -38
data/lib/pagy/extras/gearbox.rb +55 -0
data/lib/pagy/extras/headers.rb +38 -23
data/lib/pagy/extras/i18n.rb +19 -18
data/lib/pagy/extras/js_tools.rb +70 -0
data/lib/pagy/extras/jsonapi.rb +88 -0
data/lib/pagy/extras/keyset.rb +30 -0
data/lib/pagy/extras/limit.rb +63 -0
data/lib/pagy/extras/meilisearch.rb +57 -0
data/lib/pagy/extras/metadata.rb +32 -27
data/lib/pagy/extras/overflow.rb +61 -53
data/lib/pagy/extras/pagy.rb +82 -0
data/lib/pagy/extras/searchkick.rb +52 -41
data/lib/pagy/extras/size.rb +40 -0
data/lib/pagy/extras/standalone.rb +60 -0
data/lib/pagy/extras/trim.rb +19 -13
data/lib/pagy/frontend.rb +76 -51
data/lib/pagy/i18n.rb +167 -0
data/lib/pagy/keyset/active_record.rb +44 -0
data/lib/pagy/keyset/sequel.rb +57 -0
data/lib/pagy/keyset.rb +118 -0
data/lib/pagy/shared_methods.rb +26 -0
data/lib/pagy/url_helpers.rb +26 -0
data/lib/pagy.rb +91 -37
data/locales/ar.yml +29 -0
data/locales/be.yml +25 -0
data/locales/bg.yml +21 -0
data/locales/bs.yml +25 -0
data/locales/ca.yml +21 -0
data/locales/ckb.yml +18 -0
data/locales/cs.yml +23 -0
data/locales/da.yml +21 -0
data/locales/de.yml +21 -0
data/locales/dz.yml +17 -0
data/locales/en.yml +21 -0
data/{lib/locales → locales}/es.yml +11 -12
data/locales/fr.yml +21 -0
data/locales/hr.yml +25 -0
data/locales/id.yml +19 -0
data/locales/it.yml +21 -0
data/locales/ja.yml +19 -0
data/locales/km.yml +19 -0
data/locales/ko.yml +17 -0
data/locales/nb.yml +21 -0
data/locales/nl.yml +21 -0
data/locales/nn.yml +21 -0
data/locales/pl.yml +25 -0
data/{lib/locales → locales}/pt-BR.yml +11 -12
data/locales/pt.yml +21 -0
data/locales/ru.yml +25 -0
data/locales/sk.yml +23 -0
data/locales/sr.yml +25 -0
data/locales/sv-SE.yml +21 -0
data/locales/sv.yml +21 -0
data/locales/sw.yml +25 -0
data/locales/ta.yml +21 -0
data/locales/tr.yml +19 -0
data/locales/uk.yml +25 -0
data/locales/vi.yml +17 -0
data/locales/zh-CN.yml +17 -0
data/locales/zh-HK.yml +17 -0
data/locales/zh-TW.yml +17 -0
data/stylesheets/pagy.css +46 -0
data/stylesheets/pagy.scss +48 -0
data/stylesheets/pagy.tailwind.css +21 -0
metadata +95 -67
data/lib/config/pagy.rb +0 -170
data/lib/javascripts/pagy.js +0 -106
data/lib/locales/README.md +0 -35
data/lib/locales/bg.yml +0 -22
data/lib/locales/ca.yml +0 -22
data/lib/locales/da.yml +0 -22
data/lib/locales/de.yml +0 -22
data/lib/locales/en.yml +0 -22
data/lib/locales/fr.yml +0 -22
data/lib/locales/id.yml +0 -20
data/lib/locales/it.yml +0 -22
data/lib/locales/ja.yml +0 -20
data/lib/locales/km.yml +0 -19
data/lib/locales/ko.yml +0 -20
data/lib/locales/nb.yml +0 -22
data/lib/locales/nl.yml +0 -22
data/lib/locales/pl.yml +0 -24
data/lib/locales/ru.yml +0 -24
data/lib/locales/sv-SE.yml +0 -23
data/lib/locales/sv.yml +0 -23
data/lib/locales/tr.yml +0 -20
data/lib/locales/utils/i18n.rb +0 -25
data/lib/locales/utils/loader.rb +0 -34
data/lib/locales/utils/p11n.rb +0 -80
data/lib/locales/zh-CN.yml +0 -20
data/lib/locales/zh-HK.yml +0 -20
data/lib/locales/zh-TW.yml +0 -20
data/lib/pagy/extras/foundation.rb +0 -57
data/lib/pagy/extras/items.rb +0 -65
data/lib/pagy/extras/materialize.rb +0 -59
data/lib/pagy/extras/navs.rb +0 -38
data/lib/pagy/extras/pagy_search.rb +0 -18
data/lib/pagy/extras/semantic.rb +0 -55
data/lib/pagy/extras/shared.rb +0 -53
data/lib/pagy/extras/support.rb +0 -29
data/lib/pagy/extras/uikit.rb +0 -62
data/lib/templates/bootstrap_nav.html.erb +0 -24
data/lib/templates/bootstrap_nav.html.haml +0 -34
data/lib/templates/bootstrap_nav.html.slim +0 -34
data/lib/templates/bulma_nav.html.erb +0 -24
data/lib/templates/bulma_nav.html.haml +0 -32
data/lib/templates/bulma_nav.html.slim +0 -32
data/lib/templates/foundation_nav.html.erb +0 -24
data/lib/templates/foundation_nav.html.haml +0 -34
data/lib/templates/foundation_nav.html.slim +0 -34
data/lib/templates/nav.html.erb +0 -22
data/lib/templates/nav.html.haml +0 -30
data/lib/templates/nav.html.slim +0 -29
data/lib/templates/uikit_nav.html.erb +0 -15
data/lib/templates/uikit_nav.html.haml +0 -28
data/lib/templates/uikit_nav.html.slim +0 -28
data/pagy.gemspec +0 -16

data/apps/demo.ru ADDED Viewed

@@ -0,0 +1,449 @@
+# frozen_string_literal: true
+# DESCRIPTION
+#    Showcase all the helpers and styles
+#
+# DOC
+#    https://ddnexus.github.io/pagy/playground/#3-demo-app
+#
+# BIN HELP
+#    bundle exec pagy -h
+#
+# DEMO USAGE
+#    bundle exec pagy demo
+#
+# DEV USAGE
+#    bundle exec pagy clone demo
+#    bundle exec pagy ./demo.ru
+#
+# URL
+#    http://0.0.0.0:8000
+VERSION = '9.4.0'
+# Bundle
+require 'bundler/inline'
+require 'bundler'
+Bundler.configure
+gemfile(ENV['PAGY_INSTALL_BUNDLE'] == 'true') do
+  source 'https://rubygems.org'
+  gem 'oj'
+  gem 'puma'
+  gem 'rouge'
+  gem 'sinatra'
+end
+# pagy initializer
+STYLES = { pagy:        { extra: 'pagy', prefix: '', css_anchor: 'pagy-scss' },
+           bootstrap:   {},
+           bulma:       {},
+           tailwind:    { extra: 'pagy', prefix: '', css_anchor: 'pagy-tailwind-css' } }.freeze
+STYLES.each_key do |style|
+  require "pagy/extras/#{STYLES[style][:extra] || style}"
+end
+require 'pagy/extras/limit'
+require 'pagy/extras/trim'
+Pagy::DEFAULT[:trim_extra] = false         # opt-in trim
+# Sinatra setup
+require 'sinatra/base'
+# Sinatra application
+class PagyDemo < Sinatra::Base
+  include Pagy::Backend
+  get '/' do
+    redirect '/pagy'
+  end
+  get '/template' do
+    collection = MockCollection.new
+    @pagy, @records = pagy(collection, trim_extra: params['trim'])
+    erb :template, locals: { pagy: @pagy, style: 'pagy' }
+  end
+  get('/javascripts/:file') do
+    format = params[:file].split('.').last
+    if format == 'js'
+      content_type 'application/javascript'
+    elsif format == 'map'
+      content_type 'application/json'
+    end
+    send_file Pagy.root.join('javascripts', params[:file])
+  end
+  get('/stylesheets/:file') do
+    content_type 'text/css'
+    send_file Pagy.root.join('stylesheets', params[:file])
+  end
+  # One route/action per style
+  STYLES.each_key do |style|
+    prefix = STYLES[style][:prefix] || "_#{style}"
+    get("/#{style}/?:trim?") do
+      collection = MockCollection.new
+      @pagy, @records = pagy(collection, trim_extra: params['trim'])
+      erb :helpers, locals: { style:, prefix: }
+    end
+  end
+  helpers do
+    include Pagy::Frontend
+    def style_menu
+      html = +%(<div id="style-menu"> )
+      STYLES.each_key { |style| html << %(<a href="/#{style}">#{style}</a>) }
+      html << %(<a href="/template">template</a>)
+      html << %(</div>)
+    end
+    def highlight(html, format: :html)
+      if format == :html
+        html = html.gsub(/>[\s]*</, '><').strip # template single line no spaces around/between tags
+        html = Formatter.new.format(html)
+      end
+      lexer     = Rouge::Lexers::ERB.new
+      formatter = Rouge::Formatters::HTMLInline.new('monokai.sublime')
+      summary   = { html: 'Served HTML (pretty formatted)', erb: 'ERB Template' }
+      %(<details><summary>#{summary[format]}</summary><pre>\n#{
+         formatter.format(lexer.lex(html))
+      }</pre></details>)
+    end
+  end
+  # Views
+  template :layout do
+    <<~'ERB'
+      <!DOCTYPE html>
+      <html lang="en">
+      <head>
+        <title>Pagy Demo App</title>
+        <script src="/javascripts/pagy.min.js"></script>
+        <script>
+          window.addEventListener("load", Pagy.init);
+        </script>
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <%= erb :"#{style}_head" if defined?(style) %>
+        <style type="text/css">
+          @media screen { html, body {
+            font-size: 1rem;
+            line-height: 1.2s;
+            padding: 0;
+            margin: 0;
+          } }
+          body {
+            background: white !important;
+            margin: 0 !important;
+            font-family: sans-serif !important;
+          }
+          h1, h2 {
+            font-size: 1.8rem !important;
+            font-weight: 600 !important;
+            margin-top: 1rem !important;
+            margin-bottom: 0.7rem !important;
+            line-height: 1.5 !important;
+            color: rgb(90 90 90)  !important;
+          }
+          h2 {
+            font-family: monospace;
+            font-size: .9rem !important;
+            margin-top: 1.6rem !important;
+          }
+          summary, .notes {
+            font-size: .8rem;
+            color: gray;
+            margin-top: .6rem;
+            font-style: italic;
+            cursor: pointer;
+          }
+          .notes {
+            font-family: sans-serif;
+            font-weight: normal;
+          }
+          .notes code{
+            background-color: #E8E8E8;
+            padding: 0 0.3rem;
+            font-style: normal;
+            border-radius: 3px;
+          }
+          .description {
+             margin: 1rem 0;
+          }
+          .description a {
+            color: blue;
+            text-decoration: underline;
+          }
+          pre, pre code {
+            display: block;
+            margin-top: .3rem;
+            margin-bottom: 1rem;
+            font-size: .8rem !important;
+            line-height: 1rem !important;
+            color: white;
+            background-color: rgb(30 30 30);
+            padding: 1rem;
+            overflow: auto;
+          }
+          .content {
+            padding: 0 1.5rem 2rem !important;
+          }
+          #style-menu {
+            flex;
+            font-family: sans-serif;
+            font-size: 1.1rem;
+            line-height: 1.5rem;
+            white-space: nowrap;
+            color: white;
+            background-color: gray;
+            padding: .2rem 1.5rem;
+          }
+          #style-menu > :not([hidden]) ~ :not([hidden]) {
+            --space-reverse: 0;
+            margin-right: calc(0.5rem * var(--space-reverse));
+            margin-left: calc(0.5rem * calc(1 - var(--space-reverse)));
+          }
+          #style-menu a {
+            color: inherit;
+            text-decoration: none;
+          }
+          /* Quick demo for overriding the element style attribute of certain pagy helpers
+          .pagy input[style] {
+            width: 5rem !important;
+          }
+          */
+        </style>
+      </head>
+      <body>
+        <!-- each different class used by each style -->
+        <%= style_menu %>
+        <div class="content">
+          <%= yield %>
+        </div>
+      </body>
+      </html>
+    ERB
+  end
+  template :pagy_head do
+    <<~ERB
+      <!-- copy and paste the pagy style in order to edit it -->
+      <link rel="stylesheet" href="/stylesheets/pagy.css">
+    ERB
+  end
+  template :bootstrap_head do
+    <<~ERB
+      <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css">
+    ERB
+  end
+  template :bulma_head do
+    <<~ERB
+      <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css">
+    ERB
+  end
+  template :tailwind_head do
+    <<~ERB
+      <script src="https://cdn.tailwindcss.com?plugins=forms,typography,aspect-ratio"></script>
+      <!-- copy and paste the pagy.tailwind style in order to edit it -->
+      <style type="text/tailwindcss">
+        <%= Pagy.root.join('stylesheets', 'pagy.tailwind.css').read %>
+      </style>
+    ERB
+  end
+  template :helpers do
+    <<~'ERB'
+      <h1><%= style %></h1>
+      <% extra = STYLES[style][:extra] || "#{style}" %>
+      <% css_anchor = STYLES[style][:css_anchor] %>
+      <p class="description">See the <a href="http://ddnexus.github.io/pagy/docs/extras/<%= extra %>" target="blank"><%= extra %> extra</a>
+      documentation
+      <% if css_anchor %>
+        and the <a href="http://ddnexus.github.io/pagy/docs/api/stylesheets/#<%= css_anchor %>" target="blank"><%= css_anchor.gsub('-', '.') %></a>
+      <% end %>
+      for details</p>
+      <h2>Collection</h2>
+      <p id="records">@records: <%= @records.join(',') %></p>
+      <h2>pagy<%= prefix %>_nav <span class="notes">Simple nav <code>size: 5</code></span></h2>
+      <%= html = send(:"pagy#{prefix}_nav", @pagy, id: 'simple-nav', aria_label: 'Pages simple-nav', size: 5) %>
+      <%= highlight(html) %>
+      <h2>pagy<%= prefix %>_nav <span class="notes">Fast nav <code>size: 7</code></span></h2>
+      <%= html = send(:"pagy#{prefix}_nav", @pagy, id: 'nav', aria_label: 'Pages nav') %>
+      <%= highlight(html) %>
+      <h2>pagy<%= prefix %>_nav_js <span class="notes">Fast nav <code>size: 7</code></span></h2>
+      <%= html = send(:"pagy#{prefix}_nav_js", @pagy, id: 'nav-js', aria_label: 'Pages nav_js') %>
+      <%= highlight(html) %>
+      <h2>pagy<%= prefix %>_nav_js <span class="notes">Responsive nav <code>steps: {...}</code> (Resize the window to see)</span></h2>
+      <%= html = send(:"pagy#{prefix}_nav_js", @pagy, id: 'nav-js-responsive',
+           aria_label: 'Pages nav_js_responsive',
+           steps: { 0 => 5, 500 => 7, 750 => 9, 1000 => 11 }) %>
+      <%= highlight(html) %>
+      <h2>pagy<%= prefix %>_combo_nav_js</h2>
+      <%= html = send(:"pagy#{prefix}_combo_nav_js", @pagy, id: 'combo-nav-js', aria_label: 'Pages combo_nav_js') %>
+      <%= highlight(html) %>
+      <h2>pagy_info</h2>
+      <%= html = pagy_info(@pagy, id: 'pagy-info') %>
+      <%= highlight(html) %>
+      <% if style.match(/pagy|tailwind/) %>
+      <h2>pagy_limit_selector_js</h2>
+      <%= html = pagy_limit_selector_js(@pagy, id: 'limit-selector-js') %>
+      <%= highlight(html) %>
+      <h2>pagy_prev_a / pagy_next_a</h2>
+      <%= html = '<nav class="pagy" id="prev-next" aria-label="Pagy prev-next">' << pagy_prev_a(@pagy) << pagy_next_a(@pagy) << '</nav>' %>
+      <%= highlight(html) %>
+      <h2>pagy_prev_link / pagy_next_link <span class="notes">Link not rendered<span></h2>
+      <% html = '<head>' << (pagy_prev_link(@pagy)||'') << (pagy_next_link(@pagy)||'') << '</head>' %>
+      <%= highlight(html) %>
+      <% end %>
+    ERB
+  end
+  template :template do
+    <<~ERB
+      <h1>Pagy Template Demo</h1>
+      <p class="description">
+      See the <a href="https://ddnexus.github.io/pagy/docs/how-to/#using-your-pagination-templates">
+      Custom Templates</a> documentation.
+      </p>
+      <h2>Collection</h2>
+      <p id="records">@records: <%= @records.join(',') %></p>
+      <h2>Rendered ERB template</h2>
+      <%# We don't inline the template here, so we can highlight it more easily %>
+      <%= html = ERB.new(TEMPLATE).result(binding) %>
+      <%= highlight(TEMPLATE, format: :erb) %>
+      <%= highlight(html) %>
+    ERB
+  end
+  # Easier code highlighting
+  TEMPLATE = <<~ERB
+    <%# IMPORTANT: replace '<%=' with '<%==' if you run this in rails %>
+    <%# The a variable below is set to a lambda that generates the a tag %>
+    <%# Usage: a_tag = a.(page_number, text, classes: nil, aria_label: nil) %>
+    <% a = pagy_anchor(pagy) %>
+    <nav class="pagy nav" aria-label="Pages">
+      <%# Previous page link %>
+      <% if pagy.prev %>
+        <%= a.(pagy.prev, '&lt;', aria_label: 'Previous') %>
+      <% else %>
+        <a role="link" aria-disabled="true" aria-label="Previous">&lt;</a>
+      <% end %>
+      <%# Page links (series example: [1, :gap, 7, 8, "9", 10, 11, :gap, 36]) %>
+      <% pagy.series.each do |item| %>
+        <% if item.is_a?(Integer) %>
+          <%= a.(item) %>
+        <% elsif item.is_a?(String) %>
+          <a role="link" aria-disabled="true" aria-current="page" class="current"><%= item %></a>
+        <% elsif item == :gap %>
+          <a role="link" aria-disabled="true" class="gap">&hellip;</a>
+        <% end %>
+      <% end %>
+      <%# Next page link %>
+      <% if pagy.next %>
+        <%= a.(pagy.next, '&gt;', aria_label: 'Next') %>
+      <% else %>
+        <a role="link" aria-disabled="true" aria-label="Next">&lt;</a>
+      <% end %>
+    </nav>
+  ERB
+end
+# Cheap pagy formatter for helpers output
+class Formatter
+  INDENT     = '  '
+  TEXT_SPACE = "\u00B7"
+  TEXT       = /^([^<>]+)(.*)/
+  UNPAIRED   = /^(<(input|link).*?>)(.*)/
+  PAIRED     = %r{^(<(head|nav|div|span|p|a|b|label|ul|li).*?>)(.*?)(</\2>)(.*)}
+  WRAPPER    = /<.*?>/
+  DATA_PAGY  = /(data-pagy="([^"]+)")/
+  def initialize
+    @formatted = +''
+  end
+  def format(input, level = 0)
+    process(input, level)
+    @formatted
+  end
+  private
+  def process(input, level)
+    push = ->(content) { @formatted << ((INDENT * level) << content << "\n") }
+    rest = nil
+    if (match = input.match(TEXT))
+      text, rest = match.captures
+      push.(text.gsub(' ', TEXT_SPACE))
+    elsif (match = input.match(UNPAIRED))
+      tag, _name, rest = match.captures
+      push.(tag)
+    elsif (match = input.match(PAIRED))
+      tag_start, name, block, tag_end, rest = match.captures
+      ## Handle incomplete same-tag nesting
+      while block.scan(/<#{name}.*?>/).size > block.scan(tag_end).size
+        more, rest = rest.split(tag_end, 2)
+        block << tag_end << more
+      end
+      if (match = tag_start.match(DATA_PAGY))
+        search, data = match.captures
+        formatted = data.scan(/.{1,76}/).join("\n")
+        replace = %(\n#{INDENT * (level + 1)}data-pagy="#{formatted}")
+        tag_start.sub!(search, replace)
+      end
+      if block.match(WRAPPER)
+        push.(tag_start)
+        process(block, level + 1)
+        push.(tag_end)
+      else
+        push.(tag_start << block << tag_end)
+      end
+    end
+    process(rest, level) if rest
+  end
+end
+# Simple array-based collection that acts as a standard DB collection.
+class MockCollection < Array
+  def initialize(arr = Array(1..1000))
+    super
+    @collection = clone
+  end
+  def offset(value)
+    @collection = self[value..]
+    self
+  end
+  def limit(value)
+    @collection[0, value]
+  end
+  def count(*)
+    size
+  end
+end
+run PagyDemo

data/apps/index.rb ADDED Viewed

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+# PagyApp module
+module PagyApps
+  # Return the hash of app name/path
+  INDEX = Dir[File.expand_path('./*.ru', __dir__)].to_h { |f| [File.basename(f, '.ru'), f] }.freeze
+end

data/apps/keyset_ar.ru ADDED Viewed

@@ -0,0 +1,228 @@
+# frozen_string_literal: true
+# DESCRIPTION
+#    Showcase the keyset ActiveRecord pagination
+#
+# DOC
+#    https://ddnexus.github.io/pagy/playground/#5-keyset-apps
+#
+# BIN HELP
+#    bundle exec pagy -h
+#
+# DEV USAGE
+#    bundle exec pagy clone keyset_ar
+#    bundle exec pagy ./keyset_ar.ru
+#
+# URL
+#    http://0.0.0.0:8000
+VERSION = '9.4.0'
+# Bundle
+require 'bundler/inline'
+require 'bundler'
+Bundler.configure
+gemfile(ENV['PAGY_INSTALL_BUNDLE'] == 'true') do
+  source 'https://rubygems.org'
+  gem 'activerecord'
+  gem 'puma'
+  gem 'sinatra'
+  gem 'sqlite3'
+end
+# Pagy initializer
+require 'pagy/extras/limit'
+require 'pagy/extras/keyset'
+require 'pagy/extras/pagy'
+Pagy::DEFAULT[:limit] = 10
+Pagy::DEFAULT.freeze
+# Sinatra setup
+require 'sinatra/base'
+# Sinatra application
+class PagyKeyset < Sinatra::Base
+  include Pagy::Backend
+  # Root route/action
+  get '/' do
+    Time.zone = 'UTC'
+    @order = { animal: :asc, name: :asc, birthdate: :desc, id: :asc }
+    @pagy, @pets = pagy_keyset(Pet.order(@order))
+    erb :main
+  end
+  helpers do
+    include Pagy::Frontend
+    def order_symbol(dir)
+      { asc: '&#x2197;', desc: '&#x2198;' }[dir]
+    end
+  end
+  # Views
+  template :layout do
+    <<~ERB
+      <!DOCTYPE html>
+      <html lang="en">
+      <html>
+      <head>
+         <title>Pagy Keyset App</title>
+        <meta name="viewport" content="width=device-width, initial-scale=1.0">
+        <style type="text/css">
+          @media screen { html, body {
+            font-size: 1rem;
+            line-height: 1.2s;
+            padding: 0;
+            margin: 0;
+          } }
+          body {
+            background: white !important;
+            margin: 0 !important;
+            font-family: sans-serif !important;
+          }
+          .content {
+            padding: 1rem 1.5rem 2rem !important;
+          }
+          <%= Pagy.root.join('stylesheets', 'pagy.css').read %>
+        </style>
+      </head>
+      <body>
+        <%= yield %>
+      </body>
+      </html>
+    ERB
+  end
+  template :main do
+    <<~ERB
+      <div class="content">
+        <h1>Pagy Keyset App</h1>
+        <p>Self-contained, standalone app usable to easily reproduce any keyset related pagy issue with ActiveRecord sets.</p>
+        <p>Please, report the following versions in any new issue.</p>
+        <h2>Versions</h2>
+        <ul>
+          <li>Ruby:    <%= RUBY_VERSION %></li>
+          <li>Rack:    <%= Rack::RELEASE %></li>
+          <li>Sinatra: <%= Sinatra::VERSION %></li>
+          <li>Pagy:    <%= Pagy::VERSION %></li>
+        </ul>
+        <h3>Collection</h3>
+        <div id="records" class="collection">
+        <table border="1" cellspacing="0" cellpadding="3">
+          <tr>
+            <th>animal <%= order_symbol(@order[:animal]) %></th>
+            <th>name <%= order_symbol(@order[:name]) %></th>
+            <th>birthdate <%= order_symbol(@order[:birthdate]) %></th>
+            <th>id <%= order_symbol(@order[:id]) %></th>
+          </tr>
+          <% @pets.each do |pet| %>
+          <tr>
+            <td><%= pet.animal %></td>
+            <td><%= pet.name %></td>
+            <td><%= pet.birthdate %></td>
+            <td><%= pet.id %></td>
+          </tr>
+          <% end %>
+        </table>
+        </div>
+        <p>
+        <nav class="pagy" id="next" aria-label="Pagy next">
+          <%= pagy_next_a(@pagy, text: 'Next page &gt;') %>
+        </nav>
+      </div>
+    ERB
+  end
+end
+# ActiveRecord setup
+require 'active_record'
+# Match the microsecods with the strings stored into the time columns of SQLite
+# ActiveSupport::JSON::Encoding.time_precision = 6
+# Log
+output = ENV['APP_ENV'].equal?('showcase') ? IO::NULL : $stdout
+ActiveRecord::Base.logger = Logger.new(output)
+# SQLite DB files
+dir = ENV['APP_ENV'].equal?('development') ? '.' : Dir.pwd  # app dir in dev or pwd otherwise
+abort "ERROR: Cannot create DB files: the directory #{dir.inspect} is not writable." \
+      unless File.writable?(dir)
+# Connection
+ActiveRecord::Base.establish_connection(adapter: 'sqlite3', database: "#{dir}/tmp/pagy-keyset-ar.sqlite3")
+# Schema
+ActiveRecord::Schema.define do
+  create_table :pets, force: true do |t|
+    t.string   :animal
+    t.string   :name
+    t.date     :birthdate
+  end
+end
+# Models
+class Pet < ActiveRecord::Base; end
+data = <<~DATA
+  Luna  | dog    | 2018-03-10
+  Coco  | cat    | 2019-05-15
+  Dodo  | dog    | 2020-06-25
+  Wiki  | bird   | 2018-03-12
+  Baby  | rabbit | 2020-01-13
+  Neki  | horse  | 2021-07-20
+  Tino  | donkey | 2019-06-18
+  Plot  | cat    | 2022-09-21
+  Riki  | cat    | 2018-09-14
+  Susi  | horse  | 2018-10-26
+  Coco  | pig    | 2020-08-29
+  Momo  | bird   | 2023-08-25
+  Lili  | cat    | 2021-07-22
+  Beli  | pig    | 2020-07-26
+  Rocky | bird   | 2022-08-19
+  Vyvy  | dog    | 2018-05-16
+  Susi  | horse  | 2024-01-25
+  Ella  | cat    | 2020-02-20
+  Rocky | dog    | 2019-09-19
+  Juni  | rabbit | 2020-08-24
+  Coco  | bird   | 2021-03-17
+  Susi  | dog    | 2021-07-28
+  Luna  | horse  | 2023-05-14
+  Gigi  | pig    | 2022-05-19
+  Coco  | cat    | 2020-02-20
+  Nino  | donkey | 2019-06-17
+  Luna  | cat    | 2022-02-09
+  Popi  | dog    | 2020-09-26
+  Lili  | pig    | 2022-06-18
+  Mina  | horse  | 2021-04-21
+  Susi  | rabbit | 2023-05-18
+  Toni  | donkey | 2018-06-22
+  Rocky | horse  | 2019-09-28
+  Lili  | cat    | 2019-03-18
+  Roby  | cat    | 2022-06-19
+  Anto  | horse  | 2022-08-18
+  Susi  | pig    | 2021-04-21
+  Boly  | bird   | 2020-03-29
+  Sky   | cat    | 2023-07-19
+  Lili  | dog    | 2020-01-28
+  Fami  | snake  | 2023-04-27
+  Lopi  | pig    | 2019-06-19
+  Rocky | snake  | 2022-03-13
+  Denis | dog    | 2022-06-19
+  Maca  | cat    | 2022-06-19
+  Luna  | dog    | 2022-08-15
+  Jeme  | horse  | 2019-08-08
+  Sary  | bird   | 2023-04-29
+  Rocky | bird   | 2023-05-14
+  Coco  | dog    | 2023-05-27
+DATA
+# DB seed
+pets = []
+data.each_line(chomp: true) do |pet|
+  name, animal, birthdate = pet.split('|').map(&:strip)
+  pets << { name:, animal:, birthdate: }
+end
+Pet.insert_all(pets)
+run PagyKeyset