subroutine 4.1.5 → 4.4.0

data/lib/subroutine/outputs.rb

@@ -10,11 +10,27 @@ module Subroutine
 
     extend ActiveSupport::Concern
 
+    class LazyExecutor
+      def initialize(value)
+        @value_block = value
+        @executed = false
+      end
+
+      def value
+        return @value if @executed
+        @value = @value_block.respond_to?(:call) ? @value_block.call : @value
+        @executed = true
+        @value
+      end
+
+      def executed?
+        @executed
+      end
+    end
+
     included do
       class_attribute :output_configurations
       self.output_configurations = {}
-
-      attr_reader :outputs
     end
 
     module ClassMethods
@@ -39,20 +55,42 @@ module Subroutine
       @outputs = {} # don't do with_indifferent_access because it will turn provided objects into with_indifferent_access objects, which may not be the desired behavior
     end
 
+    def outputs
+      unless @outputs_executed
+        @outputs.each_pair do |key, value|
+          @outputs[key] = value.is_a?(LazyExecutor) ? value.value : value
+        end
+        @outputs_executed = true
+      end
+
+      @outputs
+    end
+
     def output(name, value)
       name = name.to_sym
       unless output_configurations.key?(name)
         raise ::Subroutine::Outputs::UnknownOutputError, name
       end
 
-      outputs[name] = value
+      @outputs[name] = output_configurations[name].lazy? ? LazyExecutor.new(value) : value
     end
 
     def get_output(name)
       name = name.to_sym
       raise ::Subroutine::Outputs::UnknownOutputError, name unless output_configurations.key?(name)
 
-      outputs[name]
+      output = @outputs[name]
+      unless output.is_a?(LazyExecutor)
+        output
+      else
+        # if its not executed, validate the type
+        unless output.executed?
+          @outputs[name] = output.value
+          ensure_output_type_valid!(name)
+        end
+
+        @outputs[name]
+      end
     end
 
     def validate_outputs!
@@ -60,21 +98,27 @@ module Subroutine
         if config.required? && !output_provided?(name)
           raise ::Subroutine::Outputs::OutputNotSetError, name
         end
-        unless valid_output_type?(name)
-          name = name.to_sym
-          raise ::Subroutine::Outputs::InvalidOutputTypeError.new(
-            name: name,
-            actual_type: outputs[name].class,
-            expected_type: output_configurations[name][:type]
-          )
+        unless output_configurations[name].lazy?
+          ensure_output_type_valid!(name)
         end
       end
     end
 
+    def ensure_output_type_valid!(name)
+      return if valid_output_type?(name)
+
+      name = name.to_sym
+      raise ::Subroutine::Outputs::InvalidOutputTypeError.new(
+        name: name,
+        actual_type: @outputs[name].class,
+        expected_type: output_configurations[name][:type]
+      )
+    end
+
     def output_provided?(name)
       name = name.to_sym
 
-      outputs.key?(name)
+      @outputs.key?(name)
     end
 
     def valid_output_type?(name)
@@ -84,9 +128,9 @@ module Subroutine
 
       output_configuration = output_configurations[name]
       return true unless output_configuration[:type]
-      return true if !output_configuration.required? && outputs[name].nil?
+      return true if !output_configuration.required? && @outputs[name].nil?
 
-      outputs[name].is_a?(output_configuration[:type])
+      @outputs[name].is_a?(output_configuration[:type])
     end
   end
 end

data/lib/subroutine/version.rb

@@ -3,8 +3,8 @@
 module Subroutine
 
   MAJOR = 4
-  MINOR = 1
-  PATCH = 5
+  MINOR = 4
+  PATCH = 0
   PRE   = nil
 
   VERSION = [MAJOR, MINOR, PATCH, PRE].compact.join(".")

data/lib/subroutine.rb

@@ -16,6 +16,18 @@ require "subroutine/op"
 
 module Subroutine
 
+  # Used by polymorphic association fields to resolve the class name to a ruby class
+  def self.constantize_polymorphic_class_name(class_name)
+    return @constantize_polymorphic_class_name.call(class_name) if defined?(@constantize_polymorphic_class_name)
+
+    class_name.camelize.constantize
+  end
+
+  # When you need to customize how a polymorphic class name is resolved, you can set this callable/lambda/proc
+  def self.constantize_polymorphic_class_name=(callable)
+    @constantize_polymorphic_class_name = callable
+  end
+
   def self.include_defaults_in_params=(bool)
     @include_defaults_in_params = !!bool
   end

