core-pipeline 0.2.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a6b3ef16c4e8c95532c84fbcfeffa10e3d8b17b710f8a829ea0ea3735039195
-  data.tar.gz: e29f64c2b55dda1e75d022c4cca2f6a2c80fe00e13760ea678335abf74b57da4
+  metadata.gz: a1893498a0bd9f99c296d22dc1db1cfc66306b73a77a89a30c0829e3958f8954
+  data.tar.gz: 5496c708adb86448f72b3239ff6210dfd6d9a41aa3729e0a7d63e58328a19ace
 SHA512:
-  metadata.gz: ccb44ec883364a2a633407dc257f44958386b817210278545e9b0291067437e553c6470616e53bab83876d04db2cebe0100ad727971a68aa955ebff7c3a87f9b
-  data.tar.gz: 6c1bb9fb0905caf54a3aef8b33bb224bc23779a66d66353b48345f61fe8a8e27c54653c65cf0d563f8073e387263675e9afe4ba0245bcfc9cf03fd8465a6b22b
+  metadata.gz: 2b96487e68c5aff4c901f785b165cb3c11719053d8bb30d742a7982075fdb98164041522d205dcd3eacbe8d1f40794498c7b0a28fcc7a6d28e9a414631dd3eca
+  data.tar.gz: 52e9f1d1ebd353b42fc6d27a55dc867b6b7d3a1975ccab209839d4b39cb51e7ca4eaed3211e30168eb6a91670f9e57dd64ed6e7b6ada62d2ba36efe77cde903e

data/CHANGELOG.md

