Class: OpenapiFirst::Middlewares::ResponseValidation

Inherits:
Object
  • Object
show all
Defined in:
lib/openapi_first/middlewares/response_validation.rb

Overview

A Rack middleware to validate requests against an OpenAPI API description

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(app, spec = nil, options = {}) ⇒ ResponseValidation

Returns a new instance of ResponseValidation.

Parameters:

  • spec (String, OpenapiFirst::Definition) (defaults to: nil) —

    Path to the OpenAPI file or an instance of Definition

  • options (defaults to: {}) —

    Hash :spec [String, OpenapiFirst::Definition] Path to the OpenAPI file or an instance of Definition.

    This will be deprecated. Please use spec argument instead.

    :raise_error [Boolean] Whether to raise an error if validation fails. default: true



14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/openapi_first/middlewares/response_validation.rb', line 14

def initialize(app, spec = nil, options = {})
  @app = app
  if spec.is_a?(Hash)
    options = spec
    spec = options.fetch(:spec)
  end
  @raise = options.fetch(:raise_error, OpenapiFirst.configuration.response_validation_raise_error)

  raise "You have to pass spec: when initializing #{self.class}" unless spec

  @definition = spec.is_a?(Definition) ? spec : OpenapiFirst.load(spec)
end

Instance Attribute Details

#app ⇒ Object (readonly) 



28
29
30
 
# File 'lib/openapi_first/middlewares/response_validation.rb', line 28

def app
  @app
end

Instance Method Details

#call(env) ⇒ Object 



30
31
32
33
34
35
 
# File 'lib/openapi_first/middlewares/response_validation.rb', line 30

def call(env)
  status, headers, body = @app.call(env)
  @definition.validate_response(Rack::Request.new(env), Rack::Response[status, headers, body],
                                raise_error: @raise)
  [status, headers, body]
end