trailblazer-operation 0.0.13 → 0.1.1

data/test/wiring/subprocess_test.rb

@@ -0,0 +1,70 @@
+# require "test_helper"
+
+# class WiringWithNestedTest < Minitest::Spec
+#   MyEnd = Class.new(Trailblazer::Circuit::End)
+
+#   class Create < Trailblazer::Operation
+#     class Edit < Trailblazer::Operation
+#       step :a
+
+#       def a(options, a_return:, **)
+#         options["a"] = 1
+#         a_return
+#       end
+
+#       # operations should expose their outputs with proper naming.
+#       #
+#       # {#<Trailblazer::Operation::Railway::End::Success:0x00000001b22310
+#       #   @name=:success,
+#       #   @options={}>=>{:role=>:success},
+#       #  #<Trailblazer::Operation::Railway::End::Failure:0x00000001b222c0
+#       #   @name=:failure,
+#       #   @options={}>=>{:role=>:unauthorized}}
+#       def self.outputs
+#         # Outputs::Only(super, :success, :failure)
+#         # Outputs::Update( outputs, failure: { role: :unauthorized}  )
+
+#         outs = super.to_a
+
+#         outs = Hash[*(outs[0]+outs[1])]
+
+#         outs.merge( outs.keys[1] => { role: :unauthorized } )
+#       end
+#     end
+
+#     attach MyEnd.new(:myend), id: "End.unauthorized"
+
+#     step ( { task: Trailblazer::Activity::Subprocess( Edit, call: :__call__ ),
+#       node_data:  { id: "Nested/" },
+#       outputs:    Edit.outputs, # THIS SHOULD OVERRIDE.
+#       connect_to: Merge({ unauthorized: "End.unauthorized" }) # connects :success automatically.
+#       }), fast_track: true
+
+#     step :b
+#     fail :f
+
+#     def b(options, a:, **)
+#       options["b"] = a+1
+#     end
+
+#     def f(options, a:, **)
+#       options["f"] = a+2
+#     end
+#   end
+
+#   # Edit ==> true, will run :b
+#   it do
+#     result = Create.({}, a_return: true )
+#     result.inspect("a", "b", "f").must_equal %{<Result:true [1, 2, nil] >}
+#     result.event.must_be_instance_of Trailblazer::Operation::Railway::End::Success
+#   end
+
+#   # Edit ==> false, will end on End.unauthorized.
+#   it do
+#     result = Create.({}, a_return: false )
+#     result.inspect("a", "b", "f").must_equal %{<Result:false [1, nil, nil] >}
+#     result.event.must_be_instance_of MyEnd
+
+#     # Create.trace({}, a_return: false ).wtf
+#   end
+# end

data/trailblazer-operation.gemspec

@@ -17,14 +17,12 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-
-  spec.add_dependency "uber" # Uber::Callable is all we need.
-  spec.add_dependency "declarative"
-  spec.add_dependency "pipetree", ">= 0.1.1", "< 0.2.0"
+  spec.add_dependency "trailblazer-activity", ">= 0.3.0", "< 0.4.0"
+  spec.add_dependency "trailblazer-context", ">= 0.1.1", "< 0.3.0"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "minitest"
 
-  spec.required_ruby_version = '>= 1.9.3'
+  spec.required_ruby_version = '>= 2.0.0'
 end

metadata

@@ -1,45 +1,37 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-operation
 version: !ruby/object:Gem::Version
-  version: 0.0.13
+  version: 0.1.1
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-12 00:00:00.000000000 Z
+date: 2017-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: uber
+  name: trailblazer-activity
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: declarative
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+        version: 0.3.0
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.3.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
-  name: pipetree
+  name: trailblazer-context
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -47,7 +39,7 @@ dependencies:
         version: 0.1.1
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -57,7 +49,7 @@ dependencies:
         version: 0.1.1
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -114,28 +106,48 @@ files:
 - README.md
 - Rakefile
 - lib/trailblazer/operation.rb
