pagy 5.6.1 → 5.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5d3090b61a9b11c0763a7c2d103ee36f4a36f0618e7e99b32357bab408a29bc
-  data.tar.gz: d5c3c376deda1c84558bbcff43809c9235cb2fc9ced7492ecdfe8df6397c873e
+  metadata.gz: 0a24ac286e97d1aacd7603d7ada3791006120004bf56c027320c4184b9488fc7
+  data.tar.gz: 63a018d758c2ffff334de22fc8fdd433cdffe74030ba46ca5c3cf5dc8a563a9c
 SHA512:
-  metadata.gz: 6591de1571e9b6bdf1a26668cf730dcbba4c83ef9f2d3727b3a1bec5f98c49a69ae2d55aab363444d85a3310e3de65fe119fb3606ca63cfdf56202c14c591568
-  data.tar.gz: 02fea4991aab7911107460e58e73a66f507f9fff990261f1536fddf016b9523003165ed0dfd024013282ef43fec221cb7fcfa27b7f6b23c60a742f175adc0eae
+  metadata.gz: f5fd0f9dd9c8c8a151ea026e7e749ba6446fec53baf4bd9af276f8059f062d50d54b0d500e46762f5f4df8a3f89af475f4b07c7d8633f8194ee3da5d33d2b104
+  data.tar.gz: cd09f6222ce1d6db7c92984c9382d080d386ea862f66b3b7104721ea6cc6fc5e788714ce2aa623517c6ad9f17c6c95fd52fdcbcf2ba9a017c1485b262ce86405

data/lib/config/pagy.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-# Pagy initializer file (5.6.1)
-# Customize only what you really need and notice that Pagy works also without any of the following lines.
+# Pagy initializer file (5.6.2)
+# Customize only what you really need and notice that the core Pagy works also without any of the following lines.
 # Should you just cherry pick part of this file, please maintain the require-order of the extras
 
 
 # Pagy DEFAULT Variables
 # See https://ddnexus.github.io/pagy/api/pagy#variables
-# All the Pagy::DEFAULT are set for all the Pagy instances but can be overridden per instance
-# by just passing them to Pagy.new|Pagy::Countless.new|Pagy::Calendar.new or the #pagy controller method
+# All the Pagy::DEFAULT are set for all the Pagy instances but can be overridden per instance by just passing them to
+# Pagy.new|Pagy::Countless.new|Pagy::Calendar::*.new or any of the #pagy* controller methods
 
 
 # Instance variables
@@ -40,7 +40,7 @@
 # See https://ddnexus.github.io/pagy/extras/array
 # require 'pagy/extras/array'
 
-# Calendar extra: Add pagination filtering by calendar time unit (year, quartr, month, week, day)
+# Calendar extra: Add pagination filtering by calendar time unit (year, quarter, month, week, day)
 # See https://ddnexus.github.io/pagy/extras/calendar
 # require 'pagy/extras/calendar'
 # Default for each unit
@@ -60,7 +60,7 @@
 # Pagy::Calendar::Day::DEFAULT[:order]      = :asc        # Time direction of pagination
 # Pagy::Calendar::Day::DEFAULT[:format]     = '%Y-%m-%d'  # strftime format
 #
-# Uncomment the following block, if you need calendar localization without using the I18n extra
+# Uncomment the following lines, if you need calendar localization without using the I18n extra
 # module LocalizePagyCalendar
 #   def localize(time, opts)
 #     ::I18n.l(time, **opts)
@@ -100,8 +100,8 @@
 # you must require the shared internal extra (BEFORE the metadata extra) ONLY if you need also the :sequels
 # require 'pagy/extras/shared'
 # require 'pagy/extras/metadata'
-# For performance reason, you should explicitly set ONLY the metadata you use in the frontend
-# Pagy::DEFAULT[:metadata] = %i[scaffold_url count page prev next last]   # example
+# For performance reasons, you should explicitly set ONLY the metadata you use in the frontend
+# Pagy::DEFAULT[:metadata] = %i[scaffold_url page prev next last]   # example
 
 # Searchkick extra: Paginate `Searchkick::Results` objects
 # See https://ddnexus.github.io/pagy/extras/searchkick
