trailblazer-activity 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3223f3eba8cc3fecb792e693dbba7da7f2941a3703b953ccc61c5044916ae5f
-  data.tar.gz: e449258dd404bfeb40516f00b44548fdae0cb59af9b7fc4695c02c649fa71bf8
+  metadata.gz: f790c2cce163e21a33c31093c7d74358574f851249b810a4e776472fccc9cb4f
+  data.tar.gz: 0e78fa480306d480850ef3709871e234ece90939e9552a4ddcfe0bb26f5e2853
 SHA512:
-  metadata.gz: 3bc812315aeff872392b12b9c7094ad851c0192f3cf340d822d4c460309574737aaabb93eb192b1e130075b711cf2b548942fe7a2cad5a1ef860b4d31b78dbde
-  data.tar.gz: 88361f9bc83de278ea1e144276d8167c9b04f82605209ef240877e33900dc8c9480954c092a55fc1e57f516a03bbb81b8499c4488701e95b54f64343a684fc55
+  metadata.gz: 35b942b116679ad0aae0793fc102ad274f2aef584dd91a9d808d0abf50f3ca62ba0e20b9eca9590063bf97096ed177c119d41e18c964d4f33730f9719e30836b
+  data.tar.gz: 63596947b49ca3bfd44d3cd567bf6abfdefbc086cea31da14716654a920caaa443c49071828114a2e7fa99905d3d5810ef9b19087b27b1782a7b1bdcdcddd410

data/.travis.yml

@@ -3,6 +3,7 @@ before_install: gem install bundler
 cache: bundler
 rvm:
   - ruby-head
+  - 3.0
   - 2.7
   - 2.6
   - 2.5

data/CHANGES.md

@@ -1,6 +1,31 @@
+# 0.12.0
+
+* Support for Ruby 3.0.
+
+# 0.11.5
+
+* Bug fix: `:output` filter from `TaskWrap::VariableMapping` wasn't returning the correct `flow_options`. If the wrapped task changed
+  its `flow_options`, the original one was still returned from the taskWrap run, not the updated one.
+
+# 0.11.4
+
+* Introduce the `config_wrap:` option in `Intermediate.call(intermediate, implementation, config_merge: {})` to allow injecting data into the activity's `:config` field.
+
+# 0.11.3
+
+* Allow `Testing.def_task` & `Testing.def_tasks` to return custom signals
+
+# 0.11.2
+
+* Updrading `trailblazer-context` version :drum:
+
+# 0.11.1
+
+* Internal warning fixes.
+
 # 0.11.0
 
-* Support for Ruby 2.7. All warnings are gone.
+* Support for Ruby 2.7. Most warnings are gone.
 
 # 0.10.1
 

data/Gemfile

@@ -1,10 +1,5 @@
 source "https://rubygems.org"
-
-# Specify your gem's dependencies in workflow.gemspec
 gemspec
 
-gem "benchmark-ips"
-gem "minitest-line"
-
-# gem "trailblazer-context", path: "../trailblazer-context"
 # gem "trailblazer-developer", path: "../trailblazer-developer"
+# gem "trailblazer-context", github: "trailblazer/trailblazer-context", branch: "ruby-3"

data/lib/trailblazer/activity.rb

@@ -10,7 +10,7 @@ module Trailblazer
     def call(args, **circuit_options)
       @schema[:circuit].(
         args,
-        **circuit_options.merge(activity: self)
+        **(circuit_options.merge(activity: self))
       )
     end
 

data/lib/trailblazer/activity/circuit.rb

@@ -45,7 +45,7 @@ module Trailblazer
           last_signal, args, _discarded_circuit_options = runner.(
             task,
             args,
-            circuit_options
+            **circuit_options
           )
 
           # Stop execution of the circuit when we hit a stop event (< End). This could be an task's End or Suspend.

data/lib/trailblazer/activity/introspect.rb

@@ -68,6 +68,20 @@ module Trailblazer
       def self.Graph(*args)
         Graph.new(*args)
       end
+
+      def self.render_task(proc)
+        if proc.is_a?(Method)
+
+          receiver = proc.receiver
+          receiver = receiver.is_a?(Class) ? (receiver.name || "#<Class:0x>") : (receiver.name || "#<Module:0x>") #"#<Class:0x>"
+
+          return "#<Method: #{receiver}.#{proc.name}>"
+        elsif proc.is_a?(Symbol)
+          return proc.to_s
+        end
+
+        proc.inspect
+      end
     end # Introspect
   end
 end

data/lib/trailblazer/activity/schema/intermediate.rb

