convenient_service 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4686692f187c6eed32b5bab389f30e138aa547050234676d4cd25271c451287b
-  data.tar.gz: c3c7ac1895761d5abb36b6783a4fcaa1167117efc6c42813a201f0e4c64defa1
+  metadata.gz: e849e1385e9637d36289bfeb4e78eccddd53b22f5f9e828c5a35c8c90967954d
+  data.tar.gz: 9538a0fb396cbe7a9f04879845a25287145021b4bfa17ea78eaf4e54643552d9
 SHA512:
-  metadata.gz: 336c3065ee969a78debe0824585deb22940b96257a3109c663a4348469da28740478bded21dffae4750b1e9889cb839ea2558591c14d81109f873d7929f57a8d
-  data.tar.gz: bb8a77dacf096fdb7451d70b5d484d1ecdb074bce0fbbe3faace722e52c6ba39a48b17ef52dfc2fc3252f93b9623182e6b5157e93b444509eb559dd947cbd6af
+  metadata.gz: f4cc32889e3c0958bc5acebc744a01b9fc80c0fa2c7a7c3a609ffd4a9d8254822d0ad4a8c1d75fd2ce39472b2ededc2ef69b3d899edcda406f1eff99b06df2b8
+  data.tar.gz: 30bf372859ef693d1d67058a886065eb7db3b3dddb530cc585e471417a94ccedfac1c86d17df56881c3f5849b04d6a0a64b752746209afa5d860f9f35f3b3689

