class GrapeSwagger::DocMethods::BuildModelDefinition

Public Class Methods

build(_model, properties, required, other_def_properties = {}) click to toggle source
# File lib/grape-swagger/doc_methods/build_model_definition.rb, line 7
def build(_model, properties, required, other_def_properties = {})
  definition = { type: 'object', properties: properties }.merge(other_def_properties)

  definition[:required] = required if required.is_a?(Array) && required.any?

  definition
end
parse_params_from_model(parsed_response, model, model_name) click to toggle source
# File lib/grape-swagger/doc_methods/build_model_definition.rb, line 15
def parse_params_from_model(parsed_response, model, model_name)
  if parsed_response.is_a?(Hash) && parsed_response.keys.first == :allOf
    refs_or_models = parsed_response[:allOf]
    parsed = parse_refs_and_models(refs_or_models, model)

    {
      allOf: parsed
    }
  else
    properties, required = parsed_response
    unless properties&.any?
      raise GrapeSwagger::Errors::SwaggerSpec,
            "Empty model #{model_name}, swagger 2.0 doesn't support empty definitions."
    end
    properties, other_def_properties = parse_properties(properties)

    build(
      model, properties, required, other_def_properties
    )
  end
end
parse_properties(properties) click to toggle source
# File lib/grape-swagger/doc_methods/build_model_definition.rb, line 37
def parse_properties(properties)
  other_properties = {}

  discriminator_key, discriminator_value =
    properties.find do |_key, value|
      value[:documentation].try(:[], :is_discriminator)
    end

  if discriminator_key
    discriminator_value.delete(:documentation)
    properties[discriminator_key] = discriminator_value

    other_properties[:discriminator] = discriminator_key
  end

  [properties, other_properties]
end
parse_refs_and_models(refs_or_models, model) click to toggle source
# File lib/grape-swagger/doc_methods/build_model_definition.rb, line 55
def parse_refs_and_models(refs_or_models, model)
  refs_or_models.map do |ref_or_models|
    if ref_or_models.is_a?(Hash) && ref_or_models.keys.first == '$ref'
      ref_or_models
    else
      properties, required = ref_or_models
      GrapeSwagger::DocMethods::BuildModelDefinition.build(model, properties, required)
    end
  end
end