Module: CMDx::Coercions::Boolean

Extended by:
Boolean
Included in:
Boolean
Defined in:
lib/cmdx/coercions/boolean.rb

Overview

Converts various input types to Boolean format

Handles conversion from strings, numbers, and other values to boolean using predefined truthy and falsey patterns.

Constant Summary collapse

FALSEY =

Rbs:

  • FALSEY: Regexp

/\A(false|f|no|n|0)\z/i
TRUTHY =

Rbs:

  • TRUTHY: Regexp

/\A(true|t|yes|y|1)\z/i

Instance Method Summary collapse

Instance Method Details

#call(value, options = EMPTY_HASH) ⇒ Boolean

Converts a value to a Boolean

Examples:

Convert truthy strings to true

Boolean.call("true")   # => true
Boolean.call("yes")    # => true
Boolean.call("1")      # => true

Convert falsey strings to false

Boolean.call("false")  # => false
Boolean.call("no")     # => false
Boolean.call("0")      # => false
Boolean.call(nil)      # => false
Boolean.call("")       # => false

Handle case-insensitive input

Boolean.call("TRUE")   # => true
Boolean.call("False")  # => false

Handle edge cases

Boolean.call("abc")    # => raises CoercionError

Parameters:

  • value (Object) —

    The value to convert to boolean

  • options (Hash) (defaults to: EMPTY_HASH) —

    Optional configuration parameters (currently unused)

Options Hash (options):

  • :unused (Object) —

    Currently no options are used

Returns:

  • (Boolean) —

    The converted boolean value

Raises:

  • (CoercionError) —

    If the value cannot be converted to boolean

Rbs:

  • (untyped value, ?Hash[Symbol, untyped] options) -> bool



46
47
48
49
50
51
52
53
54
 
# File 'lib/cmdx/coercions/boolean.rb', line 46

def call(value, options = EMPTY_HASH)
  case value.to_s
  when FALSEY, EMPTY_STRING then false
  when TRUTHY then true
  else
    type = Locale.t("cmdx.types.boolean")
    raise CoercionError, Locale.t("cmdx.coercions.into_a", type:)
  end
end