Class: Grape::Endpoint

Inherits:
Object
  • Object
show all
Defined in:
lib/grape-swagger/endpoint.rb

Constant Summary collapse

SUPPORTS_CONSUMES = 
%i[post put patch].freeze

Instance Method Summary collapse

Instance Method Details

#add_definitions_from(models) ⇒ Object 



89
90
91
92
93
 
# File 'lib/grape-swagger/endpoint.rb', line 89

def add_definitions_from(models)
  return if models.nil?

  models.each { |x| expose_params_from_model(x) }
end

#consumes_object(route, format) ⇒ Object 



171
172
173
174
175
 
# File 'lib/grape-swagger/endpoint.rb', line 171

def consumes_object(route, format)
  return unless SUPPORTS_CONSUMES.include?(route.request_method.downcase.to_sym)

  GrapeSwagger::DocMethods::ProducesConsumes.call(route.settings.dig(:description, :consumes) || format)
end

#contact_object(infos) ⇒ Object

contact



69
70
71
72
73
74
75
 
# File 'lib/grape-swagger/endpoint.rb', line 69

def contact_object(infos)
  {
    name: infos.delete(:contact_name),
    email: infos.delete(:contact_email),
    url: infos.delete(:contact_url)
  }.delete_if { |_, value| value.blank? }
end

#content_types_for(target_class) ⇒ Object 



9
10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'lib/grape-swagger/endpoint.rb', line 9

def content_types_for(target_class)
  content_types = (target_class.content_types || {}).values

  if content_types.empty?
    formats       = [target_class.format, target_class.default_format].compact.uniq
    formats       = Grape::Formatter.formatters({}).keys if formats.empty?
    content_types = Grape::ContentTypes::CONTENT_TYPES.select do |content_type, _mime_type|
      formats.include? content_type
    end.values
  end

  content_types.uniq
end

#deprecated_object(route) ⇒ Object 



132
133
134
 
# File 'lib/grape-swagger/endpoint.rb', line 132

def deprecated_object(route)
  route.options[:deprecated] if route.options.key?(:deprecated)
end

#description_object(route) ⇒ Object 



148
149
150
151
152
153
 
# File 'lib/grape-swagger/endpoint.rb', line 148

def description_object(route)
  description = route.description if route.description.present?
  description = route.options[:detail] if route.options.key?(:detail)

  description
end

#http_codes_from_route(route) ⇒ Object 



233
234
235
236
237
238
239
 
# File 'lib/grape-swagger/endpoint.rb', line 233

def http_codes_from_route(route)
  if route.http_codes.is_a?(Array) && route.http_codes.any? { |code| success_code?(code) }
    route.http_codes.clone
  else
    success_codes_from_route(route) + (route.http_codes || route.options[:failure] || [])
  end
end

#info_object(infos) ⇒ Object

building info object



44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/grape-swagger/endpoint.rb', line 44

def info_object(infos)
  result = {
    title: infos[:title] || 'API title',
    description: infos[:description],
    termsOfService: infos[:terms_of_service_url],
    contact: contact_object(infos),
    license: license_object(infos),
    version: infos[:version]
  }

  GrapeSwagger::DocMethods::Extensions.add_extensions_to_info(infos, result)

  result.delete_if { |_, value| value.blank? }
end

#license_object(infos) ⇒ Object

sub-objects of info object license



61
62
63
64
65
66
 
# File 'lib/grape-swagger/endpoint.rb', line 61

def license_object(infos)
  {
    name: infos.delete(:license),
    url: infos.delete(:license_url)
  }.delete_if { |_, value| value.blank? }
end

#method_object(route, options, path) ⇒ Object 



115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
 
# File 'lib/grape-swagger/endpoint.rb', line 115

def method_object(route, options, path)
  method = {}
  method[:summary]     = summary_object(route)
  method[:description] = description_object(route)
  method[:produces]    = produces_object(route, options[:produces] || options[:format])
  method[:consumes]    = consumes_object(route, options[:format])
  method[:parameters]  = params_object(route, options, path)
  method[:security]    = security_object(route)
  method[:responses]   = response_object(route, options)
  method[:tags]        = route.options.fetch(:tags, tag_object(route, path))
  method[:operationId] = GrapeSwagger::DocMethods::OperationId.build(route, path)
  method[:deprecated] = deprecated_object(route)
  method.delete_if { |_, value| value.nil? }

  [route.request_method.downcase.to_sym, method]
end

#params_object(route, options, path) ⇒ Object 



177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
 
# File 'lib/grape-swagger/endpoint.rb', line 177

def params_object(route, options, path)
  parameters = partition_params(route, options).map do |param, value|
    value = { required: false }.merge(value) if value.is_a?(Hash)
    _, value = default_type([[param, value]]).first if value == ''
    if value.dig(:documentation, :type)
      expose_params(value[:documentation][:type])
    elsif value[:type]
      expose_params(value[:type])
    end
    GrapeSwagger::DocMethods::ParseParams.call(param, value, path, route, @definitions)
  end

  if GrapeSwagger::DocMethods::MoveParams.can_be_moved?(route.request_method, parameters)
    parameters = GrapeSwagger::DocMethods::MoveParams.to_definition(path, parameters, route, @definitions)
  end

  GrapeSwagger::DocMethods::FormatData.to_format(parameters)

  parameters.presence
end

#path_and_definition_objects(namespace_routes, options) ⇒ Object

building path and definitions objects



78
79
80
81
82
83
84
85
86
87
 
