Class: OpenapiFirst::Definition

Inherits:
Object
  • Object
show all
Defined in:
lib/openapi_first/definition.rb,
lib/openapi_first/definition/response.rb,
lib/openapi_first/definition/operation.rb,
lib/openapi_first/definition/path_item.rb,
lib/openapi_first/definition/responses.rb,
lib/openapi_first/definition/request_body.rb,
lib/openapi_first/definition/path_template.rb

Overview

Represents an OpenAPI API Description document This is returned by OpenapiFirst.load.

Defined Under Namespace

Classes: Operation, PathItem, RequestBody, Response

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(resolved, filepath = nil) ⇒ Definition

Returns a new instance of Definition.

Parameters:

  • resolved (Hash) —

    The resolved OpenAPI document.

  • filepath (String) (defaults to: nil) —

    The file path of the OpenAPI document.



16
17
18
19
20
 
# File 'lib/openapi_first/definition.rb', line 16

def initialize(resolved, filepath = nil)
  @filepath = filepath
  @paths = resolved['paths']
  @openapi_version = detect_version(resolved)
end

Instance Attribute Details

#filepath ⇒ Object (readonly)

Returns the value of attribute filepath.



12
13
14
 
# File 'lib/openapi_first/definition.rb', line 12

def filepath
  @filepath
end

#openapi_version ⇒ Object (readonly)

Returns the value of attribute openapi_version.



12
13
14
 
# File 'lib/openapi_first/definition.rb', line 12

def openapi_version
  @openapi_version
end

#paths ⇒ Object (readonly)

Returns the value of attribute paths.



12
13
14
 
# File 'lib/openapi_first/definition.rb', line 12

def paths
  @paths
end

Instance Method Details

#operations ⇒ Array<Operation>

Gets all the operations defined in the API description.

Returns:

  • (Array<Operation>) —

    An array of Operation objects.



74
75
76
 
# File 'lib/openapi_first/definition.rb', line 74

def operations
  @operations ||= path_items.flat_map(&:operations)
end

#path(pathname) ⇒ PathItem

Gets the PathItem object for the specified path. Example:

definition.path('/pets/{id}')

Parameters:

  • pathname (String) —

    The path template string.

Returns:



83
84
85
86
87
 
# File 'lib/openapi_first/definition.rb', line 83

def path(pathname)
  return unless paths.key?(pathname)

  PathItem.new(pathname, paths[pathname], openapi_version:)
end

#request(rack_request) ⇒ RuntimeRequest

Builds a RuntimeRequest object based on the Rack request.

Parameters:

  • rack_request (Rack::Request) —

    The Rack request object.

Returns:



52
53
54
55
56
57
58
59
60
61
 
# File 'lib/openapi_first/definition.rb', line 52

def request(rack_request)
  path_item, path_params = find_path_item_and_params(rack_request.path)
  operation = path_item&.operation(rack_request.request_method.downcase)
  RuntimeRequest.new(
    request: rack_request,
    path_item:,
    operation:,
    path_params:
  )
end

#response(rack_request, rack_response) ⇒ RuntimeResponse

Builds a RuntimeResponse object based on the Rack request and response.

Parameters:

  • rack_request (Rack::Request) —

    The Rack request object.

  • rack_response (Rack::Response) —

    The Rack response object.

Returns:



67
68
69
70
 
# File 'lib/openapi_first/definition.rb', line 67

def response(rack_request, rack_response)
  runtime_request = request(rack_request)
  RuntimeResponse.new(runtime_request.operation, rack_response)
end

#validate_request(rack_request, raise_error: false) ⇒ RuntimeRequest

Validates the request against the API description.

Parameters:

  • rack_request (Rack::Request) —

    The Rack request object.

  • raise_error (Boolean) (defaults to: false) —

    Whether to raise an error if validation fails.

Returns:



26
27
28
29
30
31
32
33
 
# File 'lib/openapi_first/definition.rb', line 26

def validate_request(rack_request, raise_error: false)
  runtime_request = request(rack_request)
  validator = RequestValidation::Validator.new(runtime_request.operation)
  validation_error = validator.validate(runtime_request)
  validation_error.raise! if validation_error && raise_error
  runtime_request.error = validation_error
  runtime_request
end

#validate_response(rack_request, rack_response, raise_error: false) ⇒ RuntimeResponse

Validates the response against the API description.

Parameters:

  • rack_request (Rack::Request) —

    The Rack request object.

  • rack_response (Rack::Response) —

    The Rack response object.

  • raise_error (Boolean) (defaults to: false) —

    Whether to raise an error if validation fails.

Returns:



40
41
42
43
44
45
46
47
 
# File 'lib/openapi_first/definition.rb', line 40

def validate_response(rack_request, rack_response, raise_error: false)
  runtime_response = response(rack_request, rack_response)
  validator = ResponseValidation::Validator.new(runtime_response.operation)
  validation_error = validator.validate(runtime_response)
  validation_error.raise! if validation_error && raise_error
  runtime_response.error = validation_error
  runtime_response
end