Class: Might::FilterParameterDefinition

Inherits:
Object
  • Object
show all
Defined in:
lib/might/filter_parameter_definition.rb

Overview

Filtering parameter definition

Direct Known Subclasses

FilterUndefinedParameter

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, options = {}) ⇒ FilterParameterDefinition

Returns a new instance of FilterParameterDefinition.

Parameters:

  • name (String) —

    of the field

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :on (Symbol, {Symbol => String}, {Symbol => <String>}) — default: nil —

    filter on given relation

  • :predicates (<String>) — default: ALL_PREDICATES —

    white-listed predicates

  • :coerce (Proc) —

    coercion for the value

  • :validates (Hash{Symbol => any}) —

    for the value @example

    validates: presence: true, length: { is: 6 }



33
34
35
36
37
38
39
40
41
 
# File 'lib/might/filter_parameter_definition.rb', line 33

def initialize(name, options = {})
  options.assert_valid_keys(:as, :on, :predicates, :coerce, :validates)
  @as = options.fetch(:as, name).to_s
  @name = name.to_s
  @on = options[:on]
  @predicates = Array(options.fetch(:predicates, FilterPredicates.all)).map(&:to_s)
  @coerce = options.fetch(:coerce, ->(v) { v })
  @validations = options.fetch(:validates, {})
end

Instance Attribute Details

#as ⇒ String (readonly)

If the property name doesn’t match the name in the query string, use the :as option

Returns:

  • (String) 


11
12
13
 
# File 'lib/might/filter_parameter_definition.rb', line 11

def as
  @as
end

#name ⇒ String (readonly)

Returns:

  • (String) 


14
15
16
 
# File 'lib/might/filter_parameter_definition.rb', line 14

def name
  @name
end

#on ⇒ String? (readonly)

Association on which this parameter is defined.

Returns:

  • (String, nil) 


18
19
20
 
# File 'lib/might/filter_parameter_definition.rb', line 18

def on
  @on
end

#predicates ⇒ <String> (readonly)

White-listed predicates

Returns:

  • (<String>) 


22
23
24
 
# File 'lib/might/filter_parameter_definition.rb', line 22

def predicates
  @predicates
end

#validations ⇒ Proc (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Proc with defined validations

Returns:

  • (Proc) 


80
81
82
 
# File 'lib/might/filter_parameter_definition.rb', line 80

def validations
  @validations
end

Instance Method Details

#==(other) ⇒ Object 



50
51
52
53
54
55
56
 
# File 'lib/might/filter_parameter_definition.rb', line 50

def ==(other)
  other.is_a?(self.class) &&
    other.name == name &&
    other.as == as &&
    other.on == on &&
    other.predicates == predicates
end

#coerce(value) ⇒ any

Returns coerced value according the definition.

Parameters:

  • value (any)

Returns:

  • (any) —

    coerced value according the definition



61
62
63
 
# File 'lib/might/filter_parameter_definition.rb', line 61

def coerce(value)
  @coerce.call(value)
end

#defined? ⇒ Boolean

Returns:

  • (Boolean) 


69
70
71
 
# File 'lib/might/filter_parameter_definition.rb', line 69

def defined?
  true
end

#eql?(other) ⇒ Boolean

Returns:

  • (Boolean) 


46
47
48
 
# File 'lib/might/filter_parameter_definition.rb', line 46

def eql?(other)
  other.is_a?(self.class) && other.name == name
end

#undefined? ⇒ Boolean

Returns:

  • (Boolean) 


73
74
75
 
# File 'lib/might/filter_parameter_definition.rb', line 73

def undefined?
  !self.defined?
end

#validator ⇒ Object 



65
66
67
 
# File 'lib/might/filter_parameter_definition.rb', line 65

def validator
  FilterValueValidator.build(self)
end