Class: Dry::Monads::Try::Error

Inherits:
Dry::Monads::Try show all
Includes:
RightBiased::Left
Defined in:
lib/dry/monads/try.rb,
lib/dry/monads/maybe.rb,
lib/dry/monads/result.rb

Overview

Represents a result of a failed execution.

Constant Summary

Constants inherited from Dry::Monads::Try

DEFAULT_EXCEPTIONS

Instance Attribute Summary

Attributes inherited from Dry::Monads::Try

#exception

Instance Method Summary collapse

Methods included from RightBiased::Left

#and, #apply, #bind, #deconstruct, #deconstruct_keys, #discard, #flatten, #fmap, #or_fmap, #tee, trace_caller, #value!, #value_or, #|

Methods inherited from Dry::Monads::Try

[], #error?, pure, run, #to_monad, #value?

Constructor Details

#initialize(exception) ⇒ Error

Returns a new instance of Error.

Parameters:

  • exception (Exception) 


178
179
180
181
182
 
# File 'lib/dry/monads/try.rb', line 178

def initialize(exception)
  super()

  @exception = @value = exception
end

Instance Method Details

#===(other) ⇒ Boolean

Parameters:

Returns:

  • (Boolean) 


208
 
# File 'lib/dry/monads/try.rb', line 208

def ===(other) = Error === other && exception === other.exception

#or(*args) ⇒ Object

If a block is given passes internal value to it and returns the result, otherwise simply returns the first argument.

Examples:

Try(ZeroDivisionError) { 1 / 0 }.or { "zero!" } # => "zero!"

Parameters:

  • args (Array<Object>) —

    arguments that will be passed to a block if one was given, otherwise the first value will be returned

Returns:

  • (Object) 


198
199
200
201
202
203
204
 
# File 'lib/dry/monads/try.rb', line 198

def or(*args)
  if block_given?
    yield(exception, *args)
  else
    args[0]
  end
end

#recover(*errors) ⇒ Try::Value

Acts in a similar way to ‘rescue`. It checks if Dry::Monads::Try#exception is one of errors and yields the block if so.

Parameters:

  • errors (Class) —

    List of Exception subclasses

Returns:



216
217
218
219
220
221
222
223
224
225
226
227
228
 
# File 'lib/dry/monads/try.rb', line 216

def recover(*errors)
  if errors.empty?
    classes = DEFAULT_EXCEPTIONS
  else
    classes = errors
  end

  if classes.any? { _1 === exception }
    Value.new([exception.class], yield(exception))
  else
    self
  end
end

#to_maybe ⇒ Maybe::None

Returns:



392
 
# File 'lib/dry/monads/maybe.rb', line 392

def to_maybe = Maybe::None.new(RightBiased::Left.trace_caller)

#to_result ⇒ Result::Failure

Returns:



414
415
416
 
# File 'lib/dry/monads/result.rb', line 414

def to_result
  Result::Failure.new(exception, RightBiased::Left.trace_caller)
end

#to_s ⇒ String Also known as: inspect

Returns:

  • (String) 


185
 
# File 'lib/dry/monads/try.rb', line 185

def to_s = "Try::Error(#{exception.class}: #{exception.message})"