convenient_service 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ec5188e0830cb8a97b589ff6985d4aa1e361bce486dba86a1a1f697924d0be7
-  data.tar.gz: ab763a1c604849509f5557938768bf019b5d962dd5d6fa62771b17e3c524025d
+  metadata.gz: d53f96dab5d2b97b26168f4859dc0daefe41c8768e83e607d13234c2c7d77101
+  data.tar.gz: c6d5a9d30e5c3c768f556eb7d84b558099fcbeb96dbff655b7bd2b553435a26a
 SHA512:
-  metadata.gz: 32cf7296bf8a5ff16d7bfed6c20a855831e27b0300edede75ba7c737f357ed6ddf462641d7cacc9c5f7a65c64c3a4e59b04a60cee0ad9793f173fca7e9c0ad24
-  data.tar.gz: 71aadf20b54f0f507eb6721999b2192630eb2265d660d40ecc461de311fb930376883d1546c9c030c03f15e90e0c02e172066adc2213cb61140cc3f8b45b5137
+  metadata.gz: 9f3fb867003d44c6786446fdb2baac4550bd6ac8f34ee9196ee310912c4eb2084f40dc731dce8a2af7ac8a963d6a3579c6e886ad28251c4bf5a9a08ca290a6d2
+  data.tar.gz: e24704e463ac31d3f65a4c9a5777617157bdebb62ab785e92f3f18125d8968e5c3a6d44368553c706c9f8bab0ce7bd8f938ce53ebc1df68585493738533ef2cb

