trailblazer-macro 2.1.0.rc14 → 2.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 257d35af044c9e6d7f243f1435d2f6caaf0a2c6fbc4099b6417c8c0f7c44bf39
-  data.tar.gz: 07e52e6cc9a2b94b686ddf12462deb2076df5b3e189ff5207fe4f2a0dbdafb48
+  metadata.gz: d4da758ccf1b9e9ff6fa413c687fe09c6df11449b84a775c65280a73d1b80f72
+  data.tar.gz: 23bd67cc32f045487ca761e15227fe562e87b7cde3616e7335a8ee3126c51217
 SHA512:
-  metadata.gz: be1d7c595f022b2d8df45e630b2d72082a3625fa0b685462ae86c5ada6adf428927373c82cc05b39bcbb24c2c098e48506cf071ea06483b21fb5625343e81f0d
-  data.tar.gz: 30ed38e17b3a5edfcecbfc831a668bf348c0ab1edff3684ae48d499e457ed73790f1205bf0e18a24f217d7e2fe92560beef20c0c332bae4d3253b5b949d9878d
+  metadata.gz: 4671b91a21144afc728dba8397282a49f6517d183349179a357da87e57a223cb4f5cb81f3d29f0bda0e3013db7581367e02a6de28a19bfbc7b83dd286a3f0d9a
+  data.tar.gz: 339a312f0c7f7bee0afe5f74b06d3694ff826daff2e5bbfe4190a3238252cd92feb36ab14cf2429814eaf5b18e50abdac18bee594b7229c37fc64df8856e18b8

data/.travis.yml

@@ -1,11 +1,12 @@
-sudo: false
 language: ruby
 rvm:
-  - 2.6.2
-  - 2.5.5
-  - 2.4.4
-  - 2.3.7
-  - 2.2
-  - 2.1
-
+  - ruby-head
+  - 2.7
+  - 2.6
+  - 2.5
+  - 2.4
 cache: bundler
+jobs:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: 2.7

data/CHANGES.md

@@ -1,3 +1,26 @@
+# 2.1.4
+
+* Upgrade DSL version to fix step's circuit interface eating passed arguments
+* Upgrade OP version to remove OP::Container reference in tests
+
+# 2.1.3
+
+* Rename Model()'s `not_found_end` kwarg to `not_found_terminus` for consistency.
+
+# 2.1.2
+
+* Fix to make macros available in all Linear::DSL strategies.
+* Make `params` optional in `Model`.
+* Support for adding `End.not_found` end in `Model`.
+
+# 2.1.1
+
+* Fix case when Macros generate same id due to small entropy
+
+# 2.1.0
+
+* Finally.
+
 # 2.1.0.rc14
 
 * Remove the explicit `dsl-linear` dependency.

data/lib/trailblazer/macro.rb

@@ -1,5 +1,6 @@
+require "forwardable"
 require "trailblazer/activity"
-require "trailblazer/activity/dsl/linear" # TODO: remove this dependency
+require "trailblazer/activity/dsl/linear"
 require "trailblazer/operation" # TODO: remove this dependency
 
 require "trailblazer/macro/model"
@@ -12,18 +13,16 @@ require "trailblazer/macro/wrap"
 
 module Trailblazer
   module Macro
-    # All macros sit in the {Trailblazer::Macro} namespace, where we forward calls from
-    # operations and activities to.
-    def self.forward_macros(target)
-      target.singleton_class.def_delegators Trailblazer::Macro, :Model, :Wrap, :Rescue, :Nested
-      target.const_set(:Policy, Trailblazer::Macro::Policy)
-    end
   end
-end
 
-# TODO: Forwardable.def_delegators(Operation, Macro, :Model, :Wrap) would be amazing. It really sucks to extend a foreign class.
-# Trailblazer::Operation.singleton_class.extend Forwardable
-# Trailblazer::Macro.forward_macros(Trailblazer::Operation)
+  # All macros sit in the {Trailblazer::Macro} namespace, where we forward calls from
+  # operations and activities to.
+  module Activity::DSL::Linear::Helper
+    Policy = Trailblazer::Macro::Policy
 
