jsonapi-query_builder 0.1.7 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e613355258e5be273292baacd4b8c8aecba03b29005212749868412857feb678
-  data.tar.gz: 46f0f548604944cb9572b90c44a9e3ca5f15e1f8a47985cb588135f8cade2794
+  metadata.gz: f47ebd86badc968ef8a79333f49ac496c067ad6a26c6563cca0257c1e8cdeba2
+  data.tar.gz: ff874753c9a7ba077bf7876a8a598dd01058a0e2f7a2a982dde2fc579342a5d0
 SHA512:
-  metadata.gz: 58546d6561f997295a4505780acb1ad9ff210bd8f1c1390638283d9af62cb1f4d4e89b69e646a902851a1840590b49ce3480ef42f1fff6861a0b7d92f3f27e80
-  data.tar.gz: 851a87dab11ee9194318f4fc5ea437d842ae561b2d5e10448adf796050cc0abb866a73c16ddde0e4b5f3d9757b583498344137d11ecdeaa793dc101a285af5f7
+  metadata.gz: fc7168dad1ea652617381662a8e75cadbb132addb9b78d6af052b15b590d3f031fa143a6508e6f2feb52f82ee9f333892551378fa5a969ac5232bb48ca8b0c8e
+  data.tar.gz: 6ead187ee07d7d9db557c2010b3d2c992c01d05c888ad6a777716380fa565fc9aff54fb39db54120131bbb544418f789f53cade618c55db86d2aec3d03c08a61

data/.github/workflows/lint.yml

@@ -0,0 +1,31 @@
+name: lint
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  standardrb:
+    runs-on: ubuntu-18.04
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - name: standardrb
+        run: bundle exec standardrb
+
+  rubocop-rspec:
+    runs-on: ubuntu-18.04
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: rubocop
+        run: bundle exec rubocop --only RSpec

data/.github/workflows/spec.yml

@@ -0,0 +1,23 @@
+name: spec
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  rake-spec:
+    runs-on: ubuntu-18.04
+    strategy:
+      matrix:
+        ruby: [2.5, 2.6, 2.7, 3.0]
+
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: rake spec
+        run: bundle exec rake spec

data/.gitignore

@@ -9,5 +9,4 @@
 
 # rspec failure tracking
 .rspec_status
-Gemfile.lock
 *.gem

data/.rubocop.yml

@@ -4,5 +4,8 @@ require:
 RSpec/NestedGroups:
   Max: 4
 
+RSpec/MultipleMemoizedHelpers:
+  Max: 7
+
 AllCops:
   NewCops: enable

data/.ruby-version