-- lib/trailblazer/operation/1.9.3/option.rb
-- lib/trailblazer/operation/generic.rb
-- lib/trailblazer/operation/option.rb
-- lib/trailblazer/operation/pipetree.rb
+- lib/trailblazer/operation/deprecated_macro.rb
+- lib/trailblazer/operation/inject.rb
+- lib/trailblazer/operation/inspect.rb
+- lib/trailblazer/operation/public_call.rb
+- lib/trailblazer/operation/railway.rb
+- lib/trailblazer/operation/railway/fast_track.rb
+- lib/trailblazer/operation/railway/normalizer.rb
+- lib/trailblazer/operation/railway/task_builder.rb
 - lib/trailblazer/operation/result.rb
 - lib/trailblazer/operation/skill.rb
+- lib/trailblazer/operation/task_wrap.rb
+- lib/trailblazer/operation/trace.rb
+- lib/trailblazer/operation/variable_mapping.rb
 - lib/trailblazer/operation/version.rb
-- lib/trailblazer/skill.rb
-- test/2.0.0-pipetree_test.rb
-- test/2.1.0-pipetree_test.rb
 - test/benchmark/skill_resolver_benchmark.rb
 - test/call_test.rb
+- test/class_dependencies_test.rb
+- test/docs/doormat_test.rb
+- test/docs/wiring_test.rb
 - test/dry_container_test.rb
+- test/fast_track_test.rb
 - test/gemfiles/Gemfile.ruby-1.9
 - test/gemfiles/Gemfile.ruby-2.0
+- test/gemfiles/Gemfile.ruby-2.0.lock
 - test/gemfiles/Gemfile.ruby-2.3
 - test/inheritance_test.rb
-- test/operation_skill_test.rb
-- test/pipetree_test.rb
+- test/inspect_test.rb
+- test/introspect_test.rb
+- test/macro_test.rb
+- test/operation_test.rb
 - test/result_test.rb
+- test/ruby-2.0.0/operation_test.rb
+- test/ruby-2.0.0/step_test.rb
 - test/skill_test.rb
+- test/step_test.rb
+- test/task_wrap_test.rb
 - test/test_helper.rb
+- test/trace_test.rb
+- test/variable_mapping_test.rb
+- test/wire_test.rb
+- test/wiring/defaults_test.rb
+- test/wiring/subprocess_test.rb
 - trailblazer-operation.gemspec
 homepage: http://trailblazer.to
 licenses:
@@ -149,7 +161,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -157,22 +169,36 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.3
+rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: Trailblazer's operation object with railway flow and integrated error handling.
 test_files:
-- test/2.0.0-pipetree_test.rb
-- test/2.1.0-pipetree_test.rb
 - test/benchmark/skill_resolver_benchmark.rb
 - test/call_test.rb
+- test/class_dependencies_test.rb
+- test/docs/doormat_test.rb
+- test/docs/wiring_test.rb
 - test/dry_container_test.rb
+- test/fast_track_test.rb
 - test/gemfiles/Gemfile.ruby-1.9
 - test/gemfiles/Gemfile.ruby-2.0
+- test/gemfiles/Gemfile.ruby-2.0.lock
 - test/gemfiles/Gemfile.ruby-2.3
 - test/inheritance_test.rb
-- test/operation_skill_test.rb
-- test/pipetree_test.rb
+- test/inspect_test.rb
+- test/introspect_test.rb
+- test/macro_test.rb
+- test/operation_test.rb
 - test/result_test.rb
+- test/ruby-2.0.0/operation_test.rb
+- test/ruby-2.0.0/step_test.rb
 - test/skill_test.rb
+- test/step_test.rb
+- test/task_wrap_test.rb
 - test/test_helper.rb
+- test/trace_test.rb
+- test/variable_mapping_test.rb
+- test/wire_test.rb
+- test/wiring/defaults_test.rb
+- test/wiring/subprocess_test.rb

data/lib/trailblazer/operation/1.9.3/option.rb