@@ -212,18 +212,18 @@
 #
 # load the "de", "en" and "es" built-in locales:
 # (the first passed :locale will be used also as the default_locale)
-# Pagy::I18n.load({locale: 'de'},
-#                 {locale: 'en'},
-#                 {locale: 'es'})
+# Pagy::I18n.load({ locale: 'de' },
+#                 { locale: 'en' },
+#                 { locale: 'es' })
 #
 # load the "en" built-in locale, a custom "es" locale,
 # and a totally custom locale complete with a custom :pluralize proc:
 # (the first passed :locale will be used also as the default_locale)
-# Pagy::I18n.load({locale: 'en'},
-#                 {locale: 'es', filepath: 'path/to/pagy-es.yml'},
-#                 {locale: 'xyz',  # not built-in
-#                  filepath: 'path/to/pagy-xyz.yml',
-#                  pluralize: lambda{ |count| ... } )
+# Pagy::I18n.load({ locale: 'en' },
+#                 { locale: 'es', filepath: 'path/to/pagy-es.yml' },
+#                 { locale: 'xyz',  # not built-in
+#                   filepath: 'path/to/pagy-xyz.yml',
+#                   pluralize: lambda{ |count| ... } )
 
 
 # I18n extra: uses the standard i18n gem which is ~18x slower using ~10x more memory

data/lib/javascripts/pagy.js

@@ -5,7 +5,7 @@
 // Container of the whole pagy stuff
 function Pagy(){}
 
-Pagy.version = '5.6.1'
+Pagy.version = '5.6.2'
 
 // Used by the waitForMe function
 Pagy.delay = 100

data/lib/locales/ta.yml

@@ -0,0 +1,22 @@
+# :one_other pluralization (see https://github.com/ddnexus/pagy/blob/master/lib/locales/utils/p11n.rb)
+
+ta:
+  pagy:
+
+    item_name:
+      one: "பதிவு"
+      other: "பதிவுகள்"
+
+    nav:
+      prev: "‹ முந்தையது"
+      next: "அடுத்தது ›"
+      gap: "…"
+
+    info:
+      no_items: "%{item_name} கிடைக்கவில்லை"
+      single_page: "<b>%{count}</b> %{item_name} காட்டப்படுகின்றது"
+      multiple_pages: "மொத்தம் <b>%{count}</b> %{item_name}, காட்டப்படுபவை <b>%{from}-%{to}</b>"
+
+    combo_nav_js: "<label>%{pages}-இல் %{page_input}-வது பக்கம்</label>"
+
+    items_selector_js: "<label>ஒரு பக்கத்திற்கு %{items_input} %{item_name} காட்டு</label>"

data/lib/pagy/calendar/day.rb

@@ -16,12 +16,12 @@ class Pagy # :nodoc:
         @initial = new_time(@starting.year, @starting.month, @starting.day)
         @final   = new_time(@ending.year, @ending.month, @ending.day) + DAY
         @pages   = @last = (@final - @initial).to_i / DAY
-        @from    = start_for(@page)
+        @from    = starting_time_for(@page)
         @to      = @from + DAY
       end
 
-      # Time for the page
-      def start_for(page)
+      # Starting time for the page
+      def starting_time_for(page)
         @initial + (snap(page) * DAY)
       end
     end

data/lib/pagy/calendar/month_mixin.rb

@@ -5,7 +5,7 @@ class Pagy
     # Mixin for month based unit periods
     # It is used for month and quarter, but you could use it to implement less common unit of 6, 4, 2 months
     # (see the https://ddnexus.github.io/pagy/api/calendar#custom-units sections for details).
-    # The class that includes it needs to set the MONTH duration for the unit and the usual DEFAULT.
+    # The including class must set the MONTHS duration for the unit and the usual DEFAULT.
     module MonthMixin
       protected
 
@@ -13,36 +13,34 @@ class Pagy
       def setup_unit_vars
         super
         @months  = self.class::MONTHS  # number of months in the unit
