module Swagger::Blocks::InternalHelpers

Public Class Methods

limit_root_node(root_nodes) click to toggle source

Make sure there is exactly one root_node and return it. TODO should this merge the contents of the root nodes instead?

# File lib/swagger/blocks/internal_helpers.rb, line 65
def self.limit_root_node(root_nodes)
  if root_nodes.length == 0
    raise Swagger::Blocks::DeclarationError.new(
      'swagger_root must be declared')
  elsif root_nodes.length > 1
    raise Swagger::Blocks::DeclarationError.new(
      'Only one swagger_root declaration is allowed.')
  end
  root_nodes.first
end
merge_components(component_node, swagger_nodes, key) click to toggle source
# File lib/swagger/blocks/internal_helpers.rb, line 58
def self.merge_components(component_node, swagger_nodes, key)
  component_node.data[key] ||= {}
  component_node.data[key].merge!(swagger_nodes[:component_node].data[key]) if swagger_nodes[:component_node].data[key]
end
parse_swaggered_classes(swaggered_classes) click to toggle source

Return [root_node, api_node_map] from all of the given swaggered_classes.

# File lib/swagger/blocks/internal_helpers.rb, line 5
def self.parse_swaggered_classes(swaggered_classes)
  root_nodes = []

  api_node_map = {}
  models_nodes = []

  path_node_map = {}
  schema_node_map = {}
  component_node = nil

  swaggered_classes.each do |swaggered_class|
    next unless swaggered_class.respond_to?(:_swagger_nodes, true)
    swagger_nodes = swaggered_class.send(:_swagger_nodes)
    root_node = swagger_nodes[:root_node]
    root_nodes << root_node if root_node

    # 2.0
    if swagger_nodes[:path_node_map]
      path_node_map.merge!(swagger_nodes[:path_node_map])
    end
    if swagger_nodes[:schema_node_map]
      schema_node_map.merge!(swagger_nodes[:schema_node_map])
    end
    if swagger_nodes[:component_node]
      if component_node
        merge_components(component_node, swagger_nodes, :examples)
        merge_components(component_node, swagger_nodes, :links)
        merge_components(component_node, swagger_nodes, :parameters)
        merge_components(component_node, swagger_nodes, :requestBodies)
        merge_components(component_node, swagger_nodes, :responses)
        merge_components(component_node, swagger_nodes, :schemas)
        merge_components(component_node, swagger_nodes, :securitySchemes)
      else
        component_node = swagger_nodes[:component_node]
      end
    end
  end

  data = {root_node: self.limit_root_node(root_nodes)}

  if data[:root_node].is_swagger_2_0?
    data[:path_nodes] = path_node_map
    data[:schema_nodes] = schema_node_map
  elsif data[:root_node].is_openapi_3_0?
    data[:path_nodes] = path_node_map
    data[:component_node] = component_node
  else
    data[:api_node_map] = api_node_map
    data[:models_nodes] = models_nodes
  end
  data
end