Module: Dry::Monads::RightBiased::Left

Included in:
Maybe::None, Dry::Monads::Result::Failure, Try::Error
Defined in:
lib/dry/monads/right_biased.rb

Overview

Left/wrong/erroneous part

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.trace_caller ⇒ String

Returns Caller location.

Returns:

  • (String) —

    Caller location



237
 
# File 'lib/dry/monads/right_biased.rb', line 237

def self.trace_caller = caller_locations(2, 1)[0].to_s

Instance Method Details

#and(_) ⇒ RightBiased::Left

Returns self back. It exists to keep the interface identical to that of Right.

Returns:



319
 
# File 'lib/dry/monads/right_biased.rb', line 319

def and(_, &) = self

#apply ⇒ RightBiased::Left

Ignores the input parameter and returns self. It exists to keep the interface identical to that of Right.

Returns:



301
 
# File 'lib/dry/monads/right_biased.rb', line 301

def apply(...) = self

#bind ⇒ RightBiased::Left

Ignores the input parameter and returns self. It exists to keep the interface identical to that of Right.

Returns:



246
 
# File 'lib/dry/monads/right_biased.rb', line 246

def bind(...) = self

#deconstruct ⇒ Object

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.

Pattern matching

Examples:

case Success(x)
in Success(Integer) then ...
in Success(2..100) then ...
in Success(2..200 => code) then ...
in Failure(_) then ...
end


332
333
334
335
336
337
338
339
340
 
# File 'lib/dry/monads/right_biased.rb', line 332

def deconstruct
  if Unit.equal?(@value)
    []
  elsif @value.is_a?(::Array)
    @value
  else
    [@value]
  end
end

#deconstruct_keys(keys) ⇒ Object

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.

Pattern matching hash values

Examples:

case Failure(x)
in Failure(code: 400...500) then :user_error
in Failure(code: 500...600) then :server_error
end


351
352
353
354
355
356
357
 
# File 'lib/dry/monads/right_biased.rb', line 351

def deconstruct_keys(keys)
  if @value.respond_to?(:deconstruct_keys)
    @value.deconstruct_keys(keys)
  else
    EMPTY_HASH
  end
end

#discard ⇒ RightBiased::Left

Returns self back. It exists to keep the interface identical to that of Right.

Returns:



307
 
# File 'lib/dry/monads/right_biased.rb', line 307

def discard = self

#flatten ⇒ RightBiased::Left

Returns self back. It exists to keep the interface identical to that of Right.

Returns:



313
 
# File 'lib/dry/monads/right_biased.rb', line 313

def flatten = self

#fmap ⇒ RightBiased::Left

Ignores the input parameter and returns self. It exists to keep the interface identical to that of Right.

Returns:



258
 
# File 'lib/dry/monads/right_biased.rb', line 258

def fmap(...) = self

#or ⇒ Object

Left-biased #bind version.

Examples:

Dry::Monads.Left(ArgumentError.new('error message')).or(&:message) # => "error message"
Dry::Monads.None.or('no value') # => "no value"
Dry::Monads.None.or { Time.now } # => current time

Returns:

  • (Object)

Raises:

  • (NotImplementedError) 


268
 
# File 'lib/dry/monads/right_biased.rb', line 268

def or(...) = raise NotImplementedError

#or_fmap ⇒ RightBiased::Left, RightBiased::Right

A lifted version of ‘#or`. This is basically `#or` + `#fmap`.

Examples:

Dry::Monads.None.or_fmap('no value') # => Some("no value")
Dry::Monads.None.or_fmap { Time.now } # => Some(current time)

Returns:

Raises:

  • (NotImplementedError) 


284
 
# File 'lib/dry/monads/right_biased.rb', line 284

def or_fmap(...) = raise NotImplementedError

#tee ⇒ RightBiased::Left

Ignores the input parameter and returns self. It exists to keep the interface identical to that of Right.

Returns:



252
 
# File 'lib/dry/monads/right_biased.rb', line 252

def tee(...) = self

#value! ⇒ Object

Raises an error on accessing internal value

Raises:



240
 
# File 'lib/dry/monads/right_biased.rb', line 240

def value! = raise UnwrapError, self

#value_or(val = nil) ⇒ Object

Returns the passed value

Returns:

  • (Object) 


289
290
291
292
293
294
295
 
# File 'lib/dry/monads/right_biased.rb', line 289

def value_or(val = nil)
  if block_given?
    yield
  else
    val
  end
end

#|(alt) ⇒ RightBiased::Right, RightBiased::Left

Returns the passed value. Works in pair with Right#|.

Parameters:

Returns:



275
 
# File 'lib/dry/monads/right_biased.rb', line 275

def |(alt) = self.or(alt)