safebool 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3259e4df2ebfb2f5359249c7d1fc87dbb03c23d3
-  data.tar.gz: 8357baa33140416175df3b652581a30a381e0d9e
+  metadata.gz: b61c7f7d5196f735be3c79898e36e5fc018828ac
+  data.tar.gz: 99ea5034038bae80ccd19c7fa4bdd113673c124d
 SHA512:
-  metadata.gz: 12332af592e5acda2b25cfc6919c281c304fa0ed82f3804dab36736c32476e74d9cbc2c5d7f807b111f2fbc72cd210fa6858a0feb5ff2ef3b051aa7c633bfb68
-  data.tar.gz: ff2e864c3b041f56b78be5ef1a1342984487affd5d56b8ef440c495fd69889b4a75c7bdb701e9980c36d49c5b9481747a5eec25c54338d5666ad20c5b1438705
+  metadata.gz: 12fc6db01d0dab4916a22ed118aeace91b32be276a4e9c69ac4a4857b8a36a054d28705d970a9787b2567d3cda0a8f4e80cd5393ee0a1c1742fa6a00eb5e44b7
+  data.tar.gz: 19968f82c51794c0954a6b75b82f3417d0876d20695cef4686d0063c9b85835fd1d9972f5da07d739b47b5534c91a19abc13c0c505da48c64a9059a82e817add

data/README.md

@@ -47,8 +47,55 @@ Bool(1)               #=> NoMethodError: undefined method `Bool' for Kernel
 ...
 ```
 
+
+**Everything is `true` except `false` and `nil`.**
+Just use the bang bang (`!!`) doubled-up (logical) boolean not operator for `to_b` conversion:
+
+``` ruby
+!! false   #=> false
+!! nil     #=> false
+
+!! true    #=> true
+!! "false" #=> true
+!! ""      #=> true
+!! 0       #=> true
+!! 1       #=> true
+!! []      #=> true
+!! {}      #=> true
+!! 0.0     #=> true
+!! :false  #=> true
+# ...
+```
+
 Why? Why not? Discuss.
 
+## Intro
+
+### What's a Bool?
+
+In computer science, the Boolean data type is a data type that has one of two possible values (usually denoted _true_ and _false_),
+intended to represent the two truth values of logic and Boolean algebra.
+It is named after George Boole, who first defined an algebraic system of logic in the mid 19th century.
+
+(Source: [Boolean data type @ Wikipedia](https://en.wikipedia.org/wiki/Boolean_data_type))
+
+
+
+### Trivia Quiz - The States of Bool
+
+Q: How many states has a boolean type in a (classic) programming language?
+
+- [ A ] 1 - One State
+- [ B ] 2 - Two States
+- [ C ] 3 - Three States
+- [ D ] Other. Please tell
+
+A: In practice¹ three really :-), that is, `true`, `false` and
+undefined (e.g. `nil`).
+
+1: with nil-able / null-able types
+
+
 
 
 ## Usage
@@ -87,14 +134,14 @@ Bool(1)               #=> true
 
 How about handling errors on invalid bool values when converting / parsing?
 
-1. `to_b` always returns a bool even if the conversion / parsing fails e.g. `true` (for numbers) and `false` (for strings) on error
+1. `to_b` always returns a bool even if the conversion / parsing fails e.g. `true` for invalid numbers or strings and `false` (for empty / blank strings) on error
 2. `parse_bool / to_bool` always returns `nil` if the conversion / parsing fails
 3. `Bool()` always raises an `ArgumentError` if the conversion / parsing fails
    and a `TypeError` if the conversion is unsupported (e.g. expected required `parse_bool` method missing / undefined)
 
 
 ``` ruby
-"2".to_b                #=> false
+"2".to_b                #=> true
 "2".to_bool             #=> nil
 "2".to_bool.bool?       #=> false
 "2".to_bool.is_a?(Bool) #=> false
@@ -105,6 +152,17 @@ Bool("2")               #=> ArgumentError: invalid value "2":String for Bool();
 2.to_bool.bool?         #=> false
 2.to_bool.is_a?(Bool)   #=> false
 Bool(2)                 #=> ArgumentError: invalid value 2:Integer for Bool(); parse_bool failed (returns nil)
+
+"".to_b                  #=> false
+"".to_bool               #=> nil
+"".to_bool.bool?         #=> false
+"".to_bool.is_a?(Bool)   #=> false
+Bool("")                 #=> ArgumentError: invalid value "":String for Bool(); parse_bool failed (returns nil)
+
+# note: same for "blank" strings
+"  ".to_b                #=> false
+"  ".to_bool             #=> nil
+
 ...
 ```
 
@@ -114,7 +172,7 @@ Bool(2)                 #=> ArgumentError: invalid value 2:Integer for Bool(); p
 - Returns `true` if string is one of these values: **t**, **true**, **on**, **y**, **yes**, **1**.
 - Returns `false` if string is one of these values: **f**, **false**, **off**, **n**, **no**, **0**.
 
-For invalid boolean string values `to_b` returns `false` by default.
+For invalid boolean string values `to_b` returns `true` by default except for empty / blank strings where `to_b` returns `false`.
 See the "Handling Errors" section for more options.
 
 Note: The `Bool.parse` method ignores leading and trailing spaces and upper and lower cases e.g. ` FaLSe ` is the same as `false`.
@@ -170,8 +228,9 @@ Note: The `Bool.parse` method ignores leading and trailing spaces and upper and
 
 ''.to_b         #=> false
 ' '.to_b        #=> false
-'xxx'.to_b      #=> false
-'bool'.to_b     #=> false
+
+'xxx'.to_b      #=> true
+'bool'.to_b     #=> true
 
 ''.to_bool      #=> nil
 ' '.to_bool     #=> nil
@@ -198,8 +257,8 @@ Same as `self.to_s.to_b` or `self.to_s.to_bool`.
 :n.to_b        #=> false
 :no.to_b       #=> false
 
-:xxx.to_b      #=> false
-:bool.to_b     #=> false
+:xxx.to_b      #=> true
+:bool.to_b     #=> true
 
 :xxx.to_bool   #=> nil
 :bool.to_bool  #=> nil

data/lib/safebool.rb

@@ -140,9 +140,13 @@ end
 
 class String
   def to_b
-    value = parse_bool()
-    value = false  if value.nil?   ## note: return false (!) for all undefined / unknown string values that cannot convert to bool
-    value
+    if strip.empty?   ## add special case for empty / blank strings - return false (!)
+      value = false
+    else
+      value = parse_bool()
+      value = true  if value.nil?   ## note: return true  for all undefined / unknown string values that cannot convert to bool (except empty string)
+      value
+    end
   end
   def parse_bool() Bool.parse( self ); end
 end

data/lib/safebool/version.rb

@@ -9,7 +9,7 @@
 module SaferBool
 
   MAJOR = 1
-  MINOR = 1
+  MINOR = 2
   PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 

data/test/test_bool.rb

@@ -36,6 +36,20 @@ class TestBool < MiniTest::Test
 
     assert_equal true,   false.frozen?   ## (always) true by default
     assert_equal true,   true.frozen?    ## (always) true by default
+
+
+    assert_equal false,  !! false
+    assert_equal false,  !! nil
+
+    assert_equal true,   !! true
+    assert_equal true,   !! "false"
+    assert_equal true,   !! ""
+    assert_equal true,   !! 0
+    assert_equal true,   !! 1
+    assert_equal true,   !! []
+    assert_equal true,   !! {}
+    assert_equal true,   !! 0.0
+    assert_equal true,   !! :false
   end
 
   def test_parse
@@ -88,6 +102,12 @@ class TestBool < MiniTest::Test
     assert_equal true, Bool("y")
     assert_equal true, Bool("1")
 
+
+    assert_equal false, "".to_b
+    assert_equal false, "  ".to_b
+    assert_equal true,  "2".to_b
+    assert_equal true,  "xxx".to_b
+
     assert_equal true, "".to_bool == nil
     assert_equal true, "  ".to_bool == nil
     assert_equal true, "2".to_bool == nil
@@ -123,8 +143,12 @@ class TestBool < MiniTest::Test
     assert_equal true, Bool(:y)
     assert_equal true, Bool(:"1")
 
-    assert_equal true, :'2'.to_bool == nil
-    assert_equal true, :xxx.to_bool == nil
+    assert_equal false, :"  ".to_b
+    assert_equal true,  :"2".to_b
+    assert_equal true,  :"xxx".to_b
+
+    assert_equal true,  :'2'.to_bool == nil
+    assert_equal true,  :xxx.to_bool == nil
 
     assert_equal false, :'2'.to_bool.bool?
     assert_equal false, :'xxx'.to_bool.bool?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safebool
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-02 00:00:00.000000000 Z
+date: 2019-04-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdoc