servactory 1.6.13 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fb456eae63f08b03712474124ad24d2af28d8cf34501dcc442ff489d94152c0
-  data.tar.gz: 250cc4f9058345bfe888034c163aa49720cb5e469fe7956093defce979f85c9b
+  metadata.gz: ff122141adf96c61aac5e2c89b9ca1ea0644ec4a9e106737e114108adbf06e17
+  data.tar.gz: 04d8ab68d2ce909e7b2ab9b92e3c4cd0c356385b87fd6f1b17040d16b22f9c43
 SHA512:
-  metadata.gz: d8a3b0c171df80b8eab5941f7c6fdfd01a032689aab2b45ca91f4f6a1ef199f12e0cd998cf8a92380f1bceb76577c5d5ebe746ed1afa5ecd4c96c7c3815e39b9
-  data.tar.gz: b2a0eefa30dfc7841a425bb9b7f3405bbbea0d93c1a2d9e0e6d6306eba376ab452becff2f7fe511f775593ea6679f0b24f442eb2353934ee3444868e5654fe37
+  metadata.gz: 3eea6b5733b7a80ceeac63a5fd9e16492367da3d3bd3ffbbdda343791578a788388eb1b77873595fc710d7ca0a62985a971d2e1ba02d1048b35dede880ce63e6
+  data.tar.gz: 35a1dee0a933768875c583678019c6f62cecc4b05fe7ffaf000edd3a01596a6dba18fa0111cce3b876013994e492b91e05062e7690a01ebfdd9b3f415325e3b6

data/README.md

@@ -24,7 +24,7 @@ class UserService::Authenticate < ApplicationService::Base
 
   def call
     if (user = User.find_by(email: inputs.email)&.authenticate(inputs.password))
-      self.user = user
+      outputs.user = user
     else
       fail!(message: "Authentication failed")
     end

data/lib/servactory/base.rb

@@ -3,6 +3,7 @@
 module Servactory
   class Base
     include Configuration::DSL
+    include Info::DSL
     include Context::DSL
     include Inputs::DSL
     include Internals::DSL

data/lib/servactory/configuration/setup.rb

@@ -27,7 +27,6 @@ module Servactory
       def default_input_option_helpers
         Set[
           Servactory::Inputs::OptionHelper.new(name: :optional, equivalent: { required: false }),
-          Servactory::Inputs::OptionHelper.new(name: :internal, equivalent: { internal: true }),
           Servactory::Inputs::OptionHelper.new(name: :as_array, equivalent: { array: true })
         ]
       end

data/lib/servactory/context/callable.rb

@@ -16,8 +16,6 @@ module Servactory
           collection_of_internals: collection_of_internals
         )
 
-        prepare_data
-
         inputs_workbench.validate!
 
         methods_workbench.run!
@@ -43,8 +41,6 @@ module Servactory
           collection_of_internals: collection_of_internals
         )
 
-        prepare_data
-
         inputs_workbench.validate!
 
         methods_workbench.run!
@@ -69,12 +65,6 @@ module Servactory
         outputs_workbench.assign(context: context_store.context)
         methods_workbench.assign(context: context_store.context)
       end
-
-      def prepare_data
-        inputs_workbench.prepare      # 1
-        outputs_workbench.prepare     # 2
-        internals_workbench.prepare   # 3
-      end
     end
   end
 end

data/lib/servactory/context/workspace/inputs.rb

@@ -3,9 +3,46 @@
 module Servactory
   module Context
     module Workspace
+      # class Inputs
+      #   def initialize(**)
+      #     # NOTE: Look at the file `lib/servactory/inputs/tools/prepare.rb`
+      #   end
+      # end
+
       class Inputs
-        def initialize(**)
-          # NOTE: Look at the file `lib/servactory/inputs/tools/prepare.rb`
+        def initialize(context, workbench:)
+          @context = context
+
+          @collection_of_inputs = workbench.collection
+          @incoming_arguments = workbench.incoming_arguments
+        end
+
+        def method_missing(name, *args, &block)
+          if name.to_s.end_with?("=")
+            super
+          else
+            getter_with(name: name) { super }
+          end
+        end
+
+        def respond_to_missing?(name, *)
+          @collection_of_inputs.names.include?(name) || super
+        end
+
+        private
+
+        def getter_with(name:, &block) # rubocop:disable Lint/UnusedMethodArgument
+          input = @collection_of_inputs.find_by(name: name)
+
+          return yield if input.nil?
+
+          input_value = @incoming_arguments.fetch(input.name, nil)
+          input_value = input.default if input.optional? && input_value.blank?
+
+          input_prepare = input.prepare.fetch(:in, nil)
+          input_value = input_prepare.call(value: input_value) if input_prepare.present?
+
+          input_value
         end
       end
     end