@@ -1 +1 @@
-2.6.6
+3.0.2

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Change log
+
+## 0.2.1 (2021-10-04)
+
+- [#22](https://github.com/infinum/jsonapi-query_builder/pull/22): Bump allowed pagy version.
+
+## 0.2.0 (2021-09-29)
+Added support for Kaminari and Keyset pagination strategies in addition to Pagy.
+
+- [#21](https://github.com/infinum/jsonapi-query_builder/pull/21): Extract paginators.
+
+## 0.1.9 (2021-05-07)
+
+- [#18](https://github.com/infinum/jsonapi-query_builder/pull/18): Remove Ruby `to` version.
+- [#9](https://github.com/infinum/jsonapi-query_builder/pull/9): added github actions
+
+## 0.1.8 (2021-01-25)
+
+- [#8](https://github.com/infinum/jsonapi-query_builder/pull/8): add support for ruby 3.0
+

data/Gemfile.lock

@@ -0,0 +1,140 @@
+PATH
+  remote: .
+  specs:
+    jsonapi-query_builder (0.2.1)
+      activerecord (>= 5)
+      pagy (>= 3.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionview (6.1.4.1)
+      activesupport (= 6.1.4.1)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activemodel (6.1.4.1)
+      activesupport (= 6.1.4.1)
+    activerecord (6.1.4.1)
+      activemodel (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+    activesupport (6.1.4.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    ast (2.4.2)
+    builder (3.2.4)
+    bundler-audit (0.9.0.1)
+      bundler (>= 1.2.0, < 3)
+      thor (~> 1.0)
+    coderay (1.1.3)
+    concurrent-ruby (1.1.9)
+    crass (1.0.6)
+    diff-lcs (1.4.4)
+    erubi (1.10.0)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    kaminari (1.2.1)
+      activesupport (>= 4.1.0)
+      kaminari-actionview (= 1.2.1)
+      kaminari-activerecord (= 1.2.1)
+      kaminari-core (= 1.2.1)
+    kaminari-actionview (1.2.1)
+      actionview
+      kaminari-core (= 1.2.1)
+    kaminari-activerecord (1.2.1)
+      activerecord
+      kaminari-core (= 1.2.1)
+    kaminari-core (1.2.1)
+    lefthook (0.7.6)
+    loofah (2.12.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    method_source (1.0.0)
+    mini_portile2 (2.6.1)
+    minitest (5.14.4)
+    nokogiri (1.12.5)
+      mini_portile2 (~> 2.6.1)
+      racc (~> 1.4)
+    pagy (3.11.0)
+    parallel (1.21.0)
+    parser (3.0.2.0)
+      ast (~> 2.4.1)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.5.2)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.4.2)
+      loofah (~> 2.3)
+    rainbow (3.0.0)
+    rake (13.0.6)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
+    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.20.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.9.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.12.0)
+      parser (>= 3.0.1.1)
+    rubocop-performance (1.11.5)
+      rubocop (>= 1.7.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rspec (2.5.0)
+      rubocop (~> 1.19)
+    ruby-progressbar (1.11.0)
+    sqlite3 (1.4.2)
+    standard (1.3.0)
+      rubocop (= 1.20.0)
+      rubocop-performance (= 1.11.5)
+    standardrb (1.0.0)
+      standard
+    thor (1.1.0)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.1.0)
+    zeitwerk (2.4.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord
+  bundler (~> 2.0)
+  bundler-audit
+  jsonapi-query_builder!
+  kaminari (~> 1.2)
+  lefthook
+  pry
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop-rspec
+  sqlite3
+  standard
+  standardrb
+
+BUNDLED WITH
+   2.2.22

data/README.md

@@ -1,4 +1,4 @@
-# Jsonapi::QueryBuilder
+# Jsonapi::QueryBuilder ![lint](https://github.com/infinum/jsonapi-query_builder/workflows/lint/badge.svg)![spec](https://github.com/infinum/jsonapi-query_builder/workflows/spec/badge.svg)
 
 `Jsonapi::QueryBuilder` serves the purpose of adding the json api query related SQL conditions to the already scoped
 collection, usually used in controller index actions. 
@@ -27,6 +27,9 @@ Or install it yourself as:
 
 ```ruby
 class UserQuery < Jsonapi::QueryBuilder::BaseQuery
+  ## pagination 
+  paginator Jsonapi::QueryBuilder::Paginator::Pagy # default paginator
+  
   ## sorting
   default_sort created_at: :desc
   sorts_by :last_name
@@ -56,6 +59,29 @@ current user permissions, or for any other type of scoping. It's only responsibi
 querying. Use `pundit` or similar for policy scoping, custom query objects for other scoping, and then pass the scoped
 collection to the `Jsonapi::QueryBuilder::BaseQuery` object.
 
+### Pagination
+Pagination support is configurable using the `paginator` method to define the paginator. It defaults to the `Pagy`
+paginator, a lightweight and fast paginator. Other paginators currently supported are `Kaminari` and an implementation
+of keyset pagination. Before using these paginators we need to explicitly require the gems in our Gemfile and the
+paginator file in question. 
+Additionally one can implement it's own paginator by inheriting from `Jsonapi::QueryBuilder::Paginator::BasePaginator`.
+The minimum required implementation is a `#paginate` method that receives page params and returns a page of the
+collection. It can return the pagination details as the second item of the returned array, that can be used in the
+serializer for pagination metadata.
+#### Using the Kaminari Paginator
+```ruby
+require "jsonapi/query_builder/paginator/kaminari"
+
+paginator Jsonapi::QueryBuilder::Paginator::Kaminari
+```
+
+#### Using the Keyset Paginator
+```ruby
+require "jsonapi/query_builder/paginator/keyset"
+
+paginator Jsonapi::QueryBuilder::Paginator::Keyset
+```
+
 ### Sorting
 #### Ensuring deterministic results
 Sorting has a fallback to an unique attribute which defaults to the `id` attribute. This ensures deterministic paginated
@@ -165,6 +191,9 @@ filters_by :type, TypeFilter, if: :correct_type?
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can
 also run `bin/console` for an interactive prompt that will allow you to experiment.
 
+We're using `standardrb` and `lefthook`. You can install lefthook hooks via `lefthook install`. It will run linters and
+standardrb checks before commits, and a bundle audit + whole spec suite before push.
+
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the
 version number in `version.rb`, and then run `LEFTHOOK=0 bundle exec rake release`, which will create a git tag for the
 version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

data/jsonapi-query_builder.gemspec

@@ -36,16 +36,21 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = "~> 2.5"
+  spec.required_ruby_version = ">= 2.5"
 
   spec.add_runtime_dependency "activerecord", ">= 5"
-  spec.add_runtime_dependency "pagy", "~> 3.5"
+  spec.add_runtime_dependency "pagy", ">= 3.5"
 
   spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "bundler-audit"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "standardrb"
   spec.add_development_dependency "standard"
   spec.add_development_dependency "rubocop-rspec"
   spec.add_development_dependency "lefthook"
+  spec.add_development_dependency "kaminari", "~> 1.2"
+  spec.add_development_dependency "activerecord"
+  spec.add_development_dependency "sqlite3"
+  spec.add_development_dependency "pry"
 end

data/lefthook.yml

@@ -2,13 +2,13 @@ lint:
   commands: &lint
     lint-frozen-strings:
       glob: "*.rb"
-      run: bundle exec rubocop {staged_files} --only Style/FrozenStringLiteralComment,Layout/EmptyLineAfterMagicComment --format quiet --auto-correct
+      run: bundle exec rubocop --only Style/FrozenStringLiteralComment,Layout/EmptyLineAfterMagicComment --format quiet --auto-correct
 
 rubocop:
   commands: &rubocop
     rubocop-rspec:
       glob: "spec/*"
-      run: bundle exec rubocop {staged_files} --only RSpec --format quiet
+      run: bundle exec rubocop --only RSpec --format quiet
 
 pre-commit:
   parallel: true

data/lib/jsonapi/query_builder/base_query.rb

@@ -5,6 +5,8 @@ require "jsonapi/query_builder/mixins/include"
 require "jsonapi/query_builder/mixins/paginate"
 require "jsonapi/query_builder/mixins/sort"
 
+require "jsonapi/query_builder/paginator"
+
 module Jsonapi
   module QueryBuilder
     class BaseQuery

data/lib/jsonapi/query_builder/errors/unpermitted_sort_parameters.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Jsonapi
+  module QueryBuilder
+    module Errors
+      class UnpermittedSortParameters < ArgumentError
+        def initialize(unpermitted_parameters)
+          super [
+            unpermitted_parameters.to_sentence,
+            unpermitted_parameters.count == 1 ? "is not a" : "are not",
+            "permitted sort attribute".pluralize(unpermitted_parameters.count)
+          ].join(" ")
+        end
+      end
+    end
+  end
+end

data/lib/jsonapi/query_builder/mixins/paginate.rb

@@ -4,7 +4,20 @@ module Jsonapi
   module QueryBuilder
     module Mixins
       module Paginate
-        include Pagy::Backend
+        extend ActiveSupport::Concern
+
+        class_methods do
+          # Sets the paginator used to page the results. Defaults to Pagy
+          #
+          # @param [Jsonapi::QueryBuilder::Paginator::BasePaginator] paginator A subclass of BasePaginator
+          def paginator(paginator)
+            @paginator = paginator
+          end
+
+          def _paginator
+            @paginator || Paginator::Pagy
+          end
+        end
 
         attr_reader :pagination_details
 
@@ -14,9 +27,7 @@ module Jsonapi
         # @param [Object] page_params Optional explicit pagination params
         # @return [ActiveRecord::Relation] Paged collection
         def paginate(collection, page_params = send(:page_params))
-          @pagination_details, records = pagy collection, page: page_params[:number],
-                                                          items: page_params[:size],
-                                                          outset: page_params[:offset]
+          records, @pagination_details = self.class._paginator.new(collection).paginate(page_params)
 
           records
         end

data/lib/jsonapi/query_builder/mixins/sort.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "jsonapi/query_builder/mixins/sort/param"
+require "jsonapi/query_builder/errors/unpermitted_sort_parameters"
 
 module Jsonapi
   module QueryBuilder
@@ -8,8 +9,6 @@ module Jsonapi
       module Sort
         extend ActiveSupport::Concern
 
-        UnpermittedSortParameters = Class.new ArgumentError
-
         class_methods do
           attr_reader :_default_sort
 
@@ -59,7 +58,7 @@ module Jsonapi
         # @param [ActiveRecord::Relation] collection
         # @param [Object] sort_params Optional explicit sort params
         # @return [ActiveRecord::Relation] Sorted relation
-        # @raise [Jsonapi::QueryBuilder::Mixins::Sort::UnpermittedSortParameters] if not all sort parameters are
+        # @raise [Jsonapi::QueryBuilder::Errors::UnpermittedSortParameters] if not all sort parameters are
         #   permitted
         def sort(collection, sort_params = send(:sort_params))
           sort_params = Param.deserialize_params(sort_params)
@@ -80,11 +79,7 @@ module Jsonapi
           unpermitted_parameters = sort_params.map(&:attribute).map(&:to_sym) - self.class.supported_sorts.keys
           return if unpermitted_parameters.size.zero?
 
-          raise UnpermittedSortParameters, [
-            unpermitted_parameters.to_sentence,
-            unpermitted_parameters.count == 1 ? "is not a" : "are not",
-            "permitted sort attribute".pluralize(unpermitted_parameters.count)
-          ].join(" ")
+          raise Errors::UnpermittedSortParameters, unpermitted_parameters
         end
 
         def add_order_attributes(collection, sort_params)

data/lib/jsonapi/query_builder/paginator/base_paginator.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Jsonapi
+  module QueryBuilder
+    module Paginator
+      class BasePaginator
+        attr_reader :collection
+
+        # @param [ActiveRecord::Relation] collection
+        def initialize(collection)
+          @collection = collection
+        end
+
+        # @param [Hash] page_params
+        # @return [[ActiveRecord::Relation, Hash]] Records and pagination details
+        def paginate(page_params)
+          raise NotImplementedError, "#{self.class} should implement ##{__method__}"
+        end
+      end
+    end
+  end
+end

data/lib/jsonapi/query_builder/paginator/kaminari.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "kaminari"
+
+module Jsonapi
+  module QueryBuilder
+    module Paginator
+      class Kaminari < BasePaginator
+        def paginate(page_params)
+          paged_collection = collection
+            .page(page_params[:number])
+            .per(page_params[:size])
+            .padding(page_params[:offset])
+
+          [paged_collection, pagination_details(paged_collection, page_params)]
+        end
+
+        private
+
+        def pagination_details(collection, page_params)
+          {
+            number: collection.current_page,
+            size: collection.limit_value,
+            offset: page_params[:offset],
+            total: collection.total_count,
+            total_pages: collection.total_pages,
+            next_page: collection.next_page,
+            prev_page: collection.prev_page
+          }
+        end
+      end
+    end
+  end
+end

data/lib/jsonapi/query_builder/paginator/keyset.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module Jsonapi
+  module QueryBuilder
+    module Paginator
+      class Keyset < BasePaginator
+        DEFAULT_DIRECTION = :after
+        DEFAULT_LIMIT = 25
+
+        def paginate(page_params)
+          page_params = extract_pagination_params(page_params)
+          records = apply_pagination(collection, page_params)
+
+          [records, page_params]
+        end
+
+        private
+
+        def extract_pagination_params(params)
+          {
+            column: params.fetch(:column, nil),
+            position: params.fetch(:position, nil),
+            direction: params.fetch(:direction, DEFAULT_DIRECTION),
+            limit: params.fetch(:limit, DEFAULT_LIMIT)
+          }
+        end
+
+        def apply_pagination(collection, pagination_params)
+          column = pagination_params[:column]
+          position = pagination_params[:position]
+          direction = pagination_params[:direction]
+          limit = pagination_params[:limit]
+
+          return collection unless column
+
+          collection = apply_order(collection, column, direction)
+          collection = collection.limit(limit.to_i)
+
+          return collection unless position
+
+          apply_filter(collection, column, position, direction)
+        end
+
+        def apply_order(collection, column, direction)
+          if direction.to_sym == DEFAULT_DIRECTION
+            collection.reorder(collection.arel_table[column].asc)
+          else
+            collection.reorder(collection.arel_table[column].desc)
+          end
+        end
+
+        def apply_filter(collection, column, position, direction)
+          if direction.to_sym == DEFAULT_DIRECTION
+            collection.where(collection.arel_table[column].gt(position))
+          else
+            collection.where(collection.arel_table[column].lt(position))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jsonapi/query_builder/paginator/pagy.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "pagy"
+require "pagy/extras/items"
+
+module Jsonapi
+  module QueryBuilder
+    module Paginator
+      class Pagy < BasePaginator
+        include ::Pagy::Backend
+
+        def paginate(page_params)
+          @params = {page: page_params}
+
+          pagination_details, records = pagy collection, page: page_params[:number],
+                                                         items: page_params[:size],
+                                                         outset: page_params[:offset]
+          [records, pagination_details]
+        end
+
+        private
+
+        attr_reader :params
+      end
+    end
+  end
+end

data/lib/jsonapi/query_builder/paginator.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "jsonapi/query_builder/paginator/base_paginator"
+require "jsonapi/query_builder/paginator/pagy"

data/lib/jsonapi/query_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Jsonapi
   module QueryBuilder
-    VERSION = "0.1.7"
+    VERSION = "0.2.1"
   end
 end

data/lib/jsonapi/query_builder.rb

@@ -4,8 +4,6 @@ require "active_support/concern"
 require "active_support/core_ext/array/conversions"
 require "active_support/core_ext/hash/keys"
 require "active_support/core_ext/string/inflections"
-require "pagy"
-require "pagy/extras/items"
 
 require "jsonapi/query_builder/version"
 require "jsonapi/query_builder/base_query"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jsonapi-query_builder
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.2.1
 platform: ruby
 authors:
 - Jure Cindro
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-01-19 00:00:00.000000000 Z
+date: 2021-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -28,14 +28,14 @@ dependencies:
   name: pagy
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.5'
 - !ruby/object:Gem::Dependency
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -136,6 +150,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: kaminari
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |
   `Jsonapi::QueryBuilder` serves the purpose of adding the json api query related SQL conditions to the already scoped collection, usually used in controller index actions.
 
@@ -146,12 +216,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/lint.yml"
+- ".github/workflows/spec.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -163,11 +236,17 @@ files:
 - lib/jsonapi/query_builder/base_filter.rb
 - lib/jsonapi/query_builder/base_query.rb
 - lib/jsonapi/query_builder/base_sort.rb
+- lib/jsonapi/query_builder/errors/unpermitted_sort_parameters.rb
 - lib/jsonapi/query_builder/mixins/filter.rb
 - lib/jsonapi/query_builder/mixins/include.rb
 - lib/jsonapi/query_builder/mixins/paginate.rb
 - lib/jsonapi/query_builder/mixins/sort.rb
 - lib/jsonapi/query_builder/mixins/sort/param.rb
+- lib/jsonapi/query_builder/paginator.rb
+- lib/jsonapi/query_builder/paginator/base_paginator.rb
+- lib/jsonapi/query_builder/paginator/kaminari.rb
+- lib/jsonapi/query_builder/paginator/keyset.rb
+- lib/jsonapi/query_builder/paginator/pagy.rb
 - lib/jsonapi/query_builder/version.rb
 homepage: https://github.com/infinum/jsonapi-query_builder
 licenses:
@@ -182,7 +261,7 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -191,7 +270,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: Support `json:api` querying with ease!