convenient_service 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ec5188e0830cb8a97b589ff6985d4aa1e361bce486dba86a1a1f697924d0be7
-  data.tar.gz: ab763a1c604849509f5557938768bf019b5d962dd5d6fa62771b17e3c524025d
+  metadata.gz: 2d49bd8a8f45539edd750ba5388d4cd0dc7ab2e442380a24f38879f17c405944
+  data.tar.gz: 63adf6692c4989970e4fe1fa2b0c28bfa2c29020f33e9567d3fabbd9284f1944
 SHA512:
-  metadata.gz: 32cf7296bf8a5ff16d7bfed6c20a855831e27b0300edede75ba7c737f357ed6ddf462641d7cacc9c5f7a65c64c3a4e59b04a60cee0ad9793f173fca7e9c0ad24
-  data.tar.gz: 71aadf20b54f0f507eb6721999b2192630eb2265d660d40ecc461de311fb930376883d1546c9c030c03f15e90e0c02e172066adc2213cb61140cc3f8b45b5137
+  metadata.gz: 199c1e80a8dfeedc2a8d1873f8f75008d510fb48374ab116f7c51f49ef44cf034454280279a5fda2bdc16ccd69e6010cb70291bdf0f10295d3eabddfcc391a6e
+  data.tar.gz: 2f03ad73249e0f61ee1d2f2b3fde41c82d9bd2089ebcd95f01390df206f6dded8ee5c4880d409065f6df01ba63eec1cbf26caabaf94c4e4a962752bb1f9d967f

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # 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)
 
 

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,16 @@
 | 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/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,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/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/dependencies.rb

@@ -106,6 +106,18 @@ module ConvenientService
         require_relative "rspec"
       end
 
+      ##
+      # Loads test factory.
+      #
+      # @return [Boolean]
+      # @note Expected to be called from `spec_helper.rb`.
+      #
+      def require_factory
+        require "faker"
+
+        require_relative "factory"
+      end
+
       ##
       # Loads standard config examples.
       #

data/lib/convenient_service/examples/dry/gemfile/dry_service/config.rb

@@ -34,7 +34,7 @@ module ConvenientService
 
                 middlewares :result do
                   insert_before \
-                    Plugins::Service::HasResultSteps::Middleware,
+                    Plugins::Service::HasResult::Middleware,
                     Plugins::Service::HasResultParamsValidations::UsingDryValidation::Middleware
                 end
               end

data/lib/convenient_service/examples/rails/gemfile/rails_service/config.rb

@@ -45,7 +45,7 @@ module ConvenientService
 
                 middlewares :result do
                   insert_before \
-                    Plugins::Service::HasResultSteps::Middleware,
+                    Plugins::Service::HasResult::Middleware,
                     Plugins::Service::HasResultParamsValidations::UsingActiveModelValidations::Middleware
                 end
               end

data/lib/convenient_service/examples/rails/gemfile/services/format.rb

@@ -16,17 +16,46 @@ module ConvenientService
 
             attribute :path, :string
 
-            step Services::ReadFileContent, in: :path, out: :content
-            step Services::StripComments, in: :content, out: :content_without_comments
-            step Services::ParseContent, in: {content: :content_without_comments}, out: :parsed_content
-            step Services::FormatHeader, in: :parsed_content, out: {formatted_content: :formatted_header_content}
-            step Services::FormatBody, in: :parsed_content, out: {formatted_content: :formatted_body_content}
+            validates :path, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
+
+            step Services::ReadFileContent,
+              in: :path,
+              out: :content
+
+            step Services::StripComments,
+              in: :content,
+              out: :content_without_comments
+
+            step Services::ParseContent,
+              in: {content: :content_without_comments},
+              out: :parsed_content
+
+            step Services::FormatHeader,
+              in: :parsed_content,
+              out: {formatted_content: :formatted_header_content}
+
+            step Services::FormatBody,
+              in: :parsed_content,
+              out: {formatted_content: :formatted_body_content}
+
+            step Services::MergeSections,
+              in: [
+                {header: :formatted_header_content},
+                {body: :formatted_body_content}
+              ],
+              out: :merged_sections
+
+            step Services::ReplaceFileContent,
+              in: [
+                :path,
+                {content: :merged_sections}
+              ]
 
             before :result do
               @progressbar = ::ProgressBar.create(title: "Formatting", total: steps.count)
             end
 
-            after :step do |step_result|
+            after :step do |step|
               @progressbar.increment
             end
           end

data/lib/convenient_service/examples/rails/gemfile/services/format_header.rb

@@ -38,8 +38,7 @@ module ConvenientService
             #
             # TODO: Implement custom types.
             #
-            attr_accessor :parsed_content
-
+            attribute :parsed_content
             attribute :skip_frozen_string_literal, :boolean, default: false
 
             def result

data/lib/convenient_service/examples/rails/gemfile/services/merge_sections.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class MergeSections
+            include RailsService::Config
+
+            attribute :header, :string
+            attribute :body, :string
+
+            validates :header, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
+            validates :body, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
+
+            def result
+              success(merged_sections: "#{header}\n#{body}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/rails/gemfile/services/replace_file_content.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Rails
+      module Gemfile
+        module Services
+          class ReplaceFileContent
+            include RailsService::Config
+
+            attribute :path, :string
+            attribute :content, :string
+
+            validates :path, presence: true if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
+
+            validate :content_not_nil if ConvenientService::Dependencies.support_has_result_params_validations_using_active_model_validations?
+
+            step Services::AssertFileExists, in: :path
+            step :result, in: :path
+
+            def result
+              ::File.write(path, content)
+
+              success
+            end
+
+            private
+
+            def content_not_nil
+              errors.add(:content, "can't be nil") if content.nil?
+            end
+          end
+        end
+      end
+    end
+  end
+end