activerecord_cursor_paginate 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 198c2d0c2e71f89e73fca64d7ab8711949cf25faa20af6297d1d6045587ec7cf
-  data.tar.gz: 6f60b98579b2dcd132c09d4f75105b5cab7219ae8841c6970df9e77df6b59722
+  metadata.gz: c62461c4c0310350845f94c41ac762fc39e55892471c3b3f27482000ce2573fb
+  data.tar.gz: 0cc0e0d561bedeac454bcec204b56e7b2cb85bf84e0785ed50862753604c60f3
 SHA512:
-  metadata.gz: 85fd85af08637f1c22e52430f51bae57c5b116af2f843703dd2ab528d36616bf323d686c53c7b059fb04aa176a01bc0ec2a3c5a2b40acb6f54cf5412e2770e10
-  data.tar.gz: be0771bacd8fbd5f110c9f90927a12792ef85d8f4e4278e46321e96d82f93f87b848ad71b86cd9150c9465c39e5d8dd3a4e2a71672e51d7d7c04f00cbb561990
+  metadata.gz: 4a2b046f6ee4792539aea7b84fc3a0e65994c39d0f1d14f58cb2d3e57b39a9f4181b61c66dc5bd90462a16fbd6f6b351fbef653189d6c264c543d16c53ee7ca1
+  data.tar.gz: 74ab23173240984e9296544ad760172878d14b4d22cd4d01857f362d36220e90e530fe488933ba0fe29fd46ccff9ae909bac35d28323cbc615964492ea3e6096

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## master (unreleased)
 
+## 0.4.0 (2025-03-10)
+
+- Add ability to paginate backward from the end of the collection
+
+    ```ruby
+    paginator = users.cursor_paginate(forward_pagination: false)
+    ```
+
 ## 0.3.0 (2025-01-06)
 
 - Allow paginating over nullable columns

data/lib/activerecord_cursor_paginate/paginator.rb

@@ -20,6 +20,7 @@ module ActiveRecordCursorPaginate
   #
   class Paginator
     attr_reader :relation, :before, :after, :limit, :order, :append_primary_key
+    attr_accessor :forward_pagination
 
     # Create a new instance of the `ActiveRecordCursorPaginate::Paginator`
     #
@@ -45,10 +46,14 @@ module ActiveRecordCursorPaginate
     #   It is not recommended to use this feature, because the complexity of produced SQL
     #   queries can have a very negative impact on the database performance. It is better
     #   to paginate using only non-nullable columns.
+    # @param forward_pagination [Boolean] Whether this is a forward or backward pagination.
+    #   Optional, defaults to `true` if `:before` is not provided, `false` otherwise.
+    #   Useful when paginating backward from the end of the collection.
     #
     # @raise [ArgumentError] If any parameter is not valid
     #
-    def initialize(relation, before: nil, after: nil, limit: nil, order: nil, append_primary_key: true, nullable_columns: nil)
+    def initialize(relation, before: nil, after: nil, limit: nil, order: nil, append_primary_key: true,
+                   nullable_columns: nil, forward_pagination: before.nil?)
       unless relation.is_a?(ActiveRecord::Relation)
         raise ArgumentError, "relation is not an ActiveRecord::Relation"
       end
@@ -58,7 +63,7 @@ module ActiveRecordCursorPaginate
       @append_primary_key = append_primary_key
 
       @cursor = @current_cursor = nil
-      @is_forward_pagination = true
+      @forward_pagination = forward_pagination
       @before = @after = nil
       @page_size = nil
       @limit = nil
@@ -80,17 +85,18 @@ module ActiveRecordCursorPaginate
 
       @cursor = value || after
       @current_cursor = @cursor
-      @is_forward_pagination = value.blank?
+      @forward_pagination = false if value
       @before = value
     end
 
     def after=(value)
-      if before.present? && value.present?
+      if value.present? && before.present?
         raise ArgumentError, "Only one of :before and :after can be provided"
       end
 
-      @cursor = before || value
+      @cursor = value || before
       @current_cursor = @cursor
+      @forward_pagination = true if value
       @after = value
     end
 
@@ -136,9 +142,9 @@ module ActiveRecordCursorPaginate
       has_additional = records_plus_one.size > @page_size
 
       records = records_plus_one.take(@page_size)
-      records.reverse! unless @is_forward_pagination
+      records.reverse! unless @forward_pagination
 
-      if @is_forward_pagination
+      if @forward_pagination
         has_next_page = has_additional
         has_previous_page = @current_cursor.present?
       else
@@ -301,7 +307,7 @@ module ActiveRecordCursorPaginate
       end
 
       def pagination_direction(direction)
-        if @is_forward_pagination
+        if @forward_pagination
           direction
         else
           direction == :asc ? :desc : :asc
@@ -309,7 +315,7 @@ module ActiveRecordCursorPaginate
       end
 
       def pagination_operator(direction)
-        if @is_forward_pagination
+        if @forward_pagination
           direction == :asc ? :gt : :lt
         else
           direction == :asc ? :lt : :gt
@@ -318,7 +324,7 @@ module ActiveRecordCursorPaginate
 
       def advance_by_page(page)
         @current_cursor =
-          if @is_forward_pagination
+          if @forward_pagination
             page.next_cursor
           else
             page.previous_cursor

data/lib/activerecord_cursor_paginate/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveRecordCursorPaginate
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/activerecord_cursor_paginate.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# https://github.com/rails/rails/issues/54260
+require "logger"
+
 require "active_record"
 
 require_relative "activerecord_cursor_paginate/version"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activerecord_cursor_paginate
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - fatkodima
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-06 00:00:00.000000000 Z
+date: 2025-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord