trailblazer-circuit 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f5dc593717272d4f702fc5f2f9f0ba48481cfbad
-  data.tar.gz: 108fd37110388fb3d4d45f79787ab284e7434b3a
+  metadata.gz: b52e8d764a309e9a8977564a19ddf387c236aea0
+  data.tar.gz: ae086ee946f06831f4f513bbaae68292864787c4
 SHA512:
-  metadata.gz: 69bbd08cd6cba1c394bc5da24c4d1df1cf7cf6420a3a60c23caf085bd627d5460ffe9c965d7f703466b37f3756347b220c3f8d1fcbf6ddf06abab5b1b6dc220e
-  data.tar.gz: 1714df50a75d590b5ce04c914b1ab0ac6910bf583998551b577697367a22ca69d43d8e47ba8f5b8bb04bbc868c140f5d16bfc0cb7c3f9cd0dd2f3d178da1dd5b
+  metadata.gz: e76bc0e1ce8ea6a5a14563826947b81ea3223b2cbc8aee0b1f9fd1d54d7414fd43f1f8a8a071500fb9b308bda1c1654d852c9084aa880f5d9f87123a15eb7a95
+  data.tar.gz: 7d423b1259a76f6717a84f9aee5b3d23c0ae4696eaea6efb5e415002411683b65f73dd59f16549270b6aa640ce36beb9f7505fb5204a4581b520139ceb72857e

data/CHANGES.md

@@ -1,3 +1,7 @@
+# 0.0.7
+
+* It is now `Trailblazer::Args`.
+
 # 0.0.6
 
 * `Wrapped` is now `Wrap`. Also, a consistent `Alterations` interface allows tweaking here.

data/lib/trailblazer/circuit.rb

@@ -120,6 +120,7 @@ end
 
 require "trailblazer/circuit/activity"
 require "trailblazer/circuit/task"
+require "trailblazer/circuit/args"
 require "trailblazer/circuit/alter"
 require "trailblazer/circuit/trace"
 require "trailblazer/circuit/present"

data/lib/trailblazer/circuit/args.rb

@@ -0,0 +1,57 @@
+module Trailblazer
+  # @note This might go to trailblazer-args along with `Context` at some point.
+  class Args
+    class << self
+      # Returns a {Proc} that, when called, invokes the `proc` argument with keyword arguments.
+      # This is known as "step (call) interface".
+      #
+      # This is commonly used by `Operation::step` to wrap the argument and make it
+      # callable in the circuit.
+      #
+      #   my_proc = ->(options, **kws) { options["i got called"] = true }
+      #   task    = Trailblazer::Args::KW(my_proc)
+      #   task.(options = {})
+      #   options["i got called"] #=> true
+      #
+      # Alternatively, you can pass a symbol and an `:exec_context`.
+      #
+      #   my_proc = :some_method
+      #   task    = Trailblazer::Args::KW(my_proc)
+      #
+      #   class A
+      #     def some_method(options, **kws)
+      #       options["i got called"] = true
+      #     end
+      #   end
+      #
+      #   task.(options = {}, exec_context: A.new)
+      #   options["i got called"] #=> true
+      def KW(proc)
+        if proc.is_a? Symbol
+          ->(*args) { call_method!(proc, *args) }
+        else
+          ->(*args) { call_callable!(proc,   *args) }
+        end
+      end
+
+      private
+
+      # Calls `proc` with a "step" interface.
+      # Override this for your own step strategy.
+      def call!(proc, options)
+        proc.(options, **options.to_hash) # Step interface: (options, **)
+      end
+
+      # Note that both #call_callable! and #call_method! drop most of the args.
+      # If you need those, override this class.
+      def call_callable!(proc, options, *)
+        call!(proc, options)
+      end
+
+      # Make the context's instance method a "lambda" and reuse #call!.
+      def call_method!(proc, options, exec_context:raise, **)
+        call!(exec_context.method(proc), options)
+      end
+    end
+  end
+end

data/lib/trailblazer/circuit/task.rb

@@ -1,6 +1,5 @@
 class Trailblazer::Circuit
   module Task
-    module_function
     # Convenience functions for tasks. Totally optional.
 
     # Task::Binary aka "step"
@@ -10,38 +9,10 @@ class Trailblazer::Circuit
     #
     # Returns task to call the proc with (options, flow_options), omitting `direction`.
     # When called, the task always returns a direction signal.
-    def Binary(step, on_true=Right, on_false=Left)
+    def self.Binary(step, on_true=Right, on_false=Left)
       ->(direction, *args) do # Activity/Task interface.
         [ step.(direction, *args) ? on_true : on_false, *args ] # <=> Activity/Task interface
       end
     end
-
-    module Args
-      module_function
-      # :private:
-      # Return task to call the proc with keyword arguments. Ruby >= 2.0.
-      # This is used by `Operation::step` to wrap the argument and make it
-      # callable in the circuit.
-      def KW(proc)
-        if proc.is_a? Symbol
-          ->(*args) { meth!(proc, *args) } # Activity interface
-        else
-          ->(*args) { call!(proc, *args) } # Activity interface
-        end
-      end
-
-      # DISCUSS: standardize tmp_options.
-      # Calls `proc` with a step interface.
-      def call!(proc, direction, options, flow_options, tmp_options={})
-        # proc.(options, **options.to_hash(tmp_options))
-        proc.(options, **options.to_hash)
-      end
-
-      # Make the context's instance method a "lambda" and reuse #call!.
-      # TODO: should we make :context a kwarg?
-      def meth!(proc, direction, options, flow_options, *args)
-        call!(flow_options[:exec_context].method(proc), direction, options, flow_options, *args)
-      end
-    end
   end
 end

data/lib/trailblazer/circuit/version.rb

@@ -1,5 +1,5 @@
 module Trailblazer
   class Circuit
-    VERSION = "0.0.6"
+    VERSION = "0.0.7"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-circuit
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-06-12 00:00:00.000000000 Z
+date: 2017-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -98,6 +98,7 @@ files:
 - lib/trailblazer/circuit.rb
 - lib/trailblazer/circuit/activity.rb
 - lib/trailblazer/circuit/alter.rb
+- lib/trailblazer/circuit/args.rb
 - lib/trailblazer/circuit/present.rb
 - lib/trailblazer/circuit/task.rb
 - lib/trailblazer/circuit/testing.rb