convenient_service 0.11.0 → 0.13.0

data/benchmark/has_committed_config/ips.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "convenient_service"
+require "benchmark/ips"
+
+##
+# Introduction.
+#
+# This benchmark is checking `.has_committed_config?`. As a result, keep in mind that everything in this file should be reviewed in its context.
+# For example, there is a class called `CurrentImplementation`. Actually, it is the `ImplementationWithoutMemoizationOfHasCommittedConfigInService`.
+# Or `WithMemoizationInService` - means `ImplementationWithMemoizationOfHasCommittedConfigInService`, etc.
+#
+# For the current implementation source, see `ConvenientService::Core::Concern::ClassMethods#has_committed_config?`.
+##
+
+class CurrentImplementation
+  include ConvenientService::Standard::Config
+end
+
+class WithMemoizationInService
+  include ConvenientService::Standard::Config
+
+  class << self
+    def has_committed_config?
+      @__convenient_service_has_committed_config__ ||= super
+    end
+  end
+end
+
+##
+# Warmup.
+#
+implementations = [CurrentImplementation, WithMemoizationInService]
+
+implementations.each(&:commit_config!)
+
+##
+# Benchmarking of iterations per second.
+#
+Benchmark.ips do |x|
+  x.time = 5 # Seconds.
+  x.warmup = 0 # No additional warmup required. It is already performed outside.
+
+  x.report("`.has_committed_config?` - No memoization in service") { CurrentImplementation.has_committed_config? }
+  x.report("`.has_committed_config?` - Memoization in service") { WithMemoizationInService.has_committed_config? }
+
+  x.compare!(order: :baseline)
+end
+
+##
+# Example result.
+#
+# Calculating -------------------------------------
+# `.has_committed_config?` - No memoization in service
+#                         131.142k (± 8.9%) i/s -    220.039k in   1.777241s
+# `.has_committed_config?` - Memoization in service
+#                         131.319k (±10.5%) i/s -    216.215k in   1.763880s
+
+# Comparison:
+# `.has_committed_config?` - No memoization in service:   131142.1 i/s
+# `.has_committed_config?` - Memoization in service:   131319.1 i/s - same-ish: difference falls within error
+##
+
+##
+# Summary.
+#
+# It is one of the Convenient Service design goals to NOT pollute the end-user public interface with extra private methods, instance variables, etc.
+# Since memoization does NOT bring too big performance improvement, no extra instance variables are introduced.
+##
+
+##
+# More info.
+# - https://johnnunemaker.com/how-to-benchmark-your-ruby-gem
+# - https://github.com/evanphx/benchmark-ips
+# - https://rubydoc.info/gems/benchmark-ips/Benchmark/Compare
+# - https://en.wikipedia.org/wiki/Standard_deviation
+##

data/benchmark/has_committed_config/profile.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "convenient_service"
+require "stackprof"
+
+class Service
+  include ConvenientService::Standard::Config
+end
+
+Service.commit_config!
+
+##
+# Quotes:
+# - stackprof will tell you what is impeding your progress.
+# - The assumption is the more times something shows up in the sample the more time it is taking.
+#
+# Docs:
+# - https://www.johnnunemaker.com/how-to-benchmark-your-ruby-gem
+# - https://github.com/tmm1/stackprof
+#
+profile = StackProf.run(mode: :wall, interval: 1_000) do
+  2_000_000.times { Service.has_committed_config? }
+end
+
+result = StackProf::Report.new(profile)
+puts
+result.print_text
+puts "\n\n\n"
+result.print_method(/has_committed_config?/)

data/convenient_service.gemspec

@@ -3,6 +3,13 @@
 require_relative "lib/convenient_service/specification"
 require_relative "lib/convenient_service/version"
 
+##
+# NOTE:
+#   - Use `ConvenientService::Support::Ruby.jruby?` directly only in the files that do not require to load all dependencies.
+#   - Prefer `ConvenientService::Dependencies.ruby.jruby?` for the rest of the files.
+#
+require_relative "lib/convenient_service/support/ruby"
+
 Gem::Specification.new do |spec|
   spec.name = ConvenientService::Specification::NAME
   spec.authors = ConvenientService::Specification::AUTHORS
