core-pipeline 0.0.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a40a0de02118c468488220555a57d531b738170f51bd61bbe165f71f5851ddb6
-  data.tar.gz: bd1d8c14350961d2011fad408748095c315d04b8e7d067332e259f0b9f644656
+  metadata.gz: 53ee7741ae5354263c5f7d426eb7ad9b500c01bb4a1ee4c665ce11d054819cea
+  data.tar.gz: 8c7e495b2681c54b59e38cc066987e0f52e3ba8a5673f8285c821a38eea98e9d
 SHA512:
-  metadata.gz: 4b87d1a60bad4f85bbaedddcd956222c03380d957dcac7663c63ce56bda9c876f4a230907285982438ea33fc396b3c8de4497168c9eaa6eb451351a02444dbc9
-  data.tar.gz: f9c54d75eb9f2803326d422ab7efed3f27bec648bdccaf9222633c16e1078bf4b01bb2a9086b7eb9954d3c76e17cef4c6ff4bdb4f65a521b6d5d0dd25235ee15
+  metadata.gz: 757e21b99dbb927b0d75f4dbd8f036e3235a982aa9a449260bcb4e4ff09f3a20afb788c3ddcd213d2a75d5b44e105f69bf512a6515991cc97282e584e4a617f7
+  data.tar.gz: 241b54f107db94c7fa5afeb1a075d2df1b3cd92c97bc54c9cb3935c283d6b2085d67eb1aeb85d2cb724b0cc6785f3bacb64062233ab50c5150f44bfd70603636

data/CHANGELOG.md

