convenient_service 0.10.1 → 0.12.0

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities/stack.rb

@@ -48,8 +48,8 @@ module ConvenientService
                 ##
                 # @param index_or_middleware [Integer, ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
                 # @param middleware [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
-                # @param args [Array]
-                # @param block [Proc]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
                 # @return [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Stack]
                 #
                 # @see https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb#L88
@@ -69,8 +69,8 @@ module ConvenientService
                 ##
                 # @param index_or_middleware [Integer, ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
                 # @param middleware [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
-                # @param args [Array]
-                # @param block [Proc]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
                 # @return [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Stack]
                 #
                 # @see https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb#L97
@@ -83,8 +83,8 @@ module ConvenientService
 
                 ##
                 # @param middleware [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
-                # @param args [Array]
-                # @param block [Proc]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
                 # @return [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Stack]
                 #
                 # @see https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb#L104
@@ -97,8 +97,8 @@ module ConvenientService
 
                 ##
                 # @param middleware [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
-                # @param args [Array]
-                # @param block [Proc]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
                 # @return [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Stack]
                 #
                 # @see https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb#L111
@@ -112,8 +112,8 @@ module ConvenientService
                 ##
                 # @param index_or_middleware [Integer, ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
                 # @param middleware [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
-                # @param args [Array]
-                # @param block [Proc]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
                 # @return [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Stack]
                 #
                 # @see https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb#L118
@@ -138,8 +138,8 @@ module ConvenientService
 
                 ##
                 # @param middleware [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware]
-                # @param args [Array]
-                # @param block [Proc]
+                # @param args [Array<Object>]
+                # @param block [Proc, nil]
                 # @return [ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Stack]
                 #
                 # @see https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb#L76

data/lib/convenient_service/core/entities/config/entities/method_middlewares/entities.rb

@@ -3,5 +3,6 @@
 require_relative "entities/caller"
 require_relative "entities/chain"
 require_relative "entities/container"
+require_relative "entities/middleware_creator"
 require_relative "entities/middleware"
 require_relative "entities/stack"

data/lib/convenient_service/core/entities/config/entities/method_middlewares.rb

@@ -93,7 +93,7 @@ module ConvenientService
             #   NOTE: Consider to remove when support for Ruby 2.7 is dropped.
             #
             def resolve_super_method(entity)
-              klass.commit_config!
+              klass.commit_config!(trigger: Constants::Triggers::RESOLVE_METHOD_MIDDLEWARES_SUPER_METHOD)
 
               container.resolve_super_method(method, entity)
             end

data/lib/convenient_service/core/entities/config/errors.rb

@@ -5,7 +5,7 @@ module ConvenientService
     module Entities
       class Config
         module Errors
-          class ConfigIsCommitted < ConvenientService::Error
+          class ConfigIsCommitted < ::ConvenientService::Error
             ##
             # @param config [ConvenientService::Core::Entities::Config]
             # @return [void]
@@ -20,6 +20,43 @@ module ConvenientService
               super(message)
             end
           end
+
+          class TooManyCommitsFromMethodMissing < ::ConvenientService::Error
+            ##
+            # @param config [ConvenientService::Core::Entities::Config]
+            # @return [void]
+            #
+            # @internal
+            #   TODO: Create a troubleshooting page with possible reasons (preliminary RSpec mocks etc).
+            #   Append a link to it to the error message.
+            #
+            def initialize(config:)
+              message = <<~TEXT
+                `#{config.klass}` config is committed too many times from `method_missing`.
+
+                In order to resolve this issue try to commit it manually before usage of any config-dependent method.
+
+                Example 1 (outside class):
+
+                  # Commitment:
+                  #{config.klass}.commit_config!
+
+                  # Few lines later - usage:
+                  #{config.klass}.result # or whatever method.
+
+                Example 2 (inside class):
+
+                  class #{config.klass}
+                    # ...
+                    commit_config!
+
+                    step :result # or any other method that becomes available after config commitment.
+                  end
+              TEXT
+
+              super(message)
+            end
+          end
         end
       end
     end

data/lib/convenient_service/core/entities/config.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "config/commands"
 require_relative "config/entities"
 require_relative "config/errors"
 
@@ -57,13 +58,13 @@ module ConvenientService
         # @overload middlewares(method)
         #   Returns all instance middlewares for particular method.
         #   @param method [Symbol] Method name.
