switchyard 7.0.0

data/spec/testing/context_factory/reduce_if_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+require 'test_doubles'
+
+RSpec.describe 'ContextFactory - used with ReduceIfOrganizer' do
+  let(:organizer) { TestDoubles::ReduceIfOrganizer }
+
+  context 'when called with a truthy argument action' do
+    it 'executes a context up-to the callback action' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(4)
+    end
+
+    it 'creates a context up-to action with empty context steps' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsTwoAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(2)
+    end
+  end
+
+  context 'when called with a false argument action' do
+    it 'does not execute the steps' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 0)
+
+      expect(ctx.number).to eq(1)
+    end
+  end
+end

data/spec/testing/context_factory/reduce_until_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+require 'test_doubles'
+
+RSpec.describe 'ContextFactory - used with ReduceUntilOrganizer' do
+  let(:organizer) { TestDoubles::ReduceUntilOrganizer }
+
+  context 'when called with truthy block' do
+    it 'creates a context up-to the action defined before the iteration' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsTwoAction)
+        .with(:number => 1)
+
+      expect(ctx[:number]).to eq(2)
+    end
+
+    it 'creates a context only to the first step of the loop' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(4)
+    end
+  end
+
+  context 'when called with falsey block' do
+    it 'creates a context up-to the first step' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 7)
+
+      expect(ctx[:number]).to eq(10)
+    end
+  end
+end

data/spec/testing/context_factory/with_callback_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'test_doubles'
+
+RSpec.describe 'ContextFactory - used with CallbackOrganizer' do
+  let(:organizer) { TestDoubles::CallbackOrganizer }
+
+  context 'when called with the callback action' do
+    it 'creates a context up-to the callback action' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddTenCallbackAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(2)
+    end
+
+    it 'creates a context up-to callback action with empty context steps' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsTwoAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(12)
+    end
+
+    it 'creates a context up-to the action defined in context steps' do
+      ctx =
+        Switchyard::Testing::ContextFactory
+        .make_from(organizer)
+        .for(TestDoubles::AddsThreeAction)
+        .with(:number => 1)
+
+      expect(ctx.number).to eq(14)
+    end
+  end
+end

data/spec/testing/context_factory_spec.rb

@@ -0,0 +1,76 @@
+require "spec_helper"
+require "test_doubles"
+
+describe "ContextFactory - used with AdditionOrganizer" do
+  let(:organizer) { TestDoubles::AdditionOrganizer }
+
+  after do
+    TestDoubles::AdditionOrganizer.before_actions = nil
+  end
+
+  context "when called with the first action" do
+    it "does not alter the context" do
+      ctx = Switchyard::Testing::ContextFactory
+            .make_from(organizer)
+            .for(TestDoubles::AddsOneAction)
+            .with(1)
+
+      expect(ctx[:number]).to eq(1)
+    end
+  end
+
+  context "when called with the second action" do
+    it "adds one to the number provided" do
+      ctx = Switchyard::Testing::ContextFactory
+            .make_from(organizer)
+            .for(TestDoubles::AddsTwoAction)
+            .with(1)
+
+      expect(ctx.number).to eq(2)
+    end
+  end
+
+  context "when called with third action" do
+    it "creates a context up-to the action defined" do
+      ctx = Switchyard::Testing::ContextFactory
+            .make_from(organizer)
+            .for(TestDoubles::AddsThreeAction)
+            .with(1)
+
+      expect(ctx.number).to eq(4)
+    end
+  end
+
+  context "when there are already before_actions" do
+    it "only appends before_actions" do
+      TestDoubles::AdditionOrganizer.before_actions = [
+        ->(ctx) { ctx[:number] += 1 if ctx.current_action == TestDoubles::AddsTwoAction }
+      ]
+
+      context = Switchyard::Testing::ContextFactory
+                .make_from(TestDoubles::AdditionOrganizer)
+                .for(TestDoubles::AddsThreeAction)
+                .with(4) # Context is a "glorified" hash
+
+      expect(context.number).to eq(8)
+      expect(context[:_before_actions].length).to eq(1)
+    end
+  end
+
+  context "when used repeatedly" do
+    it "does not leave its temporary hook on the organizer class" do
+      2.times do
+        Switchyard::Testing::ContextFactory
+          .make_from(organizer)
+          .for(TestDoubles::AddsTwoAction)
+          .with(1)
+      end
+
+      hooks = organizer.instance_variable_get(:@before_actions)
+      expect(hooks.nil? || hooks.empty?).to be(true)
+
+      # e l'organizer continua a funzionare normalmente
+      expect(organizer.call(1).fetch(:number)).to eq(7)
+    end
+  end
+end

