trailblazer-activity 0.7.1 → 0.8.0

data/lib/trailblazer/activity/version.rb

@@ -1,5 +1,7 @@
 module Trailblazer
-  class Activity < Module
-    VERSION = "0.7.1"
+  module Version
+    module Activity
+      VERSION = "0.8.0"
+    end
   end
 end

data/trailblazer-activity.gemspec

@@ -4,29 +4,25 @@ require 'trailblazer/activity/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "trailblazer-activity"
-  spec.version       = Trailblazer::Activity::VERSION
+  spec.version       = Trailblazer::Version::Activity::VERSION
   spec.authors       = ["Nick Sutterer"]
   spec.email         = ["apotonick@gmail.com"]
 
-  spec.summary       = %q{Define and run any desired circuit of business logic.}
-  spec.description   = %q{Define and run any desired circuit of business logic. Used in Trailblazer's Operation to implement the railway.}
+  spec.summary       = %q{Runtime code for Trailblazer activities.}
   spec.homepage      = "http://trailblazer.to"
   spec.licenses      = ["MIT"]
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
+    f.match(%r{^(test)/})
   end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
   spec.add_dependency "hirb"
   spec.add_dependency "trailblazer-context"
 
-  spec.add_development_dependency "bundler", "~> 1.14"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler"
   spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "trailblazer-test"
+  spec.add_development_dependency "rake"
 
   spec.required_ruby_version = '>= 2.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-activity
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2018-06-17 00:00:00.000000000 Z
+date: 2019-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hirb
@@ -42,30 +42,16 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.14'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.14'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -81,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '5.0'
 - !ruby/object:Gem::Dependency
-  name: trailblazer-test
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -94,8 +80,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Define and run any desired circuit of business logic. Used in Trailblazer's
-  Operation to implement the railway.
+description: 
 email:
 - apotonick@gmail.com
 executables: []
@@ -103,6 +88,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop-https---raw-githubusercontent-com-trailblazer-meta-master-rubocop-yml"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - ".travis.yml"
@@ -113,47 +99,24 @@ files:
 - Rakefile
 - lib/trailblazer-activity.rb
 - lib/trailblazer/activity.rb
+- lib/trailblazer/activity/circuit.rb
 - lib/trailblazer/activity/config.rb
-- lib/trailblazer/activity/dsl/add_task.rb
-- lib/trailblazer/activity/dsl/helper.rb
-- lib/trailblazer/activity/dsl/magnetic.rb
-- lib/trailblazer/activity/dsl/magnetic/builder.rb
-- lib/trailblazer/activity/dsl/magnetic/builder/default_normalizer.rb
-- lib/trailblazer/activity/dsl/magnetic/builder/fast_track.rb
-- lib/trailblazer/activity/dsl/magnetic/builder/normalizer.rb
-- lib/trailblazer/activity/dsl/magnetic/builder/path.rb
-- lib/trailblazer/activity/dsl/magnetic/builder/railway.rb
-- lib/trailblazer/activity/dsl/magnetic/builder/state.rb
-- lib/trailblazer/activity/dsl/magnetic/finalizer.rb
-- lib/trailblazer/activity/dsl/magnetic/generate.rb
-- lib/trailblazer/activity/dsl/magnetic/merge.rb
-- lib/trailblazer/activity/dsl/magnetic/process_options.rb
-- lib/trailblazer/activity/dsl/magnetic/structure/alterations.rb
-- lib/trailblazer/activity/dsl/magnetic/structure/plus_poles.rb
-- lib/trailblazer/activity/dsl/magnetic/structure/polarization.rb
-- lib/trailblazer/activity/dsl/record.rb
-- lib/trailblazer/activity/dsl/schema/dependencies.rb
-- lib/trailblazer/activity/dsl/schema/sequence.rb
-- lib/trailblazer/activity/dsl/strategy/build_state.rb
-- lib/trailblazer/activity/dsl/strategy/fast_track.rb
-- lib/trailblazer/activity/dsl/strategy/path.rb
-- lib/trailblazer/activity/dsl/strategy/plan.rb
-- lib/trailblazer/activity/dsl/strategy/railway.rb
-- lib/trailblazer/activity/interface.rb
 - lib/trailblazer/activity/introspect.rb
 - lib/trailblazer/activity/present.rb
+- lib/trailblazer/activity/schema.rb
+- lib/trailblazer/activity/schema/implementation.rb
+- lib/trailblazer/activity/schema/intermediate.rb
 - lib/trailblazer/activity/structures.rb
 - lib/trailblazer/activity/task_builder.rb
 - lib/trailblazer/activity/task_wrap.rb
 - lib/trailblazer/activity/task_wrap/call_task.rb
-- lib/trailblazer/activity/task_wrap/merge.rb
+- lib/trailblazer/activity/task_wrap/inject.rb
+- lib/trailblazer/activity/task_wrap/pipeline.rb
 - lib/trailblazer/activity/task_wrap/runner.rb
-- lib/trailblazer/activity/task_wrap/trace.rb
 - lib/trailblazer/activity/task_wrap/variable_mapping.rb
 - lib/trailblazer/activity/testing.rb
 - lib/trailblazer/activity/trace.rb
 - lib/trailblazer/activity/version.rb
-- lib/trailblazer/circuit.rb
 - trailblazer-activity.gemspec
 homepage: http://trailblazer.to
 licenses:
@@ -175,8 +138,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.3
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
-summary: Define and run any desired circuit of business logic.
+summary: Runtime code for Trailblazer activities.
 test_files: []

data/lib/trailblazer/activity/dsl/add_task.rb

@@ -1,22 +0,0 @@
-class Trailblazer::Activity < Module
-  module DSL
-    module AddTask
-      def add_task!(strategy, polarizer, name, task, options, &block)
-        # The beautiful thing about State.add is it doesn't mutate anything.
-        # We're changing state here, on the outside, by overriding the ivars.
-        # That in turn means, the only mutated entity is this module.
-
-        _builder, adds, circuit, outputs, returned_options = Magnetic::Builder::State.add( self[:builder], self[:adds], strategy, polarizer, task, options, &block ) # this could be an extension itself.
-
-        self[:adds]    = adds
-        self[:circuit] = circuit
-        self[:outputs] = outputs
-
-        _, local_options, connections, sequence_options, extension_options = returned_options
-
-        # {Extension API} call all extensions.
-        extension_options.keys.collect { |ext| ext.( self, *returned_options, original_dsl_args: [name, task, options, block] ) }
-      end
-    end
-  end
-end

data/lib/trailblazer/activity/dsl/helper.rb

@@ -1,68 +0,0 @@
-module Trailblazer
-  module Activity::DSL
-    # Create a new method (e.g. Activity::step) that delegates to its builder, recompiles
-    # the circuit, etc. Method comes in a module so it can be overridden via modules.
-    #
-    # This approach assumes you maintain a {#add_task!} method.
-    def self.def_dsl(_name, strategy, polarizer)
-      Module.new do
-        define_method(_name) do |task, options={}, &block|
-          builder, adds, circuit, outputs, options = add_task!(strategy, polarizer, _name, task, options, &block)
-        end
-      end
-    end
-
-    # @api private
-    OutputSemantic = Struct.new(:value)
-    Track          = Struct.new(:color)
-    Extension      = Struct.new(:callable) do
-      def call(*args, &block)
-        callable.(*args, &block)
-      end
-    end
-
-    # Shortcut functions for the DSL. These have no state.
-    module_function
-
-    #   Output( Left, :failure )
-    #   Output( :failure ) #=> Output::Semantic
-    def Output(signal, semantic=nil)
-      return OutputSemantic.new(signal) if semantic.nil?
-
-      Activity.Output(signal, semantic)
-    end
-
-    def End(semantic)
-      Activity.End(semantic)
-    end
-
-    def Track(color)
-      Track.new(color).freeze
-    end
-
-    def Path(normalizer, track_color: "track_#{rand}", end_semantic: track_color, **options)
-      options = options.merge(track_color: track_color, end_semantic: end_semantic)
-
-      # Build an anonymous class which will be where the block is evaluated in.
-      # We use the same normalizer here, so DSL calls in the inner block have the same behavior.
-      path = Module.new do
-        extend Activity::Path( options.merge( normalizer: normalizer ) )
-      end
-
-      # this block is called in DSL::ProcessTuples. This could be improved somehow.
-      ->(block) {
-        path.instance_exec(&block)
-
-        [ track_color, path ]
-      }
-    end
-
-    # Computes the :outputs options for {activity}
-    def Subprocess(activity)
-      {
-        task:    activity,
-        outputs: activity.outputs
-      }
-    end
-  end
-end

data/lib/trailblazer/activity/dsl/magnetic.rb

@@ -1,36 +0,0 @@
-module Trailblazer
-  class Activity < Module   # all code related to the magnetic building of a circuit hash lives in this namespace.
-    module Magnetic
-      # PlusPole "radiates" a color that MinusPoles are attracted to.
-      #
-      # This datastructure is produced by the DSL and sits in an ADDS.
-      PlusPole = Struct.new(:output, :color) do
-        private :output
-
-        def signal
-          output.signal
-        end
-      end # PlusPole
-    end
-  end
-end
-
-require "trailblazer/activity/dsl/magnetic/process_options"
-require "trailblazer/activity/dsl/magnetic/structure/plus_poles"
-require "trailblazer/activity/dsl/magnetic/structure/polarization"
-require "trailblazer/activity/dsl/magnetic/structure/alterations"
-
-require "trailblazer/activity/dsl/magnetic"
-require "trailblazer/activity/dsl/magnetic/builder"
-# require "trailblazer/activity/dsl/magnetic/builder/dsl_helper"
-# require "trailblazer/activity/dsl/magnetic/dsl_helper"
-
-require "trailblazer/option"
-require "trailblazer/activity/task_builder"
-require "trailblazer/activity/dsl/magnetic/builder/default_normalizer"
-require "trailblazer/activity/dsl/magnetic/builder/path"
-require "trailblazer/activity/dsl/magnetic/builder/railway"
-require "trailblazer/activity/dsl/magnetic/builder/fast_track" # TODO: move to Operation gem.
-
-require "trailblazer/activity/dsl/magnetic/generate"
-require "trailblazer/activity/dsl/magnetic/finalizer"

data/lib/trailblazer/activity/dsl/magnetic/builder.rb

@@ -1,101 +0,0 @@
-module Trailblazer
-  module Activity::Magnetic
-
-    # TODO: move?
-    module Options
-      # Produce two hashes, one "local" options with DSL-specific options such as `:fast_track`,
-      # one with generic DSL options, for example tuples like `Right=>Output(:failure)`.
-      def self.normalize(options, local_keys)
-        local, foreign = {}, {}
-        options.each { |k,v| local_keys.include?(k) ? local[k] = v : foreign[k] = v }
-
-        return foreign, local
-      end
-    end
-
-    # Called from Path/Railway/FastTrack, creates the specific {Builder} instance.
-    def self.Builder(implementation, normalizer, builder_options={})
-      builder = implementation.new(normalizer, builder_options.freeze).freeze # e.g. Path.new(...)
-
-      return builder, implementation.InitialAdds(builder_options)
-    end
-
-    class Builder
-      def initialize(normalizer, builder_options)
-        @normalizer, @builder_options = normalizer, builder_options
-      end
-
-      def self.merge(activity_adds, merged_adds)
-        merged_adds = merged_adds[2..-1] || []
-
-        activity_adds + merged_adds
-      end
-
-      # DSL method to create a Path within an activity which is embedded.
-      #
-      # Output(:success) => Path() {}
-      def Path(*args)
-        Activity::DSL.Path(@normalizer, *args)
-      end
-
-      # Public top-level entry point.
-      def insert(strategy, polarizer, task, options, &block)
-        normalizer = options[:normalizer] || @normalizer # DISCUSS: do this at a deeper point?
-
-        task, local_options, connection_options, sequence_options, extension_options = normalizer.(task, options)
-
-        polarizations = strategy.send(polarizer, @builder_options) # Railway.StepPolarizations( @builder_options )
-
-        insert_element( polarizations, task, local_options, connection_options, sequence_options, extension_options, &block )
-      end
-
-      private
-
-      # Internal top-level entry point to add task(s) and connections.
-      # High level interface for DSL calls like ::task or ::step.
-      def insert_element(polarizations, task, local_options, connection_options, sequence_options, extension_options, &block)
-        adds, *returned_options = Builder.adds_for(polarizations, task, local_options, connection_options, sequence_options, extension_options, &block)
-      end
-
-      # @return Adds
-      def self.adds_for(polarizations, task, local_options, connection_options, sequence_options, extension_options, &block)
-        # go through all wiring options such as Output()=>:color.
-        polarizations_from_user_options, additional_adds = process_dsl_options(connection_options, local_options, &block)
-
-        polarizations = polarizations + polarizations_from_user_options
-
-        result = adds(task, polarizations, local_options, sequence_options, local_options)
-
-        return result + (local_options[:adds] || []) + additional_adds, task, local_options, connection_options, sequence_options, extension_options
-      end
-
-      def self.process_dsl_options(options, id:nil, plus_poles:, **, &block)
-        DSL::ProcessOptions.(id, options, plus_poles, &block)
-      end
-
-      # Low-level interface for DSL calls (e.g. Start, where "you know what you're doing")
-      # @private
-      def self.adds(task, polarizations, options, sequence_options, magnetic_to:nil, id:nil, plus_poles:, **) # DISCUSS: no :id ?
-        magnetic_to, plus_poles = PlusPoles.apply_polarizations(
-          polarizations,
-          magnetic_to,
-          plus_poles,
-          options
-        )
-
-        Add( id, task, magnetic_to, plus_poles,
-          options,         #{ fast_track: true },
-          sequence_options #{ group: :main }
-        )
-      end
-
-      def self.Add(id, task, magnetic_to, plus_poles, options, sequence_options)
-        [
-          [ :add, [id, [ magnetic_to, task, plus_poles ], sequence_options] ],
-        ]
-      end
-    end # Builder
-  end
-end
-
-

data/lib/trailblazer/activity/dsl/magnetic/builder/default_normalizer.rb

@@ -1,26 +0,0 @@
-module Trailblazer
-  module Activity::Magnetic
-    # This normalizer only processes basic input and is meant for bootstrapping.
-    #
-    #   task Callable, id: "success", before: "another"
-    class DefaultNormalizer
-      # Declarative::Variables
-      def self.build(plus_poles:, **options)
-        return new(plus_poles: plus_poles), options
-      end
-
-      def initialize(**default_options)
-        @default_options = default_options
-      end
-
-      # Processes the user arguments from the DSL
-      def call(task, options)
-        local_options = @default_options.merge(options) # here, we merge default :plus_poles.
-
-        local_options, sequence_options = Options.normalize( local_options, Activity::Schema::Dependencies.sequence_keywords )
-
-        return task, local_options, {}, sequence_options, {}
-      end
-    end
-  end
-end

data/lib/trailblazer/activity/dsl/magnetic/builder/fast_track.rb

@@ -1,118 +0,0 @@
-# TODO: move me to Operation.
-module Trailblazer
-  module Activity::Magnetic
-    class Builder
-
-      class FastTrack < Builder
-        def self.for(normalizer, builder_options={}) # Build the Builder.
-          Activity::Magnetic::Builder(
-            FastTrack,
-            normalizer,
-            { track_color: :success, end_semantic: :success, failure_color: :failure }.merge( builder_options )
-          )
-        end
-
-        def self.StepPolarizations(**options)
-          [
-            *Railway.StepPolarizations(options),
-            StepPolarization.new(options)
-          ]
-        end
-
-        def self.FailPolarizations(**options)
-          [
-            *Railway.FailPolarizations(options),
-            FailPolarization.new(options)
-          ]
-        end
-
-        def self.PassPolarizations(**options)
-          [
-            *Railway.PassPolarizations(options),
-            PassPolarization.new(options)
-          ]
-        end
-
-        # pass_fast: true simply means: color my :success Output with :pass_fast color
-        class StepPolarization < Railway::StepPolarization
-          def call(magnetic_to, plus_poles, options)
-            plus_poles = plus_poles.reconnect( :success   => :pass_fast ) if options[:pass_fast]
-            plus_poles = plus_poles.reconnect( :failure   => :fail_fast ) if options[:fail_fast]
-
-            # add fast track outputs if :fast_track
-            plus_poles = plus_poles.reverse_merge(
-              Activity.Output(Activity::FastTrack::FailFast, :fail_fast) => :fail_fast,
-              Activity.Output(Activity::FastTrack::PassFast, :pass_fast) => :pass_fast
-            ) if options[:fast_track]
-
-            [
-              magnetic_to,
-              plus_poles
-            ]
-          end
-        end
-
-        class FailPolarization < Railway::StepPolarization
-          def call(magnetic_to, plus_poles, options)
-            plus_poles = plus_poles.reconnect( :failure => :fail_fast, :success => :fail_fast ) if options[:fail_fast]
-            plus_poles = plus_poles.reverse_merge( Activity.Output(Activity::FastTrack::FailFast, :fail_fast) => :fail_fast, Activity.Output(Activity::FastTrack::PassFast, :pass_fast) => :pass_fast ) if options[:fast_track]
-
-            [
-              magnetic_to,
-              plus_poles
-            ]
-          end
-        end
-
-        class PassPolarization < Railway::StepPolarization
-          def call(magnetic_to, plus_poles, options)
-            plus_poles = plus_poles.reconnect( :success => :pass_fast, :failure => :pass_fast ) if options[:pass_fast]
-            plus_poles = plus_poles.reverse_merge( Activity.Output(Activity::FastTrack::FailFast, :fail_fast) => :fail_fast, Activity.Output(Activity::FastTrack::PassFast, :pass_fast) => :pass_fast ) if options[:fast_track]
-
-            [
-              magnetic_to,
-              plus_poles
-            ]
-          end
-        end
-
-        def self.default_plus_poles(*args)
-          Railway.default_plus_poles(*args)
-        end
-
-        # Adds the End.fail_fast and End.pass_fast end to the Railway sequence.
-        def self.InitialAdds(pass_fast_end: Activity.End(:pass_fast), fail_fast_end: Activity.End(:fail_fast), **builder_options)
-          path_adds = Railway.InitialAdds(**builder_options)
-
-          ends =
-            adds(
-              pass_fast_end,
-
-              Path::EndEventPolarizations(builder_options),
-
-              {},
-              { group: :end },
-
-              id:           "End.pass_fast",
-              magnetic_to:  [:pass_fast],
-              plus_poles:   {},
-            )+
-            adds(
-              fail_fast_end,
-
-              Path::EndEventPolarizations(builder_options),
-
-              {},
-              { group: :end },
-
-              magnetic_to:  [:fail_fast],
-              id:           "End.fail_fast",
-              plus_poles:   {},
-            )
-
-          path_adds + ends
-        end
-      end
-    end
-  end
-end