Class: GrapeSwagger::DocMethods::Extensions

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

Class Method Summary collapse

Class Method Details

.add(path, definitions, route) ⇒ Object 



5
6
7
8
9
10
11
12
13
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 5

def add(path, definitions, route)
  @route = route
  description = route.route_settings[:description]
  add_extension_to(path[method], extension(description)) if description && extended?(description, :x)

  settings = route.route_settings
  add_extensions_to_path(settings, path) if settings && extended?(settings, :x_path)
  add_extensions_to_definition(settings, path, definitions) if settings && extended?(settings, :x_def)
end

.add_extension_to(part, extensions) ⇒ Object 



43
44
45
46
47
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 43

def add_extension_to(part, extensions)
  concatenate(extensions).each do |key, value|
    part[key] = value
  end
end

.add_extensions_to_definition(settings, path, definitions) ⇒ Object 



19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 19

def add_extensions_to_definition(settings, path, definitions)
  def_extension = extension(settings, :x_def)

  if def_extension[:x_def].is_a?(Array)
    def_extension[:x_def].each do |extension|
      next unless extension.key?(:for)
      status = extension.delete(:for)
      definition = find_definition(status, path)
      add_extension_to(definitions[definition], x_def: extension)
    end
  else
    return unless def_extension[:x_def].key?(:for)
    status = def_extension[:x_def].delete(:for)
    definition = find_definition(status, path)
    add_extension_to(definitions[definition], def_extension)
  end
end

.add_extensions_to_path(settings, path) ⇒ Object 



15
16
17
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 15

def add_extensions_to_path(settings, path)
  add_extension_to(path, extension(settings, :x_path))
end

.concatenate(extensions) ⇒ Object 



49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 49

def concatenate(extensions)
  result = {}

  extensions.values.each do |extension|
    extension.each do |key, value|
      result["x-#{key}"] = value
    end
  end

  result
end

.extended?(part, identifier = :x) ⇒ Boolean 



61
62
63
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 61

def extended?(part, identifier = :x)
  !extension(part, identifier).empty?
end

.extension(part, identifier = :x) ⇒ Object 



65
66
67
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 65

def extension(part, identifier = :x)
  part.select { |x| x == identifier }
end

.find_definition(status, path) ⇒ Object 



37
38
39
40
41
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 37

def find_definition(status, path)
  response = path[method][:responses][status]

  response[:schema]['$ref'].split('/').last
end

.method ⇒ Object 



69
70
71
 
# File 'lib/grape-swagger/doc_methods/extensions.rb', line 69

def method
  @route.route_method.downcase.to_sym
end