@@ -29,27 +36,179 @@ Gem::Specification.new do |spec|
 
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "appraisal"
+  ##
+  # Used to run specs with multiple versions of gems.
+  # - https://github.com/thoughtbot/appraisal
+  #
+  spec.add_development_dependency "appraisal", "~> 2.5.0"
+
   spec.add_development_dependency "awesome_print"
-  spec.add_development_dependency "byebug", "~> 10.0"
-  spec.add_development_dependency "commonmarker"
+
+  ##
+  # Used for benchmarking (iteration per second). See `benchmark` directory.
+  # - https://github.com/evanphx/benchmark-ips
+  # - https://www.johnnunemaker.com/how-to-benchmark-your-ruby-gem
+  #
+  spec.add_development_dependency "benchmark-ips", "~> 2.12.0"
+
+  ##
+  # Used for debugging any Ruby code (CRuby, JRuby, etc), since it written in plain Ruby.
+  # Has minimalistic interface.
+  # Does NOT support frame filtering.
+  # - https://github.com/gsamokovarov/break
+  #
+  spec.add_development_dependency "break"
+
+  ##
+  # Used for debugging CRuby code.
+  # Check `debug` if you need frame filtering.
+  # Check `break` if you need to debug JRuby.
+  # - https://github.com/deivid-rodriguez/byebug
+  #
+  # 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
+  #
+  spec.add_development_dependency "byebug", "~> 10.0" unless ConvenientService::Support::Ruby.jruby?
+
+  ##
+  # NOTE: `commonmarker` has C extensions, that is why it is NOT supported in JRuby.
+  # - https://github.com/gjtorikian/commonmarker/tree/main/ext/commonmarker
+  #
+  spec.add_development_dependency "commonmarker" unless ConvenientService::Support::Ruby.jruby?
+
+  ##
+  # Used for debugging CRuby code.
+  # Has almost the same public API as `byebug`, but supports frame filtering.
+  # Check `break` if you need to debug JRuby.
+  # - https://github.com/ruby/debug
+  # - https://st0012.dev/from-byebug-to-ruby-debug
+  # - https://st0012.dev/from-byebug-to-ruby-debug#heading-configuration
+  # - https://github.com/ruby/debug#configuration
+  # - ENV["RUBY_DEBUG_SKIP_PATH"]
+  #
+  # NOTE: `debug` has C extensions, that is why it is NOT supported in JRuby.
+  # - https://github.com/ruby/debug/tree/master/ext/debug
+  #
+  spec.add_development_dependency "debug" unless ConvenientService::Support::Ruby.jruby?
+
   spec.add_development_dependency "faker"
+
   spec.add_development_dependency "gem-release"
+
   spec.add_development_dependency "inch"
+
   spec.add_development_dependency "json"
+
+  ##
+  # Used for memory profiling of Ruby code.
+  # - https://github.com/SamSaffron/memory_profiler
+  # - https://thoughtbot.com/blog/a-crash-course-in-analyzing-memory-usage-in-ruby
+  #
+  spec.add_development_dependency "memory_profiler"
+
+  ##
+  # Used for testing Ruby code outside RSpec.
+  # - https://github.com/minitest/minitest
+  # - https://semaphoreci.com/community/tutorials/getting-started-with-minitest
+  # - https://cloudbees.com/blog/getting-started-with-minitest
+  #
+  spec.add_development_dependency "minitest", "~> 5.18.0"
+
+  ##
+  # Used for mutation testing of Ruby code.
+  # - https://github.com/mbj/mutant
+  # - https://github.com/mbj/mutant/blob/main/docs/nomenclature.md
+  # - https://github.com/mbj/mutant/blob/main/docs/mutant-rspec.md
+  # - https://github.com/mbj/mutant/blob/main/docs/incremental.md
+  #
+  spec.add_development_dependency "mutant", "~> 0.11.21"
+  spec.add_development_dependency "mutant-rspec", "~> 0.11.21"
+
+  ##
+  # Used for coloring logs.
+  # - https://github.com/janlelis/paint
+  #
   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"
+
+  ##
+  # Used for testing Ruby code.
+  # https://rspec.info
+  #
   spec.add_development_dependency "rspec", "~> 3.11.0"
