Class: Dry::Validation::Failures

Inherits:
Object
  • Object
show all
Defined in:
lib/dry/validation/failures.rb

Overview

Failure accumulator object

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(path = ROOT_PATH) ⇒ Failures

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.

Returns a new instance of Failures.


29
30
31
32
# File 'lib/dry/validation/failures.rb', line 29

def initialize(path = ROOT_PATH)
  @path = Dry::Schema::Path[path]
  @opts = EMPTY_ARRAY.dup
end

Instance Attribute Details

#optsHash (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.

Options for messages

These options are used by MessageResolver

Returns:

  • (Hash)

26
27
28
# File 'lib/dry/validation/failures.rb', line 26

def opts
  @opts
end

#pathDry::Schema::Path (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.

The path for messages accumulated by failures object

Returns:


17
18
19
# File 'lib/dry/validation/failures.rb', line 17

def path
  @path
end

Instance Method Details

#failure(message) ⇒ Object #failure(id) ⇒ Object #failure(meta_hash) ⇒ Object

Set failure

Overloads:

  • #failure(message) ⇒ Object

    Set message text explicitly

    Examples:

    failure('this failed')

    Parameters:

    • message (String)

      The message text

  • #failure(id) ⇒ Object

    Use message identifier (needs localized messages setup)

    Examples:

    failure(:taken)

    Parameters:

    • id (Symbol)

      The message id

  • #failure(meta_hash) ⇒ Object

    Use meta_hash as a message (either explicitely or as an identifier), setting the rest of the hash as error meta attribute

    Examples:

    failure({text: :invalid, key: value})

    Parameters:

    • meta (Hash)

      The hash containing the message as value for the :text key

See Also:


59
60
61
62
# File 'lib/dry/validation/failures.rb', line 59

def failure(message, tokens = EMPTY_HASH)
  opts << { message: message, tokens: tokens, path: path }
  self
end