-Trailblazer::Activity::FastTrack.singleton_class.extend Forwardable
-Trailblazer::Macro.forward_macros(Trailblazer::Activity::FastTrack) # monkey-patching sucks.
+    module ClassMethods
+      extend Forwardable
+      def_delegators Trailblazer::Macro, :Model, :Nested, :Wrap, :Rescue
+    end # ClassMethods
+  end # Helper
+end

data/lib/trailblazer/macro/model.rb

@@ -1,5 +1,8 @@
 module Trailblazer::Macro
-  def self.Model(model_class, action = nil, find_by_key = nil)
+
+  Linear = Trailblazer::Activity::DSL::Linear
+
+  def self.Model(model_class, action = nil, find_by_key = nil, id: 'model.build', not_found_terminus: false)
     task = Trailblazer::Activity::TaskBuilder::Binary(Model.new)
 
     injection = Trailblazer::Activity::TaskWrap::Inject::Defaults::Extension(
@@ -8,11 +11,14 @@ module Trailblazer::Macro
       :"model.find_by_key"    => find_by_key
     )
 
-    {task: task, id: "model.build", extensions: [injection]}
+    options = { task: task, id: id, extensions: [injection] }
+    options = options.merge(Linear::Output(:failure) => Linear::End(:not_found)) if not_found_terminus
+
+    options
   end
 
   class Model
-    def call(options, params:,  **)
+    def call(options, params: nil,  **)
       builder                 = Model::Builder.new
       options[:model]         = model = builder.call(options, params)
       options[:"result.model"] = result = Trailblazer::Operation::Result.new(!model.nil?, {})

data/lib/trailblazer/macro/rescue.rb

@@ -20,7 +20,7 @@ module Trailblazer
         end
       end
 
-      Wrap(rescue_block, id: "Rescue(#{rand(100)})", &block)
+      Wrap(rescue_block, id: "Rescue(#{SecureRandom.hex(4)})", &block)
       # FIXME: name
       # [ step, name: "Rescue:#{block.source_location.last}" ]
     end

data/lib/trailblazer/macro/version.rb

@@ -1,7 +1,7 @@
 module Trailblazer
   module Version
     module Macro
-      VERSION = "2.1.0.rc14".freeze
+      VERSION = "2.1.4"
     end
   end
 end

data/lib/trailblazer/macro/wrap.rb

@@ -1,6 +1,8 @@
+require 'securerandom'
+
 module Trailblazer
   module Macro
-    def self.Wrap(user_wrap, id: "Wrap/#{rand(100)}", &block)
+    def self.Wrap(user_wrap, id: "Wrap/#{SecureRandom.hex(4)}", &block)
       activity = Class.new(Activity::FastTrack, &block) # This is currently coupled to {dsl-linear}.
 
       outputs  = activity.to_h[:outputs]

data/test/docs/guard_test.rb

@@ -108,30 +108,6 @@ class DocsGuardNamedTest < Minitest::Spec
   }
 end
 
-#---
-# dependency injection
-class DocsGuardInjectionTest < Minitest::Spec
-  #:di-op
-  class Create < Trailblazer::Operation
-    extend Trailblazer::Operation::Container
-
-    step Policy::Guard( ->(options, current_user:, **) { current_user == Module } )
-  end
-  #:di-op end
-
-  it { Create.(:current_user => Module).inspect("").must_equal %{<Result:true [nil] >} }
-  it {
-    result =
-  #:di-call
-  Create.(
-    {},
-    :current_user        => Module,
-    :"policy.default.eval" => Trailblazer::Operation::Policy::Guard.build(->(options, **) { false })
-  )
-  #:di-call end
-    result.inspect("").must_equal %{<Result:false [nil] >} }
-end
-
 #---
 # missing current_user throws exception
 class DocsGuardMissingKeywordTest < Minitest::Spec

data/test/docs/model_test.rb

@@ -45,6 +45,13 @@ class DocsModelTest < Minitest::Spec
   end
   #:update-with-find-by-key end
 
+  #:update-with-not-found-end
+  class UpdateFailureWithModelNotFound < Trailblazer::Operation
+    step Model( Song, :find_by, not_found_terminus: true )
+    # ..
+  end
+  #:update-with-not-found-end end
+
   it do
     #:update-ok
     result = Update.(params: { id: 1 })
@@ -83,6 +90,19 @@ class DocsModelTest < Minitest::Spec
     result.success?.must_equal false
   end
 
+  it do
+    #:update-with-not-found-end-use
+    result = UpdateFailureWithModelNotFound.(params: {title: nil})
+    result[:model] #=> nil
+    result.success? #=> false
+    result.event #=> #<Trailblazer::Activity::End semantic=:not_found>
+    #:update-with-not-found-end-use end
+
+    result[:model].must_be_nil
+    result.success?.must_equal false
+    result.event.inspect.must_equal %{#<Trailblazer::Activity::End semantic=:not_found>}
+  end
+
   #:show
   class Show < Trailblazer::Operation
     step Model( Song, :[] )

data/test/docs/nested_test.rb

@@ -131,6 +131,36 @@ class NestedInput < Minitest::Spec
     C::Create.(seq: [], params: nil).inspect(:seq).must_equal %{<Result:true [[:create, :validate, :json, :save]] >}
   end
 
+  it "Nested(:method), with pass_fast returned from nested" do
+    class JustPassFast < Trailblazer::Operation
+      step :just_pass_fast, pass_fast: true
+      include T.def_steps(:just_pass_fast)
+    end
+
+    module D
+
+      create =
+      #:nested-with-pass-fast
+      class Create < Trailblazer::Operation
+
+        def compute_nested(ctx, **)
+          JustPassFast
+        end
+
+        step :create
+        step Nested(:compute_nested)
+        step :save
+        #~meths
+        include T.def_steps(:create, :save)
+        #~meths end
+      end
+      #:nested-with-pass-fast end
+
+      # pass fast
+      create.(seq: []).inspect(:seq).must_equal %{<Result:true [[:create, :just_pass_fast, :save]] >}
+    end
+  end
+
   let(:compute_edit) {
     ->(ctx, what:, **) { what }
   }

data/test/docs/rescue_test.rb

@@ -23,7 +23,7 @@ class NestedRescueTest < Minitest::Spec
     fail ->(options, **) { options["outer-err"] = true }, id: "nested/failure"
   end
 
-  it { Trailblazer::Developer.railway(NestedInsanity).must_match /\[>Rescue\(\d+\),>nested/ } # FIXME: better introspect tests for all id-generating macros.
+  it { Trailblazer::Developer.railway(NestedInsanity).must_match /\[>Rescue\(.{8}\),>nested/ } # FIXME: better introspect tests for all id-generating macros.
   it { NestedInsanity.().inspect("a", "y", "z", "b", "c", "e", "inner-err", "outer-err").must_equal %{<Result:true [true, true, true, true, true, true, nil, nil] >} }
   it { NestedInsanity.( "raise-y" => true).inspect("a", "y", "z", "b", "c", "e", "inner-err", "outer-err").must_equal %{<Result:false [true, true, nil, nil, nil, nil, true, true] >} }
   it { NestedInsanity.( "raise-a" => true).inspect("a", "y", "z", "b", "c", "e", "inner-err", "outer-err").must_equal %{<Result:false [true, true, true, true, nil, nil, nil, true] >} }
@@ -126,4 +126,29 @@ Rescue( handler: :instance_method )
     it { Memo::Create.( { seq: [], } ).inspect(:seq, :exception_class).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify], nil] >} }
     it { Memo::Create.( { seq: [], rehash_raise: true } ).inspect(:seq, :exception_class).must_equal %{<Result:false [[:find_model, :update, :rehash, :log_error], RuntimeError] >} }
   end
+
+=begin
+Rescue(), fast_track: true {}
+=end
+  class RescueWithFastTrack < Minitest::Spec
+    Memo = Class.new
+
+    #:rescue-fasttrack
+    class Memo::Create < Trailblazer::Operation
+      rescue_block = ->(*) {
+        step :update, Output(:failure) => End(:fail_fast)
+        step :rehash
+      }
+
+      step :find_model
+      step Rescue(&rescue_block), fail_fast: true
+      step :notify
+      fail :log_error
+      #~methods
+      include T.def_steps(:find_model, :update, :notify, :log_error, :rehash)
+    end
+
+    it { Memo::Create.( { seq: [], } ).inspect(:seq).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify]] >} }
+    it { Memo::Create.( { seq: [], update: false } ).inspect(:seq).must_equal %{<Result:false [[:find_model, :update]] >} }
+  end
 end

data/test/docs/wrap_test.rb

@@ -1,9 +1,6 @@
 require "test_helper"
 
 class DocsWrapTest < Minitest::Spec
-  module Memo
-  end
-
 =begin
 When success: return the block's returns
 When raise:   return {Railway.fail!}
@@ -11,11 +8,10 @@ When raise:   return {Railway.fail!}
   #:wrap-handler
   class HandleUnsafeProcess
     def self.call((ctx, flow_options), *, &block)
-      begin
-        yield # calls the wrapped steps
-      rescue
-        [ Trailblazer::Operation::Railway.fail!, [ctx, flow_options] ]
-      end
+      yield # calls the wrapped steps
+    rescue
+      ctx[:exception] = $!.message
+      [ Trailblazer::Operation::Railway.fail!, [ctx, flow_options] ]
     end
   end
   #:wrap-handler end
@@ -64,6 +60,11 @@ result.wtf? #=>
 =end
   end
 
+=begin
+Writing into ctx in a Wrap()
+=end
+  it { Memo::Create.( { seq: [], rehash_raise: true } )[:exception].must_equal("nope!") }
+
 =begin
 When success: return the block's returns
 When raise:   return {Railway.fail!}, but wire Wrap() to {fail_fast: true}
@@ -74,13 +75,9 @@ When raise:   return {Railway.fail!}, but wire Wrap() to {fail_fast: true}
     class Memo::Create < Trailblazer::Operation
       class HandleUnsafeProcess
         def self.call((ctx), *, &block)
-          begin
-            yield # calls the wrapped steps
-          rescue
-            puts $!
-            ctx[:exception] = $!.message
-            [ Trailblazer::Operation::Railway.fail!, [ctx, {}] ]
-          end
+          yield # calls the wrapped steps
+        rescue
+          [ Trailblazer::Operation::Railway.fail!, [ctx, {}] ]
         end
       end
 
@@ -112,11 +109,9 @@ When raise:   return {Railway.fail_fast!} and configure Wrap() to {fast_track: t
     #:fail-fast-handler
     class HandleUnsafeProcess
       def self.call((ctx), *, &block)
-        begin
-          yield # calls the wrapped steps
-        rescue
-          [ Trailblazer::Operation::Railway.fail_fast!, [ctx, {}] ]
-        end
+        yield # calls the wrapped steps
+      rescue
+        [ Trailblazer::Operation::Railway.fail_fast!, [ctx, {}] ]
       end
     end
     #:fail-fast-handler end
@@ -145,122 +140,176 @@ When raise:   return {Railway.fail_fast!} and configure Wrap() to {fast_track: t
 When success: return the block's returns
 When raise:   return {Railway.fail!} or {Railway.pass!}
 =end
-  class WrapWithTransactionTest < Minitest::Spec
-    Memo = Module.new
+  class WrapWithCustomEndsTest < Minitest::Spec
+    Memo   = Module.new
 
-    module Sequel
-      def self.transaction
-        begin
-          end_event, (ctx, flow_options) = yield
-          true
-        rescue
-          false
-        end
+    #:custom-handler
+    class MyTransaction
+      MyFailSignal = Class.new(Trailblazer::Activity::Signal)
+
+      def self.call((ctx, flow_options), *, &block)
+        yield # calls the wrapped steps
+      rescue
+        MyFailSignal
       end
     end
+    #:custom-handler end
 
-    #:transaction-handler
-    class MyTransaction
-      def self.call((ctx, flow_options), *, &block)
-        result = Sequel.transaction { yield }
+    #:custom
+    class Memo::Create < Trailblazer::Operation
+      step :find_model
+      step Wrap( MyTransaction ) {
+        step :update
+        step :rehash
+      },
+        Output(:success) => End(:transaction_worked),
+        Output(MyTransaction::MyFailSignal, :failure) => End(:transaction_failed)
+      step :notify
+      fail :log_error
+      #~methods
+      include T.def_steps(:find_model, :update, :notify, :log_error)
+      include Rehash
+      #~methods end
+    end
+    #:custom end
 
-        signal = result ? Trailblazer::Operation::Railway.pass! : Trailblazer::Operation::Railway.fail!
+    it do
+      result = Memo::Create.( { seq: [] } )
+      result.inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash]] >}
+      result.event.inspect.must_equal %{#<Trailblazer::Activity::End semantic=:transaction_worked>}
+    end
 
-        [ signal, [ctx, flow_options] ]
-      end
+    it do
+      result = Memo::Create.( { seq: [], rehash_raise: true } )
+      result.inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash]] >}
+      result.event.inspect.must_equal %{#<Trailblazer::Activity::End semantic=:transaction_failed>}
     end
-    #:transaction-handler end
+  end
+
+=begin
+When success: return the block's returns
+When raise:   return {Railway.pass!} and go "successful"
+=end
+  class WrapGoesIntoPassFromRescueTest < Minitest::Spec
+    Memo = Module.new
 
-    #:transaction
     class Memo::Create < Trailblazer::Operation
+      class HandleUnsafeProcess
+        def self.call((ctx), *, &block)
+          yield # calls the wrapped steps
+        rescue
+          [ Trailblazer::Operation::Railway.pass!, [ctx, {}] ]
+        end
+      end
+
       step :find_model
-      #:wrap-only
-      step Wrap( MyTransaction ) {
+      step Wrap( HandleUnsafeProcess ) {
         step :update
         step :rehash
       }
-      #:wrap-only end
       step :notify
       fail :log_error
+
       #~methods
       include T.def_steps(:find_model, :update, :notify, :log_error)
       include Rehash
       #~methods end
     end
-    #:transaction end
 
     it { Memo::Create.( { seq: [] } ).inspect(:seq).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify]] >} }
