convenient_service 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7655bb52a95f02a3f973c4f26e8e881ebf2dec66e056de3e085515b8e1c9b8f9
-  data.tar.gz: 440d3e574c167e88ca942e98eb022665faf918933d20789d4acc50f90bd0e9e8
+  metadata.gz: 2d49bd8a8f45539edd750ba5388d4cd0dc7ab2e442380a24f38879f17c405944
+  data.tar.gz: 63adf6692c4989970e4fe1fa2b0c28bfa2c29020f33e9567d3fabbd9284f1944
 SHA512:
-  metadata.gz: 2f76c7d18d8dbe51157e07c575718383148fc070cd85705450f9ea7d5bd4c3837d459b1da3125c4a1eb6188d14ce5e5d10c1b501104949f6c609e6a0f724e820
-  data.tar.gz: fb0f1e875261f71a01fefba836b45e6c8995ea94f9aa906050f9bebdf5b4690bafda699c624a9405cec65c14928ba1956d6c3a193f434ab471ceceb4635baef6
+  metadata.gz: 199c1e80a8dfeedc2a8d1873f8f75008d510fb48374ab116f7c51f49ef44cf034454280279a5fda2bdc16ccd69e6010cb70291bdf0f10295d3eabddfcc391a6e
+  data.tar.gz: 2f03ad73249e0f61ee1d2f2b3fde41c82d9bd2089ebcd95f01390df206f6dded8ee5c4880d409065f6df01ba63eec1cbf26caabaf94c4e4a962752bb1f9d967f