@@ -1,36 +0,0 @@
-class Trailblazer::Operation
-  # :private:
-  module Option
-    def self.call(proc, &block)
-      type = :proc
-
-      option =
-        if proc.is_a? Symbol
-          type = :symbol
-          ->(input, _options) { call_method(proc, input, _options) }
-        elsif proc.is_a? Proc
-          ->(input, _options) { call_proc(proc, input, _options) }
-        elsif proc.is_a? Uber::Callable
-          type = :callable
-          ->(input, _options) { call_callable(proc, input, _options) }
-        end
-
-      yield type if block_given?
-      option
-    end
-
-    def self.call_proc(proc, input, options)
-      proc.(options)
-    end
-
-    def self.call_method(proc, input, options)
-      input.send(proc, options)
-    end
-
-    def self.call_callable(callable, input, options)
-      callable.(options)
-    end
-
-    KW = Option
-  end # Option
-end

data/lib/trailblazer/operation/generic.rb

@@ -1,12 +0,0 @@
-module Trailblazer
-  # Generic initializer for the operation.
-  module Operation::Generic
-    def initialize(skills={})
-      @skills = skills
-    end
-
-    # dependency interface
-    extend Forwardable
-    def_delegators :@skills, :[], :[]=
-  end
-end

data/lib/trailblazer/operation/option.rb

@@ -1,54 +0,0 @@
-class Trailblazer::Operation
-  # :private:
-  # This code is not beautiful, but could also be worse.
-  # I'm expecting some of this to go to Uber, as we use this pattern everywhere.
-  class Option
-    def self.call(proc, &block)
-      type = :proc
-
-      option =
-        if proc.is_a? Symbol
-          type = :symbol
-          ->(input, *_options) { call_method(proc, input, *_options) }
-        elsif proc.is_a? Proc
-          ->(input, *_options) { call_proc(proc, input, *_options) }
-        elsif proc.is_a? Uber::Callable
-          type = :callable
-          ->(input, *_options) { call_callable(proc, input, *_options) }
-        end
-
-      yield type if block_given?
-      option
-    end
-
-    def self.call_proc(proc, input, *options)
-      proc.(*options)
-    end
-
-    def self.call_method(proc, input, *options)
-      input.send(proc, *options)
-    end
-
-    def self.call_callable(callable, input, *options)
-      callable.(*options)
-    end
-
-    # Call the option with keyword arguments. Ruby <= 2.0.
-    class KW < Option
-      def self.call_proc(proc, input, options, tmp_options={})
-        return proc.(options) if proc.arity == 1
-        proc.(options, **options.to_hash(tmp_options))
-      end
-
-      def self.call_method(proc, input, options, tmp_options={})
-        return input.send(proc, options) if input.method(proc).arity == 1 # TODO: remove this
-        input.send(proc, options, **options.to_hash(tmp_options))
-      end
-
-      def self.call_callable(callable, input, options, tmp_options={})
-        return callable.(options) if callable.method(:call).arity == 1
-        callable.(options, **options.to_hash(tmp_options))
-      end
-    end
-  end
-end

data/lib/trailblazer/operation/pipetree.rb

