deterministic 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 73c7677d88bfefa44b35f3001d00eec4ae4d57ba
-  data.tar.gz: c7ea57c2f75c73203303428eb241401951b6e974
+  metadata.gz: 16ab904730d38a8b5b0e3b3a2e6a8e40f3bf68fa
+  data.tar.gz: 29b690c3723bfcce5c2cfe40fcc03db7059aee5f
 SHA512:
-  metadata.gz: 54f36f7a7868f74c04335c3e4d989ee1f5df9263df5bd917f947fed073ae18dc2c218716e56b34eb565f2efcedbad1e4fdcb97b7a695bbc24590bab37b0c5a41
-  data.tar.gz: 3f6065134f25fbe1e36e432466d8c7463557674169911aceeefdfc14860ec7903568f08896eb19a3cdeca61fb8eb09170904b54e6974880dc3e787c2c5a9ea53
+  metadata.gz: 8042eed9f812f6570fbfa18dfdb2f5245d53bbd2419dbc44fdefb7a760d5da575b19064ced2723bc82724fd4866767728951e73e89ccb3a157a1912db1d89690
+  data.tar.gz: 62e5ec295f1d1535b77cb271def694ecd8d22291e0ed39ad6f708539273cc8dca03ea81af277375f139690b1e912cef4da30f0a251d3063534bec27c9c7ac4cd

data/README.md

@@ -193,16 +193,30 @@ end # => Success(2)
 The simplest NullObject wrapper there can be. It adds `#some?` and `#none?` to `Object` though.
 
 ```ruby
-maybe(nil).foo        # => None
-maybe(nil).foo.bar    # => None
+require 'deterministic/maybe' # you need to do this explicitly
+Maybe(nil).foo        # => None
+Maybe(nil).foo.bar    # => None
+Mmaybe({a: 1})[:a]     # => 1
 
-maybe({a: 1})[:a]     # => 1
+Maybe(nil).none?      # => true
+Maybe({}).none?       # => false
 
-maybe(nil).none?      # => true
-maybe({}).none?       # => false
+Maybe(nil).some?      # => false
+Maybe({}).some?       # => true
+```
+
+## Mimic
+
+If you want a custom NullObject which mimicks another class
+
+```ruby
+class Mimick
+  def test; end
+end
 
-maybe(nil).some?      # => false
-maybe({}).some?       # => true
+null = Maybe.mimick(Mimick)
+null.test             # => None
+null.foo              # => NoMethodError
 ```
 
 ## Inspirations
@@ -211,6 +225,7 @@ maybe({}).some?       # => true
  * [Pithyless' rumblings](https://gist.github.com/pithyless/2216519)
  * [either by rsslldnphy](https://github.com/rsslldnphy/either)
  * [Functors, Applicatives, And Monads In Pictures](http://adit.io/posts/2013-04-17-functors,_applicatives,_and_monads_in_pictures.html)
+ * [Naught by avdi](https://github.com/avdi/naught/)
 
 ## Installation
 

data/lib/deterministic/maybe.rb

@@ -1,13 +1,40 @@
 # The simplest NullObject there can be
 class None
-  def self.instance
-    @instance ||= None.new
+  class << self
+    def method_missing(m, *args)
+      if m == :new
+        super
+      else
+        None.instance.send(m, *args)
+      end
+    end
+
+    def instance
+      @instance ||= new([])
+    end
+
+    def mimic(klas)
+      new(klas.instance_methods(false))
+    end
+  end
+  private_class_method :new
+
+  def initialize(methods)
+    @methods = methods
   end
 
-  # def respond_to_missing
+  # implicit conversions
+  def to_str
+    ''
+  end
+
+  def to_ary
+    []
+  end
 
-  def method_missing(*args)
-    self
+  def method_missing(m, *args)
+    return self if respond_to?(m)
+    super
   end
 
   def none?
@@ -19,7 +46,8 @@ class None
   end
 
   def respond_to?(m)
-    true
+    return true if @methods.empty? || @methods.include?(m)
+    super
   end
 end
 
@@ -33,6 +61,6 @@ class Object
   end
 end
 
-def maybe(obj)
+def Maybe(obj)
   obj.nil? ? None.instance : obj
 end

data/lib/deterministic/version.rb

@@ -1,3 +1,3 @@
 module Deterministic
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/spec/lib/deterministic/maybe_spec.rb

@@ -3,17 +3,45 @@ require 'deterministic/maybe'
 
 describe 'maybe' do
   it "does something" do
-    expect(maybe(nil).foo).to be_none
-    expect(maybe(nil).foo.bar.baz).to be_none
-    expect(maybe(nil).fetch(:a)).to be_none
-    expect(maybe(1)).to be_some
-    expect(maybe({a: 1}).fetch(:a)).to eq 1
-    expect(maybe({a: 1})[:a]).to eq 1
-    expect(maybe("a").upcase).to eq "A"
-    expect(maybe("a")).not_to be_none
+    expect(Maybe(nil).foo).to be_none
+    expect(Maybe(nil).foo.bar.baz).to be_none
+    expect(Maybe(nil).fetch(:a)).to be_none
+    expect(Maybe(1)).to be_some
+    expect(Maybe({a: 1}).fetch(:a)).to eq 1
+    expect(Maybe({a: 1})[:a]).to eq 1
+    expect(Maybe("a").upcase).to eq "A"
+    expect(Maybe("a")).not_to be_none
   end
 
-  it 'Nothing#to_s' do
+  it "None is a Singleton" do
+    expect(None.instance).to be_a None
+    expect { None.new }.to raise_error(NoMethodError, "private method `new' called for None:Class")
+  end
+
+  it "implicit conversions" do
+    null = Maybe(nil)
+    expect(null.to_str).to eq ""
+    expect(null.to_ary).to eq []
+    expect("" + null).to eq ""
+
+    a, b, c = null
+    expect(a).to be_nil
+    expect(b).to be_nil
+    expect(c).to be_nil
+  end
+
+  it "explicit conversions" do
     expect(None.to_s).to eq 'None'
   end
+
+  it "mimic, only return None on specific methods of another class" do
+    class MimicTest
+      def test
+      end
+    end
+
+    mimic = None.mimic(MimicTest)
+    expect(mimic.test).to be_none
+    expect { mimic.foo }.to raise_error(NoMethodError)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: deterministic
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Piotr Zolnierek