or_else 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 79c6cb9790f5406597f0893b6e215b33c94b8c0a
-  data.tar.gz: 075f9a3527c45f78fb9645b32b172efb94b028c5
+  metadata.gz: 909970b9f0b817e9663f287b9aa0d80a2c7d4cda
+  data.tar.gz: 5d4e9eba25df54eb18c26a2bd6231ce83222709c
 SHA512:
-  metadata.gz: dfb0c9517204b5b98b32d1a444defd6ac0cc3456e9df200ada6b6dd227f8088c5573f54099e2ba320c820a18d9cf64a857ddc803903c39aebdea402fa1217f8d
-  data.tar.gz: 56772dd2e9003a4aef7e4f18dd4acfe8fcabf26069556ae180ad86c5dde779717f50c517a565498079a395f3bc8b65f6f0ce6e6f16ea8868125777891c8abbb8
+  metadata.gz: 1963215cf7c74943f5d0fbd5a68bc67d20a397dd3a7e1a8f0b5d269d6b407b6c25d2a9f046951ab6078e16d7e2a740381a29cd880d25d292a0fd1c02646ab5ad
+  data.tar.gz: b1799d401e976b8211648390ec42733d4250c531af2cbd9720513faeedb76344701e4425837883406441fc297cf7f13b12542b72b1dda05ed08427c8cc5fdb7b

data/README.md

@@ -19,21 +19,27 @@ Or install it yourself as:
 ## Usage
 
 ```ruby
-value = Maybe(nil)        # => <OrElse::NothingClass>
+value = Maybe(nil)        # => Nothing
 value.empty?              # => true
 value.nil?                # => true
 value.exists?             # => false
-value.map { |v| v }       # => <OrElse::NothingClass>
-value.flat_map { |v| v }  # => <OrElse::NothingClass>
+value.map { |v| v }       # => Nothing (Block is ignored)
+value.flat_map { |v| Maybe(v) }  # => Nothing (Block is ignored)
 value.or_else { 'foo' }   # => 'foo'
 
 value = Maybe('value')    # => <OrElse::Just>
 value.empty?              # => false
 value.nil?                # => false
 value.exists?             # => true
-value.map { |v| v }       # => 'value'
-value.flat_map { |v| v }  # => 'value'
-value.or_else { 'foo' }   # => 'value'
+value.map { |v| v }       # => <OrElse::Just> (Block is yielded the bare value and the block is wrapped in a Maybe)
+value.flat_map { |v| Maybe(v) }  # => <OrElse::Just> (Block is yielded the bare value)
+value.or_else { 'foo' }   # => 'value' (Block is ignored)
+```
+
+Real life example:
+
+```
+comment = Maybe(post.comments.first).or_else { post.comments.build }
 ```
 
 ## Contributing

data/lib/or_else/just.rb

@@ -8,7 +8,7 @@ module OrElse
     end
 
     def map
-      yield Just.new(value)
+      Maybe(yield value)
     end
 
     def flat_map

data/lib/or_else/version.rb

@@ -1,3 +1,3 @@
 module OrElse
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end

data/spec/or_else/just_spec.rb

@@ -26,20 +26,24 @@ module OrElse
       context 'when initialized with 1' do
         let(:val) { 1 }
 
-        specify { expect { |b| just.map(&b) }.to yield_with_args(Just) }
+        specify { expect { |b| just.map(&b) }.to yield_with_args(val) }
 
-        it 'yields a Just with the value 1' do
-          just.map { |j| expect(j.value).to eq 1 }
+        it 'yields the value 1 and wraps the block in a Maybe' do
+          expect(just.map { |j| j }.value).to eq val
+        end
+
+        it 'yields the value 1 and is Nothing when the block evaluates to nil' do
+          expect(just.map { |j| nil }).to eq Nothing
         end
       end
 
       context 'when initialized with "foo"' do
         let(:val) { 'foo' }
 
-        specify { expect { |b| just.map(&b) }.to yield_with_args(Just) }
+        specify { expect { |b| just.map(&b) }.to yield_with_args(val) }
 
-        it 'yields a Just with the value "foo"' do
-          just.map { |j| expect(j.value).to eq 'foo' }
+        it 'yields the value "foo" and wraps the block in a Maybe' do
+          expect(just.map { |j| j }.value).to eq val
         end
       end
     end
@@ -48,13 +52,13 @@ module OrElse
       context 'when initialized with 1' do
         let(:val) { 1 }
 
-        specify { expect { |b| just.flat_map(&b) }.to yield_with_args(1) }
+        specify { expect { |b| just.flat_map(&b) }.to yield_with_args(val) }
       end
 
       context 'when initialized with "foo"' do
         let(:val) { 'foo' }
 
-        specify { expect { |b| just.flat_map(&b) }.to yield_with_args('foo') }
+        specify { expect { |b| just.flat_map(&b) }.to yield_with_args(val) }
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: or_else
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - alexpeachey
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-13 00:00:00.000000000 Z
+date: 2014-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler