cursor_pager 0.1.0 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1cfa8e486f765f437f2737c1778ea9f70c22849d8e0a6912bee1ec20440487a2
-  data.tar.gz: 99bbe1f36e20d8574217ca27f6bec0ef431487679f048ce7e6fb55fb8c73de5e
+  metadata.gz: 0f09f4f6c7c439bf8dc8d20ca19bce69cd7b67d0f6ffe9f8c91be7f3a673ccd6
+  data.tar.gz: c79f9159200f3013be13892fd72b51f4ccba8c5111bd17411bde6db2deb9ea8b
 SHA512:
-  metadata.gz: fe4e2e39e9d28cb318b6da7d09368f2d866a2f5386e796f8f816af22fdada3539748c46e59259c51673eee30ddb5d6059d0e02a8f6800da936be6fe1db7af6ae
-  data.tar.gz: 0e861720ee32d06b9d55c58a0f0a4ff6ba316435ae619186b8f762c42a6df40db87c79e7d968517d899fe3be3777dc146641dfa79dcada4f66883bc6e6686c48
+  metadata.gz: 469e8c30a4974b1f7be434169c46b82518de4c2f034f4c36ba01abf09b23855dd87b1d3689ef426b27b119283db25c4ba878462304c143084205e196571a7acd
+  data.tar.gz: b16fd57909391d6d442291baef95adb33ec39181db7a4a1063cbb993ed0cea678fcf9e2ba502992bd91991e18d9246c564b47f1ca83e912c46da2a85bdc0b427

data/.github/workflows/ci.yml

@@ -2,17 +2,23 @@ name: CI
 
 on:
   push:
-    branches: [master]
+    branches: [main]
   pull_request:
-    branches: [master]
+    branches: [main]
 
 jobs:
   test:
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
-        ruby-version: ["2.6", "2.7"]
-        activerecord-version: ["5.2", "6.0"]
+        include:
+          - ruby-version: "2.6"
+            activerecord-version: "5.2"
+          - ruby-version: "2.7"
+            activerecord-version: "6.0"
+          - ruby-version: "3.0"
+            activerecord-version: "6.1"
 
     services:
       db:
@@ -31,9 +37,9 @@ jobs:
         uses: actions/cache@v1
         with:
           path: vendor/bundle
-          key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
+          key: ${{ runner.os }}-gems-${{ matrix.ruby-version }}-${{ hashFiles('**/Gemfile.lock') }}
           restore-keys: |
-            ${{ runner.os }}-gems-
+            ${{ runner.os }}-gems-${{ matrix.ruby-version }}-
 
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1

data/.rubocop.yml

@@ -18,5 +18,8 @@ Metrics/BlockLength:
   Exclude:
     - /**/spec/**/*
 
+Metrics/ClassLength:
+  Max: 200
+
 Style/StringLiterals:
   EnforcedStyle: double_quotes

data/.ruby-version

@@ -1 +1 @@
-2.7.1
+2.7.2

data/Appraisals

@@ -7,3 +7,7 @@ end
 appraise "activerecord-6.0" do
   gem "activerecord", "~> 6.0.0"
 end
+
+appraise "activerecord-6.1" do
+  gem "activerecord", "~> 6.1.0"
+end

data/CHANGELOG.md

