fear 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 44b1ffdd8f0d5e74fe8a0a321976fc63cea3744d
-  data.tar.gz: 8a3a25e30333937b404297247d02e2875d3c2769
+  metadata.gz: fe1da9cca954b338585a16edadec505294704e48
+  data.tar.gz: d2b9f1d9d4a186b5d9aa622dd9509a1aacdf545f
 SHA512:
-  metadata.gz: 6fb277d637d1438a0471d586f81dbbbd2348a4bfa05873e65c74f9836c0040d7625afb6f0e93acd000ae893356f9088b4a03e1ec19881074f9e1527b634a886e
-  data.tar.gz: b763ec95bcb614cacb81f6d4d6ef27bf84d90cb3ab7dd3d299263b1a009ff9201eb3462a0e7b5fbb52fe3c84ae372295ec9eea7afa0443c49ec33fa6529b0de2
+  metadata.gz: 5a65ed502c031f9f028d8bdc2b62b0c90c5d40aaf0efb6eb56755251fd967b11c3d9955d0c5473bf4a8b9c252dfd8f0141adc4c0bc09fa0cbb89ba65d99a4200
+  data.tar.gz: 5ee2ea5cc16bd2ef862a9eb2a25303c09bcaa125ba6fcbac2a8ac50859551ee1d13dd87bd57923865c3951c97c824f18b9c3111d9b923cc568eb848016e98389

data/.rubocop.yml

@@ -6,3 +6,6 @@ Style/MethodName:
 
 Style/Documentation:
   Enabled: false
+
+Style/CaseEquality:
+  Enabled: false

data/README.md