-    it { Memo::Create.( { seq: [], rehash_raise: true } ).inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash, :log_error]] >} }
+    it { Memo::Create.( { seq: [], rehash_raise: true } ).inspect(:seq).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify]] >} }
   end
 
 =begin
 When success: return the block's returns
-When raise:   return {Railway.fail!} or {Railway.pass!}
+When raise:   return {true} and go "successful"
+You can return boolean true in wrap.
 =end
-  class WrapWithCustomEndsTest < Minitest::Spec
-    Memo   = Module.new
-    Sequel = WrapWithTransactionTest::Sequel
+  class WrapGoesIntoBooleanTrueFromRescueTest < Minitest::Spec
+    Memo = Module.new
 
-    #:custom-handler
-    class MyTransaction
-      MyFailSignal = Class.new(Trailblazer::Activity::Signal)
+    class Memo::Create < Trailblazer::Operation
+      class HandleUnsafeProcess
+        def self.call((ctx), *, &block)
+          yield # calls the wrapped steps
+        rescue
+          true
+        end
+      end
 
-      def self.call((ctx, flow_options), *, &block)
-        result = Sequel.transaction { yield }
+      step :find_model
+      step Wrap( HandleUnsafeProcess ) {
+        step :update
+        step :rehash
+      }
+      step :notify
+      fail :log_error
 
-        signal = result ? Trailblazer::Operation::Railway.pass! : MyFailSignal
+      #~methods
+      include T.def_steps(:find_model, :update, :notify, :log_error)
+      include Rehash
+      #~methods end
+    end
 