@@ -12,14 +12,16 @@ class Trailblazer::Activity
       # Compiles a {Schema} instance from an {intermediate} structure and
       # the {implementation} object references.
       #
-      # Intermediate structure, Implementation, calls extensions, passes {}config # TODO
-      def self.call(intermediate, implementation)
-        config_default = {wrap_static: Hash.new(TaskWrap.initial_wrap_static)}.freeze # DISCUSS: this really doesn't have to be here, but works for now and we want it in 99%.
+      # Intermediate structure, Implementation, calls extensions, passes {config} # TODO
+      def self.call(intermediate, implementation, config_merge: {})
+        config_default = {wrap_static: Hash.new(TaskWrap.initial_wrap_static)} # DISCUSS: this really doesn't have to be here, but works for now and we want it in 99%.
+        config         = config_default.merge(config_merge)
+        config.freeze
 
         circuit = circuit(intermediate, implementation)
         nodes   = node_attributes(intermediate, implementation)
         outputs = outputs(intermediate.stop_task_ids, nodes)
-        config  = config(implementation, config: config_default)
+        config  = config(implementation, config: config)
         Schema.new(circuit, outputs, nodes, config)
       end
 

data/lib/trailblazer/activity/task_builder.rb

@@ -5,7 +5,7 @@ module Trailblazer
     # Output signal binary: true=>Right, false=>Left.
     # Passes through all subclasses of Direction.~~~~~~~~~~~~~~~~~
     def self.Binary(user_proc)
-      Task.new(Trailblazer::Option::KW( user_proc ), user_proc)
+      Task.new(Trailblazer::Option(user_proc), user_proc)
     end
 
     # Translates the return value of the user step into a valid signal.
@@ -28,16 +28,16 @@ module Trailblazer
 
       def call( (ctx, flow_options), **circuit_options )
         # Execute the user step with TRB's kw args.
-        result = @task.( ctx, **circuit_options ) # circuit_options contains :exec_context.
+        result = @task.(ctx, keyword_arguments: ctx.to_hash, **circuit_options) # circuit_options contains :exec_context.
 
         # Return an appropriate signal which direction to go next.
-        signal = Activity::TaskBuilder.binary_signal_for( result, Activity::Right, Activity::Left )
+        signal = Activity::TaskBuilder.binary_signal_for(result, Activity::Right, Activity::Left)
 
-        return signal, [ ctx, flow_options ]
+        return signal, [ctx, flow_options]
       end
 
