File: pagination_params.rb

package info (click to toggle)
gitlab 17.6.5-19
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 629,368 kB
  • sloc: ruby: 1,915,304; javascript: 557,307; sql: 60,639; xml: 6,509; sh: 4,567; makefile: 1,239; python: 406
file content (47 lines) | stat: -rw-r--r-- 1,314 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# frozen_string_literal: true

module API
  # Concern for declare pagination params.
  #
  # @example
  #   class CustomApiResource < Grape::API::Instance
  #     include PaginationParams
  #
  #     params do
  #       use :pagination
  #     end
  #   end
  module PaginationParams
    extend ActiveSupport::Concern

    included do
      helpers do
        params :pagination do
          optional :page, type: Integer, default: 1, desc: 'Current page number', documentation: { example: 1 }
          optional :per_page, type: Integer, default: 20,
            desc: 'Number of items per page', except_values: [0], documentation: { example: 20 }
        end

        def verify_pagination_params!
          return if Feature.disabled?(:only_positive_pagination_values)

          page = begin
            Integer(params[:page])
          rescue ArgumentError, TypeError
            nil
          end

          return render_structured_api_error!({ error: 'page does not have a valid value' }, 400) if page&.< 1

          per_page = begin
            Integer(params[:per_page])
          rescue ArgumentError, TypeError
            nil
          end

          return render_structured_api_error!({ error: 'per_page does not have a valid value' }, 400) if per_page&.< 1
        end
      end
    end
  end
end