data/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## [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)
+
+
+### Features
+
+* **dependency_container:** assert valid scope ([5d75f59](https://github.com/marian13/convenient_service/commit/5d75f593c01baa695e75fe49af6b4c6b80d7d9b1))
+* **singleton_prepend_module:** introduce singleton_prepend_module custom RSpec matcher ([6636b8d](https://github.com/marian13/convenient_service/commit/6636b8d030329e4a6216a934748a70ef4bae6ff3))
+* **has_result_steps:** introduce reassign ([75855be](https://github.com/marian13/convenient_service/commit/75855be7fd9115d01d5cfad99d35319486332bd2))
+
 ## [0.5.0](https://github.com/marian13/convenient_service/compare/v0.4.0...v0.5.0) (2023-01-19)
 
 

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2022 Marian Kostyk
+Copyright (c) 2022-2023 Marian Kostyk
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -60,5 +60,5 @@ This library is under heavy development. Public API may be subject to change. Th
 ---
 
 <!-- author:start -->
-Copyright (c) 2022 [Marian Kostyk](http://mariankostyk.com).
+Copyright (c) 2022-2023 [Marian Kostyk](http://mariankostyk.com).
 <!-- author:end -->

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 | |
@@ -44,14 +44,36 @@
 | High | 🚧 | `included_once` for `Support::Concern` |
 | Medium | 🚧 | Custom YARD type for service instance, service class as return values |
 | Medium | 🚧 | Heredoc for error messages |
-| Medium | 🚧 | Specs for `be_success`, `be_error`, `be_failure` matchers | | 
-| Low | 🚧 | [Receive Counts](https://relishapp.com/rspec/rspec-mocks/docs/setting-constraints/receive-counts) for `delegate_to` | | 
+| Medium | 🚧 | Specs for `be_success`, `be_error`, `be_failure` matchers | |
+| Low | 🚧 | [Receive Counts](https://relishapp.com/rspec/rspec-mocks/docs/setting-constraints/receive-counts) for `delegate_to` | |
 | Low | 🚧 | Prefer versioning instead of modification plugin | |
 | Low | 🚧 | Consider to move `__steps__` and `__callbacks__` to `internals_class` | Benefit? |
 | Medium | 🚧 | User friendly `raise` that removes lib backtrace from caller | Should have a `debug` mode. Should work well with examples. Check RSpec `CallerFilter.first_non_rspec_line` |
 | High | 🚧 | A plugin that catches `StandardError` and returns `failure` | Should be the lowest in the stack |
 | High | 🚧 | `Support::Command` alias | Should be visible to the end user |
 | Low | 🚧 | Parallel steps | A killer feature |
-| Medium | 🚧 | Add Ruby 3.2 support to Docker and CI |  |
+| Medium | 🚧 | Add `Ruby 3.2` support to `Docker` and `CI` |  |
+| Low | 🚧 | `overload do` | |
+| Low | 🚧 | Same spec example group organization | |
+| Medium | 🚧 | `Support::Arguments` | |
+| Low | 🚧 | Null object to Nil object? | |
+| High | 🚧 | Do not use Testing Toolkit in the Primitives layer | See [Components Diagram](https://marian13.github.io/static_content/convenient_service/diagrams/components_graph.html) + it should take the minimal amount of efforts to extract and reuse `Utils`, `Suppport` in the different projects |
+| Medium | 🚧 | Perfromance testing | [rspec-benchmark](https://github.com/piotrmurach/rspec-benchmark), [Testing object allocations](https://www.honeybadger.io/blog/testing-object-allocations/), [allocation_stats](https://github.com/srawlins/allocation_stats) |
+| Medium | 🚧 | Mutant testing | [mutant](https://github.com/mbj/mutant) |
+| Low | 🚧 | Add `JRuby` support | [jruby](https://www.jruby.org/) |
+| 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 | |
 
 Search for `TODO`s in the codebase for more tasks.

data/Taskfile.yml

@@ -78,6 +78,16 @@ tasks:
 
   docker:build:ruby_2.7:
     cmds:
+      ##
+      # NOTE: Meaning of `|| 2> /dev/null`.
+      # https://stackoverflow.com/a/10250395/12201472
+      #
+      # NOTE: Meaning of `|| true`.
+      # https://superuser.com/a/887349/1180656
+      #
+      - rm Gemfile.2.7 2> /dev/null || true
+      - rm Gemfile.2.7.lock 2> /dev/null || true
+      - cp Gemfile Gemfile.2.7
       - docker build . -f docker/2.7/Dockerfile -t convenient_service:2.7
     preconditions:
       - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
@@ -85,6 +95,16 @@ tasks:
 
   docker:build:ruby_3.0:
     cmds:
+      ##
+      # NOTE: Meaning of `|| 2> /dev/null`.
+      # https://stackoverflow.com/a/10250395/12201472
+      #
+      # NOTE: Meaning of `|| true`.
+      # https://superuser.com/a/887349/1180656
+      #
+      - rm Gemfile.3.0 2> /dev/null || true
+      - rm Gemfile.3.0.lock 2> /dev/null || true
+      - cp Gemfile Gemfile.3.0
       - docker build . -f docker/3.0/Dockerfile -t convenient_service:3.0
     preconditions:
       - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
@@ -92,6 +112,16 @@ tasks:
 
   docker:build:ruby_3.1:
     cmds:
+      ##
+      # NOTE: Meaning of `|| 2> /dev/null`.
+      # https://stackoverflow.com/a/10250395/12201472
+      #
+      # NOTE: Meaning of `|| true`.
+      # https://superuser.com/a/887349/1180656
+      #
+      - rm Gemfile.3.1 2> /dev/null || true
+      - rm Gemfile.3.1.lock 2> /dev/null || true
+      - cp Gemfile Gemfile.3.1
       - docker build . -f docker/3.1/Dockerfile -t convenient_service:3.1
     preconditions:
       - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'

data/convenient_service.gemspec

@@ -33,20 +33,23 @@ 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"
   spec.add_development_dependency "paint"
   spec.add_development_dependency "progressbar"
   spec.add_development_dependency "rake", "~> 12.0"
   spec.add_development_dependency "rerun"
   spec.add_development_dependency "rouge"
-  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rspec", "~> 3.11.0"
   spec.add_development_dependency "rubocop", "~> 1.40.0"
   spec.add_development_dependency "rubocop-rspec"
   spec.add_development_dependency "tty-prompt"
   spec.add_development_dependency "standard"
   spec.add_development_dependency "simplecov"
   spec.add_development_dependency "simplecov-lcov"
-  spec.add_development_dependency "yard"
+  spec.add_development_dependency "webrick"
+  spec.add_development_dependency "yard", "~> 0.9.28"
   spec.add_development_dependency "yard-junk"
 end

data/lib/convenient_service/aliases.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
 module ConvenientService
+  Command = ::ConvenientService::Support::Command
+  Concern = ::ConvenientService::Support::Concern
   DependencyContainer = ::ConvenientService::Support::DependencyContainer
 end

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_active_model_attribute_assignment/concern.rb

@@ -9,8 +9,6 @@ module ConvenientService
             include Support::Concern
 
             included do |service_class|
-              require "active_model"
-
               service_class.include ::ActiveModel::AttributeAssignment
             end
           end

data/lib/convenient_service/common/plugins/assigns_attributes_in_constructor/using_dry_initializer/concern.rb

@@ -9,8 +9,6 @@ module ConvenientService
             include Support::Concern
 
             included do |service_class|
-              require "dry-initializer"
-
               service_class.extend ::Dry::Initializer
             end
           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.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/standard.rb

@@ -34,12 +34,6 @@ module ConvenientService
           use Plugins::Common::HasAroundCallbacks::Concern
 
           use Plugins::Service::HasInspect::Concern
-          ##
-          # NOTE: Optional plugins.
-          # TODO: Specs.
-          #
-          #   use Plugins::Common::HasConfig::Concern
-          #
         end
 
         middlewares :initialize do
@@ -51,18 +45,24 @@ module ConvenientService
         middlewares :result do
           use Plugins::Common::NormalizesEnv::Middleware
 
-          use Plugins::Service::HasResult::Middleware
-
-          use Plugins::Service::HasResultSteps::Middleware
-
           use Plugins::Common::HasCallbacks::Middleware
           use Plugins::Common::HasAroundCallbacks::Middleware
 
+          use Plugins::Service::HasResult::Middleware
+          use Plugins::Service::HasResultSteps::Middleware
+
           use Plugins::Service::RaisesOnDoubleResult::Middleware
 
           use Plugins::Common::CachesReturnValue::Middleware
         end
 
+        middlewares :step do
+          use Plugins::Common::NormalizesEnv::Middleware
+
+          use Plugins::Common::HasCallbacks::Middleware
+          use Plugins::Common::HasAroundCallbacks::Middleware
+        end
+
         middlewares :success do
           use Plugins::Common::NormalizesEnv::Middleware
 
@@ -111,6 +111,9 @@ module ConvenientService
             use Plugins::Result::HasResultShortSyntax::Concern
             use Plugins::Result::CanRecalculateResult::Concern
 
+            use Plugins::Result::HasStep::Concern
+            use Plugins::Result::CanHaveParentResult::Concern
+
             use Plugins::Result::HasInspect::Concern
           end
 
@@ -118,6 +121,9 @@ module ConvenientService
             use Plugins::Common::NormalizesEnv::Middleware
 
             use Plugins::Result::HasJsendStatusAndAttributes::Middleware
+
+            use Plugins::Result::HasStep::Initialize::Middleware
+            use Plugins::Result::CanHaveParentResult::Initialize::Middleware
           end
 
           middlewares :success? do
@@ -174,6 +180,13 @@ module ConvenientService
             use Plugins::Result::RaisesOnNotCheckedResultStatus::Middleware
           end
 
+          middlewares :to_kwargs do
+            use Plugins::Common::NormalizesEnv::Middleware
+
+            use Plugins::Result::HasStep::ToKwargs::Middleware
+            use Plugins::Result::CanHaveParentResult::ToKwargs::Middleware
+          end
+
           class self::Internals
             include Core
 
@@ -192,10 +205,10 @@ module ConvenientService
             use Plugins::Step::HasInspect::Concern
           end
 
-          middlewares :result do
+          middlewares :calculate_result do
             use Plugins::Common::NormalizesEnv::Middleware
 
-            use Plugins::Common::CachesReturnValue::Middleware
+            use Plugins::Step::CanHaveParentResult::Middleware
           end
 
           class self::Internals

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities/container/commands/resolve_methods_middlewares_callers.rb

@@ -35,30 +35,7 @@ module ConvenientService
                     # @return [Module]
                     #
                     def call
-                      get_methods_middlewares_callers || set_methods_middlewares_callers
-                    end
-
-                    private
-
-                    ##
-                    # @return [Module, nil]
-                    #
-                    def get_methods_middlewares_callers
-                      Utils::Module.get_own_const(klass, module_name)
-                    end
-
-                    ##
-                    # @return [Module]
-                    #
-                    def set_methods_middlewares_callers
-                      klass.const_set(module_name, ::Module.new)
-                    end
-
-                    ##
-                    # @return [Symbol]
-                    #
-                    def module_name
-                      @module_name ||= :MethodsMiddlewaresCallers
+                      Utils::Module.fetch_own_const(klass, :MethodsMiddlewaresCallers) { ::Module.new }
                     end
                   end
                 end