data/lib/servactory/context/workspace/internals.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Context
+    module Workspace
+      class Internals
+        def initialize(context, workbench:)
+          @context = context
+          @collection_of_internals = workbench.collection
+        end
+
+        def method_missing(name, *args, &block)
+          if name.to_s.end_with?("=")
+            setter_with(name: name, value: args.pop) { super }
+          else
+            getter_with(name: name) { super }
+          end
+        end
+
+        def respond_to_missing?(name, *)
+          @collection_of_internals.names.include?(name) || super
+        end
+
+        private
+
+        def setter_with(name:, value:, &block) # rubocop:disable Lint/UnusedMethodArgument
+          prepared_name = name.to_s.delete("=").to_sym
+
+          return yield unless @collection_of_internals.names.include?(prepared_name)
+
+          internal = @collection_of_internals.find_by(name: prepared_name)
+
+          Servactory::Internals::Validations::Type.validate!(
+            context: @context,
+            internal: internal,
+            value: value
+          )
+
+          @context.instance_variable_set(:"@#{internal.name}", value)
+        end
+
+        def getter_with(name:, &block) # rubocop:disable Lint/UnusedMethodArgument
+          internal = @collection_of_internals.find_by(name: name)
+
+          return yield if internal.nil?
+
+          @context.instance_variable_get(:"@#{internal.name}")
+        end
+      end
+    end
+  end
+end

data/lib/servactory/context/workspace/outputs.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Context
+    module Workspace
+      class Outputs
+        def initialize(context, workbench:)
+          @context = context
+          @collection_of_outputs = workbench.collection
+        end
+
+        def method_missing(name, *args, &block)
+          if name.to_s.end_with?("=")
+            setter_with(name: name, value: args.pop) { super }
+          else
+            getter_with(name: name) { super }
+          end
+        end
+
+        def respond_to_missing?(name, *)
+          @collection_of_outputs.names.include?(name) || super
+        end
+
+        private
+
+        def setter_with(name:, value:, &block) # rubocop:disable Lint/UnusedMethodArgument
+          prepared_name = name.to_s.delete("=").to_sym
+
+          return yield unless @collection_of_outputs.names.include?(prepared_name)
+
+          output = @collection_of_outputs.find_by(name: prepared_name)
+
+          Servactory::Outputs::Validations::Type.validate!(
+            context: @context,
+            output: output,
+            value: value
+          )
+
+          @context.instance_variable_set(:"@#{output.name}", value)
+        end
+
+        def getter_with(name:, &block) # rubocop:disable Lint/UnusedMethodArgument
+          output = @collection_of_outputs.find_by(name: name)
+
+          return yield if output.nil?
+
+          @context.instance_variable_get(:"@#{output.name}")
+        end
+      end
+    end
+  end
+end

data/lib/servactory/context/workspace.rb

@@ -3,12 +3,23 @@
 module Servactory
   module Context
     module Workspace
-      def errors
-        @errors ||= Servactory::Errors::Collection.new
+      def inputs
+        @inputs ||= Inputs.new(self, workbench: self.class.send(:inputs_workbench))
       end
+      alias inp inputs
 
-      def assign_inputs(inputs)
-        @inputs = inputs
+      def internals
+        @internals ||= Internals.new(self, workbench: self.class.send(:internals_workbench))
+      end
+      alias int internals
+
+      def outputs
+        @outputs ||= Outputs.new(self, workbench: self.class.send(:outputs_workbench))
+      end
+      alias out outputs
+
+      def errors
+        @errors ||= Servactory::Errors::Collection.new
       end
 
       def raise_first_fail
@@ -19,8 +30,6 @@ module Servactory
 
       protected
 