-        #   @return [Hash<Symbol, Hash<Symbol, ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares>>]
+        #   @return [Hash{Symbol => Hash{Symbol => ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares}}]
         #
         # @overload middlewares(method, scope:)
         #   Returns all scoped middlewares for particular method.
         #   @param method [Symbol] Method name.
         #   @param scope [:instance, :class]
-        #   @return [Hash<Symbol, Hash<Symbol, ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares>>]
+        #   @return [Hash{Symbol => Hash{Symbol => ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares}}]
         #
         # @overload middlewares(method, &configuration_block)
         #   Configures instance middlewares for particular method.
@@ -105,6 +106,13 @@ module ConvenientService
           @middlewares[scope][method] || Entities::MethodMiddlewares.new(scope: scope, method: method, klass: klass)
         end
 
+        ##
+        # @return [ConvenientService::Support::ThreadSafeCounter]
+        #
+        def method_missing_commits_counter
+          @method_missing_commits_counter ||= Support::ThreadSafeCounter.new(max_value: Constants::Commits::METHOD_MISSING_MAX_TRIES)
+        end
+
         ##
         # @return [Boolean]
         #
@@ -116,18 +124,20 @@ module ConvenientService
         # Commits config when called for the first time.
         # Does nothing for the subsequent calls.
         #
+        # @param trigger [ConvenientService::Support::UniqueValue]
         # @return [Boolean] true if called for the first time, false otherwise (similarly as Kernel#require).
         #
         # @see https://ruby-doc.org/core-3.1.2/Kernel.html#method-i-require
         #
-        def commit!
+        def commit!(trigger: Constants::Triggers::USER)
           concerns.include!
+            .tap { Commands::TrackMethodMissingCommitTrigger.call(config: self, trigger: trigger) }
         end
 
         private
 
         ##
-        # @note: Config is committed either by `commit_config` or `method_missing` from `ConvenientService::Core::ClassMethods`.
+        # @note: Config is committed either by `commit_config` or `method_missing` from `ConvenientService::Core::InstanceMethods` and `ConvenientService::Core::ClassMethods`.
         #
         # @return [void]
         # @raise [ConvenientService::Core::Entities::Config::Errors::ConfigIsCommitted]

data/lib/convenient_service/core/instance_methods.rb

@@ -31,15 +31,17 @@ module ConvenientService
       #
       # @param method [Symbol]
       # @param args [Array<Object>]
-      # @param kwargs [Hash<Symbol, Object>]
-      # @param block [Proc]
+      # @param kwargs [Hash{Symbol => Object}]
+      # @param block [Proc, nil]
       # @return [void]
       #
       # @internal
-      #   IMPORTANT: `method_missing` should be thread-safe.
+      #   IMPORTANT: `method_missing` MUST be thread-safe.
+      #
+      #   NOTE: `__send__` is used instead of `Support::SafeMethod` intentionally, since checking whether a method is defined is performed earlier by `Utils::Module.instance_method_defined?`.
       #
       def method_missing(method, *args, **kwargs, &block)
-        self.class.commit_config!
+        self.class.commit_config!(trigger: Constants::Triggers::INSTANCE_METHOD_MISSING)
 
         return super unless Utils::Module.instance_method_defined?(self.class, method, private: true)
 

data/lib/convenient_service/core.rb

@@ -3,6 +3,7 @@
 require_relative "core/instance_methods"
 require_relative "core/class_methods"
 
+require_relative "core/constants"
 require_relative "core/entities"
 
 require_relative "core/aliases"

data/lib/convenient_service/dependencies/built_in.rb

@@ -42,3 +42,10 @@ require "rubygems"
 #   - https://github.com/ruby/singleton
 #
 require "singleton"
+
+##
+# @internal
+#   - https://ruby-doc.org/core-2.7.0/Mutex.html
+#   - https://docs.ruby-lang.org/en/2.1.0/Mutex.html
+#
+require "thread"

data/lib/convenient_service/dependencies/extractions/active_support_concern/concern.rb

@@ -3,10 +3,26 @@
 module ConvenientService
   module Dependencies
     module Extractions