data/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## [0.8.0](https://github.com/marian13/convenient_service/compare/v0.7.0...v0.8.0) (2023-02-20)
+
+
+### Features
+
+* **aliases:** expose middlewares ([aacb6fd](https://github.com/marian13/convenient_service/commit/aacb6fda4c63e1d82e33c523885bd61397cfb583))
+* **configs:** introduce Minimal config ([70b0ca8](https://github.com/marian13/convenient_service/commit/70b0ca82679fc89099aee733d91807e371bbed39))
+* **rescues_result_unhandled_exceptions:** introduce rescues_result_unhandled_exceptions ([fd0b444](https://github.com/marian13/convenient_service/commit/fd0b4447e5abf81d971cd93a8333a89b363ef1ff))
+* **rescues_result_unhandled_exceptions:** return original exception in data + formatted exception as message ([45bc55e](https://github.com/marian13/convenient_service/commit/45bc55ec245df1b95769be761337a3cb2558a878))
+* **undefined:** introduce undefined ([2f93bdc](https://github.com/marian13/convenient_service/commit/2f93bdc86d81c9a819bbc1c4a76a0ef291a59b17))
+* **wrap_method:** introduce WrappedMethod#chain_exception ([1db33af](https://github.com/marian13/convenient_service/commit/1db33afc3a0e0713700b0bf5385900085af0a2df))
+
+
+### Bug Fixes
+
+* **wrapped_method:** define chain value even if chain.next raises an exception ([8c4cf95](https://github.com/marian13/convenient_service/commit/8c4cf9534a07e9614fdc73f0d0c019f9c3f0ea54))
+* **wrapped_method:** reraise rescued exception ([31f7ab6](https://github.com/marian13/convenient_service/commit/31f7ab6df0b34980656942992d3ecf7a67461d06))
+
+## [0.7.0](https://github.com/marian13/convenient_service/compare/v0.6.0...v0.7.0) (2023-02-13)
+
+
+### ⚠ BREAKING CHANGES
+
+* **be_result:** introduce #of_step, #of_service, remove #of
+* **has_result:** use callbacks before result
+
+### Features
+
+* **be_result:** introduce #of_step, #of_service, remove #of ([0d9ba16](https://github.com/marian13/convenient_service/commit/0d9ba16f035ef50268fdf484b0fd83c58dbb328a))
+* **be_result:** of_step supports method steps ([9127301](https://github.com/marian13/convenient_service/commit/9127301f41549fbb8c48b718e410ebd7c100e2e9))
+* **can_have_parent_Result:** introduce CanHaveParentResult plugin ([55f0b0f](https://github.com/marian13/convenient_service/commit/55f0b0f558e2edb8b0fdc56a2d8b52bc44995a2f))
+* **command:** expose command ([6abcb1a](https://github.com/marian13/convenient_service/commit/6abcb1ad481cad66eba2d4d409e3ce16b0f6591d))
+* **configs:** add around callbacks for steps ([cb9d342](https://github.com/marian13/convenient_service/commit/cb9d34204d63a96e89ebebe2991e8ab77b2624f0))
+* **has_around_callbacks:** pass arguments to around callbacks ([f682f9a](https://github.com/marian13/convenient_service/commit/f682f9a6fb3ef6e8ab50ccf0f7f3ba375a63092e))
+* **has_callbacks:** pass arguments to callbacks ([2d7f720](https://github.com/marian13/convenient_service/commit/2d7f720e37a15874ec89167e46fb67a0631ec923))
+* **has_jsend_status_and_attributes:** introduce Data#to_s ([c1e20c0](https://github.com/marian13/convenient_service/commit/c1e20c093ec4575a939645a2d951fe4e035154b8))
+* **has_result_steps:** add callback trigger for step ([475d46a](https://github.com/marian13/convenient_service/commit/475d46a5abaf6fa85260cef90d78db60146b86d9))
+* **has_result_steps:** introduce Step#original_result ([8891247](https://github.com/marian13/convenient_service/commit/8891247e5f0339d9e96e733d05b29e45a2e87e71))
+* **has_step:** introduce HasStep plugin ([e6eee96](https://github.com/marian13/convenient_service/commit/e6eee965c8707b7378173f228b9b212834be434b))
+* **not_passed:** add better #inspect ([d7ce5d9](https://github.com/marian13/convenient_service/commit/d7ce5d93a3aa5f139f6b7ee578975c1da52488c0))
+
+
+### Bug Fixes
+
+* **be_descendant_of:** fix typo ([58e0f73](https://github.com/marian13/convenient_service/commit/58e0f73f74685614d24e0ee3c8208a5626f7ef42))
+* **be_direct_descendant_of:** fix typo ([bda7d06](https://github.com/marian13/convenient_service/commit/bda7d063d1801309a58b5e4d43d738ebab5fef59))
+* **ci:** change the version of yard ([185c23c](https://github.com/marian13/convenient_service/commit/185c23c40dacf997e29d0b7defd10020c22dc196))
+* **copyable:** do not mutate input params ([0809592](https://github.com/marian13/convenient_service/commit/08095927ea03c60a00eb3b0d0323458b482827b0))
+* **dependency_container:** fix typo ([b1cf420](https://github.com/marian13/convenient_service/commit/b1cf420a2e69cc51e928a8a1ad885a65ad7fb4fe))
+* **has_result_steps:** use unsafe attributes in to_kwargs ([6c2b1d3](https://github.com/marian13/convenient_service/commit/6c2b1d3912106f6848b875d06a4d7ce1d79c4edb))
+* **has_result_steps:** use unsafe_data ([e00c346](https://github.com/marian13/convenient_service/commit/e00c3468f5761e20678c7019f0d13f2569778b19))
+* **has_result:** use callbacks before result ([eb46444](https://github.com/marian13/convenient_service/commit/eb46444536a7cf4aab869aa009c1a7c896c00c11))
+
+
+### Miscellaneous Chores
+
+* release 0.7.0 ([6433f5a](https://github.com/marian13/convenient_service/commit/6433f5a67c3f21c620d500186e0308fb7b098efc))
+
 ## [0.6.0](https://github.com/marian13/convenient_service/compare/v0.5.0...v0.6.0) (2023-01-22)
 
 

data/ROADMAP.md

@@ -32,7 +32,7 @@
 | High | 🚧 | Optimize `stack.dup` in `MethodMiddlewares#call` | Core v3 |
 | Medium | 🚧 | Make a decision of what to do with `printable_block` in custom RSpec matchers | |
 | Medium | 🚧 | User-friendly exception messages | |
-| High | 🚧 | Factories for POROs in specs ❗❗❗ | Start with `result_class`, `class self::Result`, `service_class`, `step_class`, `organizer_class` |
+| High | 🚧 | Factory for POROs in specs ❗❗❗ | Start with `result_class`, `class self::Result`, `service_class`, `step_class`, `organizer_class` |
 | High | 🚧 | Resolve warning during specs | |
 | Medium | 🚧 | Consider to change/rewrite `delegate` backend to minify its interface | |
 | Medium | 🚧 | Same order of attr macros, delegators, initialize, class methods, attr methods, queries, actions, `to_*`, comparison, inspect | |
@@ -64,5 +64,18 @@
 | Medium | 🚧 | Add `shoulda-context` to test conditionals when `RSpec` is not loaded | [shoulda-context](https://github.com/thoughtbot/shoulda-context) |
 | High | 🚧 | Abstract factory for `CastMethod` | |
 | Medium | 🚧 | `delegate_to` - option to specify of how to compare blocks | |
+| High | 🚧 | Add specs for [Reassignment::Commands::DefineMethodInContainer](https://github.com/marian13/convenient_service/blob/v0.6.0/lib/convenient_service/service/plugins/has_result_steps/entities/method/entities/callers/reassignment/commands/define_method_in_container.rb#L13) | |
+| High | 🚧 | Example for dependency containers | |
+| Low | 🚧 | `delegate_to.and_return_value` | |
+| Medium | 🚧 | Support two Cache implementations, array-based and hash-based | |
+| Low | 🚧 | `delegate_to_service` | |
+| High | 🚧 | Intentionally disable plugins to document dependencies | |
+| Low | 🚧 | `.and_return_value_should be_instance_of(expected)` | |
+| Low | 🚧 | `ConvenientService::Config.delegate_to_diff_argorithm = :diffy` | |
+| Low | 🚧 | Rubocop cop that complains when a service name does NOT start with a verb | |
+| Low | 🚧 | Generator to create a spec default structure | |
+| Low | 🚧 | Rubocop cop that complains when a service does NOT have its own suite of specs | |
+| High | 🚧 | Add specs for `WrappedMethod#call` | |
+| High | 🚧 | Check whether ignoring error was used properly | |
 
 Search for `TODO`s in the codebase for more tasks.

data/convenient_service.gemspec

@@ -33,6 +33,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "awesome_print"
   spec.add_development_dependency "byebug", "~> 10.0"
   spec.add_development_dependency "commonmarker"
+  spec.add_development_dependency "faker"
   spec.add_development_dependency "gem-release"
   spec.add_development_dependency "inch"
   spec.add_development_dependency "json"
@@ -49,6 +50,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "simplecov"
   spec.add_development_dependency "simplecov-lcov"
   spec.add_development_dependency "webrick"
-  spec.add_development_dependency "yard"
+  spec.add_development_dependency "yard", "~> 0.9.28"
   spec.add_development_dependency "yard-junk"
 end

data/lib/convenient_service/aliases.rb

@@ -1,6 +1,16 @@
 # frozen_string_literal: true
 
+##
+# @internal
+#   NOTE: Aliases hide the full constants path from the end-users in order to increase DX.
+#   - https://en.wikipedia.org/wiki/User_experience#Developer_experience
+#
 module ConvenientService
+  Command = ::ConvenientService::Support::Command
   Concern = ::ConvenientService::Support::Concern
   DependencyContainer = ::ConvenientService::Support::DependencyContainer
+
+  ClassicMiddleware = ::ConvenientService::Core::Entities::ClassicMiddleware
+  ConcernMiddleware = ::ConvenientService::Core::Entities::Config::Entities::Concerns::Entities::Middleware
+  MethodChainMiddleware = ::ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware
 end

data/lib/convenient_service/common/plugins/has_around_callbacks/middleware.rb

@@ -5,7 +5,11 @@ module ConvenientService
     module Plugins
       module HasAroundCallbacks
         class Middleware < Core::MethodChainMiddleware
-          def next(...)
+          include Support::DependencyContainer::Import
+
+          import :"entities.Callback", from: Common::Plugins::HasCallbacks::Container
+
+          def next(*args, **kwargs, &block)
             ##
             # A variable that stores return value of middleware `chain.next` aka `original_value`.
             # It is reassigned later by the `initial_around_callback`.
@@ -15,14 +19,30 @@ module ConvenientService
             ##
             # A list of around callbacks.
             #
+            # class Service
+            #   around do |chain|
+            #     # part before `chain.yield`
+            #     original_value = chain.yield
+            #     # part after `chain.yield`
+            #   end
+            # end
+            #
+            # class Service
+            #   around do |chain, arguments|
+            #     # part before `chain.yield`
+            #     original_value = chain.yield
+            #     # part after `chain.yield`
+            #   end
+            # end
+            #
             around_callbacks = entity.callbacks.for([:around, method])
 
             ##
             #
             #
-            initial_around_callback = Plugins::HasCallbacks::Entities::Callback.new(
+            initial_around_callback = entities.Callback.new(
               types: [:around, method],
-              block: proc { original_value = chain.next(...) }
+              block: proc { original_value = chain.next(*args, **kwargs, &block) }
             )
 
             ##
@@ -76,7 +96,7 @@ module ConvenientService
             # rubocop:disable Style/Semicolon
             composed =
               around_callbacks.reverse.reduce(initial_around_callback) do |composed, callback|
-                proc { callback.call_in_context(entity, composed); original_value }
+                proc { callback.call_in_context_with_value_and_arguments(entity, composed, *args, **kwargs, &block); original_value }
               end
             # rubocop:enable Style/Semicolon
 

data/lib/convenient_service/common/plugins/has_callbacks/container.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Common
+    module Plugins
+      module HasCallbacks
+        module Container
+          include Support::DependencyContainer::Export
+
+          export :"entities.Callback" do
+            Entities::Callback
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/common/plugins/has_callbacks/entities/callback.rb

@@ -6,33 +6,99 @@ module ConvenientService
       module HasCallbacks
         module Entities
           class Callback
-            attr_reader :types, :block
+            ##
+            # @!attribute [r] types
+            #   @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::TypeCollection]
+            #
+            attr_reader :types
 
+            ##
+            # @!attribute [r] block
+            #   @return [Proc]
+            #
+            attr_reader :block
+
+            ##
+            # @param types [ConvenientService::Common::Plugins::HasCallbacks::Entities::TypeCollection]
+            # @param block [Proc]
+            # @return [void]
+            #
             def initialize(types:, block:)
               @types = Entities::TypeCollection.new(types: types)
               @block = block
             end
 
+            ##
+            # @return [Boolean]
+            #
             def called?
               Utils::Bool.to_bool(@called)
             end
 
+            ##
+            # @return [Boolean]
+            #
             def not_called?
               !called?
             end
 
-            def call(*args, **kwargs)
-              block.call(*args, **kwargs).tap { mark_as_called }
+            ##
+            # @return [Object] Can be any type.
+            #
+            def call(...)
+              call_callback(...)
             end
 
+            ##
+            # @return [Object] Can be any type.
+            #
             alias_method :yield, :call
+
+            ##
+            # @return [Object] Can be any type.
+            #
             alias_method :[], :call
+
+            ##
+            # @return [Object] Can be any type.
+            #
             alias_method :===, :call
 
-            def call_in_context(context, *args, **kwargs)
-              context.instance_exec(*args, **kwargs, &block).tap { mark_as_called }
+            ##
+            # @param context [Object] Can be any type.
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
+            def call_in_context(context)
+              call_callback_in_context(context)
+            end
+
+            ##
+            # @param context [Object] Can be any type.
+            # @param args [Array]
+            # @param kwargs [Hash]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
+            def call_in_context_with_arguments(context, *args, **kwargs, &block)
+              call_callback_in_context(context, arguments(*args, **kwargs, &block))
+            end
+
+            ##
+            # @param context [Object] Can be any type.
+            # @param value [Object] Can be any type.
+            # @param args [Array]
+            # @param kwargs [Hash]
+            # @param block [Proc]
+            # @return [ConvenientService::Common::Plugins::HasCallbacks::Entities::Callback]
+            #
+            def call_in_context_with_value_and_arguments(context, value, *args, **kwargs, &block)
+              call_callback_in_context(context, value, arguments(*args, **kwargs, &block))
             end
 
+            ##
+            # @param other [Object] Can be any type.
+            # @return [Boolead]
+            #
             def ==(other)
               return unless other.instance_of?(self.class)
 
@@ -42,15 +108,42 @@ module ConvenientService
               true
             end
 
+            ##
+            # @return [Proc]
+            #
             def to_proc
               block
             end
 
             private
 
+            ##
+            # @return [Boolean]
+            #
             def mark_as_called
               @called = true
             end
+
+            ##
+            # @return [ConvenientService::Support::Arguments]
+            #
+            def arguments(...)
+              Support::Arguments.new(...)
+            end
+
+            ##
+            # @return [Object] Can be any type.
+            #
+            def call_callback(...)
+              block.call(...).tap { mark_as_called }
+            end
+
+            ##
+            # @return [Object] Can be any type.
+            #
+            def call_callback_in_context(context, *args)
+              context.instance_exec(*args, &block).tap { mark_as_called }
+            end
           end
         end
       end

data/lib/convenient_service/common/plugins/has_callbacks/middleware.rb

@@ -5,12 +5,33 @@ module ConvenientService
     module Plugins
       module HasCallbacks
         class Middleware < Core::MethodChainMiddleware
-          def next(...)
-            entity.callbacks.for([:before, method]).each { |callback| callback.call_in_context(entity) }
+          def next(*args, **kwargs, &block)
+            ##
+            # class Service
+            #   before :result do
+            #   end
+            #
+            #   before :result do |arguments|
+            #   end
+            # end
+            #
+            entity.callbacks.for([:before, method]).each { |callback| callback.call_in_context_with_arguments(entity, *args, **kwargs, &block) }
 
-            original_value = chain.next(...)
+            original_value = chain.next(*args, **kwargs, &block)
 
-            entity.callbacks.for([:after, method]).reverse_each { |callback| callback.call_in_context(entity, original_value) }
+            ##
+            # class Service
+            #   after :result do
+            #   end
+            #
+            #   after :result do |result|
+            #   end
+            #
+            #   after :result do |result, arguments|
+            #   end
+            # end
+            #
+            entity.callbacks.for([:after, method]).reverse_each { |callback| callback.call_in_context_with_value_and_arguments(entity, original_value, *args, **kwargs, &block) }
 
             original_value
           end

data/lib/convenient_service/common/plugins/has_callbacks.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 require_relative "has_callbacks/concern"
+require_relative "has_callbacks/container"
 require_relative "has_callbacks/entities"
 require_relative "has_callbacks/middleware"

data/lib/convenient_service/common/plugins/has_constructor_without_initialize/concern.rb

@@ -13,6 +13,25 @@ module ConvenientService
             # @since 0.2.0
             #
             # @internal
+            #   NOTE: `allocate` creates an uninitialized object and allocates memory for it.
+            #
+            #   NOTE: Pseudocode for default `new` implementation.
+            #     def new
+            #       instance = allocate
+            #
+            #       instance.send(:initialize)
+            #
+            #       instance
+            #     end
+            #
+            #   NOTE: Code for `new_without_initialize`.
+            #     def new_without_initialize
+            #       allocate
+            #     end
+            #
+            #   NOTE: `create` is used instead of `new` in order to avoid the accidental feeling that `new_without_initialize` is Ruby's built-in method.
+            #
+            #   NOTE: Check the following links for more info.
             #   - https://ruby-doc.org/core-2.5.0/Class.html#method-i-allocate
             #   - https://frontdeveloper.pl/2018/11/ruby-allocate-method/
             #

data/lib/convenient_service/common/plugins.rb

@@ -8,8 +8,8 @@ require_relative "plugins/normalizes_env"
 require_relative "plugins/caches_constructor_params"
 require_relative "plugins/caches_return_value"
 require_relative "plugins/can_be_copied"
-require_relative "plugins/has_around_callbacks"
 require_relative "plugins/has_callbacks"
+require_relative "plugins/has_around_callbacks"
 require_relative "plugins/has_constructor"
 require_relative "plugins/has_constructor_without_initialize"
 require_relative "plugins/has_internals"

data/lib/convenient_service/configs/minimal.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Configs
+    ##
+    # Defines minimal configuration that adds a constructor, JSend-inspired result, steps, basic inspects, and internals to services.
+    #
+    # @note: This config is NOT intented for the end-user usage. Use `Standard` instead.
+    #
+    # @internal
+    #   Heavily used in specs to test concerns and middlewares in isolation.
+    #
+    module Minimal
+      include Support::Concern
+
+      ##
+      # @internal
+      #   IMPORTANT: Order of plugins matters.
+      #
+      #   NOTE: `class_exec` (that is used under the hood by `included`) defines `class Result` in the global namespace.
+      #   That is why `class self::Result` is used.
+      #   - https://stackoverflow.com/a/51965126/12201472
+      #
+      # rubocop:disable Lint/ConstantDefinitionInBlock
+      included do
+        include Core
+
+        concerns do
+          use Plugins::Common::HasInternals::Concern
+
+          use Plugins::Service::HasInspect::Concern
+
+          use Plugins::Common::HasConstructor::Concern
+          use Plugins::Common::HasConstructorWithoutInitialize::Concern
+
+          use Plugins::Service::HasResult::Concern
+          use Plugins::Service::HasResultSteps::Concern
+        end
+
+        middlewares :initialize do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        middlewares :result do
+          use Plugins::Common::NormalizesEnv::Middleware
+
+          use Plugins::Service::HasResult::Middleware
+          use Plugins::Service::HasResultSteps::Middleware
+        end
+
+        middlewares :step do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        middlewares :success do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        middlewares :failure do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        middlewares :error do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        middlewares :result, scope: :class do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        middlewares :step, scope: :class do
+          use Plugins::Common::NormalizesEnv::Middleware
+        end
+
+        class self::Internals
+          include Core
+
+          concerns do
+            use Plugins::Internals::HasCache::Concern
+          end
+        end
+
+        class self::Result
+          include Core
+
+          concerns do
+            use Plugins::Common::HasInternals::Concern
+
+            use Plugins::Result::HasInspect::Concern
+
+            use Plugins::Common::HasConstructor::Concern
+
+            use Plugins::Result::HasJsendStatusAndAttributes::Concern
+          end
+
+          middlewares :initialize do
+            use Plugins::Common::NormalizesEnv::Middleware
+
+            use Plugins::Result::HasJsendStatusAndAttributes::Middleware
+          end
+
+          middlewares :success? do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :failure? do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :error? do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :not_success? do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :not_failure? do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :not_error? do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :data do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :message do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :code do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          middlewares :to_kwargs do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          class self::Internals
+            include Core
+
+            concerns do
+              use Plugins::Internals::HasCache::Concern
+            end
+          end
+        end
+
+        class self::Step
+          include Core
+
+          concerns do
+            use Plugins::Common::HasInternals::Concern
+
+            use Plugins::Step::HasInspect::Concern
+          end
+
+          middlewares :calculate_result do
+            use Plugins::Common::NormalizesEnv::Middleware
+          end
+
+          class self::Internals
+            include Core
+
+            concerns do
+              use Plugins::Internals::HasCache::Concern
+            end
+          end
+        end
+      end
+      # rubocop:enable Lint/ConstantDefinitionInBlock
+    end
+  end
+end