-        @initial = new_time(@starting.year, beginning_month(@starting.month))
-        @final   = add_to(new_time(@ending.year, beginning_month(@ending.month)), @months)
+        @initial = new_time(@starting.year, starting_month_including(@starting.month))
+        @final   = add_months_to(new_time(@ending.year, starting_month_including(@ending.month)), @months)
         @pages   = @last = (months_in(@final) - months_in(@initial)) / @months
-        @from    = start_for(@page)
-        @to      = add_to(@from, @months)
+        @from    = starting_time_for(@page)
+        @to      = add_months_to(@from, @months)
       end
 
-      # Time for the page
-      def start_for(page)
-        add_to(@initial, snap(page) * @months)
+      # Starting time for the page
+      def starting_time_for(page)
+        add_months_to(@initial, snap(page) * @months)
       end
 
-      # Return the beginning month for the unit (e.g. quarter) that includes the month argument
-      def beginning_month(month)
-        (@months * ((month - 1) / @months)) + 1
+      # Starting month of the unit including the passed month
+      def starting_month_including(month)
+        (@months * ((month - 1) / @months)) + 1  # remove 1 month for 0-11 calculations and add it back for 1-12 conversion
       end
 
       private
 
-      # Months in time
+      # Number of months in time
       def months_in(time)
         (time.year * 12) + time.month
       end
 
       # Add months to time
-      def add_to(time, months)
-        months += months_in(time)
-        year  = months / 12
-        month = months % 12
-        month.zero? ? new_time(year - 1, 12) : new_time(year, month)
+      def add_months_to(time, months)
+        months += months_in(time) - 1             # remove 1 month for 0-11 calculations
+        new_time(months / 12, (months % 12) + 1)  # add 1 month back for 1-12 conversion
       end
     end
   end

data/lib/pagy/calendar/quarter.rb

@@ -14,9 +14,9 @@ class Pagy # :nodoc:
 
       # The label for any page, with the substitution of the '%q' token
       def label_for(page, opts = {})
-        start_time    = start_for(page.to_i)
-        opts[:format] = (opts[:format] || @vars[:format]).gsub('%q') { (start_time.month / 4) + 1 }
-        localize(start_time, opts)
+        starting_time = starting_time_for(page.to_i)  # page could be a string
+        opts[:format] = (opts[:format] || @vars[:format]).gsub('%q') { (starting_time.month / 4) + 1 }
+        localize(starting_time, opts)
       end
     end
   end

data/lib/pagy/calendar/week.rb

@@ -18,12 +18,12 @@ class Pagy # :nodoc:
         @initial = week_start(@starting)
         @final   = week_start(@ending) + WEEK
         @pages   = @last = (@final - @initial).to_i / WEEK
-        @from    = start_for(@page)
+        @from    = starting_time_for(@page)
         @to      = @from + WEEK
       end
 
-      # Time for the page
-      def start_for(page)
+      # Starting time for the page
+      def starting_time_for(page)
         @initial + (snap(page) * WEEK)
       end
 

data/lib/pagy/calendar/year.rb

@@ -16,12 +16,12 @@ class Pagy # :nodoc:
         @initial = new_time(@starting.year)
         @final   = new_time(@ending.year + 1)
         @pages   = @last = @final.year - @initial.year
-        @from    = start_for(@page)
+        @from    = starting_time_for(@page)
         @to      = new_time(@from.year + 1)
       end
 
-      # Time for the page
-      def start_for(page)
+      # Starting time for the page
+      def starting_time_for(page)
         new_time(@initial.year + snap(page))
       end
     end

data/lib/pagy/calendar.rb

@@ -36,7 +36,7 @@ class Pagy # :nodoc:
     # The label for any page (it can pass along the I18n gem opts when it's used with the i18n extra)
     def label_for(page, opts = {})
       opts[:format] ||= @vars[:format]
-      localize(start_for(page.to_i), opts)
+      localize(starting_time_for(page.to_i), opts)  # page could be a string
     end
 
     # Period of the active page (used for nested units)

data/lib/pagy/frontend.rb

@@ -76,8 +76,8 @@ class Pagy
 
     # Similar to I18n.t: just ~18x faster using ~10x less memory
     # (@pagy_locale explicitly initialized in order to avoid warning)