+      ##
+      # @internal
+      #   NOTE:
+      #     Copied from `rails/rails` with some logic modification.
+      #     Version: v7.0.3.1.
+      #     Wrapped in a namespace `ConvenientService::Dependencies::Extractions::ActiveSupportConcern`.
+      #     Added `instance_methods` that works in a similar way as `class_methods`.
+      #     Also `ClassMethods` (and `InstanceMethods`) are loaded after `included` block, not as in the original implementation.
+      #
+      #   - https://github.com/marian13/rails/blob/v7.0.3.1/activesupport/lib/active_support/concern.rb
+      #   - https://github.com/rails/rails/blob/v7.0.3.1/activesupport/lib/active_support/concern.rb
+      #   - https://github.com/rails/rails
+      #
+      #   NOTE: It is ok that `MultipleIncludedBlocks` and `MultiplePrependBlocks` inherit from `StandardError` since dependencies are on the lower layer.
+      #
+      #   TODO: Move `Concern` to support? Rescue and reraise errors?
+      #   - https://github.com/marian13/convenient_service/wiki/Design:-Communication-Graph
+      #
       module ActiveSupportConcern
         ##
-        # https://github.com/marian13/rails/blob/v7.0.3.1/activesupport/lib/active_support/concern.rb
-        #
         # A typical module looks like this:
         #
         #   module M

data/lib/convenient_service/dependencies/extractions/active_support_concern.rb

@@ -13,4 +13,8 @@
 #   - https://github.com/rails/rails/blob/v7.0.3.1/activesupport/lib/active_support/concern.rb
 #   - https://github.com/rails/rails
 #
+#   NOTE: It is ok that `MultipleIncludedBlocks` and `MultiplePrependBlocks` inherit from `StandardError` since dependencies are on the lower layer.
+#   TODO: Move `Concern` to support? Rescue and reraise errors?
+#   - https://github.com/marian13/convenient_service/wiki/Design:-Communication-Graph
+#
 require_relative "active_support_concern/concern"

data/lib/convenient_service/dependencies/extractions/ruby_middleware/middleware/builder.rb

@@ -5,7 +5,13 @@ module ConvenientService
     module Extractions
       module RubyMiddleware
         ##
-        # https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb
+        # @internal
+        #   NOTE:
+        #     Copied from `Ibsciss/ruby-middleware` without any logic modification.
+        #     Version: v0.4.2.
+        #     - Wrapped in a namespace `ConvenientService::Dependencies::Extractions::RubyMiddleware`.
+        #
+        #   - https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/builder.rb
         #
         module Middleware
           # This provides a DSL for building up a stack of middlewares.

data/lib/convenient_service/dependencies/extractions/ruby_middleware/middleware/logger.rb

@@ -6,7 +6,13 @@ module ConvenientService
     module Extractions
       module RubyMiddleware
         ##
-        # https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/logger.rb
+        # @internal
+        #   NOTE:
+        #     Copied from `Ibsciss/ruby-middleware` without any logic modification.
+        #     Version: v0.4.2.
+        #     - Wrapped in a namespace `ConvenientService::Dependencies::Extractions::RubyMiddleware`.
+        #
+        #   - https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/logger.rb
         #
         module Middleware
 

data/lib/convenient_service/dependencies/extractions/ruby_middleware/middleware/runner.rb

@@ -3,7 +3,14 @@ module ConvenientService
     module Extractions
       module RubyMiddleware
         ##
-        # https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/runner.rb
+        # @internal
+        #   NOTE:
+        #     Copied from `Ibsciss/ruby-middleware` without any logic modification.
+        #     Version: v0.4.2.
+        #     - Wrapped in a namespace `ConvenientService::Dependencies::Extractions::RubyMiddleware`.
+        #     - Added support of middleware creators.
+        #
+        #   - https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware/runner.rb
         #
         module Middleware
           # This is a basic runner for middleware stacks. This runner does
@@ -60,6 +67,13 @@ module ConvenientService
                   # If the klass actually is a class, then instantiate it with
                   # the app and any other arguments given.
                   klass.new(next_middleware, *args, &block)
+                ##
+                # IMPORTANT: Customization compared to the original `Runner` implementation.
+                #
+                # NOTE: Added support of middleware creators.
+                #
+                elsif klass.respond_to?(:new)
+                  klass.new(next_middleware, *args, &block)
                 elsif klass.respond_to?(:call)
                   # Make it a lambda which calls the item then forwards up
                   # the chain.

data/lib/convenient_service/dependencies/extractions/ruby_middleware/middleware.rb

@@ -2,7 +2,14 @@
 
 ##
 # @internal
-#   https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware.rb
+#   NOTE:
+#     Copied from `Ibsciss/ruby-middleware` without any logic modification.
+#     Version: v0.4.2.
+#     - Wrapped in a namespace `ConvenientService::Dependencies::Extractions::RubyMiddleware`.
+#     - Replaced `require` into `require_relative`.
+#     - Added support of middleware creators.
+#
+#   - https://github.com/marian13/ruby-middleware/blob/v0.4.2/lib/middleware.rb
 #
 require_relative "middleware/builder"
 require_relative "middleware/runner"