# File 'lib/grape-swagger/endpoint.rb', line 78

def path_and_definition_objects(namespace_routes, options)
  @paths = {}
  @definitions = {}
  namespace_routes.each_value do |routes|
    path_item(routes, options)
  end

  add_definitions_from options[:models]
  [@paths, @definitions]
end

#path_item(routes, options) ⇒ Object

path object



96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
 
# File 'lib/grape-swagger/endpoint.rb', line 96

def path_item(routes, options)
  routes.each do |route|
    next if hidden?(route, options)

    @item, path = GrapeSwagger::DocMethods::PathString.build(route, options)
    @entity = route.entity || route.options[:success]

    verb, method_object = method_object(route, options, path)

    if @paths.key?(path.to_s)
      @paths[path.to_s][verb] = method_object
    else
      @paths[path.to_s] = { verb => method_object }
    end

    GrapeSwagger::DocMethods::Extensions.add(@paths[path.to_s], @definitions, route)
  end
end

#produces_object(route, format) ⇒ Object 



155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/grape-swagger/endpoint.rb', line 155

def produces_object(route, format)
  return ['application/octet-stream'] if file_response?(route.attributes.success) &&
                                         !route.attributes.produces.present?

  mime_types = GrapeSwagger::DocMethods::ProducesConsumes.call(format)

  route_mime_types = %i[formats content_types produces].map do |producer|
    possible = route.options[producer]
    GrapeSwagger::DocMethods::ProducesConsumes.call(possible) if possible.present?
  end.flatten.compact.uniq

  route_mime_types.present? ? route_mime_types : mime_types
end

#response_object(route, options) ⇒ Object 



198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
 
# File 'lib/grape-swagger/endpoint.rb', line 198

def response_object(route, options)
  codes = http_codes_from_route(route)
  codes.map! { |x| x.is_a?(Array) ? { code: x[0], message: x[1], model: x[2], examples: x[3], headers: x[4] } : x }

  codes.each_with_object({}) do |value, memo|
    value[:message] ||= ''
    memo[value[:code]] = { description: value[:message] }

    memo[value[:code]][:headers] = value[:headers] if value[:headers]

    next build_file_response(memo[value[:code]]) if file_response?(value[:model])

    response_model = @item
    response_model = expose_params_from_model(value[:model]) if value[:model]

    if memo.key?(200) && route.request_method == 'DELETE' && value[:model].nil?
      memo[204] = memo.delete(200)
      value[:code] = 204
    end

    next if value[:code] == 204
    next unless !response_model.start_with?('Swagger_doc') && (@definitions[response_model] || value[:model])

    @definitions[response_model][:description] = description_object(route)

    memo[value[:code]][:schema] = build_reference(route, value, response_model, options)
    memo[value[:code]][:examples] = value[:examples] if value[:examples]
  end
end

#security_object(route) ⇒ Object 



136
137
138
 
# File 'lib/grape-swagger/endpoint.rb', line 136

def security_object(route)
  route.options[:security] if route.options.key?(:security)
end

#success_code?(code) ⇒ Boolean

Returns:

  • (Boolean) 


228
229
230
231
 
# File 'lib/grape-swagger/endpoint.rb', line 228

def success_code?(code)
  status = code.is_a?(Array) ? code.first : code[:code]
  status.between?(200, 299)
end

#success_codes_from_route(route) ⇒ Object 



241
242
243
244
245
246
247
248
249
 
# File 'lib/grape-swagger/endpoint.rb', line 241

def success_codes_from_route(route)
  if @entity.is_a?(Array)
    return @entity.map do |entity|
      success_code_from_entity(route, entity)
    end
  end

  [success_code_from_entity(route, @entity)]
end

#summary_object(route) ⇒ Object 



140
141
142
143
144
145
146
 
# File 'lib/grape-swagger/endpoint.rb', line 140

def summary_object(route)
  summary = route.options[:desc] if route.options.key?(:desc)
  summary = route.description if route.description.present? && route.options.key?(:detail)
  summary = route.options[:summary] if route.options.key?(:summary)

  summary
end

#swagger_object(target_class, request, options) ⇒ Object

swagger spec2.0 related parts

required keys for SwaggerObject



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/grape-swagger/endpoint.rb', line 26

def swagger_object(target_class, request, options)
  object = {
    info: info_object(options[:info].merge(version: options[:doc_version])),
    swagger: '2.0',
    produces: content_types_for(target_class),
    authorizations: options[:authorizations],
    securityDefinitions: options[:security_definitions],
    security: options[:security],
    host: GrapeSwagger::DocMethods::OptionalObject.build(:host, options, request),
    basePath: GrapeSwagger::DocMethods::OptionalObject.build(:base_path, options, request),
    schemes: options[:schemes].is_a?(String) ? [options[:schemes]] : options[:schemes]
  }

  GrapeSwagger::DocMethods::Extensions.add_extensions_to_root(options, object)
  object.delete_if { |_, value| value.blank? }
end

#tag_object(route, path) ⇒ Object 



251
252
253
254
255
256
257
258
259
260
 
# File 'lib/grape-swagger/endpoint.rb', line 251

def tag_object(route, path)
  version = GrapeSwagger::DocMethods::Version.get(route)
  version = [version] unless version.is_a?(Array)
  prefix = route.prefix.to_s.split('/').reject(&:empty?)
  Array(
    path.split('{')[0].split('/').reject(&:empty?).delete_if do |i|
      prefix.include?(i) || version.map(&:to_s).include?(i)
    end.first
  ).presence
end