certainty 0.1.0 → 0.2.0

data/README.md

@@ -1,12 +1,28 @@
-# Boolean
+# Certainty
 
-Boolean is an object that represents truth.
+Certainty provides __Boolean__, an object that represents truth in
+Ruby.
 
-[![travis](https://secure.travis-ci.org/hakanensari/boolean.png)](http://travis-ci.org/hakanensari/boolean)
+The library posits three truth values: true, false, or unknown.
+
+[![travis](https://secure.travis-ci.org/hakanensari/certainty.png)](http://travis-ci.org/hakanensari/certainty)
 
 ## Usage
 
-Once you require, inquire.
+Add to your Gemfile.
+
+    gem 'certainty'
+
+Require.
+
+    require 'certainty'
+
+Inquire.
 
     true.is_a? Boolean
     => true
+
+Typecast.
+
+    Boolean("false")
+    => false

data/certainty.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.email       = ["code@papercavalier.com"]
   s.homepage    = "http://github.com/hakanensari/certainty"
   s.summary     = %q{An object that represents truth}
-  s.description = %q{Certainty sneaks Boolean, an object that represents truth, into Ruby.}
+  s.description = %q{Certainty provides Boolean, an object that represents truth.}
 
   s.rubyforge_project = "certainty"
 

data/lib/certainty.rb

@@ -1,9 +1,10 @@
 # = Certainty
 #
-# Sneaks +Boolean+, an object that represents truth, into Ruby.
+# Certainty provides +Boolean+, an object that represents truth.
 module Boolean; end
 
-[TrueClass, FalseClass].each do |klass|
+# The library posits three truth values: true, false, or unknown.
+[FalseClass, NilClass, TrueClass].each do |klass|
   klass.send :include, Boolean
 end
 
@@ -26,7 +27,7 @@ end
 
 class String
   # Returns +true+ if, downcased, the receiver is +"1"+ or +"true"+,
-  # +false+ if it is +"0"+ or +"false"+, or +nil+ otherwise.
+  # +false+ if +"0"+ or +"false"+, or +nil+ otherwise.
   def to_bool
     {
       '1'     => true,
@@ -39,8 +40,8 @@ class String
 end
 
 class Numeric
-  # Returns + true+ if the receiver, converted to float, is equal to
-  # +1.0+, +false+ if it is equal +0.0+, or +nil+ otherwise.
+  # Returns +true+ if the receiver, converted to float, is equal to
+  # +1.0+, +false+ if +0.0+, or +nil+ otherwise.
   def to_bool
     {
       1.0 => true,
@@ -51,8 +52,7 @@ class Numeric
 end
 
 module Kernel
-  # Converts _arg_ to a boolean object or +nil+ if its truth is not
-  # knowable.
+  # Converts _arg_ to a boolean object.
   def Boolean(arg)
     arg.to_bool
   end

data/lib/certainty/version.rb

@@ -1,3 +1,3 @@
 module Certainty
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/test/certainty_test.rb

@@ -8,8 +8,9 @@ require 'test/unit'
 
 class TestCertainty < Test::Unit::TestCase
   def test_existence
-    assert_kind_of Boolean, true
     assert_kind_of Boolean, false
+    assert_kind_of Boolean, nil
+    assert_kind_of Boolean, true
   end
 
   def test_boolean_representation

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: certainty
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,9 +9,9 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-08-20 00:00:00.000000000Z
+date: 2011-08-24 00:00:00.000000000Z
 dependencies: []
-description: Certainty sneaks Boolean, an object that represents truth, into Ruby.
+description: Certainty provides Boolean, an object that represents truth.
 email:
 - code@papercavalier.com
 executables: []
@@ -41,7 +41,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2654129636937927522
+      hash: -2904344466707709946
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -50,7 +50,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2654129636937927522
+      hash: -2904344466707709946
 requirements: []
 rubyforge_project: certainty
 rubygems_version: 1.8.6