-        [ signal, [ctx, flow_options] ]
-      end
+    it "translates true returned form a wrap to a signal with a `success` semantic" do
+      result = Memo::Create.( { seq: [], rehash_raise: true } )
+      result.inspect(:seq).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify]] >}
+      result.event.inspect.must_equal %{#<Trailblazer::Activity::Railway::End::Success semantic=:success>}
     end
-    #:custom-handler end
+  end
+
+=begin
+When success: return the block's returns
+When raise:   return {false} and go "failed"
+You can return boolean false in wrap.
+=end
+  class WrapGoesIntoBooleanFalseFromRescueTest < Minitest::Spec
+    Memo = Module.new
 
-    #:custom
     class Memo::Create < Trailblazer::Operation
+      class HandleUnsafeProcess
+        def self.call((ctx), *, &block)
+          yield # calls the wrapped steps
+        rescue
+          false
+        end
+      end
+
       step :find_model
-      step Wrap( MyTransaction ) {
+      step Wrap( HandleUnsafeProcess ) {
         step :update
         step :rehash
-      },
-        Output(:success) => End(:transaction_worked),
-        Output(MyTransaction::MyFailSignal, :failure) => End(:transaction_failed)
+      }
       step :notify
       fail :log_error
+
       #~methods
       include T.def_steps(:find_model, :update, :notify, :log_error)
       include Rehash
       #~methods end
     end
-    #:custom end
-
-    it do
-      result = Memo::Create.( { seq: [] } )
-      result.inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash]] >}
-      result.event.inspect.must_equal %{#<Trailblazer::Activity::End semantic=:transaction_worked>}
-    end
 
-    it do
+    it "translates false returned form a wrap to a signal with a `failure` semantic" do
       result = Memo::Create.( { seq: [], rehash_raise: true } )
-      result.inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash]] >}
-      result.event.inspect.must_equal %{#<Trailblazer::Activity::End semantic=:transaction_failed>}
+      result.inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash, :log_error]] >}
+      result.event.inspect.must_equal %{#<Trailblazer::Activity::Railway::End::Failure semantic=:failure>}
     end
   end
 
 =begin
 When success: return the block's returns
-When raise:   return {Railway.pass!} and go "successful"
+When raise:   return {nil} and go "failed"
+You can return nil in wrap.
 =end
-  class WrapGoesIntoPassFromRescueTest < Minitest::Spec
+  class WrapGoesIntoNilFromRescueTest < Minitest::Spec
     Memo = Module.new
 
     class Memo::Create < Trailblazer::Operation
       class HandleUnsafeProcess
         def self.call((ctx), *, &block)
-          begin
-            yield # calls the wrapped steps
-          rescue
-            [ Trailblazer::Operation::Railway.pass!, [ctx, {}] ]
-          end
+          yield # calls the wrapped steps
+        rescue
+          nil
         end
       end
 
@@ -278,7 +327,94 @@ When raise:   return {Railway.pass!} and go "successful"
       #~methods end
     end
 
+    it "translates nil returned form a wrap to a signal with a `failure` semantic" do
+      result = Memo::Create.( { seq: [], rehash_raise: true } )
+      result.inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash, :log_error]] >}
+      result.event.inspect.must_equal %{#<Trailblazer::Activity::Railway::End::Failure semantic=:failure>}
+    end
+  end
+
+=begin
+When success: return the block's returns
+When raise:   return {Railway.fail!}
+This one is mostly to show how one could wrap steps in a transaction
+=end
+  class WrapWithTransactionTest < Minitest::Spec
+    Memo = Module.new
+
+    module Sequel
+      def self.transaction
+        end_event, (ctx, flow_options) = yield
+      end
+    end
+
+    #:transaction-handler
+    class MyTransaction
+      def self.call((ctx, flow_options), *, &block)
+        Sequel.transaction { yield } # calls the wrapped steps
+      rescue
+        [ Trailblazer::Operation::Railway.fail!, [ctx, flow_options] ]
+      end
+    end
+    #:transaction-handler end
+
+    #:transaction
+    class Memo::Create < Trailblazer::Operation
+      step :find_model
+      step Wrap( MyTransaction ) {
+        step :update
+        step :rehash
+      }
+      step :notify
+      fail :log_error
+      #~methods
+      include T.def_steps(:find_model, :update, :notify, :log_error)
+      include Rehash
+      #~methods end
+    end
+    #:transaction end
+
     it { Memo::Create.( { seq: [] } ).inspect(:seq).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify]] >} }
