fear 2.0.1 → 3.0.0

data/lib/fear/none.rb

@@ -1,94 +1,7 @@
 # frozen_string_literal: true
 
 module Fear
-  # @api private
-  class NoneClass
-    include Option
-    include RightBiased::Left
-    include NonePatternMatch.mixin
-
-    # @raise [NoSuchElementError]
-    def get
-      raise NoSuchElementError
-    end
-
-    # @return [nil]
-    def or_nil
-      nil
-    end
-
-    # @return [true]
-    def empty?
-      true
-    end
-
-    alias :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 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)
-
   # The only instance of NoneClass
-  # @api private
   None = NoneClass.new.freeze
   public_constant :None
-
-  class << NoneClass
-    def new
-      None
-    end
-
-    def inherited(*)
-      raise "you are not allowed to inherit from NoneClass, use Fear::None instead"
-    end
-  end
 end

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 :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 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,7 +207,7 @@ module Fear
       # @yieldparam [OptionPatternMatch]
       # @return [Fear::PartialFunction]
       def matcher(&matcher)
-        OptionPatternMatch.new(&matcher)
+        Option::PatternMatch.new(&matcher)
       end
 
       def match(value, &block)
@@ -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/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

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,7 +20,7 @@ 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]

data/lib/fear/pattern_match.rb

@@ -37,7 +37,7 @@ module Fear
 
       # @return [Fear::PartialFunction]
       def new
-        builder = __new__(PartialFunction::EMPTY)
+        builder = __new__(PartialFunction::Empty)
         yield builder
         builder.result
       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

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 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

data/lib/fear/right_biased.rb

@@ -70,6 +70,7 @@ module Fear
         yield(value)
         self
       end
+      alias apply each
 
       # Maps the value using given block.
       #
@@ -144,6 +145,7 @@ module Fear
       def each
         self
       end
+      alias 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

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

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

data/lib/fear/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Fear
-  VERSION = "2.0.1"
+  VERSION = "3.0.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) }