h1. Boolean – Additional Boolean-related core extensions

| Author | Tim Morgan | | Version | 1.0 (Feb 15, 2011) | | License | Released under the MIT license. |

h2. About

Boolean adds some helpful methods for working with Ruby’s Boolean types, @TrueClass@ and @FalseClass@ (the singleton classes whose only instances are @true@ and @false@, respectively).

With Boolean, you get a @Boolean@ mixin so you can refer to @true@ and @false@ under a common class name:

<pre><code>

if variable.kind_of?(Boolean) then
  [ ... ]
end

</code></pre>

You can also type-cast Ruby objects into their Boolean values:

<pre><code>

"string".to_bool #=> true
nil.to_bool #=> false

</code></pre>

And you can parse various Ruby objects to Booleans:

<pre><code>

"yes".parse_bool #=> true
"no".parse_bool #=> false
1.parse_bool => true
0.parse_bool => false

</code></pre>

(@parse_bool@ is also aliased as @to_b@ to be consistent with the @to_i@/@to_int@ naming paradigm.)

Lastly, inline with the @Integer()@ method, you have a @Boolean()@ method:

<pre><code>

Boolean("yes") #=> true
Boolean("no") #=> false
Boolean("maybe") #=> ArgumentError

</code></pre>

h2. Installation and Usage

Just add the gem to your project’s @Gemfile@:

<pre> gem 'boolean' </pre>

All the features shown in the previous section are now available in your project code.

More information can be found in the class and method documentation.