convenient_service 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1f3cda1e00bba0f7e8c4e86e8831d6bb55385302c2da872cc6a205970938558
-  data.tar.gz: be1745b3ef9fbc5e7c892d2b15b65eda18afa2879a8c5253d67effe3c9f0c506
+  metadata.gz: e26ca79641e2ead4052a1cb3132bf2a3a6707eed8c59f0d0258fe366ed0b9b16
+  data.tar.gz: 7c82db04e08d196c52dc1f4d7c6b49e01fc7c9db0fb6bd262128a406b92a56dd
 SHA512:
-  metadata.gz: 9fe6b8fe017c94dec0516b342d1d1bce0ee968487b94cb0695414a5f5781c4cd95e1b42ec2e31f746df430caec82e2c2d39c6423d638bf838d17ab72ba8816c6
-  data.tar.gz: 4972e2fe5f288b989d42260eb86f4750614a9a16bc2b08a98eae2f6b94c8fb32f10d05daf33f37c9213ec1e134f4962a7c4d9dfba380351c801811acc7eabb01
+  metadata.gz: a30ce3ce1cc65f6fea74870b60d0e5f109c8d7e32873d7250abf4eba43339e3e045c474ca4b0f148e6465b6a22b4494ab8e0db7a880b673b44e3c181d0f771b4
+  data.tar.gz: aece2e76d26bad28d3ed9e3faef31eee4db5db4542677b4c4e943cff4b29ae4f741bfdbe2e1091c0716b4960df4d639e18593d19bb3f479c04b55930be55847a

data/.dev/.tmuxinator.yml

@@ -13,5 +13,6 @@ windows:
       panes:
         - task docker:bash:ruby_2.7
         - task docker:bash:ruby_3.0
-        - task docker:bash:ruby_3.1
+        - task docker:bash:jruby_9.4
+        - task docker:bash:truffleruby_22.3
         - git status

data/.github/workflows/ci.yml

@@ -60,7 +60,7 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.1
+          ruby-version: 3.2
           ##
           # NOTE: Installs the latest compatible Bundler version, runs `bundle install` and caches installed gems.
           # - https://github.com/ruby/setup-ruby#usage
@@ -88,6 +88,9 @@ jobs:
     # That is why the well-known Ubuntu is used.
     # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners
     #
+    # NOTE: List of all possible Ruby, JRuby versions.
+    # https://github.com/ruby/setup-ruby/blob/master/ruby-builder-versions.json
+    #
     runs-on: ubuntu-20.04
     strategy:
       matrix:
@@ -101,6 +104,23 @@ jobs:
           #
           - "3.0"
           - 3.1
+          - 3.2
+          ##
+          # NOTE: JRuby 9.4 aims CRuby 3.1 compatibility.
+          # - https://www.jruby.org/download
+          #
+          - "jruby-9.4"
+          ##
+          # NOTE: TruffleRuby 22.3 aims CRuby 3.1 compatibility.
+          # - https://www.jruby.org/download
+          #
+          # IMPORTANT: TruffleRuby 22.3 is currently disabled since too many specs are failing due to CRuby uncompatible code.
+          #
+          # NOTE: Use `task docker:bash:truffleruby_22.3` and then `task rspec` to reproduce them locally.
+          #
+          # TODO: Make ConvenientService TruffleRuby 22.3 compatible.
+          #
+          # - "truffleruby-22.3"
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
 

data/CHANGELOG.md

@@ -1,5 +1,72 @@
 # Changelog
 