@@ -1,3 +1,28 @@
+## [v0.5.0](https://github.com/metabahn/corerb/releases/tag/2021-11-06)
+
+*released on 2021-11-06*
+
+  * `add` [#105](https://github.com/metabahn/corerb/pull/105) Move pipeline control methods to their own module ([bryanp](https://github.com/bryanp))
+
+## [v0.4.1](https://github.com/metabahn/corerb/releases/tag/2021-11-03)
+
+*released on 2021-11-03*
+
+  * `fix` [#99](https://github.com/metabahn/corerb/pull/99) Prevent pipelines from being recompiled unnecessarily ([bryanp](https://github.com/bryanp))
+
+## [v0.4.0](https://github.com/metabahn/corerb/releases/tag/2021-11-02.1)
+
+*released on 2021-11-02*
+
+  * `add` [#98](https://github.com/metabahn/corerb/pull/98) Add a finalizer to pipelines ([bryanp](https://github.com/bryanp))
+
+## [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*

data/lib/core/pipeline/action.rb

@@ -10,7 +10,7 @@ module Core
     #
     class Action
       include Is::Stateful
-      state :__used_random_suffixes, default: []
+      state :__used_random_suffixes__, default: []
 
       class << self
         # [public] Builds an action for a given target.
@@ -40,10 +40,10 @@ module Core
 
         def build_name
           suffix = generate_random_suffix
-          if __used_random_suffixes.include?(suffix)
+          if __used_random_suffixes__.include?(suffix)
             build_name
           else
-            __used_random_suffixes << suffix
+            __used_random_suffixes__ << suffix
             "action_#{suffix}"
           end
         end

data/lib/core/pipeline/callable.rb

@@ -19,6 +19,7 @@ module Core
         @actions = []
         @skipped = []
         @compiled = false
+        @compiler = Compiler
       end
 
       def initialize_copy(...)
@@ -30,6 +31,10 @@ module Core
       attr_reader :actions
       attr_reader :skipped
 
+      # [public]
+      #
+      attr_writer :compiler
+
       # [public] Relocates to another object context.
       #
       def relocate(object)
@@ -97,23 +102,39 @@ module Core
       # [public] Calls the pipeline in context of an object with the given arguments.
       #
       def call(object, ...)
-        compile.call(object, ...)
+        finalize.call(object, ...)
+      end
+
+      # [public] Finalizes the pipeline.
+      #
+      def finalize
+        compile
+
+        self
       end
 
       private def compile
-        instance_eval(Compiler.compile(self, @object), __FILE__, __LINE__ - 1)
+        return if compiled?
+
+        instance_eval(@compiler.compile(self, @object), __FILE__, __LINE__ - 1)
         @compiled = true
-        self
       end
 
       private def recompile
-        singleton_class.remove_method(:call)
+        remove_compiled_call
         compile
       end
 
       private def compiled?
         @compiled == true
       end
+
+      private def remove_compiled_call
+        return unless compiled?
+
+        singleton_class.remove_method(:call)
+        @compiled = false
+      end
     end
   end
 end

data/lib/core/pipeline/compiler.rb

@@ -21,32 +21,39 @@ module Core
           CODE
         end
 
+        # [public]
+        #
         private def compile_call(callable, object)
           compiled = +""
-          finalized_actions(callable, object).each_pair do |object_id, action|
-            compiled << "begin; "
+          finalized_actions(callable, object).each_value do |action|
+            compiled << "begin\n"
+            compiled << compile_action(action, object)
+            compiled << "rescue Core::Pipeline::Signals::Rejected\n"
+            compiled << "end\n"
+          end
 
-            compiled << case action
-            when Symbol
-              if object.private_method_defined?(action)
-                "object.send(#{action.inspect}, ...); "
-              else
-                "object.#{action}(...); "
-              end
+          compiled
+        end
+
+        # [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
-              "@__finalized_actions[#{object_id}].call(...); "
+              "object.#{action[:finalized]}(...)\n"
             end
-
-            compiled << "rescue Core::Pipeline::Signals::Rejected; end\n"
+          else
+            "@__finalized_actions__[#{action[:object_id]}][:finalized].call(...)\n"
           end
-
-          compiled
         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)
+          callable.instance_variable_set(:@__finalized_actions__, finalized_actions)
         end
 
         private def validate_skipped_actions(callable)
@@ -63,13 +70,15 @@ module Core
           }.map { |action|
             finalized = action.finalize(object)
 
-            if action.curried?
+            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
 
@@ -137,7 +146,7 @@ module Core
 
             code = <<~CODE
               def #{wrapped_name}(*args, **kwargs, &block)
-                #{finalized}(#{signature})
+                self.#{finalized}(#{signature})
               end
             CODE
 

data/lib/core/pipeline/version.rb

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

data/lib/is/pipeline/controller.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Is
+  module Pipeline
+    # [public]
+    #
+    module Controller
+      # [public] Halts the execution of the pipeline, setting the pipeline's current value to the given object.
+      #
+      private def halt(value = nil)
+        raise Core::Pipeline::Signals::Halted.new(value)
+      end
+
+      # [public] Rejects the current action, skipping the rest of the action and calling remaining pipeline actions.
+      #
+      private def reject
+        raise Core::Pipeline::Signals::Rejected
+      end
+    end
+  end
+end

data/lib/is/pipeline.rb

@@ -3,6 +3,7 @@
 require "is/extension"
 require "is/stateful"
 
+require_relative "pipeline/controller"
 require_relative "../core/pipeline/callable"
 require_relative "../core/pipeline/compiler"
 require_relative "../core/pipeline/signals/halted"
@@ -56,7 +57,7 @@ module Is
       end
     end
 
-    extends :implementation do
+    extends :implementation, dependencies: [Is::Pipeline::Controller] do
       # [public] Calls a pipeline with arguments.
       #
       def call(...)
@@ -100,16 +101,12 @@ module Is
     end
 
     extends :implementation, prepend: true do
-      # [public] Halts the execution of the pipeline, setting the pipeline's current value to the given object.
+      # [public]
       #
-      private def halt(value = nil)
-        raise Core::Pipeline::Signals::Halted.new(value)
-      end
-
-      # [public] Rejects the current action, skipping the rest of the action and calling remaining pipeline actions.
-      #
-      private def reject
-        raise Core::Pipeline::Signals::Rejected
+      def finalize
+        super if defined?(super)
+        pipeline.finalize
+        self
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: core-pipeline
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Bryan Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-24 00:00:00.000000000 Z
+date: 2021-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: core-extension
@@ -70,6 +70,7 @@ files:
 - lib/core/pipeline/signals/rejected.rb
 - lib/core/pipeline/version.rb
 - lib/is/pipeline.rb
+- lib/is/pipeline/controller.rb
 homepage: https://github.com/metabahn/corerb/
 licenses:
 - MPL-2.0