convenient_service 0.1.0

data/ROADMAP.md

@@ -0,0 +1,41 @@
+# Roadmap
+
+| Priority | Status | Goal | Notes |
+| - | - | - | - |
+| High | ✅ | 100% coverage of `Core` | |
+| Medium | 🚧 | Type signatures for the whole codebase ([Yard @param, @overload, @return](https://rubydoc.info/gems/yard/file/docs/Tags.md#taglist)) | |
+| Medium | 🚧 | `Service.success?` shortcut for `Service.result.success?` | |
+| Medium | 🚧 | Release `v0.1.0` with a warning that lib is still under heavy development | |
+| Medium | 🚧 | [Active Record transaction](https://api.rubyonrails.org/classes/ActiveRecord/Transactions/ClassMethods.html) examples | |
+| Low | 🚧 | [Capybara](https://github.com/teamcapybara/capybara) examples | |
+| Low | 🚧 | [Thread.current](https://ruby-doc.org/core-3.1.2/Thread.html#method-c-current) to cache repetable nested steps during an organizer invocation | |
+| Medium | 🚧 | Inline step sequence | |
+| High | 🚧 | Move callbacks to internals | |
+| Low | 🚧 | Create an example of `id_or_record` [attribute](https://api.rubyonrails.org/classes/ActiveRecord/Attributes/ClassMethods.html) |
+| Low | 🚧 | GitHub Wiki/Gists for Support | |
+| Low | 🚧 | Contribute to Shoulda Matchers | |
+| High | ✅ | `respond_to_missing?` | [ConvenientService::Core::ClassMethods#respond_to_missing?](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/core/class_methods.rb#L105), [ConvenientService::Core::InstanceMethods#respond_to_missing?](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/core/instance_methods.rb#L30) |
+| High | ⏳ | Custom matcher to track `ConvenientService::Logger` messages | |
+| Medium | 🚧 | Remove `respond_to?` from `Copyable` | Investigate before making any decision |
+| High | 🚧 | Unified `inspect` | |
+| High | ✅ | Remove race condition for `method_missing` | https://github.com/marian13/convenient_service/pull/5 |
+| High | ✅ | Remove incompatiility of [Module#include](https://gist.github.com/marian13/9c25041f835564e945d978839097d419) | https://github.com/marian13/convenient_service/pull/3 |
+| Medium | ✅ | Split `Utils` specs into separate files | [convenient_service/spec/lib/convenient_service/utils](https://github.com/marian13/convenient_service/tree/main/spec/lib/convenient_service/utils) |
+| Medium | 🚧 | How to test thread-safety? | |
+| Medium | ✅ | Rename `Utils::Module.find_own_const` to `Utils::Module.get_own_const` | [ConvenientService::Utils::Module::GetOwnConst](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/utils/module/get_own_const.rb) |
+| Medium | 🚧 | Mark `@api private` methods, classes | [YARD Tags](https://www.rubydoc.info/gems/yard/file/docs/Tags.md) |
+| Medium | ✅ | A way to check if block has one required positional argument | [#proc_has_one_positional_argument?](https://github.com/marian13/convenient_service/blob/main/lib/convenient_service/utils/proc/exec_config.rb#L96) |
+| Medium | 🚧 | Factories for POROs in specs | |
+| Low | 🚧 | Define method middleware caller with visibility | |
+| Low | 🚧 | Dependency containers to remove high coupling | |
+| Low | 🚧 | Measure performance | |
+| Low | 🚧 | Rewrite middleware backend to count [convenient_service](https://github.com/marian13/convenient_service) specifics | |
+| 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 ❗❗❗ | |
+| 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 | |
+| Medium | 🚧 | Move `Cache` to `Support` | |
+| Medium | 🚧 | Statically specify plugin dependencies | |

data/Rakefile

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+##
+# NOTE: Why not `bin` folder? It has a different purpose. It should contain "binaries/executables" that can be used by the end user.
+# Search for `bin` in the following links for more info.
+# - https://guides.rubygems.org/what-is-a-gem/
+# - https://guides.rubygems.org/faqs/
+#
+task :confirm do
+  require "tty-prompt"
+
+  ##
+  # NOTE: `ARGV[0]` contains `confirm` (this task name).
+  #
+  message = ARGV[1] || "Are you sure?"
+
+  ##
+  # NOTE: Why "tty-prompt"? No time to write, maintain complex, cross-platform bash scripts if you are a full-time application developer.
+  #
+  prompt = TTY::Prompt.new
+
+  ##
+  # NOTE: `prompt.yes?` docs.
+  # https://github.com/piotrmurach/tty-prompt#25-yesno
+  #
+  yes = prompt.yes?(message)
+
+  ##
+  # NOTE: Use `echo $?` to debug exit code (0 means ok, 1 - error).
+  #
+  yes ? exit(0) : exit(1)
+end
+
+task :playground do
+  require "irb"
+
+  require_relative "env"
+
+  require "convenient_service"
+
+  require_relative "spec/support/convenient_service"
+  require_relative "spec/support/convenient_service/rails" if ENV["APPRAISAL_NAME"] == "all" || ENV["APPRAISAL_NAME"].include?("rails")
+  require_relative "spec/support/convenient_service/dry" if ENV["APPRAISAL_NAME"] == "all" || ENV["APPRAISAL_NAME"].include?("dry")
+
+  ##
+  # NOTE: Clears `ARGV` since both `rake` and `irb` uses it.
+  # https://stackoverflow.com/a/2876645/12201472
+  #
+  ARGV.clear
+
+  IRB.start(__FILE__)
+end

data/Taskfile.yml

@@ -0,0 +1,316 @@
+version: '3'
+
+##
+# IMPORTANT: All tasks listed in this file should be executed from the root folder.
+# https://taskfile.dev/usage/#task-directory
+#
+# NOTE: Examples of multiline strings in YAML.
+# https://yaml-multiline.info/
+#
+# NOTE: Use `[ "${IN_DOCKER_CONTAINER}" == "true" ] && echo true || echo false` to debug ``[ "${IN_DOCKER_CONTAINER}" == "true" ]`.
+#
+# NOTE: Forwarding CLI arguments to commands ({{.CLI_ARGS}}).
+# https://taskfile.dev/usage/#forwarding-cli-arguments-to-commands
+#
+tasks:
+  default:
+    cmds:
+      - task: rspec
+
+  coverage:lcov:merge:
+    cmds:
+      - npx --yes lcov-result-merger 'coverage/**/lcov.info' coverage/lcov.info
+
+  coverage:open:
+    cmds:
+      - open coverage/index.html
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  deps:
+    cmds:
+      - task: deps:install
+
+  deps:install:
+    cmds:
+      - bundle install
+      - bundle exec appraisal install
+
+  deps:clean:
+    cmds:
+      - "bundle exec rake confirm \"This task removes Gemfile*.lock and gemfiles/**/*. Are you sure?\""
+      - rm Gemfile*.lock
+      - rm -rf gemfiles
+
+  docker:bash:ruby_2.7:
+    cmds:
+      - docker run --rm -it -v $(pwd):/gem convenient_service:2.7 bash
+    interactive: true
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  docker:bash:ruby_3.0:
+    cmds:
+      - docker run --rm -it -v $(pwd):/gem convenient_service:3.0 bash
+    interactive: true
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  docker:bash:ruby_3.1:
+    cmds:
+      - docker run --rm -it -v $(pwd):/gem convenient_service:3.1 bash
+    interactive: true
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  docker:build:
+    cmds:
+      - task: docker:build:ruby_2.7
+      - task: docker:build:ruby_3.0
+      - task: docker:build:ruby_3.1
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  docker:build:ruby_2.7:
+    cmds:
+      - docker build . -f docker/2.7/Dockerfile -t convenient_service:2.7
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  docker:build:ruby_3.0:
+    cmds:
+      - docker build . -f docker/3.0/Dockerfile -t convenient_service:3.0
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  docker:build:ruby_3.1:
+    cmds:
+      - docker build . -f docker/3.1/Dockerfile -t convenient_service:3.1
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  ##
+  # NOTE: `sdoc` (wrapper for `rdoc`) is replaced by `yard`, since you have a feeling like every time is a first time with `rdoc`.
+  # - https://kapeli.com/cheat_sheets/Yard.docset/Contents/Resources/Documents/index
+  # - https://rubydoc.info/gems/yard/file/README.md
+  # - `yardoc --help`
+  #
+  # NOTE: `commonmarker` supports GitHub Flavored Markdown.
+  # - https://github.com/gjtorikian/commonmarker
+  # - https://github.github.com/gfm/
+  # - https://github.com/github/markup#markups
+  # - https://github.com/lsegal/yard/pull/1388
+  #
+  # TODO: Contribute. Forward `--parse-option LIBERAL_HTML_TAG` to commonmarker.
+  #
+  # NOTE: options are specified in the `.yardopts` file.
+  #
+  docs:generate:
+    cmds:
+      - bundle exec yardoc
+
+  docs:generate:open:
+    cmds:
+      - task: docs:generate
+      - task: docs:open
+
+  docs:lint:
+    cmds:
+      - mkdir -p docs
+      - bundle exec yard-junk --text --html docs/junk-yard.html
+
+  docs:missed:
+    cmds:
+      ##
+      # NOTE: Options are taken from `.inch.yml`.
+      #
+      - bundle exec inch
+
+  docs:open:
+    cmds:
+      - open docs/index.html
+    preconditions:
+      - sh: '[ "${IN_DOCKER_CONTAINER}" != "true" ]'
+        msg: This task can be invoked only from the host operating system (https://www.ibm.com/cloud/learn/containerization)
+
+  ##
+  # NOTE: A trailing "/**" matches everything inside.
+  # https://git-scm.com/docs/gitignore
+  #
+  git:staged:specs:
+    cmds:
+      - git diff --cached --name-only --diff-filter=d "spec/**"
+
+  lint:
+    cmds:
+      - task: rubocop
+      - task: docs:lint
+
+  playground:
+    cmds:
+      - bundle exec rake playground
+    interactive: true
+
+  playground:all:
+    cmds:
+      - bundle exec appraisal all rake playground
+    interactive: true
+
+  playground:dry:
+    cmds:
+      - bundle exec appraisal dry rake playground
+    interactive: true
+
+  playground:rails_5.2:
+    cmds:
+      - bundle exec appraisal rails_5.2 rake playground
+    interactive: true
+
+  playground:rails_6.0:
+    cmds:
+      - bundle exec appraisal rails_6.0 rake playground
+    interactive: true
+
+  playground:rails_6.1:
+    cmds:
+      - bundle exec appraisal rails_6.1 rake playground
+    interactive: true
+
+  playground:rails_7.0:
+    cmds:
+      - bundle exec appraisal rails_7.0 rake playground
+    interactive: true
+
+  playground:standard:
+    cmds:
+      - bundle exec rake playground
+    interactive: true
+
+  release:major:
+    cmds:
+      - gem bump convenient_service --version major
+
+  release:minor:
+    cmds:
+      - gem bump convenient_service --version minor
+
+  release:patch:
+    cmds:
+      - gem bump convenient_service --version patch
+
+  rspec:
+    cmds:
+      - task: rspec:standard
+      - task: rspec:rails_5.2
+      - task: rspec:rails_6.0
+      - task: rspec:rails_6.1
+      - task: rspec:rails_7.0
+      - task: rspec:dry
+
+  ##
+  # NOTE: Run rspec only for git staged spec files.
+  # https://githowto.com/staging_and_committing
+  #
+  rspec:staged:
+    cmds:
+      - task: rspec:standard:staged
+      - task: rspec:rails_5.2:staged
+      - task: rspec:rails_6.0:staged
+      - task: rspec:rails_6.1:staged
+      - task: rspec:rails_7.0:staged
+      - task: rspec:dry:staged
+
+  rspec:dry:
+    cmds:
+      - bundle exec appraisal dry rspec --format progress --require dry_helper {{.GIT_STAGED_SPEC_FILES}} {{.CLI_ARGS}}
+
+  rspec:dry:staged:
+    - task: rspec:dry
+      vars:
+        GIT_STAGED_SPEC_FILES:
+          ##
+          # NOTE: `task: git:staged:specs` does NOT work.
+          #
+          sh: task git:staged:specs --silent
+
+  rspec:rails_5.2:
+    cmds:
+      - bundle exec appraisal rails_5.2 rspec --format progress --require rails_helper {{.GIT_STAGED_SPEC_FILES}} {{.CLI_ARGS}}
+
+  rspec:rails_5.2:staged:
+    - task: rspec:rails_5.2
+      vars:
+        GIT_STAGED_SPEC_FILES:
+          ##
+          # NOTE: `task: git:staged:specs` does NOT work.
+          #
+          sh: task git:staged:specs --silent
+
+  rspec:rails_6.0:
+    cmds:
+      - bundle exec appraisal rails_6.0 rspec --format progress --require rails_helper {{.GIT_STAGED_SPEC_FILES}} {{.CLI_ARGS}}
+
+  rspec:rails_6.0:staged:
+    - task: rspec:rails_6.0
+      vars:
+        GIT_STAGED_SPEC_FILES:
+          ##
+          # NOTE: `task: git:staged:specs` does NOT work.
+          #
+          sh: task git:staged:specs --silent
+
+  rspec:rails_6.1:
+    cmds:
+      - bundle exec appraisal rails_6.1 rspec --format progress --require rails_helper {{.GIT_STAGED_SPEC_FILES}} {{.CLI_ARGS}}
+
+  rspec:rails_6.1:staged:
+    - task: rspec:rails_6.1
+      vars:
+        GIT_STAGED_SPEC_FILES:
+          ##
+          # NOTE: `task: git:staged:specs` does NOT work.
+          #
+          sh: task git:staged:specs --silent
+
+  rspec:rails_7.0:
+    cmds:
+      - bundle exec appraisal rails_7.0 rspec --format progress --require rails_helper {{.GIT_STAGED_SPEC_FILES}} {{.CLI_ARGS}}
+
+  rspec:rails_7.0:staged:
+    - task: rspec:rails_7.0
+      vars:
+        GIT_STAGED_SPEC_FILES:
+          ##
+          # NOTE: `task: git:staged:specs` does NOT work.
+          #
+          sh: task git:staged:specs --silent
+
+  rspec:standard:
+    cmds:
+      - bundle exec rspec --format progress {{.GIT_STAGED_SPEC_FILES}} {{.CLI_ARGS}}
+
+  rspec:standard:staged:
+    cmds:
+      - task: rspec:standard
+        vars:
+          GIT_STAGED_SPEC_FILES:
+            ##
+            # NOTE: `task: git:staged:specs` does NOT work.
+            #
+            sh: task git:staged:specs --silent
+
+  rubocop:
+    cmds:
+      - bundle exec rubocop --config .rubocop.yml {{.CLI_ARGS}}
+
+  rubocop:format:
+    cmds:
+      - bundle exec rubocop --config .rubocop.yml -A {{.CLI_ARGS}}

data/convenient_service.gemspec

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "lib/convenient_service/specification"
+require_relative "lib/convenient_service/version"
+
+Gem::Specification.new do |spec|
+  spec.name = ConvenientService::Specification::NAME
+  spec.authors = ConvenientService::Specification::AUTHORS
+  spec.email = ConvenientService::Specification::EMAIL
+  spec.homepage = ConvenientService::Specification::HOMEPAGE
+  spec.summary = ConvenientService::Specification::SUMMARY
+  spec.description = ConvenientService::Specification::DESCRIPTION
+
+  spec.version = ConvenientService::VERSION
+
+  spec.license = "MIT"
+
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "appraisal"
+  spec.add_development_dependency "awesome_print"
+  spec.add_development_dependency "byebug", "~> 10.0"
+  spec.add_development_dependency "commonmarker"
+  spec.add_development_dependency "gem-release"
+  spec.add_development_dependency "inch"
+  spec.add_development_dependency "paint"
+  spec.add_development_dependency "progressbar"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rerun"
+  spec.add_development_dependency "rouge"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rubocop-rspec"
+  spec.add_development_dependency "tty-prompt"
+  spec.add_development_dependency "standard"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "simplecov-lcov"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "yard-junk"
+end

data/docker/2.7/Dockerfile

@@ -0,0 +1,73 @@
+##
+# Ruby 2.7 with Node.js 16.x.
+#
+# NOTE: Linted by hadolint.
+#
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/3.0/Dockerfile
+#
+# NOTE: A command to build image.
+#
+#   cd convenient_service
+#   cp Gemfile Gemfile.2.7
+#   docker build . -f docker/2.7/Dockerfile -t convenient_service:2.7
+#   # or `task docker:build:ruby_2.7`
+#
+# NOTE: A command to run bash in container.
+#
+#   cd convenient_service
+#   docker run --rm -it -v $(pwd):/gem convenient_service:2.7 bash
+#   # or `task docker:bash:ruby_2.7`
+#
+# 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.
+# - 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
+# https://github.com/nodejs/Release
+#
+FROM timbru31/ruby-node:2.7-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.2.7
+
+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/3.0/Dockerfile

@@ -0,0 +1,73 @@
+##
+# Ruby 3.0 with Node.js 16.x.
+#
+# NOTE: Linted by hadolint.
+#
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/3.0/Dockerfile
+#
+# NOTE: A command to build image.
+#
+#   cd convenient_service
+#   cp Gemfile Gemfile.3.0
+#   docker build . -f docker/3.0/Dockerfile -t convenient_service:3.0
+#   # or `task docker:build:ruby_3.0`
+#
+# NOTE: A command to run bash in container.
+#
+#   cd convenient_service
+#   docker run --rm -it -v $(pwd):/gem convenient_service:3.0 bash
+#   # or `task docker:bash:ruby_3.0`
+#
+# 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.
+# - 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
+# https://github.com/nodejs/Release
+#
+FROM timbru31/ruby-node:3.0-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.0
+
+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/3.1/Dockerfile

@@ -0,0 +1,73 @@
+##
+# Ruby 3.1 with Node.js 16.x.
+#
+# NOTE: Linted by hadolint.
+#
+#   docker run --rm -i ghcr.io/hadolint/hadolint < docker/3.1/Dockerfile
+#
+# NOTE: A command to build image.
+#
+#   cd convenient_service
+#   cp Gemfile Gemfile.3.1
+#   docker build . -f docker/3.1/Dockerfile -t convenient_service:3.1
+#   # or `task docker:build:ruby_3.1`
+#
+# NOTE: A command to run bash in container.
+#
+#   cd convenient_service
+#   docker run --rm -it -v $(pwd):/gem convenient_service:3.1 bash
+#   # or `task docker:bash:ruby_3.1`
+#
+# 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.
+# - 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
+# https://github.com/nodejs/Release
+#
+FROM timbru31/ruby-node:3.1-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.1
+
+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