+## [0.12.0](https://github.com/marian13/convenient_service/compare/v0.11.0...v0.12.0) (2023-04-01)
+
+
+### ⚠ BREAKING CHANGES
+
+* **has_j_send_status_and_attributes:** use Jsend to JSend
+* **can_have_method_steps:** bring back CanHaveMethodSteps since it is thread-safe
+
+### Features
+
+* **be_result:** add trigger for BE_RESULT ([d7a416e](https://github.com/marian13/convenient_service/commit/d7a416e39377378655740d9997695c0100b60258))
+* **can_have_method_steps:** bring back CanHaveMethodSteps since it is thread-safe ([cbd4f35](https://github.com/marian13/convenient_service/commit/cbd4f35fa22c85f8005582ac06118d1f63337984))
+* **core:** add config constants ([7438742](https://github.com/marian13/convenient_service/commit/7438742268cb808f082cdb9a1a36e8698d73a662))
+* **core:** add method_missing_commits_counter ([9f143a0](https://github.com/marian13/convenient_service/commit/9f143a02c49b078ddbb3a953dc657b1c4c992494))
+* **core:** add trigger for config commitment in class method missing ([97a4acf](https://github.com/marian13/convenient_service/commit/97a4acf06d30e08411790db917867da53f49653b))
+* **core:** add trigger for config commitment in instance method missing ([e1ebfc0](https://github.com/marian13/convenient_service/commit/e1ebfc028d157cadd8a70ebc7321883986db6633))
+* **core:** add trigger for RESOLVE_METHOD_MIDDLEWARES_SUPER_METHOD ([d419985](https://github.com/marian13/convenient_service/commit/d419985dca3e348b1ee8607aadfd2ea4a0cc84be))
+* **core:** add trigger option commit_config! ([2c7c041](https://github.com/marian13/convenient_service/commit/2c7c041f7602710db53e2caf9ab4061579254983))
+* **core:** default commit trigger to user ([127822a](https://github.com/marian13/convenient_service/commit/127822a7da2e6e4c95272e627d101f68ce0f5479))
+* **core:** introduce config commitment triggers ([b92ee50](https://github.com/marian13/convenient_service/commit/b92ee50d7216b6e49464449f9678071bada0109b))
+* **core:** introduce middleware arguments ([5ca7868](https://github.com/marian13/convenient_service/commit/5ca7868181d44f0f1eb1f2958270e4c6bbb76646))
+* **core:** introduce Middleware.with ([4272262](https://github.com/marian13/convenient_service/commit/427226258cce031679c51a5b4ea900506c995c4a))
+* **core:** introduce MiddlewareCreator ([d1b6ce8](https://github.com/marian13/convenient_service/commit/d1b6ce89fdc008359f9fd0ed080c3cfb28bd39b7))
+* **core:** MiddlewareCreator#new ([e36cee9](https://github.com/marian13/convenient_service/commit/e36cee97a8cceb70fe7564bde516dc31f4b37157))
+* **core:** track method_missing commit triggers ([f3a7264](https://github.com/marian13/convenient_service/commit/f3a7264e3ddb67976fbf2e1c875df15f6f133c0b))
+* **depencency_container:** introduce entry ([a905b6e](https://github.com/marian13/convenient_service/commit/a905b6e90cf656a409246f17be84d39c3b4f79c6))
+* **feature:** introduce initial feature ([7413273](https://github.com/marian13/convenient_service/commit/7413273af1d5abad4aee912cc8bffe8f1d6d1d0b))
+* **finite_loop:** introduce FiniteLoop.finite_loop ([ae363c1](https://github.com/marian13/convenient_service/commit/ae363c1b159692b5ef42f09bb6250ee7615d4ffe))
+* **has_jsend_status_and_attributes:** allow user to provide Code, Data, Message and Status classes ([ff9703e](https://github.com/marian13/convenient_service/commit/ff9703e91c310d6223fbf8c9142c9e41d58498ba))
+* **has_result_status_check_short_syntax:** Add two more short bool result checks ([a8a8a8b](https://github.com/marian13/convenient_service/commit/a8a8a8b2c7d6ff90249488dffff892dff90bf914))
+* **in_threads:** introduce in_threads RSpec helper ([dbd54ac](https://github.com/marian13/convenient_service/commit/dbd54ac86f75f45ad03bedd2622efc3d7055d4a2))
+* **rescues_result_unhandled_exceptions:** read max_backtrace_size from middleware arguments ([6d7de5e](https://github.com/marian13/convenient_service/commit/6d7de5ecd38d2a9bc7bc719aa44e86f3a31694d7))
+* **ruby_middleware:** add support of middleware creators ([06bcc15](https://github.com/marian13/convenient_service/commit/06bcc15f6f600e4fc40ec7e1842495f2b37edfd0))
+* **ruby:** check if jruby ([fba70da](https://github.com/marian13/convenient_service/commit/fba70daf5713fa99384e860e33c7db32de4b9e91))
+* **ruby:** check if truffleruby ([341ced1](https://github.com/marian13/convenient_service/commit/341ced193953cd8c51a97ac3c4cb8822433485f0))
+* **stub_service:** add trigger for STUB_SERVICE ([047c835](https://github.com/marian13/convenient_service/commit/047c8358cafd86d84ced0f300440d4a08ee10994))
+* support ruby 3.2 in CI and Docker ([4dc26b9](https://github.com/marian13/convenient_service/commit/4dc26b93c074870362cafaaa15d9625542d51b92))
+* **support:** introduce thread_safe_counter ([ea25f15](https://github.com/marian13/convenient_service/commit/ea25f159091b7bfd71af593e9dadcdb015606a53))
+* **support:** introduce UniqueValue ([b007123](https://github.com/marian13/convenient_service/commit/b0071230455ad80cd206c1e34eb5f59a6f90af61))
+* **support:** safe_method ([b37d735](https://github.com/marian13/convenient_service/commit/b37d735c03b08e57d930c9d5cb1c7cd089a07e0a))
+* **support:** ThreadSafeCounter#current_value= ([bf703bb](https://github.com/marian13/convenient_service/commit/bf703bb80e4bdac62edff930ea9e524012dbd221))
+* **thread_safe_counter:** introduce bincrement and bdecrement ([a0ef972](https://github.com/marian13/convenient_service/commit/a0ef9729eb3bb1e22536375ce7e9cb57a0f7fa7b))
+* **unique_value:** add == consistency ([26c8686](https://github.com/marian13/convenient_service/commit/26c8686cbf52caa932d677d080dc283943b048cb))
+* **unique_value:** add comparisons ([cf02a50](https://github.com/marian13/convenient_service/commit/cf02a505ca1f34e70d50236f691ebbc89fdcb29f))
+* **utils:** introduce Object.resolve_class ([94f6ca2](https://github.com/marian13/convenient_service/commit/94f6ca2178c8bb048b35b10c74d60385fa003079))
+
+
+### Bug Fixes
+
+* **can_have_steps:** set correct error namaspace ([1f6d647](https://github.com/marian13/convenient_service/commit/1f6d647e1babdd2c565390691a56442ad0fd315c))
+* **can_have_stubbed_result:** add thread-safety ([ef77058](https://github.com/marian13/convenient_service/commit/ef77058a877c903a6156875d02d436ac4216174a))
+* **core:** remove typo in description ([a34323f](https://github.com/marian13/convenient_service/commit/a34323f1a20a0667aba6fdceb77476345a26d1d3))
+* **dependency_container:** remove typo ([fbcfd28](https://github.com/marian13/convenient_service/commit/fbcfd28ccd6747da5c7e7b48aa620206403264e9))
+* **has_result_status_check_short_syntax:** Correct implementation of two methods ([5cf6004](https://github.com/marian13/convenient_service/commit/5cf6004bdfe49973452846e452dbcd087074b723))
+* **logger:** update ENV variable ([86301ce](https://github.com/marian13/convenient_service/commit/86301ce98bcfa18a4bdb7e4d34c283493865bc76))
+* **support:** group examples ([97549e9](https://github.com/marian13/convenient_service/commit/97549e9d2e342041a7d5b64d2bf68dbcedf73ca2))
+
+
+### Miscellaneous Chores
+
+* release 0.12.0 ([da182b6](https://github.com/marian13/convenient_service/commit/da182b694865ea5e10163193b3219439a6d3be3e))
+
+
+### Code Refactoring
+
+* **has_j_send_status_and_attributes:** use Jsend to JSend ([ffb2642](https://github.com/marian13/convenient_service/commit/ffb26424f9ce8f176a148c146c238a2bb1c77ce6))
+
 ## [0.11.0](https://github.com/marian13/convenient_service/compare/v0.10.1...v0.11.0) (2023-03-04)
 
 

data/Gemfile

@@ -4,3 +4,9 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in convenient_service.gemspec
 gemspec
+
+group :development, :test do
+  # NOTE: Temporarily pointing appraisal at the commit in the main branch until the following issue is resolved:
+  # https://github.com/thoughtbot/appraisal/issues/199
+  gem "appraisal", github: "thoughtbot/appraisal", ref: "b200e636903700098bef25f4f51dbc4c46e4c04c"
+end

data/README.md

@@ -14,7 +14,9 @@
 <!-- header:end -->
 
 <!-- badges:start -->
-[![Gem Version](https://badge.fury.io/rb/convenient_service.svg)](https://rubygems.org/gems/convenient_service) [![GitHub Actions CI](https://github.com/marian13/convenient_service/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/marian13/convenient_service/actions/workflows/ci.yml) [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard) [![Coverage Status](https://coveralls.io/repos/github/marian13/convenient_service/badge.svg)](https://coveralls.io/github/marian13/convenient_service?branch=main) [![inline docs](http://inch-ci.org/github/marian13/convenient_service.svg?branch=main)](http://inch-ci.org/github/marian13/convenient_service)
+[![Ruby](https://img.shields.io/badge/ruby-%23CC342D.svg?style=for-the-badge&logo=ruby&logoColor=white)](https://www.ruby-lang.org/en/)
+
+[![Gem Version](https://badge.fury.io/rb/convenient_service.svg)](https://rubygems.org/gems/convenient_service) [![Gem Downloads](https://img.shields.io/gem/dt/convenient_service.svg)](https://rubygems.org/gems/convenient_service) ![visitors](https://visitor-badge.glitch.me/badge?page_id=marian13/convenient_service) [![GitHub Actions CI](https://github.com/marian13/convenient_service/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/marian13/convenient_service/actions/workflows/ci.yml) [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard) [![Coverage Status](https://coveralls.io/repos/github/marian13/convenient_service/badge.svg)](https://coveralls.io/github/marian13/convenient_service?branch=main) [![inline docs](http://inch-ci.org/github/marian13/convenient_service.svg?branch=main)](http://inch-ci.org/github/marian13/convenient_service) [![yard docs](http://img.shields.io/badge/yard-docs-blue.svg)](https://marian13.github.io/convenient_service/)
 [![Convenient Service on stackoverflow](https://img.shields.io/badge/stackoverflow-community-orange.svg?logo=stackoverflow)](https://stackoverflow.com/tags/convenient-service)
 [![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/user?u=31435716&fan_landing=true)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -34,7 +36,7 @@ Yet another approach to revisit the service object pattern, but this time focusi
 <!-- warning:start -->
 ## WARNING ❗❗❗
 
-This library is under heavy development. Public API may be subject to change. The first major release is still to come. Use the current version at your own risk. Ruby 2.7+. Thanks.
+This library is under heavy development. Public API may be subject to change. The first major release is still to come. Use the current version at your own risk. Ruby 2.7+, JRuby 9.4+ (TruffleRuby support is planned as well). Thanks.
 <!-- features:end -->
 <!-- warning:end -->
 

data/Taskfile.yml

@@ -67,11 +67,46 @@ tasks:
       - 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.2:
+    cmds:
+      - docker run --rm -it -v $(pwd):/gem convenient_service:3.2 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)
+
+  ##
+  # NOTE: JRuby 9.4 aims CRuby 3.1 compatibility.
+  # - https://www.jruby.org/download
+  #
+  docker:bash:jruby_9.4:
+    cmds:
+      - docker run --rm -it -v $(pwd):/gem convenient_service:jruby-9.4 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)
+
+  ##
+  # NOTE: TruffleRuby 22.3 aims CRuby 3.1 compatibility.
+  # - https://github.com/oracle/truffleruby/blob/master/doc/user/compatibility.md
+  #
+  docker:bash:truffleruby_22.3:
+    cmds:
+      - docker run --rm -it -v $(pwd):/gem convenient_service:truffleruby-22.3 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
+      - task: docker:build:ruby_3.2
+      - task: docker:build:jruby_9.4
+      - task: docker:build:truffleruby_22.3
     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)
@@ -127,6 +162,65 @@ tasks:
       - 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.2:
+    cmds:
+      ##
+      # NOTE: Meaning of `|| 2> /dev/null`.
+      # https://stackoverflow.com/a/10250395/12201472
+      #
+      # NOTE: Meaning of `|| true`.
+      # https://superuser.com/a/887349/1180656
+      #
+      - rm Gemfile.3.2 2> /dev/null || true
+      - rm Gemfile.3.2.lock 2> /dev/null || true
+      - cp Gemfile Gemfile.3.2
+      - docker build . -f docker/3.2/Dockerfile -t convenient_service:3.2
+    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: JRuby 9.4 aims CRuby 3.1 compatibility.
+  # - https://www.jruby.org/download
+  #
+  docker:build:jruby_9.4:
+    cmds:
+      ##
+      # NOTE: Meaning of `|| 2> /dev/null`.
+      # https://stackoverflow.com/a/10250395/12201472
+      #
+      # NOTE: Meaning of `|| true`.
+      # https://superuser.com/a/887349/1180656
+      #
+      - rm Gemfile.jruby-9.4 2> /dev/null || true
+      - rm Gemfile.jruby-9.4.lock 2> /dev/null || true
+      - cp Gemfile Gemfile.jruby-9.4
+      - docker build . -f docker/jruby-9.4/Dockerfile -t convenient_service:jruby-9.4
+    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: TruffleRuby 22.3 aims CRuby 3.1 compatibility.
+  # - https://github.com/oracle/truffleruby/blob/master/doc/user/compatibility.md
+  #
+  docker:build:truffleruby_22.3:
+    cmds:
+      ##
+      # NOTE: Meaning of `|| 2> /dev/null`.
+      # https://stackoverflow.com/a/10250395/12201472
+      #
+      # NOTE: Meaning of `|| true`.
+      # https://superuser.com/a/887349/1180656
+      #
+      - rm Gemfile.truffleruby-22.3 2> /dev/null || true
+      - rm Gemfile.truffleruby-22.3.lock 2> /dev/null || true
+      - cp Gemfile Gemfile.truffleruby-22.3
+      - docker build . -f docker/truffleruby-22.3/Dockerfile -t convenient_service:truffleruby-22.3
+    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: Dev only command.
   # NOTE: macOS specific command.

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
@@ -30,26 +37,57 @@ Gem::Specification.new do |spec|
   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"
+
+  ##
+  # 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?
+
   spec.add_development_dependency "faker"
+
   spec.add_development_dependency "gem-release"
+
   spec.add_development_dependency "inch"
+
   spec.add_development_dependency "json"
+
   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.11.0"
+
   spec.add_development_dependency "rubocop", "~> 1.40.0"
+
   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 "webrick"
+
   spec.add_development_dependency "yard", "~> 0.9.28"
+
   spec.add_development_dependency "yard-junk"
 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