@@ -1,142 +0,0 @@
-require "pipetree"
-require "pipetree/railway"
-require "trailblazer/operation/result"
-
-if RUBY_VERSION == "1.9.3"
-  require "trailblazer/operation/1.9.3/option" # TODO: rename to something better.
-else
-  require "trailblazer/operation/option" # TODO: rename to something better.
-end
-
-class Trailblazer::Operation
-  Instantiate = ->(klass, options) { klass.new(options) } # returns operation instance.
-
-  # Implements the API to populate the operation's pipetree and
-  # `Operation::call` to invoke the latter.
-  # Learn more about the Pipetree gem here: https://github.com/apotonick/pipetree
-  module Pipetree
-    def self.included(includer)
-      includer.extend ClassMethods # ::call, ::inititalize_pipetree!
-      includer.extend DSL          # ::|, ::> and friends.
-
-      includer.initialize_pipetree!
-    end
-
-    module ClassMethods
-      # Top-level, this method is called when you do Create.() and where
-      # all the fun starts, ends, and hopefully starts again.
-      def call(options)
-        pipe = self["pipetree"] # TODO: injectable? WTF? how cool is that?
-
-        last, operation = pipe.(self, options)
-
-        # Any subclass of Right will be interpreted as successful.
-        Result.new(!!(last <= Railway::Right), options)
-      end
-
-      # This method would be redundant if Ruby had a Class::finalize! method the way
-      # Dry.RB provides it. It has to be executed with every subclassing.
-      def initialize_pipetree!
-        heritage.record :initialize_pipetree!
-
-        self["pipetree"] = Railway.new
-
-        strut = ->(last, input, options) { [last, Instantiate.(input, options)] } # first step in pipe.
-        self["pipetree"].add(Railway::Right, strut, name: "operation.new") # DISCUSS: using pipe API directly here. clever?
-      end
-    end
-
-    class Railway < ::Pipetree::Railway
-      FailFast = Class.new(Left)
-      PassFast = Class.new(Right)
-
-      def self.fail!     ; Left     end
-      def self.fail_fast!; FailFast end
-      def self.pass!     ; Right    end
-      def self.pass_fast!; PassFast end
-    end
-
-    # The Strut wrapping each step. Makes sure that Track signals are returned immediately.
-    class Switch < ::Pipetree::Railway::Strut
-      Decider = ->(result, config, *args) do
-        return result if result.is_a?(Class) && result <= Railway::Track # this might be pretty slow?
-
-        config[:decider_class].(result, config, *args) # e.g. And::Decider.(result, ..)
-      end
-    end
-
-    # Strut that doesn't evaluate the step's result but stays on `last` or configured :signal.
-    class Stay < ::Pipetree::Railway::Strut
-      Decider = ->(result, config, last, *) { config[:signal] || last }
-    end
-
-    module DSL
-      def success(*args); add(Railway::Right, Stay::Decider, *args) end
-      def failure(*args); add(Railway::Left,  Stay::Decider, *args) end
-      def step(*args)   ; add(Railway::Right, Railway::And::Decider, *args) end
-
-    private
-      # Operation-level entry point.
-      def add(track, decider_class, proc, options={})
-        heritage.record(:add, track, decider_class, proc, options)
-
-        DSL.insert(self["pipetree"], track, decider_class, proc, options)
-      end
-
-      def self.insert(pipe, track, decider_class, proc, options={}) # TODO: make :name required arg.
-        _proc, options = proc.is_a?(Array) ? macro!(proc, options) : step!(proc, options)
-
-        options = options.merge(replace: options[:name]) if options[:override] # :override
-        strut_class, strut_options = AddOptions.(decider_class, options)       # :fail_fast and friends.
-
-        pipe.add(track, strut_class.new(_proc, strut_options), options)
-      end
-
-      def self.macro!(proc, options)
-        _proc, macro_options = proc
-
-        [ _proc, macro_options.merge(options) ]
-      end
-
-      def self.step!(proc, options)
-        name  = ""
-        _proc = Option::KW.(proc) do |type|
-          name = proc if type == :symbol
-          name = "#{proc.source_location[0].split("/").last}:#{proc.source_location.last}" if proc.is_a? Proc if type == :proc
-          name = proc.class  if type == :callable
-        end
-
-        [ _proc, { name: name }.merge(options) ]
-      end
-
-      AddOptions = ->(decider_class, options) do
-        # for #failure and #success:
-        if decider_class == Stay::Decider
-          return [Stay, signal: Railway::FailFast] if options[:fail_fast]
-          return [Stay, signal: Railway::PassFast] if options[:pass_fast]
-          return [Stay, {}]
-        else # for #step:
-          return [Switch, decider_class: decider_class, on_false: Railway::FailFast] if options[:fail_fast]
-          return [Switch, decider_class: decider_class, on_true:  Railway::PassFast] if options[:pass_fast]
-          return [Switch, decider_class: decider_class]
-        end
-      end
-    end # DSL
-  end
-
-  require "uber/callable"
-  # Allows defining dependencies and inject/override them via runtime options, if desired.
-  class Pipetree::Step
-    include Uber::Callable
-
-    def initialize(step, dependencies={})
-      @step, @dependencies = step, dependencies
-    end
-
-    def call(input, options)
-      @dependencies.each { |k, v| options[k] ||= v } # not sure i like this, but the step's API is cool.
-
-      @step.(input, options)
-    end
-  end
-end