Module: DbMod::Statements::Configuration::Defaults

Defined in:
lib/db_mod/statements/configuration/defaults.rb

Overview

Provides functionality backing the MethodConfiguration#defaults setting. Allows certain statement or prepared method parameters to be omitted, supplying default values where necessary:

def_statement(:a, 'SELECT id FROM a WHERE x > $y') { defaults y: 10 }
def_prepared(:b, %(
  INSERT INTO b
    (p, q, r)
  VALUES
    ($1, $2, $3)
  RETURNING p, q, r
)) { defaults(5, 6).single(:row) }

# ...

a    # y => 10
a 11 # y => 11

# defaults filled in from the right
b 1, 2 # => { 'p' => '1', 'q' => '2', 'r' => '6' }

Class Method Summary collapse

Class Method Details

.extend(definition, params, defaults) ⇒ Proc

Extend a method definition by wrapping it with a proc that will try to fill in any omitted arguments with given defaults.

Parameters:

  • definition (Proc) —

    base method definition, with parameter validation already attached

  • params (Hash<Symbol,value>, Array<value>) —

    see DbMod::Statements::Configuration.def_configurable

  • defaults (Hash<Symbol,value,Array<value>] default values, in the same form as they would be provided to the original method definition except that some values may be omitted) —

    efaults [Hash<Symbol,value,Array<value>] default values, in the same form as they would be provided to the original method definition except that some values may be omitted

Returns:

  • (Proc) —

    new method definition, or the same one if no default values have been appended



38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/db_mod/statements/configuration/defaults.rb', line 38

def self.extend(definition, params, defaults)
  return definition if defaults.nil?

  if [[], 0].include? params
    fail ArgumentError, 'defaults not allowed for no-args methods'
  end

  if params.is_a? Array
    extend_named_args_method(definition, defaults)
  else
    extend_fixed_args_method(definition, params, defaults)
  end
end

.extend_fixed_args_method(definition, arity, defaults) ⇒ Object (private)

Extend a method with numbered parameters, providing default argument values for one or more parameters. Defaults will be applied, in the same left-to-right order, but at the right-hand side of the parameter list, as with normal method default arguments.

Parameters:

  • definition (Proc) —

    base method definition, with parameter validation already attached

  • arity (Fixnum) —

    number of arguments expected by the base method definition

  • defaults (Array) —

    default parameter values



104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'lib/db_mod/statements/configuration/defaults.rb', line 104

def self.extend_fixed_args_method(definition, arity, defaults)
  fail ArgumentError, 'too many defaults' if defaults.size > arity

  unless defaults.is_a? Array
    fail ArgumentError, 'array expected for defaults'
  end

  arity = (arity - defaults.size)..arity
  fail ArgumentError, 'too many defaults' if arity.min < 0

  lambda do |*args|
    Defaults.use_fixed_defaults(args, defaults, arity)
    instance_exec(*args, &definition)
  end
end

.extend_named_args_method(definition, defaults) ⇒ Object (private)

Extend a method with named parameters, providing default argument values for one or more parameters.

Parameters:

  • definition (Proc) —

    base method definition, with parameter validation already attached

  • defaults (Hash<Symbol,value>) —

    default parameter values



61
62
63
64
65
66
67
68
69
70
 
# File 'lib/db_mod/statements/configuration/defaults.rb', line 61

def self.extend_named_args_method(definition, defaults)
  unless defaults.is_a? Hash
    fail ArgumentError, 'hash expected for defaults'
  end

  lambda do |*args|
    Defaults.use_named_defaults(args, defaults)
    instance_exec(*args, &definition)
  end
end

.use_fixed_defaults(args, defaults, arity) ⇒ Object (private)

Fill in any missing parameter arguments using default values where available.

Parameters:

  • args (Array) —

    method arguments before processing and validation

  • defaults (Array) —

    default parameter values

  • arity (Range<Fixnum>) —

    number of arguments expected by the base method definition



128
129
130
131
132
133
134
135
136
 
# File 'lib/db_mod/statements/configuration/defaults.rb', line 128

def self.use_fixed_defaults(args, defaults, arity)
  unless arity.include? args.count
    fail ArgumentError, "#{args.count} given, (#{arity}) expected"
  end

  defaults[args.size - arity.min...defaults.size].each do |arg|
    args << arg
  end
end

.use_named_defaults(args, defaults) ⇒ Object (private)

Fill in any missing parameter arguments using default values where available.

Parameters:

  • args ([Hash<Symbol,value>]) —

    method arguments before processing and validation

  • defaults (Hash<Symbol,value>) —

    default parameter values



79
80
81
82
83
84
85
86
87
88
89
90
 
# File 'lib/db_mod/statements/configuration/defaults.rb', line 79

def self.use_named_defaults(args, defaults)
  # Special case when no args given.
  args << {} if args.empty?

  # If the args are weird, expect normal parameter validation
  # to pick it up.
  return args unless args.last.is_a? Hash

  defaults.each do |arg, value|
    args.last[arg] = value unless args.last.key? arg
  end
end