data/lib/convenient_service/dependencies/extractions/ruby_middleware.rb

@@ -5,8 +5,9 @@
 #   NOTE:
 #     Copied from `Ibsciss/ruby-middleware` without any logic modification.
 #     Version: v0.4.2.
-#     Just wrapped in a namespace `ConvenientService::Dependencies::Extractions::RubyMiddleware`.
-#     Replaced `require` into `require_relative`.
+#     - Wrapped in a namespace `ConvenientService::Dependencies::Extractions::RubyMiddleware`.
+#     - Replaced `require` into `require_relative`.
+#     - Added support of middleware creators.
 #
 #   - https://github.com/marian13/ruby-middleware/blob/v0.4.2
 #   - https://github.com/Ibsciss/ruby-middleware/blob/v0.4.2

data/lib/convenient_service/dependencies.rb

@@ -87,15 +87,28 @@ module ConvenientService
       # @return [Boolean]
       # @note Expected to be called from `irb`, `pry`, `spec_helper.rb`, etc.
       #
+      # @internal
+      #   NOTE: `byebug` has C extensions, that is why it is NOT supported in JRuby.
+      #   - https://github.com/deivid-rodriguez/byebug/tree/master/ext/byebug
+      #   - https://github.com/deivid-rodriguez/byebug/issues/179#issuecomment-152727003
+      #
       def require_development_tools
         require "awesome_print"
-        require "byebug"
+        require "byebug" unless ruby.jruby?
         require "paint"
         require "rouge"
         require "tempfile"
 
-        require_relative "dependencies/extractions/byebug_syntax_highlighting"
-        require_relative "dependencies/extractions/b"
+        require_relative "dependencies/extractions/byebug_syntax_highlighting" unless ruby.jruby?
+        require_relative "dependencies/extractions/b" unless ruby.jruby?
+      end
+
+      ##
+      # @return [Boolean]
+      # @note Expected to be called from `spec_helper.rb`.
+      #
+      def require_test_tools
+        require "faker"
       end
 
       ##
@@ -114,18 +127,6 @@ 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.rb

@@ -14,10 +14,10 @@ module ConvenientService
   module Examples
     module Dry
       module Gemfile
-        class << self
-          def format(path)
-            Services::Format[path: path]
-          end
+        include ConvenientService::Feature
+
+        entry :format do |path|
+          Services::Format[path: path]
         end
       end
     end

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

@@ -14,10 +14,10 @@ module ConvenientService
   module Examples
     module Rails
       module Gemfile
-        class << self
-          def format(path)
-            Services::Format[path: path]
-          end
+        include ConvenientService::Feature
+
+        entry :format do |path|
+          Services::Format[path: path]
         end
       end
     end

data/lib/convenient_service/examples/standard/cowsay.rb

@@ -13,10 +13,10 @@ module ConvenientService
   module Examples
     module Standard
       module Cowsay
-        class << self
-          def print(text = "Hello World!", out: $stdout)
-            Services::Print[text: text, out: out]
-          end
+        include ConvenientService::Feature
+
+        entry :print do |text = "Hello World!", out: $stdout|
+          Services::Print[text: text, out: out]
         end
       end
     end

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

@@ -8,7 +8,7 @@ module ConvenientService
           class AssertFileExists
             include ConvenientService::Standard::Config
 
-            attr_accessor :path
+            attr_reader :path
 
             def initialize(path:)
               @path = path

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

@@ -8,7 +8,7 @@ module ConvenientService
           class AssertFileNotEmpty
             include ConvenientService::Standard::Config
 
-            attr_accessor :path
+            attr_reader :path
 
             def initialize(path:)
               @path = path

data/lib/convenient_service/examples/standard/gemfile/services/assert_node_available.rb

@@ -13,15 +13,6 @@ module ConvenientService
           class AssertNodeAvailable
             include ConvenientService::Standard::Config
 
-            ##
-            # NOTE: `commit_config!` is used explicitly, since `step` method is NOT missed. It will be taken from `Turnip`.
-            # - https://github.com/jnicklas/turnip/blob/master/lib/turnip.rb#L29
-            # - https://github.com/jnicklas/turnip/blob/8272ef92902329d2d29bb5ba2b29cd431523478f/lib/turnip/define.rb#L3
-            #
-            # TODO: Troubleshooting guide.
-            #
-            commit_config!
-
             ##
             # NOTE: `> /dev/null 2>&1` is used to hide output.
             # https://unix.stackexchange.com/a/119650/394253

data/lib/convenient_service/examples/standard/gemfile.rb

@@ -13,10 +13,10 @@ module ConvenientService
   module Examples
     module Standard
       module Gemfile
-        class << self
-          def format(path)
-            Services::Format[path: path]
-          end
+        include ConvenientService::Feature
+
+        entry :format do |path|
+          Services::Format[path: path]
         end
       end
     end

data/lib/convenient_service/examples/standard/request_params.rb

@@ -37,10 +37,10 @@ module ConvenientService
   module Examples
     module Standard
       module RequestParams
-        class << self
-          def prepare(request)
-            Services::Prepare[request: request]
-          end
+        include ConvenientService::Feature
+
+        entry :prepare do |request|
+          Services::Prepare[request: request]
         end
       end
     end

data/lib/convenient_service/feature.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module Feature
+    include Support::Concern
+
+    included do
+      include Support::DependencyContainer::Entry
+      include Support::DependencyContainer::Export
+    end
+  end
+end

data/lib/convenient_service/logger.rb

@@ -23,15 +23,16 @@ module ConvenientService
       private
 
       ##
-      # NOTE: `super` is `Logger.new`.
-      # https://ruby-doc.org/stdlib-3.1.0/libdoc/logger/rdoc/Logger.html#method-c-new
+      # @internal
+      #   NOTE: `super` is `Logger.new`.
+      #   - https://ruby-doc.org/stdlib-3.1.0/libdoc/logger/rdoc/Logger.html#method-c-new
       #
       # rubocop:disable Style/GlobalStdStream
       def new
-        super(STDOUT).tap do |logger|
-          logger.level = ENV["ACTIVE_SERVICE_LOGGER_LEVEL"] || "INFO"
+        super(::STDOUT).tap do |logger|
+          logger.level = ::ENV["CONVENIENT_SERVICE_LOGGER_LEVEL"] || "INFO"
 
-          logger.formatter = colored_formatter if ENV["ACTIVE_SERVICE_LOGGER_ENABLE_COLORS"] == "true"
+          logger.formatter = colored_formatter if ::ENV["CONVENIENT_SERVICE_LOGGER_ENABLE_COLORS"] == "true"
         end
       end
       # rubocop:enable Style/GlobalStdStream

data/lib/convenient_service/rspec/helpers/custom/in_threads.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module ConvenientService
+  module RSpec
+    module Helpers
+      module Custom
+        # @internal
+        #   TODO: Specs.
+        #
+        class InThreads < Support::Command
+          ##
+          # @!attribute [r] n
+          #   @return [Integer] Amount of threads.
+          #
+          attr_reader :n
+
+          ##
+          # @!attribute [r] args
+          #   @return [Array<Object>] Args passed to `Thread.new`.
+          #
+          # @internal
+          #   NOTE: More info about `args`.
+          #   - https://ruby-doc.org/core-2.7.0/Thread.html#method-c-new
+          #
+          attr_reader :args
+
+          ##
+          # @!attribute [r] block
+          #   @return [Proc] Block passed to `Thread.new`.
+          #
+          # @internal
+          #   NOTE: More info about `block`.
+          #   - https://ruby-doc.org/core-2.7.0/Thread.html#method-c-new
+          #
+          attr_reader :block
+
+          ##
+          # @param n [Integer] Amount of threads.
+          # @param args [Array<Object>] Args passed to `Thread.new`.
+          # @param block [Proc, nil] Block passed to `Thread.new`.
+          # @return [void]
+          #
+          def initialize(n, *args, &block)
+            @n = n
+            @args = args
+            @block = block
+          end
+
+          ##
+          # @return [Array<Object>] Thread values. Can be any type.
+          #
+          # @internal
+          #   NOTE: `thread.value` calls `thread.join` under the hood. That is why it is missed here.
+          #   - https://ruby-doc.org/core-2.7.0/Thread.html#method-i-value
+          #
+          #   TODO: Thread pool? Why?
+          #   - https://github.com/toy/in_threads/blob/master/lib/in_threads.rb
+          #
+          def call
+            threads = []
+
+            ##
+            # NOTE: CRuby has GIL, so the specs are almost always successful for simple cases.
+            # NOTE: JRuby or TruffleRuby use real threads, so NOT thread-safe code starts to fail even for the simplest cases.
+            #
+            n.times { threads << ::Thread.new(*args, &block) }
+
+            threads.map(&:value)
+          end
+        end
+      end
+    end
+  end
+end