data/switchyard.gemspec

@@ -0,0 +1,35 @@
+require File.expand_path('../lib/switchyard/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Boscolo Michele"]
+  gem.email         = ["miboscol@gmail.com"]
+  gem.description   = %q{Switchyard combines the Organizer/Action/Context pattern of LightService with functional programming constructs (Result/Option monads, pattern matching) inspired by Deterministic: complex workflows are organized into small single-purpose actions with functional error handling.}
+  gem.summary       = %q{A service skeleton with an emphasis on simplicity with a pinch a functional programming}
+  gem.homepage      = "https://github.com/sphynx79/switchyard"
+  gem.license       = "MIT"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.name          = "switchyard"
+  gem.require_paths = ["lib"]
+  gem.version       = Switchyard::VERSION
+  gem.required_ruby_version = '>= 3.1.0'
+
+  gem.add_runtime_dependency("dry-inflector", ">= 0.2.1", "< 2")
+  # logger non e' piu una default gem da Ruby 3.5/4.0: senza questa
+  # dichiarazione `require 'logger'` fallisce sotto Bundler
+  gem.add_runtime_dependency("logger", "~> 1.5")
+
+  # i18n e' opzionale a runtime: l'adapter I18n viene usato solo se
+  # l'applicazione ospite carica la gem (vedi Configuration)
+  gem.add_development_dependency("i18n", "~> 1.8", ">= 1.8.11")
+  gem.add_development_dependency("rake", "~> 13.0")
+  gem.add_development_dependency("rspec", "~> 3.13")
+  gem.add_development_dependency("simplecov", "~> 0.22")
+  gem.add_development_dependency("simplecov-cobertura", "~> 3.0")
+  gem.add_development_dependency("rubocop", "~> 1.75")
+  gem.add_development_dependency("rubocop-performance", "~> 1.20")
+  gem.add_development_dependency("pry", "~> 0.15")
+  gem.add_development_dependency("solargraph", "~> 0.50")
+  gem.add_development_dependency("benchmark-ips", "~> 2.13")
+end

metadata

@@ -0,0 +1,351 @@
+--- !ruby/object:Gem::Specification
+name: switchyard
+version: !ruby/object:Gem::Version
+  version: 7.0.0
+platform: ruby
+authors:
+- Boscolo Michele
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-inflector
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.8.11
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.8.11
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: simplecov-cobertura
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.75'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.75'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.20'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: solargraph
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.50'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.13'
+description: 'Switchyard combines the Organizer/Action/Context pattern of LightService
+  with functional programming constructs (Result/Option monads, pattern matching)
+  inspired by Deterministic: complex workflows are organized into small single-purpose
+  actions with functional error handling.'
+email:
+- miboscol@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/project-build.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".solargraph.yml"
+- Appraisals
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- audit/bench.rb
+- audit/verify_findings.rb
+- gemfiles/dry_inflector_0_2_1.gemfile
+- gemfiles/i18n_1_8_11.gemfile
+- lib/switchyard.rb
+- lib/switchyard/action.rb
+- lib/switchyard/configuration.rb
+- lib/switchyard/context.rb
+- lib/switchyard/context/key_verifier.rb
+- lib/switchyard/deprecations.rb
+- lib/switchyard/errors.rb
+- lib/switchyard/functional/enum.rb
+- lib/switchyard/functional/maybe.rb
+- lib/switchyard/functional/monad.rb
+- lib/switchyard/functional/null.rb
+- lib/switchyard/functional/option.rb
+- lib/switchyard/functional/result.rb
+- lib/switchyard/functional/sequencer.rb
+- lib/switchyard/i18n/localization_adapter.rb
+- lib/switchyard/localization_adapter.rb
+- lib/switchyard/localization_map.rb
+- lib/switchyard/organizer.rb
+- lib/switchyard/organizer/execute.rb
+- lib/switchyard/organizer/iterate.rb
+- lib/switchyard/organizer/reduce_case.rb
+- lib/switchyard/organizer/reduce_if.rb
+- lib/switchyard/organizer/reduce_if_else.rb
+- lib/switchyard/organizer/reduce_until.rb
+- lib/switchyard/organizer/reduce_while.rb
+- lib/switchyard/organizer/scoped_reducable.rb
+- lib/switchyard/organizer/with_callback.rb
+- lib/switchyard/organizer/with_reducer.rb
+- lib/switchyard/organizer/with_reducer_factory.rb
+- lib/switchyard/organizer/with_reducer_log_decorator.rb
+- lib/switchyard/testing.rb
+- lib/switchyard/testing/context_factory.rb
+- lib/switchyard/version.rb
+- resources/fail_actions.png
+- resources/light-service.png
+- resources/organizer_and_actions.png
+- resources/skip_actions.png
+- spec/acceptance/add_numbers_spec.rb
+- spec/acceptance/after_actions_spec.rb
+- spec/acceptance/around_each_spec.rb
+- spec/acceptance/before_actions_spec.rb
+- spec/acceptance/custom_log_from_organizer_spec.rb
+- spec/acceptance/deprecation_warnings_spec.rb
+- spec/acceptance/fail_spec.rb
+- spec/acceptance/log_from_organizer_spec.rb
+- spec/acceptance/message_localization_spec.rb
+- spec/acceptance/organizer/add_aliases_spec.rb
+- spec/acceptance/organizer/add_to_context_spec.rb
+- spec/acceptance/organizer/around_each_with_reduce_if_spec.rb
+- spec/acceptance/organizer/context_failure_and_skipping_spec.rb
+- spec/acceptance/organizer/execute_spec.rb
+- spec/acceptance/organizer/iterate_spec.rb
+- spec/acceptance/organizer/reduce_case_spec.rb
+- spec/acceptance/organizer/reduce_if_else_spec.rb
+- spec/acceptance/organizer/reduce_if_spec.rb
+- spec/acceptance/organizer/reduce_until_spec.rb
+- spec/acceptance/organizer/reduce_while_spec.rb
+- spec/acceptance/organizer/with_callback_spec.rb
+- spec/acceptance/organizer_entry_point_spec.rb
+- spec/acceptance/rollback_spec.rb
+- spec/acceptance/skip_all_remaining_spec.rb
+- spec/acceptance/testing/context_factory_spec.rb
+- spec/action_expected_keys_spec.rb
+- spec/action_expects_and_promises_spec.rb
+- spec/action_optional_expected_keys_spec.rb
+- spec/action_promised_keys_spec.rb
+- spec/action_spec.rb
+- spec/context/inspect_spec.rb
+- spec/context_spec.rb
+- spec/examples/amount_spec.rb
+- spec/examples/controller_spec.rb
+- spec/examples/validate_address_spec.rb
+- spec/i18n_localization_adapter_spec.rb
+- spec/lib/deterministic/class_mixin_spec.rb
+- spec/lib/deterministic/currify_spec.rb
+- spec/lib/deterministic/monad_axioms.rb
+- spec/lib/deterministic/monad_spec.rb
+- spec/lib/deterministic/null_spec.rb
+- spec/lib/deterministic/option_spec.rb
+- spec/lib/deterministic/result/failure_spec.rb
+- spec/lib/deterministic/result/result_map_spec.rb
+- spec/lib/deterministic/result/result_shared.rb
+- spec/lib/deterministic/result/success_spec.rb
+- spec/lib/deterministic/result_spec.rb
+- spec/lib/deterministic/sequencer_spec.rb
+- spec/lib/edge_cases_spec.rb
+- spec/lib/enum_spec.rb
+- spec/lib/native_pattern_matching_spec.rb
+- spec/localization_adapter_spec.rb
+- spec/organizer/with_reducer_spec.rb
+- spec/organizer_key_aliases_spec.rb
+- spec/organizer_spec.rb
+- spec/readme_spec.rb
+- spec/sample/calculates_order_tax_action_spec.rb
+- spec/sample/calculates_tax_spec.rb
+- spec/sample/looks_up_tax_percentage_action_spec.rb
+- spec/sample/provides_free_shipping_action_spec.rb
+- spec/sample/tax/calculates_order_tax_action.rb
+- spec/sample/tax/calculates_tax.rb
+- spec/sample/tax/looks_up_tax_percentage_action.rb
+- spec/sample/tax/provides_free_shipping_action.rb
+- spec/spec_helper.rb
+- spec/support.rb
+- spec/test_doubles.rb
+- spec/testing/context_factory/iterate_spec.rb
+- spec/testing/context_factory/reduce_if_spec.rb
+- spec/testing/context_factory/reduce_until_spec.rb
+- spec/testing/context_factory/with_callback_spec.rb
+- spec/testing/context_factory_spec.rb
+- switchyard.gemspec
+homepage: https://github.com/sphynx79/switchyard
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A service skeleton with an emphasis on simplicity with a pinch a functional
+  programming
+test_files: []