fear 2.0.1 → 3.1.0

data/lib/fear/none_class/pattern_match.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Fear
+  class NoneClass
+    # @api private
+    class PatternMatch < Option::PatternMatch
+      # @param conditions [<#==>]
+      # @return [Fear::OptionPatternMatch]
+      def some(*conditions)
+        self
+      end
+    end
+
+    private_constant :PatternMatch
+  end
+end

data/lib/fear/none_class.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Fear
+  # @api private
+  class NoneClass
+    include Option
+    include RightBiased::Left
+    include PatternMatch.mixin
+
+    class << self
+      def inherited(*)
+        raise "you are not allowed to inherit from NoneClass, use Fear::None instead"
+      end
+    end
+
+    # @raise [NoSuchElementError]
+    def get
+      raise NoSuchElementError
+    end
+
+    # @return [nil]
+    def or_nil
+      nil
+    end
+
+    # @return [true]
+    def empty?
+      true
+    end
+
+    alias_method :blank?, :empty?
+
+    # @return [false]
+    def present?
+      false
+    end
+
+    # @return [None]
+    def select(*)
+      self
+    end
+
+    # @return [None]
+    def reject(*)
+      self
+    end
+
+    # @return [String]
+    def inspect
+      "#<Fear::NoneClass>"
+    end
+
+    # @return [String]
+    alias_method :to_s, :inspect
+
+    # @param other [Any]
+    # @return [Boolean]
+    def ==(other)
+      other.is_a?(NoneClass)
+    end
+
+    # @param other
+    # @return [Boolean]
+    def ===(other)
+      self == other
+    end
+
+    # @param other [Fear::Option]
+    # @return [Fear::Option]
+    def zip(other)
+      if other.is_a?(Option)
+        Fear.none
+      else
+        raise TypeError, "can't zip with #{other.class}"
+      end
+    end
+
+    # @return [RightBiased::Left]
+    def filter_map
+      self
+    end
+  end
+
+  private_constant(:NoneClass)
+end

data/lib/fear/option/pattern_match.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Fear
+  module Option
+    # Option pattern matcher
+    #
+    # @example
+    #   pattern_match =
+    #     Option::PatternMatch.new
+    #       .some(Integer) { |x| x * 2 }
+    #       .some(String) { |x| x.to_i * 2 }
+    #       .none { 'NaN' }
+    #       .else { 'error '}
+    #
+    #   pattern_match.call(42) => 'NaN'
+    #
+    #  @example the same matcher may be defined using block syntax
+    #    Option::PatternMatch.new do |m|
+    #       m.some(Integer) { |x| x * 2 }
+    #       m.some(String) { |x| x.to_i * 2 }
+    #       m.none { 'NaN' }
+    #       m.else { 'error '}
+    #    end
+    #
+    # @note it has two optimized subclasses +Fear::SomePatternMatch+ and +Fear::NonePatternMatch+
+    # @api private
+    class PatternMatch < Fear::PatternMatch
+      # Match against Some
+      #
+      # @param conditions [<#==>]
+      # @return [Fear::Option::PatternMatch]
+      def some(*conditions, &effect)
+        branch = Fear.case(Fear::Some, &:get).and_then(Fear.case(*conditions, &effect))
+        or_else(branch)
+      end
+
+      # Match against None
+      #
+      # @param effect [Proc]
+      # @return [Fear::Option::PatternMatch]
+      def none(&effect)
+        branch = Fear.case(Fear::None, &effect)
+        or_else(branch)
+      end
+    end
+  end
+end

data/lib/fear/option.rb

@@ -207,11 +207,11 @@ module Fear
       # @yieldparam [OptionPatternMatch]
       # @return [Fear::PartialFunction]
       def matcher(&matcher)
-        OptionPatternMatch.new(&matcher)
+        Option::PatternMatch.new(&matcher)
       end
 
       def match(value, &block)
-        matcher(&block).(value)
+        matcher(&block).call(value)
       end
     end
 
@@ -258,7 +258,3 @@ module Fear
     end
   end
 end
-
-require "fear/option_pattern_match"
-require "fear/some"
-require "fear/none"

