rung 0.0.1.pre.alpha → 0.1

data/lib/rung/{base.rb → operation.rb}

@@ -1,13 +1,14 @@
 module Rung
-  class Base
+  class Operation
     extend Definition::StepsDSL
+    extend Definition::OperationDSL
 
     def self.call(initial_state = {})
       new.call(initial_state)
     end
 
     def call(initial_state = {})
-      Runner::Runner.new(self.class.steps_definition, initial_state, self).call
+      Runner::Runner.new(self, initial_state).call
     end
   end
 end

data/lib/rung/runner/call_helper.rb

@@ -1,33 +1,51 @@
+# rubocop:disable Metrics/ParameterLists, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/LineLength
 module Rung
   module Runner
     module CallHelper
       class << self
-        def call(operation, state, operation_instance, from_block = false, &block)
-          raise "Can't pass block when from_block is enabled" if block && from_block
-          runnable = to_runnable(operation, operation_instance)
+        def call(action, state, operation_instance, action_from_block = false, second_argument = nil, &block)
+          raise Error, "Can't pass block when action_from_block is enabled" if block && action_from_block
 
-          if from_block
-            runnable.arity.zero? ? operation_instance.instance_exec(&runnable) : operation_instance.instance_exec(state, &runnable)
+          runnable = to_runnable(action, operation_instance)
+          arity = runnable.arity
+
+          if action_from_block
+            case arity
+            when 0
+              operation_instance.instance_exec(&runnable)
+            when 1
+              operation_instance.instance_exec(state, &runnable)
+            else
+              operation_instance.instance_exec(state, second_argument, &runnable)
+            end
           else
-            runnable.arity.zero? ? runnable.call(&block) : runnable.call(state, &block)
+            case arity
+            when 0
+              runnable.call(&block)
+            when 1
+              runnable.call(state, &block)
+            else
+              runnable.call(state, second_argument, &block)
+            end
           end
         end
 
         private
 
-        def to_runnable(operation, operation_instance)
-          case operation
+        def to_runnable(action, operation_instance)
+          case action
           when Symbol, String
-            operation_instance.method(operation)
+            operation_instance.method(action)
           when Proc
-            operation
+            action
           else
-            operation.method(:call)
+            action.method(:call)
           end
         rescue NameError
-          operation
+          action
         end
       end
     end
   end
 end
+# rubocop:enable Metrics/ParameterLists, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/LineLength

data/lib/rung/runner/run_context.rb

@@ -1,25 +1,42 @@
 module Rung
   module Runner
     class RunContext
-      def initialize(steps_definition:, operation_instance:, state:)
-        @steps_definition = steps_definition
+      extend Forwardable
+
+      def initialize(operation_instance, state)
         @operation_instance = operation_instance
         @state = state
         @failed = false
+        @stopped = false
       end
 
-      attr_reader :steps_definition, :operation_instance, :state
+      def_delegators :operation_class,
+        :steps_definition, :around_callbacks,
+        :around_each_callbacks
+      attr_reader :operation_instance, :state
+
+      def operation_class
+        operation_instance.class
+      end
 
       def fail!
         @failed = true
       end
 
-      def failed?
-        @failed
+      def stop!
+        @stopped = true
+      end
+
+      def stopped?
+        @stopped
       end
 
       def success?
-        !failed?
+        !@failed
+      end
+
+      def to_state
+        State.new state, success?, operation_instance
       end
     end
   end

data/lib/rung/runner/runner.rb

@@ -1,26 +1,33 @@
 module Rung
   module Runner
     class Runner
-      def initialize(steps_definition, initial_state, operation_instance)
-        @context = RunContext.new(
-          steps_definition: steps_definition,
-          operation_instance: operation_instance,
-          state: RunState.new(initial_state)
-        )
+      def initialize(operation_instance, initial_state)
+        @context = RunContext.new(operation_instance, {}.merge(initial_state))
       end
 
       extend Forwardable
       def_delegators :@context,
-        :steps_definition, :operation_instance, :state, :failed?, :success?, :fail!
+        :steps_definition, :operation_instance,
+        :around_callbacks, :around_each_callbacks,
+        :success?, :stopped?, :fail!, :stop!
 
       def call
-        run_success = iterate(steps_definition)
+        with_callbacks(around_callbacks) { iterate(steps_definition) }
 
-        Result.new(run_success, state)
+        current_state
       end
 
       private
 
+      def with_callbacks(callbacks, second_argument: nil, &block)
+        callbacks.reverse.inject(block) do |inner, callback|
+          lambda do
+            CallHelper.call callback.action, current_state, operation_instance,
+              callback.from_block, second_argument, &inner
+          end
+        end.call
+      end
+
       def iterate(steps_definition)
         steps_definition.each(&method(:run_step))
 
@@ -28,11 +35,14 @@ module Rung
       end
 
       def run_step(step)
+        return if stopped?
         return unless step.run?(success?)
 
-        step_success = call_step(step)
+        step_success = with_callbacks(
+          around_each_callbacks, second_argument: step
+        ) { call_step(step) }
 
-        fail! unless step_success
+        handle_failure(step) unless step_success
       end
 
       def call_step(step)
@@ -40,13 +50,23 @@ module Rung
       end
 
       def call_nested_step(nested)