@@ -5,4 +5,50 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## Unreleased
+## [Unreleased]
+
+## [0.2.4] - 2021-04-01
+
+### Fixed
+
+* Fix `Page#next_page?` when given a grouped relation #15
+
+## [0.2.3] - 2020-11-23
+
+### Fixed
+
+* Fix using cursors with preloaded or eager loaded associations #13
+
+## [0.2.2] - 2020-09-29
+
+### Fixed
+
+* Fix checking if the next page exists when a custom select is given #12
+
+## [0.2.1] - 2020-05-13
+
+### Fixed
+
+* Fix fetching cursor values when relation has join and string order values #9
+
+## [0.2.0] - 2020-04-23
+
+### Added
+
+* `first_cursor` & `last_cursor` convenience methods
+* Configurable default & maximum page sizes #6
+
+## [0.1.0] - 2020-04-23
+
+### Added
+
+* First implementation of cursor-pased pagination #2
+* Configurable cursor encoder #3
+
+[Unreleased]: https://github.com/check24-profis/shared-cursor-pager/compare/v0.2.4...HEAD
+[0.2.4]: https://github.com/check24-profis/shared-cursor-pager/compare/v0.2.3...v0.2.4
+[0.2.3]: https://github.com/check24-profis/shared-cursor-pager/compare/v0.2.2...v0.2.3
+[0.2.2]: https://github.com/check24-profis/shared-cursor-pager/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/check24-profis/shared-cursor-pager/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/check24-profis/shared-cursor-pager/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/check24-profis/shared-cursor-pager/releases/tag/v0.1.0

data/Gemfile.lock

@@ -1,73 +1,75 @@
 PATH
   remote: .
   specs:
-    cursor_pager (0.1.0)
+    cursor_pager (0.2.4)
       activerecord (>= 5.2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.0.2.2)
-      activesupport (= 6.0.2.2)
-    activerecord (6.0.2.2)
-      activemodel (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
-    activesupport (6.0.2.2)
+    activemodel (6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activerecord (6.1.3.1)
+      activemodel (= 6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activesupport (6.1.3.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2)
-    appraisal (2.2.0)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    appraisal (2.4.0)
       bundler
       rake
       thor (>= 0.14.0)
-    ast (2.4.0)
-    concurrent-ruby (1.1.6)
-    database_cleaner (1.8.4)
-    database_cleaner-active_record (1.8.0)
-      activerecord
-      database_cleaner (~> 1.8.0)
-    diff-lcs (1.3)
-    i18n (1.8.2)
+    ast (2.4.2)
+    concurrent-ruby (1.1.8)
+    database_cleaner-active_record (2.0.0)
+      activerecord (>= 5.a)
+      database_cleaner-core (~> 2.0.0)
+    database_cleaner-core (2.0.1)
+    diff-lcs (1.4.4)
+    i18n (1.8.10)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.4)
-    minitest (5.14.0)
-    parallel (1.19.1)
-    parser (2.7.1.1)
-      ast (~> 2.4.0)
+    minitest (5.14.4)
+    parallel (1.20.1)
+    parser (3.0.0.0)
+      ast (~> 2.4.1)
     pg (1.2.3)
     rainbow (3.0.0)
     rake (12.3.3)
+    regexp_parser (2.1.1)
     rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    rubocop (0.82.0)
-      jaro_winkler (~> 1.5.1)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    rubocop (1.12.0)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 3.0.0.0)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
       rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 2.0)
-    ruby-progressbar (1.10.1)
-    thor (1.0.1)
-    thread_safe (0.3.6)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
-    unicode-display_width (1.7.0)
-    zeitwerk (2.3.0)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.4.1)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.11.0)
+    thor (1.1.0)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.0.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
@@ -82,4 +84,4 @@ DEPENDENCIES
   rubocop
 
 BUNDLED WITH
-   2.1.4
+   2.2.15

data/README.md

@@ -1,6 +1,6 @@
 # CursorPager
 