data/lib/fear/option_api.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/option"
-
 module Fear
   module OptionApi
     # An +Option+ factory which creates +Some+ if the argument is
@@ -29,7 +27,7 @@ module Fear
       Fear::None
     end
 
-    # @param value [any]
+    # @param value [Object]
     # @return [Fear::Some]
     # @example
     #   Fear.some(17) #=> #<Fear::Some get=17>

data/lib/fear/partial_function/and_then.rb

@@ -25,7 +25,7 @@ module Fear
       # @param arg [any]
       # @return [any ]
       def call(arg)
-        function.(partial_function.(arg))
+        function.call(partial_function.call(arg))
       end
 
       # @param arg [any]
@@ -41,7 +41,7 @@ module Fear
         result = partial_function.call_or_else(arg) do
           return yield(arg)
         end
-        function.(result)
+        function.call(result)
       end
     end
 

data/lib/fear/partial_function/combined.rb

@@ -24,11 +24,11 @@ module Fear
       # @param arg [any]
       # @return [any ]
       def call(arg)
-        f2.(f1.(arg))
+        f2.call(f1.call(arg))
       end
 
-      alias === call
-      alias [] call
+      alias_method :===, :call
+      alias_method :[], :call
 
       # @param arg [any]
       # @yieldparam arg [any]

data/lib/fear/partial_function/empty.rb

@@ -1,12 +1,10 @@
 # frozen_string_literal: true
 
-require "fear/empty_partial_function"
-
 module Fear
   module PartialFunction
-    EMPTY = EmptyPartialFunction.new
-    EMPTY.freeze
+    Empty = EmptyPartialFunction.new
+    Empty.freeze
 
-    public_constant :EMPTY
+    public_constant :Empty
   end
 end

data/lib/fear/partial_function/guard.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/partial_function/guard/or"
-require "fear/partial_function/guard/and"
-require "fear/partial_function/guard/and3"
-
 module Fear
   module PartialFunction
     # Guard represents PartialFunction guardian

data/lib/fear/partial_function/or_else.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/utils"
-
 module Fear
   module PartialFunction
     # Composite function produced by +PartialFunction#or_else+ method
@@ -29,8 +27,8 @@ module Fear
         f1.call_or_else(arg, &f2)
       end
 
-      alias === call
-      alias [] call
+      alias_method :===, :call
+      alias_method :[], :call
 
       # @param other [Fear::PartialFunction]
       # @return [Fear::PartialFunction]

data/lib/fear/partial_function.rb

@@ -1,14 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/partial_function/and_then"
-require "fear/partial_function/any"
-require "fear/partial_function/combined"
-require "fear/partial_function/empty"
-require "fear/partial_function/guard"
-require "fear/partial_function/lifted"
-require "fear/partial_function/or_else"
-require "fear/partial_function_class"
-
 module Fear
   # A partial function is a unary function defined on subset of all possible inputs.
   # The method +defined_at?+ allows to test dynamically if an arg is in

data/lib/fear/partial_function_class.rb

@@ -20,14 +20,14 @@ module Fear
     #   is contained in the function domain.
     # @raise [MatchError] when this partial function is not defined.
     def call(arg)
-      call_or_else(arg, &PartialFunction::EMPTY)
+      call_or_else(arg, &PartialFunction::Empty)
     end
 
     # @param arg [any]
     # @yield [arg] if function not defined
     def call_or_else(arg)
       if defined_at?(arg)
-        function.(arg)
+        function.call(arg)
       else
         yield arg
       end

data/lib/fear/pattern_match.rb

@@ -33,11 +33,11 @@ module Fear
   # @note Use this class only to build custom pattern match classes. See +Fear::OptionPatternMatch+ as an example.
   class PatternMatch
     class << self
-      alias __new__ new
+      alias_method :__new__, :new
 
       # @return [Fear::PartialFunction]
       def new
-        builder = __new__(PartialFunction::EMPTY)
+        builder = __new__(PartialFunction::Empty)
         yield builder
         builder.result
       end
@@ -61,7 +61,7 @@ module Fear
 
         Module.new do
           define_method(as) do |&matchers|
-            matcher_class.new(&matchers).(self)
+            matcher_class.new(&matchers).call(self)
           end
         end
       end