data/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [0.14.0](https://github.com/marian13/convenient_service/compare/v0.13.0...v0.14.0) (2023-09-20)
+
+
+### ⚠ BREAKING CHANGES
+
+* **has_j_send_result_params_validations:** return errors on validation issues
+* **has_j_send_result_params_validations:** return errors on validation issues
+* **can_have_fallbacks:** fallback only failures by default
+* **be_result:** update got part
+* **has_j_send_result_short:** update constants
+* **fallbacks:** create separate fallbacks failures and errors, run only error fallback when true
+
+### Features
+
+* **be_result:** introduce be_result ([f8fc85b](https://github.com/marian13/convenient_service/commit/f8fc85bb9141851c130a040731e4bb99114050d2))
+* **can_have_fallbacks:** allow to pass fallback_true_status ([584dabe](https://github.com/marian13/convenient_service/commit/584dabe83f87c2d794ea779a3e5c7f0b0ea97f65))
+* **can_have_fallbacks:** fallback only failures by default ([58650a7](https://github.com/marian13/convenient_service/commit/58650a736be0a4daaf283c6eef9e0867a34d44d4))
+* **configs:** create copy of v1 ([bb039c8](https://github.com/marian13/convenient_service/commit/bb039c83f53607c4cf59f634c662fc604f13ff7b))
+* **examples:** create copy of v1 ([70bd3fe](https://github.com/marian13/convenient_service/commit/70bd3febc4a88ebe7e7c3d33c7dd2e1c03331ccb))
+* **has_awesome_print_inspect:** add message and data keys ([14e0a3f](https://github.com/marian13/convenient_service/commit/14e0a3f088edf8ea8565ba7ff06ca0212c4116e9))
+* **has_inspect:** add message and data keys ([8f30b7a](https://github.com/marian13/convenient_service/commit/8f30b7a905b8a953d514061ed381a404b65c81af))
+* **has_j_send_result_params_validations:** return errors on validation issues ([e25e1a4](https://github.com/marian13/convenient_service/commit/e25e1a4f94cc309035533220dbcfbfccbb94cc94))
+* **has_j_send_result_params_validations:** return errors on validation issues ([09a9b94](https://github.com/marian13/convenient_service/commit/09a9b948070f3132818d1da9ef009d1d15655ab9))
+* **has_j_send_result_short_syntax:** allow to pass data, message, code to all results ([aabf2f9](https://github.com/marian13/convenient_service/commit/aabf2f98d32407616159cbcd2bcc6349a9a3b98f))
+* **has_j_send_result_short_syntax:** allow to pass message and code to short form of error ([1af3153](https://github.com/marian13/convenient_service/commit/1af3153aa1bf385eadcf73f30e13a3cc5126d793))
+* **has_j_send_result_short_syntax:** allow to pass message and code to short form of failure ([7390630](https://github.com/marian13/convenient_service/commit/73906300f94ec6488f312d4a611f433d8c850691))
+* **has_j_send_result_short_syntax:** allow to pass message and code to short form of success ([fdf2ab2](https://github.com/marian13/convenient_service/commit/fdf2ab23ade8941ed2c6dd10d17769eaebecc855))
+* **has_j_send_status_and_attributes:** introduce Data#keys ([27f43e1](https://github.com/marian13/convenient_service/commit/27f43e1594988cc523e9bb3608e90a40e4c2b442))
+* **has_j_send_status_and_attributes:** introduce Message#empty? ([6c1452d](https://github.com/marian13/convenient_service/commit/6c1452d99d71be45bb6cb95159a2fd32ffca668e))
+* **rescues_result_unhandled_exceptions:** allow to pass status ([2ef85f2](https://github.com/marian13/convenient_service/commit/2ef85f2970dd56802bd22f467529da6242faf967))
+* **using_active_model_validations:** allow to pass status to middleware ([bc5bb70](https://github.com/marian13/convenient_service/commit/bc5bb7027fe94724a8d28a3770b68c731b37ff10))
+* **using_dry_validation:** allow to pass status to middleware ([3a5ef12](https://github.com/marian13/convenient_service/commit/3a5ef120219a8a94b1d15bb7226f265db967ce9e))
+
+
+### Miscellaneous Chores
+
+* release 0.14.0 ([c7cef07](https://github.com/marian13/convenient_service/commit/c7cef0721d8360329c19b8ad4d636bcec83805c6))
+
+
+### Code Refactoring
+
+* **be_result:** update got part ([428280a](https://github.com/marian13/convenient_service/commit/428280a8eb2aed09f49bd949f84b7e10ef933708))
+* **fallbacks:** create separate fallbacks failures and errors, run only error fallback when true ([bbab564](https://github.com/marian13/convenient_service/commit/bbab5647d09ecdba9c9727bef3e2dc6b8138710b))
+* **has_j_send_result_short:** update constants ([2074acd](https://github.com/marian13/convenient_service/commit/2074acd001115dd4c60d432e71a4fef58794c881))
+
 ## 0.13.0 (2023-08-27)
 
 

data/lib/convenient_service/configs/minimal.rb

@@ -18,7 +18,7 @@ module ConvenientService
     #       # ...
     #     end
     #
-    #   In turn, `:fallback_result` is added by `use Plugins::Service::CanHaveFallback::Concern` in `Standard`.
+    #   In turn, `:fallback_result` is added by `use Plugins::Service::CanHaveFallbacks::Concern` in `Standard`.
     #   That is why it is the responsibility of the `Standard` config, to define:
     #
     #     middlewares :fallback_result do

data/lib/convenient_service/configs/standard/aliases.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Standard
+    module V1
+      Config = ::ConvenientService::Configs::Standard::V1
+    end
+  end
+end

data/lib/convenient_service/configs/standard/v1.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Configs
+    ##
+    # Default configuration for the user-defined services.
+    #
+    module Standard
+      module V1
+        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 Configs::Minimal
+
+          concerns do
+            use Plugins::Common::CachesConstructorArguments::Concern
+            use Plugins::Common::CanBeCopied::Concern
+            use Plugins::Service::CanRecalculateResult::Concern
+            use Plugins::Service::HasJSendResultShortSyntax::Concern
+            use Plugins::Service::HasJSendResultStatusCheckShortSyntax::Concern
+
+            use Plugins::Common::HasCallbacks::Concern
+            use Plugins::Common::HasAroundCallbacks::Concern
+
+            use Plugins::Service::HasMermaidFlowchart::Concern
+          end
+
+          middlewares :initialize do
+            use Plugins::Service::CollectsServicesInException::Middleware
+            use Plugins::Common::CachesConstructorArguments::Middleware
+          end
+
+          middlewares :result do
+            insert_after \
+              Plugins::Common::NormalizesEnv::Middleware,
+              Plugins::Service::CollectsServicesInException::Middleware
+
+            insert_before \
+              Plugins::Service::RaisesOnNotResultReturnValue::Middleware,
+              Plugins::Common::HasCallbacks::Middleware
+
+            insert_after \
+              Plugins::Common::HasCallbacks::Middleware,
+              Plugins::Common::HasAroundCallbacks::Middleware
+
+            ##
+            # TODO: Rewrite. This plugin does NOT do what it states. Probably I was NOT with a clear mind while writing it (facepalm).
+            #
+            # use Plugins::Service::RaisesOnDoubleResult::Middleware
+
+            insert_before \
+              Plugins::Service::RaisesOnNotResultReturnValue::Middleware,
+              Plugins::Service::SetsParentToForeignResult::Middleware
+          end
+
+          middlewares :step do
+            use Plugins::Common::HasCallbacks::Middleware
+            use Plugins::Common::HasAroundCallbacks::Middleware
+          end
+
+          middlewares :success do
+            use Plugins::Service::HasJSendResultShortSyntax::Success::Middleware
+          end
+
+          middlewares :failure do
+            use Plugins::Service::HasJSendResultShortSyntax::Failure::Middleware
+          end
+
+          middlewares :error do
+            use Plugins::Service::HasJSendResultShortSyntax::Error::Middleware
+          end
+
+          class self::Result
+            concerns do
+              use Plugins::Common::HasJSendResultDuckShortSyntax::Concern
+              use Plugins::Result::CanRecalculateResult::Concern
+
+              use Plugins::Result::CanHaveStep::Concern
+              use Plugins::Result::CanBeOwnResult::Concern
+              use Plugins::Result::CanHaveParentResult::Concern
+              use Plugins::Result::CanHaveCheckedStatus::Concern
+            end
+
+            middlewares :success? do
+              use Plugins::Result::CanHaveCheckedStatus::Middleware
+            end
+
+            middlewares :failure? do
+              use Plugins::Result::CanHaveCheckedStatus::Middleware
+            end
+
+            middlewares :error? do
+              use Plugins::Result::CanHaveCheckedStatus::Middleware
+            end
+
+            middlewares :not_success? do
+              use Plugins::Result::CanHaveCheckedStatus::Middleware
+            end
+
+            middlewares :not_failure? do
+              use Plugins::Result::CanHaveCheckedStatus::Middleware
+            end
+
+            middlewares :not_error? do
+              use Plugins::Result::CanHaveCheckedStatus::Middleware
+            end
+
+            middlewares :data do
+              use Plugins::Result::RaisesOnNotCheckedResultStatus::Middleware
+            end
+
+            middlewares :message do
+              use Plugins::Result::RaisesOnNotCheckedResultStatus::Middleware
+            end
+
+            middlewares :code do
+              use Plugins::Result::RaisesOnNotCheckedResultStatus::Middleware
+            end
+          end
+
+          class self::Step
+            concerns do
+              use Plugins::Common::HasJSendResultDuckShortSyntax::Concern
+            end
+
+            middlewares :result do
+              use Plugins::Step::CanHaveParentResult::Middleware
+            end
+          end
+
+          if Dependencies.rspec.loaded?
+            concerns do
+              insert_before 0, Plugins::Service::CanHaveStubbedResults::Concern
+            end
+
+            middlewares :result do
+              insert_after \
+                Plugins::Common::NormalizesEnv::Middleware,
+                Plugins::Service::CanHaveStubbedResults::Middleware
+
+              insert_before \
+                Plugins::Service::CanHaveStubbedResults::Middleware,
+                Plugins::Service::CountsStubbedResultsInvocations::Middleware
+            end
+
+            middlewares :result, scope: :class do
+              insert_after \
+                Plugins::Common::NormalizesEnv::Middleware,
+                Plugins::Service::CanHaveStubbedResults::Middleware
+
+              insert_before \
+                Plugins::Service::CanHaveStubbedResults::Middleware,
+                Plugins::Service::CountsStubbedResultsInvocations::Middleware
+            end
+
+            class self::Result
+              concerns do
+                use Plugins::Result::CanBeStubbedResult::Concern
+                use Plugins::Result::HasStubbedResultInvocationsCounter::Concern
+              end
+
+              middlewares :initialize do
+                insert_before \
+                  Plugins::Result::HasJSendStatusAndAttributes::Middleware,
+                  Plugins::Result::HasStubbedResultInvocationsCounter::Middleware
+              end
+            end
+          end
+        end
+        # rubocop:enable Lint/ConstantDefinitionInBlock
+      end
+    end
+  end
+end

data/lib/convenient_service/configs/standard.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative "standard/v1"
+require_relative "standard/aliases"
+
 module ConvenientService
   module Configs
     ##
@@ -30,7 +33,7 @@ module ConvenientService
           use Plugins::Common::HasCallbacks::Concern
           use Plugins::Common::HasAroundCallbacks::Concern
 
-          use Plugins::Service::CanHaveFallback::Concern
+          use Plugins::Service::CanHaveFallbacks::Concern
           use Plugins::Service::HasMermaidFlowchart::Concern
         end
 
@@ -64,15 +67,28 @@ module ConvenientService
 
         ##
         # @internal
-        #   NOTE: Check `Minimal` docs to understand why `use Plugins::Common::NormalizesEnv::Middleware` for `:fallback_result` is used in `Standard`, not in `Minimal` config.
+        #   NOTE: Check `Minimal` docs to understand why `use Plugins::Common::NormalizesEnv::Middleware` for `:fallback_failure_result` is used in `Standard`, not in `Minimal` config.
         #
-        middlewares :fallback_result do
+        middlewares :fallback_failure_result do
           use Plugins::Common::NormalizesEnv::Middleware
           use Plugins::Service::CollectsServicesInException::Middleware
           use Plugins::Common::CachesReturnValue::Middleware
 
           use Plugins::Service::RaisesOnNotResultReturnValue::Middleware
-          use Plugins::Service::CanHaveFallback::Middleware
+          use Plugins::Service::CanHaveFallbacks::Middleware.with(status: :failure)
+        end
+
+        ##
+        # @internal
+        #   NOTE: Check `Minimal` docs to understand why `use Plugins::Common::NormalizesEnv::Middleware` for `:fallback_error_result` is used in `Standard`, not in `Minimal` config.
+        #
+        middlewares :fallback_error_result do
+          use Plugins::Common::NormalizesEnv::Middleware
+          use Plugins::Service::CollectsServicesInException::Middleware
+          use Plugins::Common::CachesReturnValue::Middleware
+
+          use Plugins::Service::RaisesOnNotResultReturnValue::Middleware
+          use Plugins::Service::CanHaveFallbacks::Middleware.with(status: :error)
         end
 
         middlewares :step do
@@ -99,7 +115,7 @@ module ConvenientService
 
             use Plugins::Result::CanHaveStep::Concern
             use Plugins::Result::CanBeOwnResult::Concern
-            use Plugins::Result::CanHaveFallback::Concern
+            use Plugins::Result::CanHaveFallbacks::Concern
             use Plugins::Result::CanHaveParentResult::Concern
             use Plugins::Result::CanHaveCheckedStatus::Concern
           end
@@ -144,20 +160,30 @@ module ConvenientService
         class self::Step
           concerns do
             use Plugins::Common::HasJSendResultDuckShortSyntax::Concern
-            use Plugins::Step::CanHaveFallback::Concern
+            use Plugins::Step::CanHaveFallbacks::Concern
           end
 
           middlewares :result do
-            use Plugins::Step::CanHaveFallback::Middleware
+            use Plugins::Step::CanHaveFallbacks::Middleware.with(fallback_true_status: :failure)
             use Plugins::Step::CanHaveParentResult::Middleware
           end
 
-          middlewares :service_fallback_result do
+          middlewares :service_fallback_failure_result do
+            use Plugins::Common::NormalizesEnv::Middleware
+            use Plugins::Common::CachesReturnValue::Middleware
+          end
+
+          middlewares :fallback_failure_result do
+            use Plugins::Common::NormalizesEnv::Middleware
+            use Plugins::Common::CachesReturnValue::Middleware
+          end
+
+          middlewares :service_fallback_error_result do
             use Plugins::Common::NormalizesEnv::Middleware
             use Plugins::Common::CachesReturnValue::Middleware
           end
 
-          middlewares :fallback_result do
+          middlewares :fallback_error_result do
             use Plugins::Common::NormalizesEnv::Middleware
             use Plugins::Common::CachesReturnValue::Middleware
           end

data/lib/convenient_service/dependencies.rb

@@ -292,9 +292,10 @@ module ConvenientService
       #
       # Loads standard config examples.
       #
+      # @param version [String]
       # @return [Boolean]
       #
-      def require_standard_examples
+      def require_standard_examples(version: "")
         ##
         # - https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/Date.html
         # - https://ruby-doc.org/stdlib-2.7.0/libdoc/date/rdoc/DateTime.html
@@ -325,11 +326,11 @@ module ConvenientService
         #
         require "uri"
 
-        require_relative "examples/standard/cowsay"
-        require_relative "examples/standard/date_time"
-        require_relative "examples/standard/factorial"
-        require_relative "examples/standard/gemfile"
-        require_relative "examples/standard/request_params"
+        require_relative ::File.join("examples", "standard", version, "cowsay")
+        require_relative ::File.join("examples", "standard", version, "date_time")
+        require_relative ::File.join("examples", "standard", version, "factorial")
+        require_relative ::File.join("examples", "standard", version, "gemfile")
+        require_relative ::File.join("examples", "standard", version, "request_params")
       end
 
       ##
@@ -337,9 +338,10 @@ module ConvenientService
       #
       # Loads rails config examples.
       #
+      # @param version [String]
       # @return [Boolean]
       #
-      def require_rails_examples
+      def require_rails_examples(version: "")
         ##
         # - https://ruby-doc.org/stdlib-2.7.0/libdoc/json/rdoc/JSON.html
         # - https://github.com/flori/json
@@ -357,7 +359,7 @@ module ConvenientService
         #
         require "webrick"
 
-        require_relative "examples/rails/gemfile"
+        require_relative ::File.join("examples", "rails", version, "gemfile")
       end
 
       ##
@@ -365,9 +367,10 @@ module ConvenientService
       #
       # Loads dry config examples.
       #
+      # @param version [String]
       # @return [Boolean]
       #
-      def require_dry_examples
+      def require_dry_examples(version: "")
         ##
         # - https://ruby-doc.org/stdlib-2.7.0/libdoc/json/rdoc/JSON.html
         # - https://github.com/flori/json
@@ -385,7 +388,7 @@ module ConvenientService
         #
         require "webrick"
 
-        require_relative "examples/dry/gemfile"
+        require_relative ::File.join("examples", "dry", version, "gemfile")
       end
 
       ##

data/lib/convenient_service/examples/dry/gemfile/services/assert_file_exists.rb

@@ -17,7 +17,7 @@ module ConvenientService
             end
 
             def result
-              return error("File with path `#{path}` does NOT exist") unless ::File.exist?(path)
+              return failure("File with path `#{path}` does NOT exist") unless ::File.exist?(path)
 
               success
             end

data/lib/convenient_service/examples/dry/gemfile/services/assert_file_not_empty.rb

@@ -17,7 +17,7 @@ module ConvenientService
             end
 
             def result
-              return error(message: "File with path `#{path}` is empty") if ::File.zero?(path)
+              return failure("File with path `#{path}` is empty") if ::File.zero?(path)
 
               success
             end

data/lib/convenient_service/examples/dry/gemfile/services/parse_content.rb

@@ -52,7 +52,7 @@ module ConvenientService
             step :result, in: :content, out: :parsed_content
 
             def result
-              success(data: {parsed_content: parse_content})
+              success(parsed_content: parse_content)
             end
 
             def parse_content

data/lib/convenient_service/examples/dry/gemfile/services/print_shell_command.rb

@@ -3,7 +3,7 @@
 ##
 # Usage example:
 #
-#   ConvenientService::Examples::Dry::Gemfile::Services::PrintShellCommand.result(text: "ls -a")
+#   ConvenientService::Examples::Dry::Gemfile::Services::PrintShellCommand.result(command: "ls -a")
 #
 module ConvenientService
   module Examples
@@ -24,7 +24,7 @@ module ConvenientService
             end
 
             def result
-              return error("Printing of shell command `#{command}` is skipped") if skip
+              return failure("Printing of shell command `#{command}` is skipped") if skip
 
               out.puts
 
@@ -33,7 +33,7 @@ module ConvenientService
               success
             end
 
-            def fallback_result
+            def fallback_failure_result
               success
             end
           end

data/lib/convenient_service/examples/dry/gemfile/services/read_file_content.rb

@@ -21,7 +21,7 @@ module ConvenientService
             step :result, in: :path, out: :content
 
             def result
-              success(data: {content: ::File.read(path)})
+              success(content: ::File.read(path))
             end
           end
         end

data/lib/convenient_service/examples/dry/gemfile/services/run_shell_command.rb

@@ -34,7 +34,7 @@ module ConvenientService
               if system(command)
                 success
               else
-                error(message: "#{command} returned non-zero exit code")
+                error("#{command} returned non-zero exit code")
               end
             end
           end

data/lib/convenient_service/examples/dry/gemfile/services/strip_comments.rb

@@ -28,7 +28,7 @@ module ConvenientService
             step :result, in: :file_without_comments, out: :content_without_comments
 
             def result
-              success(data: {content_without_comments: file_without_comments.read})
+              success(content_without_comments: file_without_comments.read)
             end
 
             private

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+# result = ConvenientService::Examples::Dry::V1::Gemfile.format(path: "Gemfile")
+# result = ConvenientService::Examples::Dry::V1::Gemfile.format(path: "spec/cli/gemfile/format/fixtures/Gemfile")
+#
+module ConvenientService
+  module Examples
+    module Dry
+      module V1
+        class Gemfile
+          class DryService
+            module Config
+              include Support::Concern
+
+              included do
+                include ConvenientService::Standard::V1::Config
+
+                ##
+                # NOTE: `AssignsAttributesInConstructor::UsingDryInitializer` plugin.
+                #
+                concerns do
+                  use ConvenientService::Plugins::Common::AssignsAttributesInConstructor::UsingDryInitializer::Concern
+                end
+
+                ##
+                # NOTE: `HasJSendResultParamsValidations::UsingDryValidation` plugin.
+                #
+                concerns do
+                  use ConvenientService::Plugins::Service::HasJSendResultParamsValidations::UsingDryValidation::Concern
+                end
+
+                middlewares :result do
+                  insert_before \
+                    ConvenientService::Plugins::Service::RaisesOnNotResultReturnValue::Middleware,
+                    ConvenientService::Plugins::Service::HasJSendResultParamsValidations::UsingDryValidation::Middleware.with(status: :failure)
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "dry_service/config"

data/lib/convenient_service/examples/dry/v1/gemfile/services/assert_file_exists.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Dry
+      module V1
+        class Gemfile
+          module Services
+            class AssertFileExists
+              include DryService::Config
+
+              option :path
+
+              contract do
+                schema do
+                  required(:path).filled(:string)
+                end
+              end
+
+              def result
+                return error("File with path `#{path}` does NOT exist") unless ::File.exist?(path)
+
+                success
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/dry/v1/gemfile/services/assert_file_not_empty.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Examples
+    module Dry
+      module V1
+        class Gemfile
+          module Services
+            class AssertFileNotEmpty
+              include DryService::Config
+
+              option :path
+
+              contract do
+                schema do
+                  required(:path).filled(:string)
+                end
+              end
+
+              def result
+                return error(message: "File with path `#{path}` is empty") if ::File.zero?(path)
+
+                success
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/convenient_service/examples/dry/v1/gemfile/services/assert_node_available.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+##
+# Usage example:
+#
+#   ConvenientService::Examples::Dry::V1::Gemfile::Services::AssertNodeAvailable.result
+#
+module ConvenientService
+  module Examples
+    module Dry
+      module V1
+        class Gemfile
+          module Services
+            class AssertNodeAvailable
+              include DryService::Config
+
+              ##
+              # NOTE: `> /dev/null 2>&1` is used to hide output.
+              # https://unix.stackexchange.com/a/119650/394253
+              #
+              step Services::RunShellCommand, in: {command: -> { "which node > /dev/null 2>&1" }}
+            end
+          end
+        end
+      end
+    end
+  end
+end