-![build](https://github.com/askcharlie/cursor_pager/workflows/CI/badge.svg)
+![build](https://github.com/check24-profis/shared-cursor-pager/workflows/CI/badge.svg) [![Gem Version](https://badge.fury.io/rb/cursor_pager.svg)](https://badge.fury.io/rb/cursor_pager)
 
 A small and easy-to-use library that aims to make it easy to build Rails APIs
 with cursor-based pagination (aka keyset pagination).
@@ -45,7 +45,9 @@ To get information about the page or generate a cursor
 ```ruby
 page.previous_page?                # Tells you if there is a previous page
 page.next_page?                    # Tells you if there is a next page
-page.cursor_for(page.records.last) # Will generate a cursor for a specific item
+page.cursor_for(page.records.last) # Generates a cursor for a specific item
+page.first_cursor                  # Generates a cursor for the first item
+page.last_cursor                   # Generates a cursor for the last item
 ```
 
 To fetch the first then usres after a certain cursor
@@ -65,6 +67,8 @@ page.records
 
 ## Configuration
 
+### Encoder
+
 By default cursors are base64 encoded primary keys of the records. If you wish
 to change that because you want to add encryption or something similiar, you
 can provide your own encoder class.
@@ -85,6 +89,18 @@ CursorPager.configure do |config|
 end
 ```
 
+### Default & Maximum Page Size
+
+The default & maximum page sizes are configured as `nil` (unlimited) by default.
+You can however set your own values.
+
+```ruby
+CursorPager.configure do |config|
+  config.default_page_size = 25
+  config.maximum_page_size = 100
+end
+```
+
 ## Not (yet) supported
 
 * Ordering by SQL alias or function
@@ -103,5 +119,5 @@ The gem is available as open source under the terms of the [MIT License].
 
 [JSON API Cursor Pagination]: https://jsonapi.org/profiles/ethanresnick/cursor-pagination/
 [Relay's GraphQL Cursor Connection]: https://relay.dev/graphql/connections.htm
-[code of conduct]: https://github.com/askcharlie/cursor_pager/blob/master/CODE_OF_CONDUCT.md
+[code of conduct]: https://github.com/check24-profis/shared-cursor-pager/blob/main/CODE_OF_CONDUCT.md
 [MIT License]: https://opensource.org/licenses/MIT

data/cursor_pager.gemspec

@@ -9,14 +9,14 @@ Gem::Specification.new do |spec|
   spec.email         = ["bastian.bartmann@check24.de"]
 
   spec.summary       = "Cursor-based pagination for ActiveRecord relations."
-  spec.homepage      = "https://github.com/askcharlie/cursor_pager"
+  spec.homepage      = "https://github.com/check24-profis/shared-cursor-pager"
   spec.license       = "MIT"
   spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = spec.homepage
   spec.metadata["changelog_uri"] =
-    "https://github.com/askcharlie/cursor_pager/blob/master/CHANGELOG.md"
+    "https://github.com/check24-profis/shared-cursor-pager/blob/main/CHANGELOG.md"
 
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`

data/gemfiles/activerecord_5.2.gemfile.lock

@@ -1,71 +1,74 @@
 PATH
   remote: ..
   specs:
-    cursor_pager (0.1.0)
+    cursor_pager (0.2.4)
       activerecord (>= 5.2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (5.2.4.2)
-      activesupport (= 5.2.4.2)
-    activerecord (5.2.4.2)
-      activemodel (= 5.2.4.2)
-      activesupport (= 5.2.4.2)
+    activemodel (5.2.4.4)
+      activesupport (= 5.2.4.4)
+    activerecord (5.2.4.4)
+      activemodel (= 5.2.4.4)
+      activesupport (= 5.2.4.4)
       arel (>= 9.0)
-    activesupport (5.2.4.2)
+    activesupport (5.2.4.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-    appraisal (2.2.0)
+    appraisal (2.3.0)
       bundler
       rake
       thor (>= 0.14.0)
     arel (9.0.0)
-    ast (2.4.0)
-    concurrent-ruby (1.1.6)
-    database_cleaner (1.8.4)
+    ast (2.4.1)
+    concurrent-ruby (1.1.7)
+    database_cleaner (1.8.5)
     database_cleaner-active_record (1.8.0)
       activerecord
       database_cleaner (~> 1.8.0)
-    diff-lcs (1.3)
-    i18n (1.8.2)
+    diff-lcs (1.4.4)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.4)
-    minitest (5.14.0)
-    parallel (1.19.1)
-    parser (2.7.1.1)
-      ast (~> 2.4.0)
+    minitest (5.14.2)
+    parallel (1.20.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
     pg (1.2.3)
     rainbow (3.0.0)
     rake (12.3.3)
+    regexp_parser (1.8.2)
     rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    rubocop (0.81.0)
-      jaro_winkler (~> 1.5.1)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (1.4.0)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8)
       rexml
+      rubocop-ast (>= 1.1.1)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.1.1)
+      parser (>= 2.7.1.5)
     ruby-progressbar (1.10.1)
     thor (1.0.1)
     thread_safe (0.3.6)
-    tzinfo (1.2.7)
+    tzinfo (1.2.8)
       thread_safe (~> 0.1)
     unicode-display_width (1.7.0)
 
@@ -83,4 +86,4 @@ DEPENDENCIES
   rubocop
 
 BUNDLED WITH
-   2.1.4
+   2.2.15

data/gemfiles/activerecord_6.0.gemfile.lock

@@ -1,73 +1,76 @@
 PATH
   remote: ..
   specs:
-    cursor_pager (0.1.0)
+    cursor_pager (0.2.4)
       activerecord (>= 5.2.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.0.2.2)
-      activesupport (= 6.0.2.2)
-    activerecord (6.0.2.2)
-      activemodel (= 6.0.2.2)
-      activesupport (= 6.0.2.2)
-    activesupport (6.0.2.2)
+    activemodel (6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activerecord (6.0.3.4)
+      activemodel (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activesupport (6.0.3.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-      zeitwerk (~> 2.2)
-    appraisal (2.2.0)
+      zeitwerk (~> 2.2, >= 2.2.2)
+    appraisal (2.3.0)
       bundler
       rake
       thor (>= 0.14.0)
-    ast (2.4.0)
-    concurrent-ruby (1.1.6)
-    database_cleaner (1.8.4)
+    ast (2.4.1)
+    concurrent-ruby (1.1.7)
+    database_cleaner (1.8.5)
     database_cleaner-active_record (1.8.0)
       activerecord
       database_cleaner (~> 1.8.0)
-    diff-lcs (1.3)
-    i18n (1.8.2)
+    diff-lcs (1.4.4)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.4)
-    minitest (5.14.0)
-    parallel (1.19.1)
-    parser (2.7.1.1)
-      ast (~> 2.4.0)
+    minitest (5.14.2)
+    parallel (1.20.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
     pg (1.2.3)
     rainbow (3.0.0)
     rake (12.3.3)
+    regexp_parser (1.8.2)
     rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.1)
-      rspec-support (~> 3.9.1)
-    rspec-expectations (3.9.1)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.2)
-    rubocop (0.81.0)
-      jaro_winkler (~> 1.5.1)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (1.4.0)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8)
       rexml
+      rubocop-ast (>= 1.1.1)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.1.1)
+      parser (>= 2.7.1.5)
     ruby-progressbar (1.10.1)
     thor (1.0.1)
     thread_safe (0.3.6)
-    tzinfo (1.2.7)
+    tzinfo (1.2.8)
       thread_safe (~> 0.1)
     unicode-display_width (1.7.0)
-    zeitwerk (2.3.0)
+    zeitwerk (2.4.1)
 
 PLATFORMS
   ruby
@@ -83,4 +86,4 @@ DEPENDENCIES
   rubocop
 
 BUNDLED WITH
-   2.1.4
+   2.2.15

data/gemfiles/activerecord_6.1.gemfile

@@ -0,0 +1,13 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "appraisal"
+gem "database_cleaner-active_record"
+gem "pg"
+gem "rake", "~> 12.0"
+gem "rspec", "~> 3.0"
+gem "rubocop"
+gem "activerecord", "~> 6.1.0"
+
+gemspec path: "../"

data/gemfiles/activerecord_6.1.gemfile.lock

@@ -0,0 +1,88 @@
+PATH
+  remote: ..
+  specs:
+    cursor_pager (0.2.4)
+      activerecord (>= 5.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activerecord (6.1.3.1)
+      activemodel (= 6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activesupport (6.1.3.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    appraisal (2.4.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    ast (2.4.2)
+    concurrent-ruby (1.1.8)
+    database_cleaner-active_record (2.0.0)
+      activerecord (>= 5.a)
+      database_cleaner-core (~> 2.0.0)
+    database_cleaner-core (2.0.1)
+    diff-lcs (1.4.4)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    minitest (5.14.4)
+    parallel (1.20.1)
+    parser (3.0.0.0)
+      ast (~> 2.4.1)
+    pg (1.2.3)
+    rainbow (3.0.0)
+    rake (12.3.3)
+    regexp_parser (2.1.1)
+    rexml (3.2.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    rubocop (1.12.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.4.1)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.11.0)
+    thor (1.1.0)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.0.0)
+    zeitwerk (2.4.2)
+
+PLATFORMS
+  x86_64-darwin-19
+
+DEPENDENCIES
+  activerecord (~> 6.1.0)
+  appraisal
+  cursor_pager!
+  database_cleaner-active_record
+  pg
+  rake (~> 12.0)
+  rspec (~> 3.0)
+  rubocop
+
+BUNDLED WITH
+   2.2.15

data/lib/cursor_pager/configuration.rb

@@ -5,10 +5,24 @@ module CursorPager
   # Encapulates all the configuration for the library.
   class Configuration
     # The encoder that will be used to encode & decode cursors.
+    # Defaults to `Base64Encoder`.
     attr_accessor :encoder
 
+    # The default page size that will be used if no `first` or `last` were
+    # specified. Every record fitting the cursor constraints will be returned
+    # if it's set to `nil`.
+    # Defaults to `nil`.
+    attr_accessor :default_page_size
+
+    # The maximum allowed page size. Clients will never receive more records per
+    # page than is sepcified here. There is no maximum if this is set to `nil`.
+    # Defaults to `nil`.
+    attr_accessor :maximum_page_size
+
     def initialize
       @encoder = Base64Encoder
+      @default_page_size = nil
+      @maximum_page_size = nil
     end
   end
 

data/lib/cursor_pager/page.rb

@@ -3,12 +3,19 @@
 module CursorPager
   # The main class that coordinates the whole pagination.
   class Page
-    attr_reader :relation, :first, :last, :after, :before, :order_values
+    extend Forwardable
+
+    attr_reader :relation, :first_value, :last_value, :after, :before,
+      :order_values
+
+    def_delegators :@configuration, :encoder, :default_page_size,
+      :maximum_page_size
 
     def initialize(relation, first: nil, last: nil, after: nil, before: nil)
+      @configuration = CursorPager.configuration
       @relation = relation
-      @first = first
-      @last = last
+      @first_value = first
+      @last_value = last
       @after = after
       @before = before
       @order_values = OrderValues.from_relation(relation)
@@ -17,6 +24,28 @@ module CursorPager
       verify_order_directions!
     end
 
+    # A capped `first` value.
+    # The underlying instance variable `first_value` doesn't have limits on it.
+    # If neither `first` nor `last` is given, but `default_page_size` or
+    # `maximum_page_size` are configured, they will be used for first.
+    def first
+      @first ||= begin
+                   capped = limit_pagination_argument(first_value)
+
+                   if capped.nil? && last.nil?
+                     capped = default_page_size || maximum_page_size
+                   end
+
+                   capped
+                 end
+    end
+
+    # A capped `last` value.
+    # The underlying instance variable `last_value` doesn't have limits on it.
+    def last
+      @last ||= limit_pagination_argument(last_value)
+    end
+
     def previous_page?
       @previous_page ||= if after_limit_value.present?
                            true
@@ -31,16 +60,26 @@ module CursorPager
       @next_page ||= if before_limit_value.present?
                        true
                      elsif first
-                       sliced_relation.limit(first + 1).count == first + 1
+                       sliced_relation.offset(first).exists?
                      else
                        false
                      end
     end
 
     def cursor_for(item)
+      return if item.nil?
+
       encoder.encode(item.id.to_s)
     end
 
+    def first_cursor
+      cursor_for(records.first)
+    end
+
+    def last_cursor
+      cursor_for(records.last)
+    end
+
     def records
       @records ||= limited_relation.to_a
     end
@@ -67,6 +106,21 @@ module CursorPager
       raise ConflictingOrdersError
     end
 
+    # Used to cap `first` and `last` arguments.
+    # Returns `nil` if the argument is `nil`, otherwise a value between `0` and
+    # `maximum_page_size`.
+    def limit_pagination_argument(argument)
+      return if argument.nil?
+
+      if argument.negative?
+        argument = 0
+      elsif maximum_page_size && argument > maximum_page_size
+        argument = maximum_page_size
+      end
+
+      argument
+    end
+
     def limited_relation
       @limited_relation ||= LimitRelation.new(sliced_relation, first, last).call
     end
@@ -93,18 +147,23 @@ module CursorPager
     end
 
     def limit_value_for(cursor)
-      id = encoder.decode(cursor)
-
-      selects = order_values.map(&:select_string)
-      item = relation.where(id: id).select(selects).first
+      item = limit_item_for(cursor)
 
       raise CursorNotFoundError, cursor if item.blank?
 
       order_values.map { |value| item[value.select_alias] }
     end
 
-    def encoder
-      CursorPager.configuration.encoder
+    def limit_item_for(cursor)
+      id = encoder.decode(cursor)
+
+      selects = order_values.map(&:select_string)
+      ordered_relation_copy = ordered_relation.dup
+
+      ordered_relation_copy.preload_values = []
+      ordered_relation_copy.eager_load_values = []
+      ordered_relation_copy
+        .unscope(:includes).where(id: id).select(selects).first
     end
   end
 end

data/lib/cursor_pager/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CursorPager
-  VERSION = "0.1.0"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cursor_pager
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.4
 platform: ruby
 authors:
 - Bastian Bartmann
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-04-23 00:00:00.000000000 Z
+date: 2021-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -24,7 +24,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 5.2.0
-description: 
+description:
 email:
 - bastian.bartmann@check24.de
 executables: []
@@ -53,6 +53,8 @@ files:
 - gemfiles/activerecord_5.2.gemfile.lock
 - gemfiles/activerecord_6.0.gemfile
 - gemfiles/activerecord_6.0.gemfile.lock
+- gemfiles/activerecord_6.1.gemfile
+- gemfiles/activerecord_6.1.gemfile.lock
 - lib/cursor_pager.rb
 - lib/cursor_pager/base64_encoder.rb
 - lib/cursor_pager/configuration.rb
@@ -66,14 +68,14 @@ files:
 - lib/cursor_pager/page.rb
 - lib/cursor_pager/slice_relation.rb
 - lib/cursor_pager/version.rb
-homepage: https://github.com/askcharlie/cursor_pager
+homepage: https://github.com/check24-profis/shared-cursor-pager
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/askcharlie/cursor_pager
-  source_code_uri: https://github.com/askcharlie/cursor_pager
-  changelog_uri: https://github.com/askcharlie/cursor_pager/blob/master/CHANGELOG.md
-post_install_message: 
+  homepage_uri: https://github.com/check24-profis/shared-cursor-pager
+  source_code_uri: https://github.com/check24-profis/shared-cursor-pager
+  changelog_uri: https://github.com/check24-profis/shared-cursor-pager/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -88,8 +90,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Cursor-based pagination for ActiveRecord relations.
 test_files: []