Sha256: 27286363cf74733f1f0a5ab66df5bda2ae6e23dcaf9a9a5844f04992f99f6012
Contents?: true
Size: 1.48 KB
Versions: 10
Compression:
Stored size: 1.48 KB
Contents
# frozen_string_literal: true
# author: Vadim Shaveiko <@vshaveyko>
module RailsApiDoc::Controller::Parameter
VALID_KEYS = [:type, :required, :enum, :model].freeze #:nodoc:
# Use parameter in controller to defined REQUEST parameter.
# Adds it to repository: RailsApiDoc::Controller::Parameter::Repository
def parameter(name, options, &block)
raise ArgumentError, 'Parameter already defined.' if repo.key?(name)
validate_options(options, block_given?)
define_parameter(name, options, &block)
end
private
def validate_options(options, block_given)
if options.nil? || options.empty?
raise ArgumentError, 'Empty options passed.'
end
options.assert_valid_keys(VALID_KEYS)
Repository::Param.valid_type?(options[:type])
Repository::Param.valid_enum?(options[:enum])
Repository::Param.valid_nested?(options[:type], block_given)
end
# default repo can be reassigned to deal with nested parameters
# see nested_parameter
def repo
@repo || Repository[self]
end
def define_parameter(name, parameter_data, &block)
repo[name] = \
if Repository::Param.valid_nested?(parameter_data[:type], block_given?)
Repository::Param.new(name, nested_parameter(parameter_data, &block))
else
Repository::Param.new(name, parameter_data)
end
end
def nested_parameter(parameter_data)
_backup_repo = @repo
@repo = {}
yield
parameter_data.merge(nested: @repo)
ensure
@repo = _backup_repo
end
end
Version data entries
10 entries across 10 versions & 1 rubygems