-  spec.add_development_dependency "rubocop", "~> 1.40.0"
-  spec.add_development_dependency "rubocop-rspec"
+
+  ##
+  # Used for performance testing with RSpec.
+  # https://github.com/piotrmurach
+  #
+  spec.add_development_dependency "rspec-benchmark", "~> 0.6.0"
+
+  ##
+  # Used for linting Ruby files.
+  # https://github.com/rubocop/rubocop
+  #
+  spec.add_development_dependency "rubocop", "~> 1.52.0"
+
+  ##
+  # Used as a set of rules for rubocop for linting RSpec files.
+  # https://github.com/rubocop/rubocop-rspec
+  #
+  spec.add_development_dependency "rubocop-rspec", "~> 2.22.0"
+
   spec.add_development_dependency "tty-prompt"
-  spec.add_development_dependency "standard"
+
+  ##
+  # Used as a set of rules for robocop for linting source files.
+  # https://github.com/testdouble/standard
+  #
+  spec.add_development_dependency "standard", "~> 1.30.1"
+
   spec.add_development_dependency "simplecov"
+
   spec.add_development_dependency "simplecov-lcov"
+
+  ##
+  # Used to have a simplified public API of minitest.
+  # - https://github.com/thoughtbot/shoulda-context
+  #
+  spec.add_development_dependency "shoulda-context", "~> 2.0.0"
+
+  ##
+  # Used for benchmarking (call-stack profiler). See `benchmark` directory.
+  # - https://github.com/tmm1/stackprof
+  # - https://www.johnnunemaker.com/how-to-benchmark-your-ruby-gem
+  #
+  spec.add_development_dependency "stackprof", "~> 0.2.25" unless ConvenientService::Support::Ruby.jruby?
+
   spec.add_development_dependency "webrick"
+
   spec.add_development_dependency "yard", "~> 0.9.28"
+
   spec.add_development_dependency "yard-junk"
+
+  ##
+  # The following gems are Convenient Service alternatives.
+  # Used for performance comparisons.
+  # See `benchmark/empty_service`.
+  # - https://github.com/sunny/actor
+  # - https://github.com/collectiveidea/interactor
+  # - https://github.com/trailblazer/trailblazer-operation
+  # - https://github.com/AaronLasseigne/active_interaction
+  # - https://github.com/adomokos/light-service
+  # - https://github.com/cypriss/mutations
+  #
+  spec.add_development_dependency "service_actor", "~> 3.7.0"
+  spec.add_development_dependency "interactor", "~> 3.1.2"
+  spec.add_development_dependency "trailblazer-operation", "~> 0.10.1"
+  spec.add_development_dependency "active_interaction", "~> 5.3.0"
+  spec.add_development_dependency "light-service", "~> 0.18.0"
+  spec.add_development_dependency "mutations", "~> 0.9.1"
 end

data/docker/2.7/Dockerfile

@@ -3,7 +3,7 @@
 #
 # NOTE: Linted by hadolint.
 #
-#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/3.0/Dockerfile
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/2.7/Dockerfile
 #
 # NOTE: A command to build image.
 #
@@ -21,12 +21,12 @@
 # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
 # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
 # That is why a `slim` version is used instead of `alpine`.
-# Also `slim` is more similar to Ubuntu used in CI.
+# Also `slim` is more similar to Ubuntu.
 # - https://github.com/timbru31/docker-ruby-node/tree/master/2.7/16
 # - https://medium.com/swlh/alpine-slim-stretch-buster-jessie-bullseye-bookworm-what-are-the-differences-in-docker-62171ed4531d
 # - https://hub.docker.com/r/timbru31/ruby-node/tags
 #
-# NOTE: Gallium means Node.js 16.x
+# NOTE: Gallium means Node.js 16.x.
 # https://github.com/nodejs/Release
 #
 FROM timbru31/ruby-node:2.7-slim-gallium

data/docker/3.0/Dockerfile

@@ -21,12 +21,12 @@
 # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
 # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
 # That is why a `slim` version is used instead of `alpine`.