-      attr_reader :inputs
-
       def fail_input!(input_name, message:)
         raise Servactory.configuration.input_error_class.new(
           input_name: input_name,

data/lib/servactory/info/dsl.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Info
+    module DSL
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        def info
+          Servactory::Info::Result.new(
+            inputs: collection_of_inputs.names,
+            internals: collection_of_internals.names,
+            outputs: collection_of_outputs.names
+          )
+        end
+      end
+    end
+  end
+end

data/lib/servactory/info/result.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Servactory
+  module Info
+    class Result
+      attr_reader :inputs,
+                  :internals,
+                  :outputs
+
+      def initialize(inputs:, internals:, outputs:)
+        @inputs = inputs
+        @internals = internals
+        @outputs = outputs
+      end
+    end
+  end
+end

data/lib/servactory/inputs/collection.rb

@@ -5,7 +5,7 @@ module Servactory
     class Collection
       # NOTE: http://words.steveklabnik.com/beware-subclassing-ruby-core-classes
       extend Forwardable
-      def_delegators :@collection, :<<, :each, :map, :merge
+      def_delegators :@collection, :<<, :each, :map, :merge, :find
 
       def initialize(*)
         @collection = Set.new
@@ -14,6 +14,10 @@ module Servactory
       def names
         map(&:name)
       end
+
+      def find_by(name:)
+        find { |input| input.internal_name == name }
+      end
     end
   end
 end

data/lib/servactory/inputs/workbench.rb

@@ -3,12 +3,15 @@
 module Servactory
   module Inputs
     class Workbench
+      attr_reader :collection,
+                  :incoming_arguments
+
       def self.work_with(...)
         new(...)
       end
 
-      def initialize(collection_of_inputs)
-        @collection_of_inputs = collection_of_inputs
+      def initialize(collection)
+        @collection = collection
       end
 
       def assign(context:, arguments:)
@@ -17,25 +20,20 @@ module Servactory
       end
 
       def find_unnecessary!
-        Tools::FindUnnecessary.validate!(context, @incoming_arguments, collection_of_inputs)
+        Tools::FindUnnecessary.validate!(context, @incoming_arguments, collection)
       end
 
       def check_rules!
-        Tools::Rules.validate!(context, collection_of_inputs)
-      end
-
-      def prepare
-        Tools::Prepare.prepare(context, @incoming_arguments, collection_of_inputs)
+        Tools::Rules.validate!(context, collection)
       end
 
       def validate!
-        Tools::Validation.validate!(context, @incoming_arguments, collection_of_inputs)
+        Tools::Validation.validate!(context, @incoming_arguments, collection)
       end
 
       private
 
-      attr_reader :context,
-                  :collection_of_inputs
+      attr_reader :context
     end
   end
 end

data/lib/servactory/internals/collection.rb

@@ -5,7 +5,7 @@ module Servactory
     class Collection
       # NOTE: http://words.steveklabnik.com/beware-subclassing-ruby-core-classes
       extend Forwardable
-      def_delegators :@collection, :<<, :each, :map, :merge
+      def_delegators :@collection, :<<, :each, :map, :merge, :find
 
       def initialize(*)
         @collection = Set.new
@@ -14,6 +14,10 @@ module Servactory
       def names
         map(&:name)
       end
+
+      def find_by(name:)
+        find { |internal| internal.name == name }
+      end
     end
   end
 end

data/lib/servactory/internals/workbench.rb

@@ -3,26 +3,23 @@
 module Servactory
   module Internals
     class Workbench
+      attr_reader :collection
+
       def self.work_with(...)
         new(...)
       end
 
-      def initialize(collection_of_internals)
-        @collection_of_internals = collection_of_internals
+      def initialize(collection)
+        @collection = collection
       end
 
       def assign(context:)
         @context = context
       end
 
-      def prepare
-        Tools::Prepare.prepare(context, collection_of_internals)
-      end
-
       private
 
-      attr_reader :context,
-                  :collection_of_internals
+      attr_reader :context
     end
   end
 end

data/lib/servactory/outputs/collection.rb

@@ -5,7 +5,7 @@ module Servactory
     class Collection
       # NOTE: http://words.steveklabnik.com/beware-subclassing-ruby-core-classes
       extend Forwardable
-      def_delegators :@collection, :<<, :each, :map, :merge
+      def_delegators :@collection, :<<, :each, :map, :merge, :find
 
       def initialize(*)
         @collection = Set.new
@@ -14,6 +14,10 @@ module Servactory
       def names
         map(&:name)
       end
+
+      def find_by(name:)
+        find { |output| output.name == name }
+      end
     end
   end
 end

data/lib/servactory/outputs/workbench.rb

@@ -3,12 +3,14 @@
 module Servactory
   module Outputs
     class Workbench
+      attr_reader :collection
+
       def self.work_with(...)
         new(...)
       end
 
-      def initialize(collection_of_outputs)
-        @collection_of_outputs = collection_of_outputs
+      def initialize(collection)
+        @collection = collection
       end
 
       def assign(context:)
@@ -16,16 +18,12 @@ module Servactory
       end
 
       def find_conflicts_in!(collection_of_internals:)
-        Tools::Conflicts.validate!(context, collection_of_outputs, collection_of_internals)
-      end
-
-      def prepare
-        Tools::Prepare.prepare(context, collection_of_outputs)
+        Tools::Conflicts.validate!(context, collection, collection_of_internals)
       end
 
       private
 
-      attr_reader :context, :collection_of_outputs
+      attr_reader :context
     end
   end
 end

data/lib/servactory/{test → test_kit}/fake_type.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Servactory
-  module Test
+  module TestKit
     class FakeType; end
   end
 end

data/lib/servactory/{test → test_kit}/result.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Servactory
-  module Test
+  module TestKit
     class Result
       def initialize(**attributes)
         attributes.each_pair do |method_name, method_return|

data/lib/servactory/version.rb

@@ -3,8 +3,8 @@
 module Servactory
   module VERSION
     MAJOR = 1
-    MINOR = 6
-    PATCH = 13
+    MINOR = 7
+    PATCH = 0
 
     STRING = [MAJOR, MINOR, PATCH].join(".")
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: servactory
 version: !ruby/object:Gem::Version
-  version: 1.6.13
+  version: 1.7.0
 platform: ruby
 authors:
 - Anton Sokolov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-14 00:00:00.000000000 Z
+date: 2023-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -198,6 +198,8 @@ files:
 - lib/servactory/context/store.rb
 - lib/servactory/context/workspace.rb
 - lib/servactory/context/workspace/inputs.rb
+- lib/servactory/context/workspace/internals.rb
+- lib/servactory/context/workspace/outputs.rb
 - lib/servactory/engine.rb
 - lib/servactory/errors/base.rb
 - lib/servactory/errors/collection.rb
@@ -205,6 +207,8 @@ files:
 - lib/servactory/errors/input_error.rb
 - lib/servactory/errors/internal_error.rb
 - lib/servactory/errors/output_error.rb
+- lib/servactory/info/dsl.rb
+- lib/servactory/info/result.rb
 - lib/servactory/inputs/collection.rb
 - lib/servactory/inputs/define_input_conflict.rb
 - lib/servactory/inputs/define_input_method.rb
@@ -216,7 +220,6 @@ files:
 - lib/servactory/inputs/options_collection.rb
 - lib/servactory/inputs/tools/check_errors.rb
 - lib/servactory/inputs/tools/find_unnecessary.rb
-- lib/servactory/inputs/tools/prepare.rb
 - lib/servactory/inputs/tools/rules.rb
 - lib/servactory/inputs/tools/validation.rb
 - lib/servactory/inputs/validations/base.rb
@@ -229,7 +232,6 @@ files:
 - lib/servactory/internals/collection.rb
 - lib/servactory/internals/dsl.rb
 - lib/servactory/internals/internal.rb
-- lib/servactory/internals/tools/prepare.rb
 - lib/servactory/internals/validations/base.rb
 - lib/servactory/internals/validations/type.rb
 - lib/servactory/internals/workbench.rb
@@ -244,13 +246,12 @@ files:
 - lib/servactory/outputs/dsl.rb
 - lib/servactory/outputs/output.rb
 - lib/servactory/outputs/tools/conflicts.rb
-- lib/servactory/outputs/tools/prepare.rb
 - lib/servactory/outputs/validations/base.rb
 - lib/servactory/outputs/validations/type.rb
 - lib/servactory/outputs/workbench.rb
 - lib/servactory/result.rb
-- lib/servactory/test/fake_type.rb
-- lib/servactory/test/result.rb
+- lib/servactory/test_kit/fake_type.rb
+- lib/servactory/test_kit/result.rb
 - lib/servactory/utils.rb
 - lib/servactory/version.rb
 homepage: https://github.com/afuno/servactory

data/lib/servactory/inputs/tools/prepare.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Inputs
-    module Tools
-      class Prepare
-        def self.prepare(...)
-          new(...).prepare
-        end
-
-        def initialize(context, incoming_arguments, collection_of_inputs)
-          @context = context
-          @incoming_arguments = incoming_arguments
-          @collection_of_inputs = collection_of_inputs
-        end
-
-        def prepare
-          @inputs_variables = {}
-          @internal_variables = {}
-
-          @collection_of_inputs.each do |input|
-            process_input(input)
-          end
-
-          create_instance_variables
-        end
-
-        private
-
-        def process_input(input)
-          input_value = @incoming_arguments.fetch(input.name, nil)
-          input_value = input.default if input.optional? && input_value.blank?
-
-          input_prepare = input.prepare.fetch(:in, nil)
-          input_value = input_prepare.call(value: input_value) if input_prepare.present?
-
-          if input.internal?
-            @internal_variables[input.name] = input_value
-          else
-            @inputs_variables[input.internal_name] = input_value
-          end
-        end
-
-        def create_instance_variables
-          inputs_class = Servactory::Context::Workspace::Inputs.dup
-          inputs_class.class_eval(class_inputs_template) if class_inputs_template.present?
-
-          @context.assign_inputs(inputs_class.new(**@inputs_variables))
-
-          @context.class.class_eval(context_internal_variables_template) if context_internal_variables_template.present?
-
-          @internal_variables.each do |input_name, input_value|
-            @context.instance_variable_set(:"@#{input_name}", input_value)
-          end
-        end
-
-        ########################################################################
-
-        # EXAMPLE:
-        #
-        #   attr_reader(*[:attr_1, :attr_2, :attr_3])
-        #
-        #   def initialize(attr_1:, attr_2:, attr_3:)
-        #     @attr_1 = attr_1; @attr_2 = attr_2; @attr_3 = attr_3;
-        #   end
-        #
-        def class_inputs_template
-          return if @inputs_variables.blank?
-
-          @class_inputs_template ||= <<-RUBY
-            attr_reader(*#{@inputs_variables.keys})
-
-            def initialize(#{@inputs_variables.keys.join(':, ')}:)
-              #{@inputs_variables.keys.map { |key| "@#{key} = #{key}" }.join('; ')}
-            end
-          RUBY
-        end
-
-        # EXAMPLE:
-        #
-        #   attr_reader(*[:attr_1])
-        #
-        def context_internal_variables_template
-          return if @internal_variables.blank?
-
-          @context_internal_variables_template ||= <<-RUBY
-            attr_reader(*#{@internal_variables.keys})
-          RUBY
-        end
-      end
-    end
-  end
-end

data/lib/servactory/internals/tools/prepare.rb

@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Internals
-    module Tools
-      class Prepare
-        def self.prepare(...)
-          new(...).prepare
-        end
-
-        def initialize(context, collection_of_internals)
-          @context = context
-          @collection_of_internals = collection_of_internals
-        end
-
-        def prepare
-          @collection_of_internals.each do |internal|
-            create_instance_variable_for(internal)
-          end
-        end
-
-        private
-
-        def create_instance_variable_for(internal)
-          @context.class.class_eval(context_internal_template_for(internal))
-        end
-
-        # EXAMPLE:
-        #
-        #   define_method(:user=) do |value|
-        #     Servactory::Internals::Validations::Type.validate!( context: self, internal:, value: )
-        #
-        #     instance_variable_set(:@user, value)
-        #   end
-        #
-        #   private attr_reader :user
-        #
-        def context_internal_template_for(internal)
-          <<-RUBY
-            define_method(:#{internal.name}=) do |value|
-              Servactory::Internals::Validations::Type.validate!(
-                context: self,
-                internal: internal,
-                value: value
-              )
-
-              instance_variable_set(:@#{internal.name}, value)
-            end
-
-            private
-
-            attr_reader :#{internal.name}
-          RUBY
-        end
-      end
-    end
-  end
-end

data/lib/servactory/outputs/tools/prepare.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-module Servactory
-  module Outputs
-    module Tools
-      class Prepare
-        def self.prepare(...)
-          new(...).prepare
-        end
-
-        def initialize(context, collection_of_outputs)
-          @context = context
-          @collection_of_outputs = collection_of_outputs
-        end
-
-        def prepare
-          @collection_of_outputs.each do |output|
-            create_instance_variable_for(output)
-          end
-        end
-
-        private
-
-        def create_instance_variable_for(output)
-          @context.class.class_eval(context_output_template_for(output))
-        end
-
-        # EXAMPLE:
-        #
-        #   define_method(:user=) do |value|
-        #     Servactory::Internals::Validations::Type.validate!( context: self, output:, value: )
-        #
-        #     instance_variable_set(:@user, value)
-        #   end
-        #
-        def context_output_template_for(output)
-          <<-RUBY
-            define_method(:#{output.name}=) do |value|
-              Servactory::Outputs::Validations::Type.validate!(
-                context: self,
-                output: output,
-                value: value
-              )
-
-              instance_variable_set(:@#{output.name}, value)
-            end
-
-            attr_reader :#{output.name}
-          RUBY
-        end
-      end
-    end
-  end
-end