@@ -162,6 +162,23 @@ would be translated to:
 end
 ```
 
+### Pattern Matching
+
+`Option`, `Either`, and `Try` contains enhanced version of `#===` method. It performs matching not 
+only on container itself, but on enclosed value as well. I'm writing all the options in a one 
+case statement in sake of simplicity.
+ 
+```ruby
+case Some(42)
+when Some(42)                #=> matches
+when Some(41)                #=> does not match
+when Some(Fixnum)            #=> matches
+when Some(String)            #=> does not match
+when Some((40..43))          #=> matches
+when Some(-> (x) { x > 40 }) #=> matches
+end  
+```
+
 ## Testing
 
 To simplify testing, you may use [fear-rspec](https://github.com/bolshakov/fear-rspec) gem. It
@@ -174,3 +191,12 @@ provides a bunch of rspec matchers.
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
+
+## Alternatives
+
+* [dry-monads](https://github.com/dry-rb/dry-monads)
+* [deterministic](https://github.com/pzol/deterministic)
+* [ruby-possibly](https://github.com/rap1ds/ruby-possibly)
+* [kleisli](https://github.com/txus/kleisli)
+* [rumonade](https://github.com/ms-ati/rumonade)
+

data/lib/fear/either.rb

@@ -143,8 +143,8 @@ module Fear
   #   @example
   #     Right(12).select_or_else(-1, &:even?)       #=> Right(12)
   #     Right(7).select_or_else(-1, &:even?)        #=> Left(-1)
-  #     Left(12).select_or_else(-1, &:even?)        #=> Left(-1)
-  #     Left(12).select_or_else(-> { -1 }, &:even?) #=> Left(-1)
+  #     Left(12).select_or_else(-1, &:even?)        #=> Left(12)
+  #     Left(12).select_or_else(-> { -1 }, &:even?) #=> Left(12)
   #
   # @!method select(&predicate)
   #   Returns +Left+ of value if the given predicate

data/lib/fear/failure.rb

@@ -68,5 +68,16 @@ module Fear
     def to_either
       Left.new(value)
     end
+
+    # Used in case statement
+    # @param other [any]
+    # @return [Boolean]
+    def ===(other)
+      if other.is_a?(Failure)
+        value === other.value
+      else
+        super
+      end
+    end
   end
 end

data/lib/fear/left.rb

@@ -15,10 +15,9 @@ module Fear
     end
     alias failure? left?
 
-    # @param default [Proc, any]
     # @return [Either]
-    def select_or_else(default)
-      Left.new(Utils.return_or_call_proc(default))
+    def select_or_else(*)
+      self
     end
 
     # @return [Left]
@@ -54,5 +53,16 @@ module Fear
         Utils.assert_type!(v, Either)
       end
     end
+
+    # Used in case statement
+    # @param other [any]
+    # @return [Boolean]
+    def ===(other)
+      if other.is_a?(Left)
+        value === other.value
+      else
+        super
+      end
+    end
   end
 end

data/lib/fear/right_biased.rb

@@ -85,6 +85,17 @@ module Fear
       def any?
         yield(value)
       end
+
+      # Used in case statement
+      # @param other [any]
+      # @return [Boolean]
+      def ===(other)
+        if other.is_a?(right_class)
+          value === other.value
+        else
+          super
+        end
+      end
     end
 
     module Left

data/lib/fear/try.rb

@@ -249,7 +249,6 @@ module Fear
       # @return [Failure]
       #
       def Failure(exception)
-        fail TypeError, "not an error: #{exception}" unless exception.is_a?(StandardError)
         Failure.new(exception)
       end
 

data/lib/fear/version.rb

@@ -1,3 +1,3 @@
 module Fear
-  VERSION = '0.4.1'.freeze
+  VERSION = '0.4.2'.freeze
 end

data/spec/fear/failure_spec.rb

@@ -86,4 +86,28 @@ RSpec.describe Fear::Failure do
     subject { failure.to_either }
     it { is_expected.to eq(Left(exception)) }
   end
+
+  describe '#===' do
+    subject { match === failure }
+
+    context 'matches erectly' do
+      let(:match) { Failure(exception) }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'value does not match' do
+      let(:match) { Failure(ArgumentError.new) }
+      it { is_expected.to eq(false) }
+    end
+
+    context 'matches by class' do
+      let(:match) { Failure(RuntimeError) }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'does not matches by class' do
+      let(:match) { Failure(ArgumentError) }
+      it { is_expected.to eq(false) }
+    end
+  end
 end

data/spec/fear/left_spec.rb

@@ -25,16 +25,16 @@ RSpec.describe Fear::Left do
     context 'proc default' do
       let(:default) { -> { -1 } }
 
-      it 'returns Left of evaluated default' do
-        is_expected.to eq(described_class.new(-1))
+      it 'returns itself' do
+        is_expected.to eq(left)
       end
     end
 
     context 'default' do
       let(:default) { -1 }
 
-      it 'return Left of default' do
-        is_expected.to eq(described_class.new(-1))
+      it 'returns itself' do
+        is_expected.to eq(left)
       end
     end
   end
@@ -108,4 +108,28 @@ RSpec.describe Fear::Left do
       end
     end
   end
+
+  describe '#===' do
+    subject { match === left }
+
+    context 'matches erectly' do
+      let(:match) { Left('value') }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'value does not match' do
+      let(:match) { Left('error') }
+      it { is_expected.to eq(false) }
+    end
+
+    context 'matches by class' do
+      let(:match) { Left(String) }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'does not matches by class' do
+      let(:match) { Left(Integer) }
+      it { is_expected.to eq(false) }
+    end
+  end
 end

data/spec/fear/right_biased/left.rb

@@ -64,4 +64,13 @@ RSpec.shared_examples Fear::RightBiased::Left do
     subject { left.any? { |v| v == 'value' } }
     it { is_expected.to eq(false) }
   end
+
+  describe '#===' do
+    subject { match === left }
+
+    context 'the same object' do
+      let(:match) { left }
+      it { is_expected.to eq(true) }
+    end
+  end
 end

data/spec/fear/right_biased/right.rb

@@ -90,4 +90,33 @@ RSpec.shared_examples Fear::RightBiased::Right do
       it { is_expected.to eq(false) }
     end
   end
+
+  describe '#===' do
+    subject { match === right }
+
+    context 'matches erectly' do
+      let(:match) { described_class.new('value') }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'the same object' do
+      let(:match) { right }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'value does not match' do
+      let(:match) { described_class.new('error') }
+      it { is_expected.to eq(false) }
+    end
+
+    context 'matches by class' do
+      let(:match) { described_class.new(String) }
+      it { is_expected.to eq(true) }
+    end
+
+    context 'does not matches by class' do
+      let(:match) { described_class.new(Integer) }
+      it { is_expected.to eq(false) }
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fear
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Tema Bolshakov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-12-16 00:00:00.000000000 Z
+date: 2016-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-equalizer