-    def pagy_t(key, **opts)
-      Pagy::I18n.t(@pagy_locale ||= nil, key, **opts)
+    def pagy_t(key, opts = {})
+      Pagy::I18n.t(@pagy_locale ||= nil, key, opts)
     end
   end
 end

data/lib/pagy/i18n.rb

@@ -10,12 +10,16 @@ class Pagy
 
     # Pluralization rules
     module P11n
-      # Utility variables
-      from0to1   = [0, 1].freeze
-      from2to4   = [2, 3, 4].freeze
-      from5to9   = [5, 6, 7, 8, 9].freeze
-      from11to14 = [11, 12, 13, 14].freeze
-      from12to14 = [12, 13, 14].freeze
+      # Pluralization variables
+      from0to1   = (0..1).to_a.freeze
+      from2to4   = (2..4).to_a.freeze
+      from3to10  = (3..10).to_a.freeze
+      from5to9   = (5..9).to_a.freeze
+      from11to14 = (11..14).to_a.freeze
+      from11to99 = (11..99).to_a.freeze
+      from12to14 = (12..14).to_a.freeze
+
+      from0to1_from5to9 = from0to1 + from5to9
 
       # Store the proc defining each pluralization RULE
       # Logic adapted from https://github.com/svenfuchs/rails-i18n
@@ -24,12 +28,12 @@ class Pagy
           lambda do |n = 0|
             mod100 = n % 100
             case
-            when n == 0                         then 'zero' # rubocop:disable Style/NumericPredicate
-            when n == 1                         then 'one'
-            when n == 2                         then 'two'
-            when (3..10).to_a.include?(mod100)  then 'few'
-            when (11..99).to_a.include?(mod100) then 'many'
-            else                                     'other'
+            when n == 0                      then 'zero' # rubocop:disable Style/NumericPredicate
+            when n == 1                      then 'one'
+            when n == 2                      then 'two'
+            when from3to10.include?(mod100)  then 'few'
+            when from11to99.include?(mod100) then 'many'
+            else                                  'other'
             end
           end,
 
@@ -68,10 +72,10 @@ class Pagy
             mod10  = n % 10
             mod100 = n % 100
             case
-            when n == 1                                                               then 'one'
-            when from2to4.include?(mod10) && !from12to14.include?(mod100)             then 'few'
-            when (from0to1 + from5to9).include?(mod10) || from12to14.include?(mod100) then 'many'
-            else                                                                           'other'
+            when n == 1                                                           then 'one'
+            when from2to4.include?(mod10) && !from12to14.include?(mod100)         then 'few'
+            when from0to1_from5to9.include?(mod10) || from12to14.include?(mod100) then 'many'
+            else                                                                       'other'
             end
           end,
 
@@ -149,7 +153,7 @@ class Pagy
     end
 
     # Translate and pluralize the key with the locale DATA
-    def t(locale, key, **opts)
+    def t(locale, key, opts = {})
       data, pluralize = DATA[locale]
       translation = data[key] || (opts[:count] && data[key += ".#{pluralize.call(opts[:count])}"]) \
                       or return %([translation missing: "#{key}"])

data/lib/pagy.rb

@@ -5,7 +5,7 @@ require 'pathname'
 
 # Core class
 class Pagy
-  VERSION = '5.6.1'
+  VERSION = '5.6.2'
 
   # Root pathname to get the path of Pagy files like templates or dictionaries
   def self.root

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pagy
 version: !ruby/object:Gem::Version
-  version: 5.6.1
+  version: 5.6.2
 platform: ruby
 authors:
 - Domizio Demichelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-28 00:00:00.000000000 Z
+date: 2021-11-29 00:00:00.000000000 Z
 dependencies: []
 description: Agnostic pagination in plain ruby. It does it all. Better.
 email:
@@ -46,6 +46,7 @@ files:
 - lib/locales/sv-SE.yml
 - lib/locales/sv.yml
 - lib/locales/sw.yml
+- lib/locales/ta.yml
 - lib/locales/tr.yml
 - lib/locales/uk.yml
 - lib/locales/zh-CN.yml