-        CallHelper.call(nested.operation, state, operation_instance) do
-          iterate(nested.nested_steps)
+        CallHelper.call nested.action, current_state, operation_instance do
+          iterate nested.nested_steps
         end
       end
 
       def call_simple_step(step)
-        CallHelper.call(step.operation, state, operation_instance, step.from_block)
+        CallHelper.call step.action, current_state, operation_instance,
+          step.from_block
+      end
+
+      def current_state
+        @context.to_state
+      end
+
+      def handle_failure(step)
+        fail! unless step.ignore_result?
+        stop! if step.fail_fast?
       end
     end
   end

data/lib/rung/state.rb

@@ -0,0 +1,35 @@
+module Rung
+  class State
+    include ValueObject
+
+    def initialize(state, success, operation)
+      @success = success
+      @operation = operation
+      @state = state
+    end
+
+    def method_missing(method, *args)
+      return @state.send(method, *args) if @state.respond_to?(method)
+
+      super
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @state.respond_to?(method_name, include_private) || super
+    end
+
+    attr_reader :operation
+
+    def success?
+      @success
+    end
+
+    def fail?
+      !success?
+    end
+
+    alias failure? fail?
+    alias failed? fail?
+    alias successful? success?
+  end
+end

data/lib/rung/value_object.rb

@@ -0,0 +1,12 @@
+module Rung
+  module ValueObject
+    def ==(other)
+      return false if self.class != other.class
+
+      instance_variables.all? do |variable|
+        instance_variable_get(variable) ==
+          other.send(:instance_variable_get, variable)
+      end
+    end
+  end
+end

data/lib/rung/version.rb

@@ -1,3 +1,3 @@
 module Rung
-  VERSION = "0.0.1-alpha"
+  VERSION = '0.1'.freeze
 end

data/rung.gemspec

@@ -1,28 +1,27 @@
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "rung/version"
+require 'rung/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "rung"
+  spec.name          = 'rung'
   spec.version       = Rung::VERSION
-  spec.authors       = ["Jan Jędrychowski"]
-  spec.email         = ["jan@jedrychowski.org"]
-
-  spec.summary       = %q{Business operations DSL}
-  spec.description   = %q{Service object/business operation/Railway DSL, inspired by Trailblazer Operation}
-  spec.homepage      = "https://github.com/gogiel/rung"
-  spec.license       = "MIT"
+  spec.authors       = ['Jan Jędrychowski']
+  spec.email         = ['jan@jedrychowski.org']
 
+  spec.summary       = 'Business operations DSL'
+  spec.description   = 'Service object/business operation/Railway DSL, inspired by Trailblazer Operation'
+  spec.homepage      = 'https://github.com/gogiel/rung'
+  spec.license       = 'MIT'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec|bin)/}) }
   end
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_development_dependency "bundler", "~> 1.16"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "cucumber", "~> 3.1"
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'cucumber', '~> 3.1'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
 end

data/target/cukedoctor-intro.adoc

@@ -0,0 +1 @@
+../README.adoc

data/target/cukedoctor.css

@@ -0,0 +1,3 @@
+.exampleblock .icon.green {
+  display: none;
+}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rung
 version: !ruby/object:Gem::Version
-  version: 0.0.1.pre.alpha
+  version: '0.1'
 platform: ruby
 authors:
 - Jan Jędrychowski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-27 00:00:00.000000000 Z
+date: 2019-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -25,47 +25,47 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.16'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: cucumber
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '10.0'
 - !ruby/object:Gem::Dependency
-  name: cucumber
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.0'
 description: Service object/business operation/Railway DSL, inspired by Trailblazer
   Operation
 email:
@@ -74,32 +74,48 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".circleci/config.yml"
+- ".config/cucumber.yml"
+- ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.md
+- README.adoc
 - Rakefile
-- features/failure.feature
-- features/state.feature
+- features/010_operation.feature
+- features/020_state.feature
+- features/030_failure.feature
+- features/040_failure_step.feature
+- features/050_other_steps.feature
+- features/051_fail_fast.feature
+- features/060_step_wrappers.feature
+- features/070_operation_wrappers.feature
+- features/080_exceptions_handling.feature
+- features/090_around_step_wrapper.feature
+- features/200_misc.feature
 - features/step_definitions/output.rb
 - features/step_definitions/temporary_code_scope.rb
-- features/steps_definition.feature
 - features/support/env.rb
 - lib/rung.rb
-- lib/rung/base.rb
-- lib/rung/definition/steps/nested_step.rb
-- lib/rung/definition/steps/step.rb
-- lib/rung/definition/steps_definition.rb
+- lib/rung/definition/callback.rb
+- lib/rung/definition/nested_step.rb
+- lib/rung/definition/operation_dsl.rb
+- lib/rung/definition/step.rb
 - lib/rung/definition/steps_dsl.rb
 - lib/rung/error.rb
+- lib/rung/operation.rb
 - lib/rung/runner/call_helper.rb
-- lib/rung/runner/result.rb
 - lib/rung/runner/run_context.rb
-- lib/rung/runner/run_state.rb
 - lib/rung/runner/runner.rb
+- lib/rung/state.rb
+- lib/rung/value_object.rb
 - lib/rung/version.rb
 - rung.gemspec
+- target/cukedoctor-intro.adoc
+- target/cukedoctor.css
+- tmp/.keep
 homepage: https://github.com/gogiel/rung
 licenses:
 - MIT
@@ -115,9 +131,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.5.2.1