trailblazer-core-utils 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffd6f5ee742ac7a35fb76d3b3f32209733e28872106ed207dcc2ece528602803
-  data.tar.gz: 90f0ac4e6948d0d7f081d1feca960b1b5e70d43e12e07d21039cf824816d41f3
+  metadata.gz: '0786b99461164892b7ff976597820ffd9892f97b2f6aa11d2ada59e98b0b9856'
+  data.tar.gz: 39b60eef74d5a4af000aa24798908557392d49ec2155593753b112047be4bea1
 SHA512:
-  metadata.gz: 916540bc3af545bb78b6ff11ac2d1351410e4f41fcb646aa8c7da2656e7b0c80e172af7a92912be6901a009e0faa69f20da18f9161f4b0186cd852d9bb9382f8
-  data.tar.gz: 5aeff319bd9b266d93ae426e9553e2fc5cf2749dee7d65e2ed4cb8303ccea2bc31dbd461018b51a12ff86059bde27032f78c0f1cf7417e26672a33474721ac33
+  metadata.gz: 1c258c2fdeaa80ad702598b049af9c352821edb100f5e2506e107b93b79bc5b008d6aab28552b6640ea4e56b1f9b0ba3656d5ab911c8eda13482de6221f3583e
+  data.tar.gz: bd842eb0300aea0fd82c41aff9c62a76be0576add12aeabfcfdd95c487d3407ed4aeeadb9fc7ff01d6febb5d45a36ef6b6fc4fc7bf135e380d621f98d8dc34da

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [0.0.8]
+
+* Add `Core.def_steps` and `Core.def_tasks` to create test steps. This logic used to sit
+  in `trailblazer-activity`.
+
 ## [0.0.7]
 
 * In `convert_operation_test`, it is `result.terminus` now.

data/lib/trailblazer/core/utils/assertions.rb

@@ -0,0 +1,68 @@
+module Trailblazer
+  module Core::Utils
+     module Assertions
+      # `:seq` is always passed into ctx.
+      # @param :seq String What the {:seq} variable in the result ctx looks like. (expected seq)
+      # @param :expected_ctx_variables Variables that are added during the call by the asserted activity.
+      def assert_call(activity, terminus: :success, seq: "[]", expected_ctx_variables: {}, **ctx_variables)
+        # Call without taskWrap!
+        signal, (ctx, _) = activity.([{seq: [], **ctx_variables}, _flow_options = {}]) # simply call the activity with the input you want to assert.
+
+        assert_call_for(signal, ctx, terminus: terminus, seq: seq, **expected_ctx_variables, **ctx_variables)
+      end
+
+      # Use {TaskWrap.invoke} to call the activity.
+      def assert_invoke(activity, terminus: :success, seq: "[]", circuit_options: {}, flow_options: {}, expected_ctx_variables: {}, **ctx_variables)
+        signal, (ctx, returned_flow_options) = Activity::TaskWrap.invoke(
+          activity,
+          [
+            {seq: [], **ctx_variables},
+            flow_options,
+          ],
+          **circuit_options
+        )
+
+        assert_call_for(signal, ctx, terminus: terminus, seq: seq, **ctx_variables, **expected_ctx_variables) # DISCUSS: ordering of variables?
+
+        return signal, [ctx, returned_flow_options]
+      end
+
+      def assert_call_for(signal, ctx, terminus: :success, seq: "[]", **ctx_variables)
+        assert_equal signal.to_h[:semantic], terminus, "assert_call expected #{terminus} terminus, not #{signal}. Use assert_call(activity, terminus: #{signal.to_h[:semantic].inspect})"
+
+        assert_equal ctx.inspect, {seq: "%%%"}.merge(ctx_variables).inspect.sub('"%%%"', seq)
+
+        return ctx
+      end
+
+      # Tests {:circuit} and {:outputs} fields so far.
+      def assert_process_for(process, *args)
+        semantics, circuit = args[0..-2], args[-1]
+
+        assert_equal semantics.sort, process.to_h[:outputs].collect { |output| output[:semantic] }.sort
+
+        assert_circuit(process, circuit)
+
+        process
+      end
+
+      alias_method :assert_process, :assert_process_for
+
+      def assert_circuit(schema, circuit)
+        cct = Cct(schema)
+
+        cct = cct.gsub("#<Trailblazer::Activity::TaskBuilder::Task user_proc=", "<*")
+        assert_equal circuit.to_s, cct
+      end
+
+      def Cct(activity)
+        Activity::Introspect::Render.(activity, inspect_task: Assertions.method(:render_task))
+      end
+    end
+
+    # Use this in {#Cct}.
+    def self.render_task(proc)
+      Activity::Introspect.render_task(proc)
+    end
+  end
+end

data/lib/trailblazer/core/utils/def_steps.rb

@@ -0,0 +1,46 @@
+module Trailblazer
+  module Core::Utils
+    # Helpers to quickly create steps and tasks.
+    module DefSteps
+      # Creates a module with one step method for each name.
+      #
+      # @example
+      #   extend T.def_steps(:create, :save)
+      def self.def_steps(*names)
+        Module.new do
+          module_function
+
+          names.each do |name|
+            define_method(name) do |ctx, **|
+              ctx[:seq] << name
+              ctx.key?(name) ? ctx[name] : true
+            end
+          end
+        end
+      end
+
+      # Creates a method instance with a task interface.
+      #
+      # @example
+      #   task task: T.def_task(:create)
+      def self.def_task(name)
+        def_tasks(name).method(name)
+      end
+
+      def self.def_tasks(*names)
+        Module.new do
+          module_function
+
+          names.each do |name|
+            define_method(name) do |(ctx, flow_options), **|
+              ctx[:seq] << name
+              signal = ctx.key?(name) ? ctx[name] : Activity::Right
+
+              return signal, [ctx, flow_options]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/trailblazer/core/utils/version.rb

@@ -1,7 +1,7 @@
 module Trailblazer
   module Core
     module Utils
-      VERSION = "0.0.7"
+      VERSION = "0.0.8"
     end
   end
 end

data/lib/trailblazer/core.rb

@@ -3,6 +3,8 @@ require "trailblazer/core/utils/convert_operation_test"
 require "trailblazer/core/utils/symbol_inspect_for"
 require "trailblazer/core/utils/inspect"
 require "trailblazer/core/utils/strip"
+require "trailblazer/core/utils/def_steps"
+require "trailblazer/core/utils/assertions"
 
 module Trailblazer
   module Core
@@ -14,6 +16,8 @@ module Trailblazer
       extend Forwardable
       def_delegator Utils::ConvertOperationTest, :call, :convert_operation_test
       def_delegator Utils, :symbol_inspect_for
+      def_delegator Utils::DefSteps, :def_steps
+      def_delegator Utils::DefSteps, :def_tasks
     end
   end
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer-core-utils
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-03-27 00:00:00.000000000 Z
-dependencies: []
+date: 2025-07-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: trailblazer-activity-dsl-linear
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - apotonick@gmail.com
@@ -23,7 +37,9 @@ files:
 - Rakefile
 - lib/trailblazer/core.rb
 - lib/trailblazer/core/utils.rb
+- lib/trailblazer/core/utils/assertions.rb
 - lib/trailblazer/core/utils/convert_operation_test.rb
+- lib/trailblazer/core/utils/def_steps.rb
 - lib/trailblazer/core/utils/inspect.rb
 - lib/trailblazer/core/utils/strip.rb
 - lib/trailblazer/core/utils/symbol_inspect_for.rb
@@ -48,7 +64,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Utilities for Trailblazer core developers.