-# Also `slim` is more similar to Ubuntu used in CI.
+# Also `slim` is more similar to Ubuntu.
 # - https://github.com/timbru31/docker-ruby-node/tree/master/3.0/16
 # - https://medium.com/swlh/alpine-slim-stretch-buster-jessie-bullseye-bookworm-what-are-the-differences-in-docker-62171ed4531d
 # - https://hub.docker.com/r/timbru31/ruby-node/tags
 #
-# NOTE: Gallium means Node.js 16.x
+# NOTE: Gallium means Node.js 16.x.
 # https://github.com/nodejs/Release
 #
 FROM timbru31/ruby-node:3.0-slim-gallium

data/docker/3.1/Dockerfile

@@ -21,12 +21,12 @@
 # NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
 # In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
 # That is why a `slim` version is used instead of `alpine`.
-# Also `slim` is more similar to Ubuntu used in CI.
+# Also `slim` is more similar to Ubuntu.
 # - https://github.com/timbru31/docker-ruby-node/tree/master/3.1/16
 # - https://medium.com/swlh/alpine-slim-stretch-buster-jessie-bullseye-bookworm-what-are-the-differences-in-docker-62171ed4531d
 # - https://hub.docker.com/r/timbru31/ruby-node/tags
 #
-# NOTE: Gallium means Node.js 16.x
+# NOTE: Gallium means Node.js 16.x.
 # https://github.com/nodejs/Release
 #
 FROM timbru31/ruby-node:3.1-slim-gallium

data/docker/3.2/Dockerfile

@@ -0,0 +1,73 @@
+##
+# Ruby 3.2 with Node.js 16.x.
+#
+# NOTE: Linted by hadolint.
+#
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/3.2/Dockerfile
+#
+# NOTE: A command to build image.
+#
+#   cd convenient_service
+#   cp Gemfile Gemfile.3.2
+#   docker build . -f docker/3.2/Dockerfile -t convenient_service:3.2
+#   # or `task docker:build:ruby_3.2`
+#
+# NOTE: A command to run bash in container.
+#
+#   cd convenient_service
+#   docker run --rm -it -v $(pwd):/gem convenient_service:3.2 bash
+#   # or `task docker:bash:ruby_3.2`
+#
+# NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
+# In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
+# That is why a `slim` version is used instead of `alpine`.
+# Also `slim` is more similar to Ubuntu.
+# - https://github.com/timbru31/docker-ruby-node/tree/master/3.2/16
+# - https://medium.com/swlh/alpine-slim-stretch-buster-jessie-bullseye-bookworm-what-are-the-differences-in-docker-62171ed4531d
+# - https://hub.docker.com/r/timbru31/ruby-node/tags
+#
+# NOTE: Gallium means Node.js 16.x.
+# https://github.com/nodejs/Release
+#
+FROM timbru31/ruby-node:3.2-slim-gallium
+
+##
+# NOTE: `bundle install` dependencies.
+#
+RUN apt-get update -qq \
+  && apt-get install --no-install-recommends -y git \
+  && apt-get install --no-install-recommends -y make \
+  && apt-get install --no-install-recommends -y gcc \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+RUN mkdir -p /gem
+
+WORKDIR /gem
+
+COPY . /gem
+
+##
+# NOTE: Every container has its own copy of `Gemfile`. This way a developer doesn't need to delete `Gemfile.lock` all the time when changing containers.
+# - https://docs.docker.com/engine/reference/builder/#env
+# - https://stackoverflow.com/questions/48863711/is-it-possible-to-override-gemfile-for-local-development
+#
+ENV BUNDLE_GEMFILE=Gemfile.3.2
+
+RUN bundle install
+
+RUN bundle exec appraisal install
+
+##
+# NOTE: Installs `task`.
+# https://taskfile.dev/installation/#install-script
+#
+# NOTE: `task` is installed into `~/bin`. That is why `-b /bin` is used. See `echo ${PATH}` to debug.
+#
+RUN sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b /bin
+
+##
+# NOTE: Is used to check whether a command is executed inside a Docker container. See Rakefile for examples.
+# https://stackoverflow.com/a/65942222/12201472
+#
+ENV IN_DOCKER_CONTAINER=true

data/docker/jruby-9.4/Dockerfile

@@ -0,0 +1,88 @@
+##
+# JRuby 9.4 (CRuby 3.1 compatible) with Node.js 16.x.
+# - https://www.jruby.org/download
+#
+# NOTE: Linted by hadolint.
+#
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/jruby-9.4/Dockerfile
+#
+# NOTE: A command to build image.
+#
+#   cd convenient_service
+#   cp Gemfile Gemfile.jruby-9.4
+#   docker build . -f docker/jruby-9.4/Dockerfile -t convenient_service:jruby-9.4
+#   # or `task docker:build:jruby_9.4`
+#
+# NOTE: A command to run bash in container.
+#
+#   cd convenient_service
+#   docker run --rm -it -v $(pwd):/gem convenient_service:jruby-9.4 bash
+#   # or `task docker:bash:jruby_9.4`
+#
+# NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
+# In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
+# `jruby:9.4` uses Ubuntu under the hood.s
+# - https://hub.docker.com/_/jruby/tags
+# - https://github.com/jruby/docker-jruby/blob/master/9.4/jre8/Dockerfile
+# - https://github.com/adoptium/containers/blob/main/19/jdk/ubuntu/jammy/Dockerfile.releases.full#L20
+#
+# NOTE: Gallium means Node.js 16.x.
+# https://github.com/nodejs/Release
+#
+FROM jruby:9.4
+
+##
+# NOTE: `git` is `bundle install` dependency.
+#
+# NOTE: `curl` and `gnupg2` are Node.js 16.x dependencies.
+# https://github.com/timbru31/docker-ruby-node/blob/master/3.2/16/slim/Dockerfile
+#
+RUN apt-get update -qq \
+  && apt-get install --no-install-recommends -y git \
+  && apt-get install --no-install-recommends -y curl \
+  && apt-get install --no-install-recommends -y gnupg2 \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+RUN mkdir -p /gem
+
+WORKDIR /gem
+
+COPY . /gem
+
+##
+# NOTE: Every container has its own copy of `Gemfile`. This way a developer doesn't need to delete `Gemfile.lock` all the time when changing containers.
+# - https://docs.docker.com/engine/reference/builder/#env
+# - https://stackoverflow.com/questions/48863711/is-it-possible-to-koverride-gemfile-for-local-development
+#
+ENV BUNDLE_GEMFILE=Gemfile.jruby-9.4
+
+RUN bundle install
+
+RUN bundle exec appraisal install
+
+##
+# NOTE: Installs `task`.
+# https://taskfile.dev/installation/#install-script
+#
+# NOTE: `task` is installed into `~/bin`. That is why `-b /bin` is used. See `echo ${PATH}` to debug.
+#
+RUN sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b /bin
+
+##
+# NOTE: Intalls Node.js 16.x and `yarn`.
+# https://github.com/timbru31/docker-ruby-node/blob/master/3.2/16/slim/Dockerfile
+#
+RUN curl -sL https://deb.nodesource.com/setup_16.x | bash -\
+  && apt-get update -qq \
+  && apt-get install -qq --no-install-recommends nodejs \
+  && apt-get upgrade -qq \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*\
+  && npm install -g yarn@1
+
+##
+# NOTE: Is used to check whether a command is executed inside a Docker container. See Rakefile for examples.
+# https://stackoverflow.com/a/65942222/12201472
+#
+ENV IN_DOCKER_CONTAINER=true

data/docker/truffleruby-22.3/Dockerfile

@@ -0,0 +1,91 @@
+##
+# TruffleRuby 22.3 (CRuby 3.1 compatible) with Node.js 16.x.
+# - https://github.com/graalvm/container/blob/master/truffleruby/README.md
+# - https://github.com/oracle/truffleruby/blob/master/doc/user/compatibility.md
+#
+# NOTE: Linted by hadolint.
+#
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/truffleruby-22.3/Dockerfile
+#
+# NOTE: A command to build image.
+#
+#   cd convenient_service
+#   cp Gemfile Gemfile.truffleruby-22.3
+#   docker build . -f docker/truffleruby-22.3/Dockerfile -t convenient_service:truffleruby-22.3
+#   # or `task docker:build:jruby_9.4`
+#
+# NOTE: A command to run bash in container.
+#
+#   cd convenient_service
+#   docker run --rm -it -v $(pwd):/gem convenient_service:truffleruby-22.3 bash
+#   # or `task docker:bash:jruby_9.4`
+#
+# NOTE: If there are no memory, performance, or cost constraints, prefer to use as standard Linux distribution as it is possible.
+# In a general case, you simply won't have enough time to resolve all the "quirks" of more specific distributions if you are an application developer.
+# `ghcr.io/graalvm/truffleruby:debian-22.3` uses Debian (that is similar to Ubuntu) under the hood.
+# - https://github.com/graalvm/container/pkgs/container/truffleruby/65464856?tag=debian-22.3
+# - https://github.com/graalvm/container/blob/master/truffleruby/Dockerfile.debian#L6
+# - https://www.graalvm.org/latest/docs/getting-started/container-images/
+#
+# NOTE: Gallium means Node.js 16.x.
+# https://github.com/nodejs/Release
+#
+FROM ghcr.io/graalvm/truffleruby:debian-22.3
+
+##
+# NOTE: `git`, `make`, `gcc` are `bundle install` dependencies.
+#
+# NOTE: `curl` and `gnupg2` are Node.js 16.x dependencies.
+# https://github.com/timbru31/docker-ruby-node/blob/master/3.2/16/slim/Dockerfile
+#
+RUN apt-get update -qq \
+  && apt-get install --no-install-recommends -y git \
+  && apt-get install --no-install-recommends -y make \
+  && apt-get install --no-install-recommends -y gcc \
+  && apt-get install --no-install-recommends -y curl \
+  && apt-get install --no-install-recommends -y gnupg2 \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*
+
+RUN mkdir -p /gem
+
+WORKDIR /gem
+
+COPY . /gem
+
+##
+# NOTE: Every container has its own copy of `Gemfile`. This way a developer doesn't need to delete `Gemfile.lock` all the time when changing containers.
+# - https://docs.docker.com/engine/reference/builder/#env
+# - https://stackoverflow.com/questions/48863711/is-it-possible-to-koverride-gemfile-for-local-development
+#
+ENV BUNDLE_GEMFILE=Gemfile.truffleruby-22.3
+
+RUN bundle install
+
+RUN bundle exec appraisal install
+
+##
+# NOTE: Installs `task`.
+# https://taskfile.dev/installation/#install-script
+#
+# NOTE: `task` is installed into `~/bin`. That is why `-b /bin` is used. See `echo ${PATH}` to debug.
+#
+RUN sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b /bin
+
+##
+# NOTE: Intalls Node.js 16.x and `yarn`.
+# https://github.com/timbru31/docker-ruby-node/blob/master/3.2/16/slim/Dockerfile
+#
+RUN curl -sL https://deb.nodesource.com/setup_16.x | bash -\
+  && apt-get update -qq \
+  && apt-get install -qq --no-install-recommends nodejs \
+  && apt-get upgrade -qq \
+  && apt-get clean \
+  && rm -rf /var/lib/apt/lists/*\
+  && npm install -g yarn@1
+
+##
+# NOTE: Is used to check whether a command is executed inside a Docker container. See Rakefile for examples.
+# https://stackoverflow.com/a/65942222/12201472
+#
+ENV IN_DOCKER_CONTAINER=true

data/lib/convenient_service/alias.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+CS = ::ConvenientService

data/lib/convenient_service/aliases.rb

@@ -9,8 +9,4 @@ module ConvenientService
   Command = ::ConvenientService::Support::Command
   Concern = ::ConvenientService::Support::Concern
   DependencyContainer = ::ConvenientService::Support::DependencyContainer
-
-  ClassicMiddleware = ::ConvenientService::Core::Entities::ClassicMiddleware
-  ConcernMiddleware = ::ConvenientService::Core::Entities::Config::Entities::Concerns::Entities::Middleware
-  MethodChainMiddleware = ::ConvenientService::Core::Entities::Config::Entities::MethodMiddlewares::Entities::Middleware
 end

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

@@ -3,6 +3,5 @@
 module ConvenientService
   module Plugins
     Common = ::ConvenientService::Common::Plugins
-    Internals = ::ConvenientService::Common::Plugins::HasInternals::Entities::Internals::Plugins
   end
 end