-      def inspect
-        %{#<Trailblazer::Activity::TaskBuilder::Task user_proc=#{@user_proc}>}
+      def inspect # TODO: make me private!
+        %{#<Trailblazer::Activity::TaskBuilder::Task user_proc=#{Trailblazer::Activity::Introspect.render_task(@user_proc)}>}
       end
       alias_method :to_s, :inspect
     end

data/lib/trailblazer/activity/task_wrap/call_task.rb

@@ -6,9 +6,11 @@ class Trailblazer::Activity
     def self.call_task(wrap_ctx, original_args)
       task = wrap_ctx[:task]
 
+      original_arguments, original_circuit_options = original_args
+
       # Call the actual task we're wrapping here.
       # puts "~~~~wrap.call: #{task}"
-      return_signal, return_args = task.(*original_args)
+      return_signal, return_args = task.(original_arguments, **original_circuit_options)
 
       # DISCUSS: do we want original_args here to be passed on, or the "effective" return_args which are different to original_args now?
       wrap_ctx = wrap_ctx.merge( return_signal: return_signal, return_args: return_args )

data/lib/trailblazer/activity/task_wrap/inject.rb

@@ -13,7 +13,7 @@ class Trailblazer::Activity
 
             ctx = original_ctx.merge(defaulted_options)
 
-            Trailblazer::Context.for_circuit(ctx, {}, [original_ctx, flow_options], circuit_options) # TODO: test if Inject and :context_class work.
+            Trailblazer::Context(ctx, {}, flow_options[:context_options])
           end
 
           output = ->(new_ctx, (original_ctx, _flow_options), _circuit_options) { # FIXME: use Unscope

data/lib/trailblazer/activity/task_wrap/runner.rb

@@ -9,7 +9,7 @@ class Trailblazer::Activity
       #
       # @api private
       # @interface Runner
-      def self.call(task, args, circuit_options)
+      def self.call(task, args, **circuit_options)
         wrap_ctx = { task: task }
 
         # this pipeline is "wrapped around" the actual `task`.

data/lib/trailblazer/activity/task_wrap/variable_mapping.rb

@@ -38,7 +38,7 @@ class Trailblazer::Activity
       end
 
       # {input.call()} is invoked in the circuit.
-      # `original_args` are the actual args passed to the wrapped task: [ [options, ..], circuit_options ]
+      # `original_args` are the actual args passed to the wrapped task: [ [ctx, ..], circuit_options ]
       #
       def call(wrap_ctx, original_args)
         # let user compute new ctx for the wrapped task.
@@ -57,7 +57,7 @@ class Trailblazer::Activity
 
       # Invoke the @filter callable with the original circuit interface.
       def apply_filter((ctx, original_flow_options), original_circuit_options)
-        @filter.([ctx, original_flow_options], original_circuit_options) # returns {new_ctx}.
+        @filter.([ctx, original_flow_options], **original_circuit_options) # returns {new_ctx}.
       end
     end
 
@@ -73,12 +73,14 @@ class Trailblazer::Activity
       def call(wrap_ctx, original_args)
         (original_ctx, original_flow_options), original_circuit_options = original_args
 
-        returned_ctx, _ = wrap_ctx[:return_args]  # this is the Context returned from {call}ing the wrapped user task.
-        original_ctx    = wrap_ctx[@id]           # grab the original ctx from before which was set in the {:input} filter.
+        return_args = wrap_ctx[:return_args]
+
+        returned_ctx, returned_flow_options = wrap_ctx[:return_args]  # this is the Context returned from {call}ing the wrapped user task.
+        original_ctx                        = wrap_ctx[@id]           # grab the original ctx from before which was set in the {:input} filter.
         # let user compute the output.
-        output_ctx = @filter.(returned_ctx, [original_ctx, original_flow_options], original_circuit_options)
+        output_ctx = @filter.(returned_ctx, [original_ctx, returned_flow_options], **original_circuit_options)
 
-        wrap_ctx = wrap_ctx.merge( return_args: [output_ctx, original_flow_options] )
+        wrap_ctx = wrap_ctx.merge( return_args: [output_ctx, returned_flow_options] )
 
         # and then pass on the "new" context.
         return wrap_ctx, original_args

data/lib/trailblazer/activity/testing.rb

@@ -27,7 +27,9 @@ module Trailblazer
       Module.new do
         define_singleton_method(name) do | (ctx, flow_options), ** |
           ctx[:seq] << name
-          return Activity::Right, [ctx, flow_options]
+          signal = ctx.key?(name) ? ctx[name] : Activity::Right
+
+          return signal, [ctx, flow_options]
         end
       end.method(name)
     end
@@ -38,9 +40,9 @@ module Trailblazer
         names.each do |name|
           define_method(name) do | (ctx, flow_options), ** |
             ctx[:seq] << name
-            result = ctx.key?(name) ? ctx[name] : true
+            signal = ctx.key?(name) ? ctx[name] : Activity::Right
 
-            return (result ? Activity::Right : Activity::Left), [ctx, flow_options]
+            return signal, [ctx, flow_options]
           end
         end
       end
@@ -60,10 +62,6 @@ module Trailblazer
           Success = Activity::End(:success)
         end
 
-        def Cct(activity)
-          Trailblazer::Developer::Render::Circuit.(activity)
-        end
-
         # TODO: Remove this once all it's references are removed
         def implementing
           Implementing
@@ -141,9 +139,19 @@ module Trailblazer
 
         def assert_circuit(schema, circuit)
           cct = Cct(schema)
+
           cct = cct.gsub("#<Trailblazer::Activity::TaskBuilder::Task user_proc=", "<*")
           assert_equal %{#{circuit}}, cct
         end
+
+      def Cct(activity)
+        Trailblazer::Developer::Render::Circuit.(activity, inspect_task: Trailblazer::Activity::Testing.method(:render_task))
+      end
+    end
+
+    # Use this in {#Cct}.
+    def self.render_task(proc)
+      Activity::Introspect.render_task(proc)
     end
   end
 end

data/lib/trailblazer/activity/version.rb

@@ -1,7 +1,7 @@
 module Trailblazer
   module Version
     module Activity
-      VERSION = '0.11.0'.freeze
+      VERSION = '0.12.0'.freeze
     end
   end
 end

data/trailblazer-activity.gemspec

@@ -17,10 +17,11 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "trailblazer-context", ">= 0.3.0", "< 0.4.0"
+  spec.add_dependency "trailblazer-context", ">= 0.4.0", "< 0.5.0"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "minitest-line"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "trailblazer-developer", ">= 0.0.7"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-activity
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-04 00:00:00.000000000 Z
+date: 2021-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: trailblazer-context
@@ -16,20 +16,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.4.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -58,6 +58,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-line
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -139,8 +153,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.3
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: Runtime code for Trailblazer activities.