Class: Committee::Drivers::OpenAPI2::Driver

Inherits:
Driver
  • Object
show all
Defined in:
lib/committee/drivers/open_api_2/driver.rb

Instance Method Summary collapse

Instance Method Details

#default_allow_get_bodyObject



16
17
18
# File 'lib/committee/drivers/open_api_2/driver.rb', line 16

def default_allow_get_body
  true
end

#default_coerce_date_timesObject



7
8
9
# File 'lib/committee/drivers/open_api_2/driver.rb', line 7

def default_coerce_date_times
  false
end

#default_coerce_form_paramsObject

Whether parameters that were form-encoded will be coerced by default.



12
13
14
# File 'lib/committee/drivers/open_api_2/driver.rb', line 12

def default_coerce_form_params
  true
end

#default_path_paramsObject

Whether parameters in a request’s path will be considered and coerced by default.



22
23
24
# File 'lib/committee/drivers/open_api_2/driver.rb', line 22

def default_path_params
  true
end

#default_query_paramsObject

Whether parameters in a request’s query string will be considered and coerced by default.



28
29
30
# File 'lib/committee/drivers/open_api_2/driver.rb', line 28

def default_query_params
  true
end

#default_validate_success_onlyObject



32
33
34
# File 'lib/committee/drivers/open_api_2/driver.rb', line 32

def default_validate_success_only
  true
end

#nameObject



36
37
38
# File 'lib/committee/drivers/open_api_2/driver.rb', line 36

def name
  :open_api_2
end

#parse(data) ⇒ Object

Parses an API schema and builds a set of route definitions for use with Committee.

The expected input format is a data hash with keys as strings (as opposed to symbols) like the kind produced by JSON.parse or YAML.load.



45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# File 'lib/committee/drivers/open_api_2/driver.rb', line 45

def parse(data)
  REQUIRED_FIELDS.each do |field|
    if !data[field]
      raise ArgumentError, "Committee: no #{field} section in spec data."
    end
  end

  if data['swagger'] != '2.0'
    raise ArgumentError, "Committee: driver requires OpenAPI 2.0."
  end

  schema = Schema.new
  schema.driver = self

  schema.base_path = data['basePath'] || ''

  # Arbitrarily choose the first media type found in these arrays. This
  # approach could probably stand to be improved, but at least users will
  # for now have the option of turning media type validation off if they so
  # choose.
  schema.consumes = data['consumes'].first
  schema.produces = data['produces'].first

  schema.definitions, store = parse_definitions!(data)
  schema.routes = parse_routes!(data, schema, store)

  schema
end

#schema_classObject



74
75
76
# File 'lib/committee/drivers/open_api_2/driver.rb', line 74

def schema_class
  Committee::Drivers::OpenAPI2::Schema
end