Sha256: b0371263fa50e401b7951c227941e55560e28a360be02a0ead52e3dec7f70fb2

Contents?: true

Size: 1.72 KB

Versions: 10

Compression:

Stored size: 1.72 KB

Contents

# frozen_string_literal: true

require 'grape/middleware/base'

module Grape
  module Middleware
    module Versioner
      # This middleware sets various version related rack environment variables
      # based on the request parameters and removes that parameter from the
      # request parameters for subsequent middleware and API.
      # If the version substring does not match any potential initialized
      # versions, a 404 error is thrown.
      # If the version substring is not passed the version (highest mounted)
      # version will be used.
      #
      # Example: For a uri path
      #   /resource?apiver=v1
      #
      # The following rack env variables are set and path is rewritten to
      # '/resource':
      #
      #   env['api.version'] => 'v1'
      class Param < Base
        def default_options
          {
            version_options: {
              parameter: 'apiver'
            }
          }
        end

        def before
          potential_version = Rack::Utils.parse_nested_query(env[Grape::Http::Headers::QUERY_STRING])[paramkey]
          return if potential_version.nil?
          throw :error, status: 404, message: '404 API Version Not Found', headers: { Grape::Http::Headers::X_CASCADE => 'pass' } if options[:versions] && !options[:versions].find { |v| v.to_s == potential_version }
          env[Grape::Env::API_VERSION] = potential_version
          env[Grape::Env::RACK_REQUEST_QUERY_HASH].delete(paramkey) if env.key? Grape::Env::RACK_REQUEST_QUERY_HASH
        end

        private

        def paramkey
          version_options[:parameter] || default_options[:version_options][:parameter]
        end

        def version_options
          options[:version_options]
        end
      end
    end
  end
end

Version data entries

10 entries across 10 versions & 2 rubygems

Version Path
grape-1.5.3 lib/grape/middleware/versioner/param.rb
grape-1.5.2 lib/grape/middleware/versioner/param.rb
grape-1.5.1 lib/grape/middleware/versioner/param.rb
grape-1.5.0 lib/grape/middleware/versioner/param.rb
grape-extra_validators-2.0.0 vendor/bundle/ruby/2.6.0/gems/grape-1.4.0/lib/grape/middleware/versioner/param.rb
grape-1.4.0 lib/grape/middleware/versioner/param.rb
grape-1.3.3 lib/grape/middleware/versioner/param.rb
grape-1.3.2 lib/grape/middleware/versioner/param.rb
grape-1.3.1 lib/grape/middleware/versioner/param.rb
grape-1.3.0 lib/grape/middleware/versioner/param.rb