-    it { Memo::Create.( { seq: [], rehash_raise: true } ).inspect(:seq).must_equal %{<Result:true [[:find_model, :update, :rehash, :notify]] >} }
+    it { Memo::Create.( { seq: [], rehash_raise: true } ).inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :rehash, :log_error]] >} }
+  end
+
+=begin
+When success: return {Railway.pass_fast!}
+When failure: return {Railway.fail!}
+This one is mostly to show how one could evaluate Wrap()'s return value based on Wrap() block's return
+=end
+  class WrapWithBlockReturnSignatureCheckTest < Minitest::Spec
+    Memo = Module.new
+
+    #:handler-with-signature-evaluator
+    class HandleUnsafeProcess
+      def self.call((_ctx, _flow_options), *, &block)
+        signal, (ctx, flow_options) = yield
+        evaluated_signal = if signal.to_h[:semantic] == :success
+                            Trailblazer::Operation::Railway.pass_fast!
+                          else
+                            Trailblazer::Operation::Railway.fail!
+                          end
+        [ evaluated_signal, [ctx, flow_options] ]
+      end
+    end
+    #:handler-with-signature-evaluator end
+
+    #:transaction
+    class Memo::Create < Trailblazer::Operation
+      step :find_model
+      step Wrap( HandleUnsafeProcess ) {
+        step :update
+      }, fast_track: true # because Wrap can return pass_fast! now
+      step :notify
+      fail :log_error
+      #~methods
+      include T.def_steps(:find_model, :update, :notify, :log_error)
+      #~methods end
+    end
+    #:transaction end
+
+    it { Memo::Create.( { seq: [] } ).inspect(:seq).must_equal %{<Result:true [[:find_model, :update]] >} }
+    it { Memo::Create.( { seq: [], update: false } ).inspect(:seq).must_equal %{<Result:false [[:find_model, :update, :log_error]] >} }
   end
 end

data/test/operation/model_test.rb

@@ -19,11 +19,8 @@ class ModelTest < Minitest::Spec
   end
 
   # :new new.
-  it { Create.(params: {})[:model].inspect.must_equal %{#<struct ModelTest::Song id=nil, title=nil>} }
-  it do
-
-    result = Create.(params: {})
-
+  it "initializes new model's instance" do
+    result = Create.()
     result[:model].inspect.must_equal %{#<struct ModelTest::Song id=nil, title=nil>}
   end
 

data/test/test_helper.rb

@@ -1,9 +1,10 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require "trailblazer/macro"
+
 require "delegate" # Ruby 2.2
 require "minitest/autorun"
 
 require "trailblazer/developer"
-require "trailblazer/macro"
-
 
 module Mock
   class Result
@@ -39,7 +40,7 @@ T = Trailblazer::Activity::Testing
 module Rehash
   def rehash(ctx, seq:, rehash_raise: false, **)
     seq << :rehash
-    raise if rehash_raise
+    raise "nope!" if rehash_raise
     true
   end
 end

data/trailblazer-macro.gemspec

@@ -25,7 +25,9 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "roar"
   spec.add_development_dependency "trailblazer-developer"
 
-  spec.add_dependency "trailblazer-operation", ">= 0.5.2" # TODO: this dependency will be removed.
+  spec.add_dependency "trailblazer-activity", ">= 0.11.2", "< 1.0.0"
+  spec.add_dependency "trailblazer-activity-dsl-linear", ">= 0.3.3", "< 1.0.0"
+  spec.add_dependency "trailblazer-operation", ">= 0.6.5" # TODO: this dependency will be removed.
 
-  spec.required_ruby_version = ">= 2.0.0"
+  spec.required_ruby_version = ">= 2.2.0"
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-macro
 version: !ruby/object:Gem::Version
-  version: 2.1.0.rc14
+  version: 2.1.4
 platform: ruby
 authors:
 - Nick Sutterer
 - Marc Tich
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-09-18 00:00:00.000000000 Z
+date: 2020-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -95,20 +95,60 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: trailblazer-activity
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.11.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.11.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: trailblazer-activity-dsl-linear
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: trailblazer-operation
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.2
+        version: 0.6.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.2
+        version: 0.6.5
 description: Macros for Trailblazer's operation
 email:
 - apotonick@gmail.com
@@ -152,7 +192,7 @@ homepage: http://trailblazer.to
 licenses:
 - LGPL-3.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -160,16 +200,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: 2.2.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.7.6
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
 summary: 'Macros for Trailblazer''s operation: Policy, Wrap, Rescue and more.'
 test_files: