lib/pagy/extras/standalone.rb



# See the Pagy documentation: https://ddnexus.github.io/pagy/docs/extras/standalone
# frozen_string_literal: true

require 'uri'

class Pagy # :nodoc:
  # Use pagy without any request object, nor Rack environment/gem, nor any defined params method,
  # even in the irb/rails console without any app or config.
  module StandaloneExtra
    # Extracted from Rack::Utils and reformatted for rubocop
    # :nocov:
    module QueryUtils
      module_function

      def build_nested_query(value, prefix = nil)
        case value
        when Array
          value.map { |v| build_nested_query(v, "#{prefix}[]") }.join('&')
        when Hash
          value.map do |k, v|
            build_nested_query(v, prefix ? "#{prefix}[#{escape(k)}]" : escape(k))
          end.delete_if(&:empty?).join('&')
        when nil
          escape(prefix)
        else
          raise ArgumentError, 'value must be a Hash' if prefix.nil?

          "#{escape(prefix)}=#{escape(value)}"
        end
      end

      def escape(str)
        URI.encode_www_form_component(str)
      end
    end
    # :nocov:

    # Return the URL for the page. If there is no pagy.vars[:url]
    # it works exactly as the regular #pagy_url_for, relying on the params method and Rack.
    # If there is a defined pagy.vars[:url] variable it does not need the params method nor Rack.
    def pagy_url_for(pagy, page, fragment: nil, **_)
      return super unless pagy.vars[:url]

      vars         = pagy.vars
      params       = vars[:params].is_a?(Hash) ? vars[:params].clone : {}  # safe when it gets reused
      pagy_set_query_params(page, vars, params)
      params       = vars[:params].(params) if vars[:params].is_a?(Proc)
      query_string = "?#{QueryUtils.build_nested_query(params)}"
      "#{vars[:url]}#{query_string}#{fragment}"
    end
  end
  UrlHelpers.prepend StandaloneExtra

  # Define a dummy params method if it's not already defined in the including module
  module Backend
    def self.included(controller)
      controller.define_method(:params) { {} } unless controller.method_defined?(:params)
    end
  end
end