@@ -89,12 +89,13 @@ module Fear
     #
     # @param guards [<#===>]
     # @param effect [Proc]
-    # @return [Fear::PartialFunction]
+    # @return [Fear::PatternMatch]
     # @see #or_else for details
     def case(*guards, &effect)
       or_else(Fear.case(*guards, &effect))
     end
 
+    # @return [Fear::PatternMatch]
     # @see Fear::PartialFunction#or_else
     def or_else(other)
       self.result = result.or_else(other)

data/lib/fear/pattern_matching_api.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/partial_function"
-require "fear/pattern_match"
-
 module Fear
   # @api private
   module PatternMatchingApi
@@ -82,7 +79,7 @@ module Fear
     # @yieldparam matcher [Fear::PartialFunction]
     # @return [any]
     def match(value, &block)
-      matcher(&block).(value)
+      matcher(&block).call(value)
     end
 
     # Creates partial function defined on domain described with guards

data/lib/fear/right/pattern_match.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Fear
+  class Right
+    # @api private
+    class PatternMatch < Either::PatternMatch
+      def left(*)
+        self
+      end
+      alias_method :failure, :left
+    end
+
+    private_constant :PatternMatch
+  end
+end

data/lib/fear/right.rb

@@ -4,7 +4,7 @@ module Fear
   class Right
     include Either
     include RightBiased::Right
-    include RightPatternMatch.mixin
+    include PatternMatch.mixin
 
     # @api private
     def right_value
@@ -15,13 +15,13 @@ module Fear
     def right?
       true
     end
-    alias success? right?
+    alias_method :success?, :right?
 
     # @return [false]
     def left?
       false
     end
-    alias failure? left?
+    alias_method :failure?, :left?
 
     # @param default [Proc, any]
     # @return [Either]
@@ -59,7 +59,7 @@ module Fear
     # @param reduce_right [Proc]
     # @return [any]
     def reduce(_reduce_left, reduce_right)
-      reduce_right.(value)
+      reduce_right.call(value)
     end
 
     # @return [Either]

data/lib/fear/right_biased.rb

@@ -70,6 +70,7 @@ module Fear
         yield(value)
         self
       end
+      alias_method :apply, :each
 
       # Maps the value using given block.
       #
@@ -144,6 +145,7 @@ module Fear
       def each
         self
       end
+      alias_method :apply, :each
 
       # Ignores the given block and return self.
       #

data/lib/fear/some/pattern_match.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Fear
+  class Some
+    # @api private
+    class PatternMatch < Option::PatternMatch
+      # @return [Fear::OptionPatternMatch]
+      def none
+        self
+      end
+    end
+
+    private_constant :PatternMatch
+  end
+end

data/lib/fear/some.rb

@@ -4,7 +4,7 @@ module Fear
   class Some
     include Option
     include RightBiased::Right
-    include SomePatternMatch.mixin
+    include PatternMatch.mixin
 
     attr_reader :value
     protected :value
@@ -28,7 +28,7 @@ module Fear
       false
     end
 
-    alias :blank? :empty?
+    alias_method :blank?, :empty?
 
     # @return [true]
     def present?
@@ -65,7 +65,7 @@ module Fear
     end
 
     # @return [String]
-    alias to_s inspect
+    alias_method :to_s, :inspect
 
     # @param other [Fear::Option]
     # @return [Fear::Option]

data/lib/fear/success/pattern_match.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Fear
+  class Success
+    # @api private
+    class PatternMatch < Try::PatternMatch
+      # @param conditions [<#==>]
+      # @return [Fear::TryPatternMatch]
+      def failure(*conditions)
+        self
+      end
+    end
+
+    private_constant :PatternMatch
+  end
+end

data/lib/fear/success.rb

@@ -4,7 +4,7 @@ module Fear
   class Success
     include Try
     include RightBiased::Right
-    include SuccessPatternMatch.mixin
+    include PatternMatch.mixin
 
     attr_reader :value
     protected :value
@@ -52,7 +52,7 @@ module Fear
       else
         raise NoSuchElementError, "Predicate does not hold for `#{value}`"
       end
-    rescue StandardError => error
+    rescue => error
       Failure.new(error)
     end
 
@@ -69,14 +69,14 @@ module Fear
     # @return [Try]
     def map
       super
-    rescue StandardError => error
+    rescue => error
       Failure.new(error)
     end
 
     # @return [Try]
     def flat_map
       super
-    rescue StandardError => error
+    rescue => error
       Failure.new(error)
     end
 
@@ -97,7 +97,7 @@ module Fear
     end
 
     # @return [String]
-    alias to_s inspect
+    alias_method :to_s, :inspect
 
     # @return [<any>]
     def deconstruct

data/lib/fear/try/pattern_match.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Fear
+  module Try
+    # Try pattern matcher
+    #
+    # @note it has two optimized subclasses +Fear::Success::PatternMatch+ and +Fear::FailurePatternMatch+
+    # @api private
+    class PatternMatch < Fear::PatternMatch
+      # Match against +Fear::Success+
+      #
+      # @param conditions [<#==>]
+      # @return [Fear::Try::PatternMatch]
+      def success(*conditions, &effect)
+        branch = Fear.case(Fear::Success, &:get).and_then(Fear.case(*conditions, &effect))
+        or_else(branch)
+      end
+
+      # Match against +Fear::Failure+
+      #
+      # @param conditions [<#==>]
+      # @return [Fear::Try::PatternMatch]
+      def failure(*conditions, &effect)
+        branch = Fear.case(Fear::Failure, &:exception).and_then(Fear.case(*conditions, &effect))
+        or_else(branch)
+      end
+    end
+  end
+end

data/lib/fear/try.rb

@@ -231,7 +231,7 @@ module Fear
   #
   # @!method match(&matcher)
   #   Pattern match against this +Try+
-  #   @yield matcher [Fear::TryPatternMatch]
+  #   @yield matcher [Fear::Try::PatternMatch]
   #   @example
   #     Fear.try { ... }.match do |m|
   #       m.success(Integer) do |x|
@@ -276,10 +276,10 @@ module Fear
       #     end
       #   matcher.call(try)
       #
-      # @yieldparam [Fear::TryPatternMatch]
+      # @yieldparam [Fear::Try::PatternMatch]
       # @return [Fear::PartialFunction]
       def matcher(&matcher)
-        TryPatternMatch.new(&matcher)
+        Try::PatternMatch.new(&matcher)
       end
     end
 
@@ -317,7 +317,3 @@ module Fear
     end
   end
 end
-
-require "fear/try_pattern_match"
-require "fear/success"
-require "fear/failure"

data/lib/fear/try_api.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/try"
-
 module Fear
   module TryApi
     # Constructs a +Try+ using the block. This
@@ -14,7 +12,7 @@ module Fear
     #
     def try
       success(yield)
-    rescue StandardError => error
+    rescue => error
       failure(error)
     end
 

data/lib/fear/utils.rb

@@ -38,7 +38,7 @@ module Fear
 
       def return_or_call_proc(value)
         if value.respond_to?(:call)
-          value.()
+          value.call
         else
           value
         end

data/lib/fear/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Fear
-  VERSION = "2.0.1"
+  VERSION = "3.1.0"
   public_constant :VERSION
 end

data/lib/fear.rb

@@ -1,16 +1,8 @@
 # frozen_string_literal: true
 
-require "fear/utils"
-require "fear/right_biased"
-require "fear/struct"
-require "fear/unit"
-require "fear/either_api"
-require "fear/for_api"
-require "fear/future_api"
-require "fear/option_api"
-require "fear/pattern_matching_api"
-require "fear/try_api"
-require "fear/version"
+require "zeitwerk"
+loader = Zeitwerk::Loader.for_gem
+loader.setup
 
 module Fear
   Error = Class.new(StandardError)
@@ -25,9 +17,6 @@ module Fear
   NoSuchElementError = Class.new(Error)
   public_constant :NoSuchElementError
 
-  PatternSyntaxError = Class.new(Error)
-  public_constant :PatternSyntaxError
-
   extend EitherApi
   extend ForApi
   extend FutureApi

data/spec/fear/awaitable_spec.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "fear/awaitable"
-
 RSpec.describe Fear::Awaitable do
   subject(:awaitable) { Object.new.extend(Fear::Awaitable) }