Class: Tram::Policy::Errors

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/tram/policy/errors.rb

Overview

Enumerable collection of unique unordered validation errors

Notice: A collection is context-dependent;

it knows about a scope of policy it belongs to,
and how to translate error messages in that scope.

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#policy ⇒ Tram::Policy (readonly)

Returns the poplicy errors provided by.

Returns:



15
16
17
 
# File 'lib/tram/policy/errors.rb', line 15

def policy
  @policy
end

Instance Method Details

#add(message = nil, **tags) ⇒ self

Adds error message to the collection

Parameters:

  • message (#to_s) (defaults to: nil) —

    Either a message, or a symbolic key for translation

  • tags (Hash<Symbol, Object>) —

    Tags to be attached to the message

Returns:

  • (self) —

    the collection

Raises:

  • (ArgumentError) 


23
24
25
26
27
28
29
 
# File 'lib/tram/policy/errors.rb', line 23

def add(message = nil, **tags)
  message ||= tags.delete(:message)
  raise ArgumentError.new("Error message should be defined") unless message

  @set << Tram::Policy::Error.new(@policy.t(message, tags), **tags)
  self
end

#by_tags(**filter) ⇒ Hash<Symbol, Object>

Selects errors filtered by tags

Parameters:

  • filter (Hash<Symbol, Object>)

Returns:

  • (Hash<Symbol, Object>) 


45
46
47
48
 
# File 'lib/tram/policy/errors.rb', line 45

def by_tags(**filter)
  filter = filter.to_a
  reject { |error| (filter - error.to_h.to_a).any? }
end

#each ⇒ Enumerator<Tram::Policy::Error>

Iterates by collected errors

Returns:



36
37
38
 
# File 'lib/tram/policy/errors.rb', line 36

def each
  @set.each { |error| yield(error) }
end

#empty?(&block) ⇒ Boolean

Checks whether a collection is empty

Returns:

  • (Boolean) 


54
55
56
 
# File 'lib/tram/policy/errors.rb', line 54

def empty?(&block)
  block ? !any?(&block) : !any?
end

#full_messages ⇒ Array<String>

The array of ordered error messages with error tags info

Returns:

  • (Array<String>) 


70
71
72
 
# File 'lib/tram/policy/errors.rb', line 70

def full_messages
  @set.map(&:full_message).sort
end

#merge(other) ⇒ Object

Merges other collection to the current one and returns new collection with the current scope

param [Tram::Policy::Errors] other Collection to be merged yieldparam [Hash<Symbol, Object>]

Examples:

Add some tag to merged errors

policy.merge(other) { |err| err[:source] = "other" }



83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/tram/policy/errors.rb', line 83

def merge(other)
  return self unless other.is_a?(self.class) && other.any?

  if block_given?
    other.each { |err| add yield(err.to_h) }
  else
    @set |= other.to_a
  end

  self
end

#messages ⇒ Array<String>

The array of ordered error messages

Returns:

  • (Array<String>) 


62
63
64
 
# File 'lib/tram/policy/errors.rb', line 62

def messages
  @set.map(&:message).sort
end