@@ -1,3 +1,31 @@
+## [v0.3.0](https://github.com/metabahn/corerb/releases/tag/2021-11-02)
+
+*released on 2021-11-02*
+
+  * `chg` [#97](https://github.com/metabahn/corerb/pull/97) Designate internal state with leading and trailing double underscores ([bryanp](https://github.com/bryanp))
+  * `chg` [#89](https://github.com/metabahn/corerb/pull/89) Allow the pipeline compiler to be extended ([bryanp](https://github.com/bryanp))
+
+## [v0.2.0](https://github.com/metabahn/corerb/releases/tag/2021-10-24)
+
+*released on 2021-10-24*
+
+  * `chg` [#77](https://github.com/metabahn/corerb/pull/77) Add recompile support to pipelines ([bryanp](https://github.com/bryanp))
+
+## [v0.1.0](https://github.com/metabahn/corerb/releases/tag/2021-07-15)
+
+*released on 2021-07-15*
+
+  * `fix` [#81](https://github.com/metabahn/corerb/pull/81) Tie up loose ends around curried pipeline actions ([bryanp](https://github.com/bryanp))
+  * `add` [#80](https://github.com/metabahn/corerb/pull/80) Define curried pipeline actions ([bryanp](https://github.com/bryanp))
+  * `fix` [#69](https://github.com/metabahn/corerb/pull/69) Allow pipelines to be called at the class level ([bryanp](https://github.com/bryanp))
+  * `add` [#64](https://github.com/metabahn/corerb/pull/64) Add a method for checking if a callable pipeline will call any actions ([bryanp](https://github.com/bryanp))
+  * `chg` [#63](https://github.com/metabahn/corerb/pull/63) Improve inspect output for callable pipelines ([bryanp](https://github.com/bryanp))
+  * `chg` [#61](https://github.com/metabahn/corerb/pull/61) Refactor pipelines to be more performant for new instances ([bryanp](https://github.com/bryanp))
+  * `fix` [#59](https://github.com/metabahn/corerb/pull/59) Prevent collisions in auto-defined action names ([bryanp](https://github.com/bryanp))
+  * `chg` [#58](https://github.com/metabahn/corerb/pull/58) Define pipeline actions with context ([bryanp](https://github.com/bryanp))
+  * `chg` [#57](https://github.com/metabahn/corerb/pull/57) Avoid cache lookups for action calls when the action is just a method ([bryanp](https://github.com/bryanp))
+  * `add` [#54](https://github.com/metabahn/corerb/pull/54) Make all pipeline objects inspectable ([bryanp](https://github.com/bryanp))
+
 ## [v0.0.0](https://github.com/metabahn/corerb/releases/tag/2021-07-07)
 
 *released on 2021-07-07*

data/lib/core/pipeline/action.rb

@@ -1,28 +1,35 @@
 # frozen_string_literal: true
 
+require "is/inspectable"
+require "is/stateful"
+require "securerandom"
+
 module Core
   module Pipeline
     # [public] A pipeline action.
     #
     class Action
+      include Is::Stateful
+      state :__used_random_suffixes__, default: []
+
       class << self
         # [public] Builds an action for a given target.
         #
-        def build(target = nil, *args, context:, before:, after:, &block)
+        def build(target = nil, *args, before: nil, after: nil, context: nil, curry: false, &block)
           if block
-            Actions::Block.new(target, before: before, after: after, &block)
+            Actions::Block.new(target, before: before, after: after, context: context, curry: curry, &block)
           else
-            build_target(target, *args, before: before, after: after)
+            build_target(target, *args, before: before, after: after, context: context, curry: curry)
           end
         end
 
-        private def build_target(first, *args, before:, after:)
+        private def build_target(first, *args, before:, after:, context:, curry:)
           case first
           when String, Symbol
-            if (target = build_target(args[0], *args[1..], before: before, after: after))
+            if (target = build_target(args[0], *args[1..], before: before, after: after, context: context, curry: curry))
               target
             else
-              Actions::Method.new(first, before: before, after: after)
+              Actions::Method.new(first, before: before, after: after, context: context, curry: curry)
             end
           when NilClass
             nil
@@ -30,11 +37,30 @@ module Core
             raise ArgumentError, "unsupported action type"
           end
         end
+
+        def build_name
+          suffix = generate_random_suffix
+          if __used_random_suffixes__.include?(suffix)
+            build_name
+          else
+            __used_random_suffixes__ << suffix
+            "action_#{suffix}"
+          end
+        end
+
+        def generate_random_suffix
+          SecureRandom.hex(8)
+        end
       end
 
-      def initialize(before:, after:)
+      include Is::Inspectable
+
+      def initialize(name, before: nil, after: nil, context: nil, curry: false)
+        @name = (name || self.class.build_name).to_sym
         @before = before
         @after = after
+        @context = context
+        @curry = curry
       end
 
       # [public] The action name.
@@ -49,6 +75,16 @@ module Core
       #
       attr_reader :after
 
+      # [public] The context this action should be called in.
+      #
+      attr_reader :context
+
+      # [public] Returns `true` if the action should be curried.
+      #
+      def curried?
+        @curry == true
+      end
+
       # [public] Finalizes the action for the given context.
       #
       def finalize(context)

data/lib/core/pipeline/actions/block.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "securerandom"
+require "is/inspectable"
 
 module Core
   module Pipeline
@@ -8,24 +8,35 @@ module Core
       # [public] A pipeline action defined as a block.
       #
       class Block < Action
-        class << self
-          def build_name
-            "action_#{SecureRandom.hex(8)}"
-          end
-        end
+        include Is::Inspectable
 
-        def initialize(name = nil, before:, after:, &block)
-          @name = name || self.class.build_name
+        def initialize(name = nil, before: nil, after: nil, context: nil, curry: false, &block)
           @block = block
 
-          super(before: before, after: after)
+          super(name, before: before, after: after, context: context, curry: curry)
         end
 
         # [public]
         #
         def finalize(context)
-          context.define_singleton_method(@name, &@block)
-          context.method(@name).to_proc
+          case @context
+          when NilClass
+            unless context.method_defined?(@name)
+              context.define_method(@name, &@block)
+            end
+
+            @name
+          else
+            if @block.binding.receiver.equal?(@context)
+              @block
+            else
+              unless context.singleton_class.method_defined?(@name)
+                @context.define_singleton_method(@name, &@block)
+              end
+
+              @context.method(@name).to_proc
+            end
+          end
         end
       end
     end

data/lib/core/pipeline/actions/method.rb

@@ -1,22 +1,31 @@
 # frozen_string_literal: true
 
+require "is/inspectable"
+
 module Core
   module Pipeline
     module Actions
       # [public] A pipeline action defined as a method.
       #
       class Method < Action
-        def initialize(name = nil, before:, after:)
-          @name = name
+        include Is::Inspectable
+
+        def initialize(name = nil, before: nil, after: nil, context: nil, curry: false)
           @method = nil
 
-          super(before: before, after: after)
+          super(name, before: before, after: after, context: context, curry: curry)
         end
 
         # [public]
         #
         def finalize(context)
-          context.method(@name).to_proc
+          case @context
+          when NilClass
+            context.instance_method(@name)
+            @name
+          else
+            @context.method(@name).to_proc
+          end
         end
       end
     end

data/lib/core/pipeline/callable.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require "is/inspectable"
+
+require_relative "action"
+require_relative "compiler"
+
+module Core
+  module Pipeline
+    include Is::Inspectable
+    inspects without: [:@object, :@mutex]
+
+    # [public] Calls a pipeline on a pipelined object.
+    #
+    class Callable
+      def initialize(object)
+        @object = object
+        @mutex = Mutex.new
+        @actions = []
+        @skipped = []
+        @compiled = false
+        @compiler = Compiler
+      end
+
+      def initialize_copy(...)
+        @actions = @actions.clone
+        @skipped = @skipped.clone
+        super
+      end
+
+      attr_reader :actions
+      attr_reader :skipped
+
+      # [public]
+      #
+      attr_writer :compiler
+
+      # [public] Relocates to another object context.
+      #
+      def relocate(object)
+        @object = object
+      end
+
+      # [public] Returns true if the pipeline will call any actions.
+      #
+      def any?
+        (@actions.map(&:name) - @skipped).any?
+      end
+
+      # [public] Defines a pipeline action.
+      #
+      def action(*args, before: nil, after: nil, context: nil, curry: false, &block)
+        @actions << Action.build(*args, before: before, after: after, context: context, curry: curry, &block)
+        recompile if compiled?
+      end
+
+      # [public] Skips the given action.
+      #
+      def skip(name)
+        @skipped << name.to_sym
+        recompile if compiled?
+      end
+
+      # [public] Replaces existing actions with actions from the given pipeline.
+      #
+      def use(pipeline)
+        if (pipeline.is_a?(Class) || pipeline.is_a?(Module)) && pipeline.ancestors.include?(Is::Pipeline)
+          @mutex.synchronize do
+            @actions.clear
+            @actions.concat(pipeline.pipeline.actions)
+            recompile if compiled?
+          end
+        else
+          raise ArgumentError, "expected a pipeline"
+        end
+      end
+
+      # [public] Includes actions from the given pipeline.
+      #
+      def include(pipeline)
+        if (pipeline.is_a?(Class) || pipeline.is_a?(Module)) && pipeline.ancestors.include?(Is::Pipeline)
+          @actions.concat(pipeline.pipeline.actions)
+          recompile if compiled?
+        else
+          raise ArgumentError, "expected a pipeline"
+        end
+      end
+
+      # [public] Excludes actions from the given pipeline.
+      #
+      def exclude(pipeline)
+        if (pipeline.is_a?(Class) || pipeline.is_a?(Module)) && pipeline.ancestors.include?(Is::Pipeline)
+          pipeline.pipeline.actions.each do |action|
+            @actions.delete(action)
+            recompile if compiled?
+          end
+        else
+          raise ArgumentError, "expected a pipeline"
+        end
+      end
+
+      # [public] Calls the pipeline in context of an object with the given arguments.
+      #
+      def call(object, ...)
+        compile.call(object, ...)
+      end
+
+      private def compile
+        instance_eval(@compiler.compile(self, @object), __FILE__, __LINE__ - 1)
+        @compiled = true
+        self
+      end
+
+      private def recompile
+        singleton_class.remove_method(:call)
+        compile
+      end
+
+      private def compiled?
+        @compiled == true
+      end
+    end
+  end
+end

data/lib/core/pipeline/compiler.rb

@@ -5,30 +5,29 @@ require_relative "signals/rejected"
 
 module Core
   module Pipeline
-    # [public] Compiles a pipeline instance into a callable object.
+    # [public] Compiles a pipeline into evalable code.
     #
     class Compiler
       class << self
-        # [public] Compiles a pipeline instance.
+        # [public] Compiles a callable pipeline in context of an object.
         #
-        def compile(pipeline)
-          compiled = <<~CODE
-            def call(...)
-            #{compile_pipeline(pipeline)}
+        def compile(callable, object)
+          <<~CODE
+            def call(object, ...)
+            #{compile_call(callable, object)}
             rescue Core::Pipeline::Signals::Halted => error
               error.value
             end
           CODE
-
-          pipeline.instance_eval(compiled, __FILE__, __LINE__ - 1)
         end
 
-        private def compile_pipeline(pipeline)
+        # [public]
+        #
+        private def compile_call(callable, object)
           compiled = +""
-
-          finalized_actions(pipeline).each_key do |object_id|
+          finalized_actions(callable, object).each_value do |action|
             compiled << "begin\n"
-            compiled << "  @__finalized_actions[#{object_id}].call(...)\n"
+            compiled << compile_action(action, object)
             compiled << "rescue Core::Pipeline::Signals::Rejected\n"
             compiled << "end\n"
           end
@@ -36,38 +35,61 @@ module Core
           compiled
         end
 
-        private def finalized_actions(pipeline)
-          validate_skipped_actions(pipeline)
-          finalized_actions = build_finalized_actions(pipeline)
-          pipeline.instance_variable_set(:@__finalized_actions, finalized_actions)
+        # [public]
+        #
+        private def compile_action(action, object)
+          case action[:finalized]
+          when Symbol
+            if object.private_method_defined?(action[:finalized])
+              "object.send(#{action[:finalized].inspect}, ...)\n"
+            else
+              "object.#{action[:finalized]}(...)\n"
+            end
+          else
+            "@__finalized_actions__[#{action[:object_id]}][:finalized].call(...)\n"
+          end
+        end
+
+        private def finalized_actions(callable, object)
+          validate_skipped_actions(callable)
+          finalized_actions = build_finalized_actions(callable, object)
+          callable.instance_variable_set(:@__finalized_actions__, finalized_actions)
         end
 
-        private def validate_skipped_actions(pipeline)
-          pipeline.__skipped_actions.each do |skipped_action|
-            unless pipeline.__actions.any? { |action| action.name == skipped_action }
-              raise "cannot skip unknown action `#{skipped_action}`"
+        private def validate_skipped_actions(callable)
+          callable.skipped.each do |skipped|
+            unless callable.actions.any? { |action| action.name == skipped }
+              raise "cannot skip unknown action `#{skipped}`"
             end
           end
         end
 
-        private def build_finalized_actions(pipeline)
-          ordered_actions(pipeline).reject { |action|
-            pipeline.__skipped_actions.include?(action.name)
+        private def build_finalized_actions(callable, object)
+          ordered_actions(callable).reject { |action|
+            callable.skipped.include?(action.name)
           }.map { |action|
-            action.finalize(pipeline)
+            finalized = action.finalize(object)
+
+            finalized = if action.curried?
+              wrap_finalized_action_for_context(finalized, action.context || object)
+            else
+              finalized
+            end
+
+            {object: action, finalized: finalized, object_id: finalized.object_id}
           }.each_with_object({}) { |action, lookup|
-            lookup[action.object_id] = action
+            lookup[action[:object_id]] = action
           }
         end
 
-        private def ordered_actions(pipeline)
-          return pipeline.__actions if pipeline.__actions.empty?
+        private def ordered_actions(callable)
+          return callable.actions if callable.actions.empty?
 
           marked = []
           ordered = []
-          working = pipeline.__actions.dup
+          working = callable.actions.dup
 
-          pipeline.__actions.each do |action|
+          callable.actions.each do |action|
             unless action.before || action.after
               ordered << action
               working.delete(action)
@@ -110,6 +132,205 @@ module Core
 
           ordered
         end
+
+        private def wrap_finalized_action_for_context(finalized, context)
+          case finalized
+          when Symbol
+            wrapped_name = :"curried_#{finalized}"
+            method = context.instance_method(finalized)
+            signature = [
+              build_method_arguments_signature(method),
+              build_method_keywords_signature(method),
+              "&block"
+            ].compact.join(", ")
+
+            code = <<~CODE
+              def #{wrapped_name}(*args, **kwargs, &block)
+                self.#{finalized}(#{signature})
+              end
+            CODE
+
+            context.class_eval(code, __FILE__, __LINE__ - 1)
+
+            wrapped_name
+          else
+            if callable_accepts_keyword_arguments?(finalized)
+              finalized_keywords = callable_keywords(finalized)
+
+              if callable_accepts_arguments?(finalized)
+                argument_count = callable_arguments(finalized).count
+
+                if callable_accepts_keyword_arguments_splat?(finalized)
+                  if callable_accepts_arguments_splat?(finalized)
+                    if RbConfig::CONFIG["RUBY_PROGRAM_VERSION"] < "3"
+                      proc { |*args, **kwargs, &block|
+                        finalized.call(*args.take(argument_count), *args[argument_count..], **kwargs.slice(*finalized_keywords), **kwargs.reject { |kwarg, _| finalized_keywords.include?(kwarg) }, &block)
+                      }
+                    else
+                      proc { |*args, **kwargs, &block|
+                        finalized.call(*args.take(argument_count), *args[argument_count..], **kwargs.slice(*finalized_keywords), **kwargs.except(*finalized_keywords), &block)
+                      }
+                    end
+                  elsif RbConfig::CONFIG["RUBY_PROGRAM_VERSION"] < "3"
+                    proc { |*args, **kwargs, &block|
+                      finalized.call(*args.take(argument_count), **kwargs.slice(*finalized_keywords), **kwargs.reject { |kwarg, _| finalized_keywords.include?(kwarg) }, &block)
+                    }
+                  else
+                    proc { |*args, **kwargs, &block|
+                      finalized.call(*args.take(argument_count), **kwargs.slice(*finalized_keywords), **kwargs.except(*finalized_keywords), &block)
+                    }
+                  end
+                elsif callable_accepts_arguments_splat?(finalized)
+                  proc { |*args, **kwargs, &block|
+                    finalized.call(*args.take(argument_count), *args[argument_count..], **kwargs.slice(*finalized_keywords), &block)
+                  }
+                else
+                  proc { |*args, **kwargs, &block|
+                    finalized.call(*args.take(argument_count), **kwargs.slice(*finalized_keywords), &block)
+                  }
+                end
+              elsif callable_accepts_keyword_arguments_splat?(finalized)
+                if callable_accepts_arguments_splat?(finalized)
+                  if RbConfig::CONFIG["RUBY_PROGRAM_VERSION"] < "3"
+                    proc { |*args, **kwargs, &block|
+                      finalized.call(*args, **kwargs.slice(*finalized_keywords), **kwargs.reject { |kwarg, _| finalized_keywords.include?(kwarg) }, &block)
+                    }
+                  else
+                    proc { |*args, **kwargs, &block|
+                      finalized.call(*args, **kwargs.slice(*finalized_keywords), **kwargs.except(*finalized_keywords), &block)
+                    }
+                  end
+                elsif RbConfig::CONFIG["RUBY_PROGRAM_VERSION"] < "3"
+                  proc { |*, **kwargs, &block|
+                    finalized.call(**kwargs.slice(*finalized_keywords), **kwargs.reject { |kwarg, _| finalized_keywords.include?(kwarg) }, &block)
+                  }
+                else
+                  proc { |*, **kwargs, &block|
+                    finalized.call(**kwargs.slice(*finalized_keywords), **kwargs.except(*finalized_keywords), &block)
+                  }
+                end
+              elsif callable_accepts_arguments_splat?(finalized)
+                proc { |*args, **kwargs, &block|
+                  finalized.call(*args, **kwargs.slice(*finalized_keywords), &block)
+                }
+              else
+                proc { |*, **kwargs, &block|
+                  finalized.call(**kwargs.slice(*finalized_keywords), &block)
+                }
+              end
+            elsif callable_accepts_arguments?(finalized)
+              argument_count = callable_arguments(finalized).count
+
+              if callable_accepts_keyword_arguments_splat?(finalized)
+                if callable_accepts_arguments_splat?(finalized)
+                  proc { |*args, **kwargs, &block|
+                    finalized.call(*args.take(argument_count), *args[argument_count..], **kwargs, &block)
+                  }
+                else
+                  proc { |*args, **kwargs, &block|
+                    finalized.call(*args.take(argument_count), **kwargs, &block)
+                  }
+                end
+              elsif callable_accepts_arguments_splat?(finalized)
+                proc { |*args, **, &block|
+                  finalized.call(*args.take(argument_count), *args[argument_count..], &block)
+                }
+              else
+                proc { |*args, **, &block|
+                  finalized.call(*args.take(argument_count), &block)
+                }
+              end
+            elsif callable_accepts_keyword_arguments_splat?(finalized)
+              if callable_accepts_arguments_splat?(finalized)
+                proc { |*args, **kwargs, &block|
+                  finalized.call(*args, **kwargs, &block)
+                }
+              else
+                proc { |*, **kwargs, &block|
+                  finalized.call(**kwargs, &block)
+                }
+              end
+            elsif callable_accepts_arguments_splat?(finalized)
+              proc { |*args, **, &block|
+                finalized.call(*args, &block)
+              }
+            else
+              proc { |*, **, &block|
+                finalized.call(&block)
+              }
+            end
+          end
+        end
+
+        private def build_method_arguments_signature(method)
+          return if method.arity == 0
+
+          arguments = callable_arguments(method)
+
+          if arguments.any?
+            if callable_accepts_arguments_splat?(method)
+              "*args.take(#{arguments.count}), *args[#{arguments.count}..]"
+            else
+              "*args.take(#{arguments.count})"
+            end
+          elsif callable_accepts_arguments_splat?(method)
+            "*args"
+          end
+        end
+
+        private def build_method_keywords_signature(method)
+          return if method.arity == 0
+
+          keywords = callable_keywords(method)
+
+          if keywords.any?
+            keywords_string = keywords.map { |keyword| ":#{keyword}" }.join(", ")
+
+            if callable_accepts_keyword_arguments_splat?(method)
+              if RbConfig::CONFIG["RUBY_PROGRAM_VERSION"] < "3"
+                "**kwargs.slice(#{keywords_string}), **kwargs.reject { |kwarg, _| [#{keywords_string}].include?(kwarg) }"
+              else
+                "**kwargs.slice(#{keywords_string}), **kwargs.except(*#{keywords_string})"
+              end
+            else
+              "**kwargs.slice(#{keywords_string})"
+            end
+          elsif callable_accepts_keyword_arguments_splat?(method)
+            "**kwargs"
+          end
+        end
+
+        private def callable_accepts_arguments_splat?(callable)
+          callable.parameters.any? { |type, _| type == :rest }
+        end
+
+        private def callable_accepts_keyword_arguments_splat?(callable)
+          callable.parameters.any? { |type, _| type == :keyrest }
+        end
+
+        private def callable_accepts_arguments?(callable)
+          callable.parameters.any? { |type, _| type == :req || type == :opt }
+        end
+
+        private def callable_accepts_keyword_arguments?(callable)
+          callable.parameters.any? { |type, _| type == :keyreq || type == :key }
+        end
+
+        private def callable_arguments(callable)
+          callable.parameters.select { |type, _|
+            type == :req || type == :opt
+          }.map { |_, name|
+            name
+          }
+        end
+
+        private def callable_keywords(callable)
+          callable.parameters.select { |type, _|
+            type == :keyreq || type == :key
+          }.map { |_, name|
+            name
+          }
+        end
       end
     end
   end

data/lib/core/pipeline/signals/halted.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "is/inspectable"
+
 module Core
   module Pipeline
     module Signals
       class Halted < Exception
+        include Is::Inspectable
+
         def initialize(value)
           @value = value
         end

data/lib/core/pipeline/signals/rejected.rb

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
+require "is/inspectable"
+
 module Core
   module Pipeline
     module Signals
       class Rejected < Exception
+        include Is::Inspectable
       end
     end
   end

data/lib/core/pipeline/version.rb

@@ -2,7 +2,7 @@
 
 module Core
   module Pipeline
-    VERSION = "0.0.0"
+    VERSION = "0.3.0"
 
     def self.version
       VERSION

data/lib/is/pipeline.rb

@@ -1,10 +1,9 @@
 # frozen_string_literal: true
 
-require "is/async"
 require "is/extension"
 require "is/stateful"
 
-require_relative "../core/pipeline/action"
+require_relative "../core/pipeline/callable"
 require_relative "../core/pipeline/compiler"
 require_relative "../core/pipeline/signals/halted"
 require_relative "../core/pipeline/signals/rejected"
@@ -15,70 +14,92 @@ module Is
   module Pipeline
     extend Is::Extension
 
+    applies do |extended:|
+      # [public] The current callable pipeline.
+      #
+      state :pipeline, default: Core::Pipeline::Callable.new(extended ? singleton_class : self)
+    end
+
     extends dependencies: [
       Is::Stateful
     ]
 
-    extends :class do
+    extends :definition do
       # [public] Defines a pipeline action.
       #
-      def action(*args, before: nil, after: nil, &block)
-        @__actions << Core::Pipeline::Action.build(*args, context: self, before: before, after: after, &block)
+      def action(*args, before: nil, after: nil, context: nil, curry: false, &block)
+        pipeline.action(*args, before: before, after: after, context: context, curry: curry, &block)
       end
 
       # [public] Skips the given action.
       #
       def skip_action(name)
-        @__skipped_actions << name.to_sym
+        pipeline.skip(name)
       end
 
       # [public] Replaces existing actions with actions from the given pipeline.
       #
-      def use_pipeline(pipeline)
-        if (pipeline.is_a?(Class) || pipeline.is_a?(Module)) && pipeline.ancestors.include?(Is::Pipeline)
-          @__actions.clear
-          @__actions.concat(pipeline.__actions)
-        else
-          raise ArgumentError, "expected a pipeline"
-        end
+      def use_pipeline(other_pipeline)
+        pipeline.use(other_pipeline)
       end
 
       # [public] Includes actions from the given pipeline.
       #
-      def include_pipeline(pipeline)
-        if (pipeline.is_a?(Class) || pipeline.is_a?(Module)) && pipeline.ancestors.include?(Is::Pipeline)
-          @__actions.concat(pipeline.__actions)
-        else
-          raise ArgumentError, "expected a pipeline"
-        end
+      def include_pipeline(other_pipeline)
+        pipeline.include(other_pipeline)
       end
 
       # [public] Excludes actions from the given pipeline.
       #
-      def exclude_pipeline(pipeline)
-        if (pipeline.is_a?(Class) || pipeline.is_a?(Module)) && pipeline.ancestors.include?(Is::Pipeline)
-          pipeline.__actions.each do |action|
-            @__actions.delete(action)
-          end
-        else
-          raise ArgumentError, "expected a pipeline"
-        end
+      def exclude_pipeline(other_pipeline)
+        pipeline.exclude(other_pipeline)
       end
     end
 
-    extends :instance do
+    extends :implementation do
       # [public] Calls a pipeline with arguments.
       #
       def call(...)
-        # Compiles the pipeline then redefines `call` to call the compiled pipeline.
-        #
-        Core::Pipeline::Compiler.compile(self)
+        @pipeline.call(self, ...)
+      end
+
+      # [public] Defines a pipeline action, isolated to the instance.
+      #
+      def action(*args, before: nil, after: nil, context: nil, curry: false, &block)
+        pipeline.relocate(singleton_class)
+        pipeline.action(*args, before: before, after: after, context: context, curry: curry, &block)
+      end
+
+      # [public] Skips the given action, isolated to the instance.
+      #
+      def skip_action(name)
+        pipeline.relocate(singleton_class)
+        pipeline.skip(name)
+      end
+
+      # [public] Replaces existing actions with actions from the given pipeline, isolated to the instance.
+      #
+      def use_pipeline(other_pipeline)
+        pipeline.relocate(singleton_class)
+        pipeline.use(other_pipeline)
+      end
+
+      # [public] Includes actions from the given pipeline, isolated to the instance.
+      #
+      def include_pipeline(other_pipeline)
+        pipeline.relocate(singleton_class)
+        pipeline.include(other_pipeline)
+      end
 
-        call(...)
+      # [public] Excludes actions from the given pipeline, isolated to the instance.
+      #
+      def exclude_pipeline(other_pipeline)
+        pipeline.relocate(singleton_class)
+        pipeline.exclude(other_pipeline)
       end
     end
 
-    extends :instance, prepend: true do
+    extends :implementation, prepend: true do
       # [public] Halts the execution of the pipeline, setting the pipeline's current value to the given object.
       #
       private def halt(value = nil)
@@ -91,10 +112,5 @@ module Is
         raise Core::Pipeline::Signals::Rejected
       end
     end
-
-    applied do
-      state :__actions, default: []
-      state :__skipped_actions, default: []
-    end
   end
 end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: core-pipeline
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-07 00:00:00.000000000 Z
+date: 2021-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: core-async
+  name: core-extension
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
-  name: core-extension
+  name: core-inspect
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: core-state
   requirement: !ruby/object:Gem::Requirement
@@ -64,6 +64,7 @@ files:
 - lib/core/pipeline/action.rb
 - lib/core/pipeline/actions/block.rb
 - lib/core/pipeline/actions/method.rb
+- lib/core/pipeline/callable.rb
 - lib/core/pipeline/compiler.rb
 - lib/core/pipeline/signals/halted.rb
 - lib/core/pipeline/signals/rejected.rb
@@ -88,7 +89,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: Turns Ruby objects into pipelines.