data/subroutine.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["mike@mnelson.io"]
   spec.summary       = "Feature-driven operation objects."
   spec.description   = "An interface for creating feature-driven operations."
-  spec.homepage      = "https://github.com/mnelson/subroutine"
+  spec.homepage      = "https://github.com/guideline-tech/subroutine"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0")
@@ -21,6 +21,10 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "activemodel", ">= 6.1"
   spec.add_dependency "activesupport", ">= 6.1"
+  spec.add_dependency "base64"
+  spec.add_dependency "bigdecimal"
+  spec.add_dependency "logger"
+  spec.add_dependency "mutex_m"
 
   spec.add_development_dependency "actionpack", ">= 6.1"
   spec.add_development_dependency "byebug"
@@ -29,4 +33,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "minitest-reporters"
   spec.add_development_dependency "mocha"
   spec.add_development_dependency "rake"
+
+  spec.required_ruby_version = ">= 3.2.0"
 end

data/test/subroutine/outputs_test.rb

@@ -10,6 +10,20 @@ module Subroutine
       end
     end
 
+    class LazyOutputOp < ::Subroutine::Op
+      outputs :foo, lazy: true
+      outputs :baz, lazy: true, type: String
+
+      def perform
+        output :foo, -> { call_me }
+        output :baz, -> { call_baz }
+      end
+
+      def call_me; end
+
+      def call_baz; end
+    end
+
     class MissingOutputSetOp < ::Subroutine::Op
       outputs :foo
       def perform
@@ -99,5 +113,50 @@ module Subroutine
         op.submit
       end
     end
+
+    ################
+    # lazy outputs #
+    ################
+
+    def test_it_does_not_call_lazy_output_values_if_not_accessed
+      op = LazyOutputOp.new
+      op.expects(:call_me).never
+      op.submit!
+    end
+
+    def test_it_calls_lazy_output_values_if_accessed
+      op = LazyOutputOp.new
+      op.expects(:call_me).once
+      op.submit!
+      op.foo
+    end
+
+    def test_it_validates_type_when_lazy_output_is_accessed
+      op = LazyOutputOp.new
+      op.expects(:call_baz).once.returns("a string")
+      op.submit!
+      assert_silent do
+        op.baz
+      end
+    end
+
+    def test_it_raises_error_on_invalid_type_when_lazy_output_is_accessed
+      op = LazyOutputOp.new
+      op.expects(:call_baz).once.returns(10)
+      op.submit!
+      error = assert_raises(Subroutine::Outputs::InvalidOutputTypeError) do
+        op.baz
+      end
+      assert_match(/Invalid output type for 'baz' expected String but got Integer/, error.message)
+    end
+
+    def test_it_returns_outputs
+      op = LazyOutputOp.new
+      op.expects(:call_me).once.returns(1)
+      op.expects(:call_baz).once.returns("a string")
+      op.submit!
+      assert_equal({ foo: 1, baz: "a string" }, op.outputs)
+    end
+
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: subroutine
 version: !ruby/object:Gem::Version
-  version: 4.1.5
+  version: 4.4.0
 platform: ruby
 authors:
 - Mike Nelson
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -38,6 +37,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mutex_m
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
@@ -164,6 +219,8 @@ files:
 - gemfiles/rails_7.1.gemfile.lock
 - gemfiles/rails_7.2.gemfile
 - gemfiles/rails_7.2.gemfile.lock
+- gemfiles/rails_8.0.gemfile
+- gemfiles/rails_8.0.gemfile.lock
 - lib/subroutine.rb
 - lib/subroutine/association_fields.rb
 - lib/subroutine/association_fields/association_type_mismatch_error.rb
@@ -193,11 +250,10 @@ files:
 - test/subroutine/type_caster_test.rb
 - test/support/ops.rb
 - test/test_helper.rb
-homepage: https://github.com/mnelson/subroutine
+homepage: https://github.com/guideline-tech/subroutine
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -205,15 +261,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Feature-driven operation objects.
 test_files:
@@ -225,6 +280,8 @@ test_files:
 - gemfiles/rails_7.1.gemfile.lock
 - gemfiles/rails_7.2.gemfile
 - gemfiles/rails_7.2.gemfile.lock
+- gemfiles/rails_8.0.gemfile
+- gemfiles/rails_8.0.gemfile.lock
 - test/subroutine/association_test.rb
 - test/subroutine/auth_test.rb
 - test/subroutine/base_test.rb