kettle-jem 7.0.0 → 7.1.3

data/lib/kettle/jem/templates/Rakefile.example

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+# {KJ|FREEZE_TOKEN}:freeze
+# To retain chunks of comments & code during kettle-jem templating:
+# Wrap custom sections with freeze markers (e.g., as above and below this comment chunk).
+# kettle-jem will then preserve content between those markers across template runs.
+# {KJ|FREEZE_TOKEN}:unfreeze
+
+# {KJ|GEM_NAME} Rakefile v{KJ|KETTLE_JEM_VERSION} - {KJ|TEMPLATE_RUN_DATE}
+# Ruby 2.3 (Safe Navigation) or higher required
+#
+# See LICENSE.md for license information.
+#
+# Copyright (c) {KJ|TEMPLATE_RUN_YEAR} {KJ|AUTHOR:NAME} ({KJ|AUTHOR:DOMAIN})
+#
+# Expected to work in any project that uses Bundler.
+#
+# Sets up tasks for appraisal2, floss_funding, kettle-jem, kettle-dev, rspec, minitest, rubocop_gradual, reek, yard, and stone_checksums.
+#
+# rake appraisal:install                      # Install Appraisal gemfiles (initial setup...
+# rake appraisal:reset                        # Delete Appraisal lockfiles (gemfiles/*.gemfile.lock)
+# rake appraisal:generate                     # Generate Appraisal gemfiles without resolving...
+# rake appraisal:update                       # Generate and update Appraisal gemfiles
+# rake bench                                  # Run all benchmarks (alias for bench:run)
+# rake bench:list                             # List available benchmark scripts
+# rake bench:run                              # Run all benchmark scripts (skips on CI)
+# rake build:generate_checksums               # Generate both SHA256 & SHA512 checksums i...
+# rake bundle:audit:check                     # Checks the Gemfile.lock for insecure depe...
+# rake bundle:audit:update                    # Updates the bundler-audit vulnerability d...
+# rake ci:act[opt]                            # Run 'act' with a selected workflow
+# rake coverage                               # Run specs w/ coverage and open results in...
+# rake default                                # Default tasks aggregator
+# rake install                                # Build and install {KJ|GEM_NAME}-1.0.0.gem in...
+# rake install:local                          # Build and install {KJ|GEM_NAME}-1.0.0.gem in...
+# rake kettle:jem:install                     # Internal target used by `kettle-jem install`
+# rake kettle:jem:selftest                    # Self-test: template {KJ|GEM_NAME} against itse...
+# rake kettle:jem:template                    # Internal target used by scoped `kettle-jem template --only`
+# rake reek                                   # Check for code smells
+# rake reek:update                            # Run reek and store the output into the RE...
+# rake release[remote]                        # Create tag v1.0.0 and build and push kett...
+# rake rubocop_gradual                        # Run RuboCop Gradual
+# rake rubocop_gradual:autocorrect            # Run RuboCop Gradual with autocorrect (onl...
+# rake rubocop_gradual:autocorrect_all        # Run RuboCop Gradual with autocorrect (saf...
+# rake rubocop_gradual:check                  # Run RuboCop Gradual to check the lock file
+# rake rubocop_gradual:force_update           # Run RuboCop Gradual to force update the l...
+# rake rubocop_gradual_debug                  # Run RuboCop Gradual
+# rake rubocop_gradual_debug:autocorrect      # Run RuboCop Gradual with autocorrect (onl...
+# rake rubocop_gradual_debug:autocorrect_all  # Run RuboCop Gradual with autocorrect (saf...
+# rake rubocop_gradual_debug:check            # Run RuboCop Gradual to check the lock file
+# rake rubocop_gradual_debug:force_update     # Run RuboCop Gradual to force update the l...
+# rake spec                                   # Run RSpec code examples
+# rake test                                   # Run tests
+# rake yard                                   # Generate YARD Documentation
+# rake yard:lint                              # Lint YARD Documentation
+#
+
+# simplecov:disable
+require "bundler/gem_tasks" if !Dir[File.join(__dir__, "*.gemspec")].empty?
+# simplecov:enable
+
+# Define a base default task early so other files can enhance it.
+desc "Default tasks aggregator"
+task :default do
+  puts "Default task complete."
+end
+
+# simplecov:disable
+### MONOREPO FAMILY TASKS
+if Dir.exist?(File.join(__dir__, "gems"))
+  def family_gem_dirs
+{KJ|RAKE:FAMILY_GEM_DIRS_ENUMERATION}
+  end
+
+  def run_kettle_family(*args)
+    sh("bundle", "exec", "kettle-family", *args)
+  end
+
+  namespace :family do
+    desc "List released Ruby subgems"
+    task :list do
+      family_gem_dirs.each { |path| puts File.basename(path) }
+    end
+
+    desc "Run release readiness checks for the Ruby gem family"
+    task :readiness do
+      run_kettle_family("check")
+    end
+
+    desc "Run tests for the Ruby gem family"
+    task :test do
+      run_kettle_family("test", "--execute")
+    end
+
+    desc "Run lint for the Ruby gem family"
+    task :lint do
+      run_kettle_family("lint", "--execute")
+    end
+
+    desc "Generate YARD docs for the Ruby gem family"
+    task :docs do
+      run_kettle_family("docs", "--execute")
+    end
+
+    desc "Report release state for the Ruby gem family"
+    task :release_state do
+      run_kettle_family("release-state")
+    end
+
+    desc "Run the Ruby gem family release planner"
+    task :release do
+      run_kettle_family("release")
+    end
+
+    desc "Execute the Ruby gem family release"
+    task :release_execute do
+      run_kettle_family("release", "--execute")
+    end
+  end
+end
+# simplecov:enable
+
+# External gems that define tasks - add here!
+begin
+  require "kettle/dev"
+  Kettle::Dev.install_tasks unless Kettle::Dev::RUNNING_AS == "rake"
+rescue LoadError
+  warn("NOTE: kettle-dev isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
+end
+
+### TEMPLATING TASKS
+# These tasks are installed for the `kettle-jem` executable. Run full templating
+# through `kettle-jem install`; use `kettle-jem template --only PATH` only for
+# scoped file updates. The executable prepares the environment and then
+# delegates here when rake orchestration is needed.
+kettle_jem_selftest_unavailable_note = nil
+begin
+  require "kettle/jem"
+  if Kettle::Jem.respond_to?(:install_tasks)
+    Kettle::Jem.install_tasks
+  else
+    kettle_jem_selftest_unavailable_note = "NOTE: kettle-jem #{Kettle::Jem::Version::VERSION} does not provide rake tasks in this environment"
+  end
+rescue LoadError
+  kettle_jem_selftest_unavailable_note = "NOTE: kettle-jem isn't installed, or is disabled for #{RUBY_VERSION} in the current environment"
+end
+
+if kettle_jem_selftest_unavailable_note
+  desc("(stub) kettle:jem:selftest is unavailable")
+  task("kettle:jem:selftest") do
+    warn(kettle_jem_selftest_unavailable_note)
+  end
+end
+
+### RELEASE TASKS
+# Setup stone_checksums
+begin
+  require "stone_checksums"
+rescue LoadError
+  desc("(stub) build:generate_checksums is unavailable")
+  task("build:generate_checksums") do
+    warn("NOTE: stone_checksums isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
+  end
+end

data/lib/kettle/jem/templates/SECURITY.md.example

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+| Version  | Supported |
+|----------|-----------|
+| {KJ|SECURITY:SUPPORTED_VERSION} | ✅         |
+
+## Security contact information
+
+To report a security vulnerability, please use the
+[Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure.
+
+## Additional Support
+
+If you are interested in support for versions older than the latest release,
+please consider sponsoring the project / maintainer @ https://liberapay.com/{KJ|FUNDING:LIBERAPAY}/donate,
+or find other sponsorship links in the [README].
+
+[README]: README.md

data/lib/kettle/jem/templates/bin/setup.example

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+
+quiet=false
+bundle_args=(install)
+
+for arg in "$@"; do
+  case "$arg" in
+	--quiet)
+	  quiet=true
+	  bundle_args+=(--quiet)
+	  ;;
+	-h|--help)
+	  cat <<'USAGE'
+Usage: bin/setup [--quiet]
+
+Options:
+  --quiet   Pass --quiet to bundle install and suppress shell tracing.
+USAGE
+	  exit 0
+	  ;;
+	*)
+	  printf 'bin/setup: unknown option: %s\n' "$arg" >&2
+	  exit 2
+	  ;;
+  esac
+done
+
+if [ "$quiet" != "true" ]; then
+  set -vx
+fi
+
+bundle "${bundle_args[@]}"
+
+# Do any other automated setup that you need to do here

data/lib/kettle/jem/templates/certs/pboling.pem.example

@@ -0,0 +1,27 @@
+-----BEGIN CERTIFICATE-----
+MIIEgDCCAuigAwIBAgIBATANBgkqhkiG9w0BAQsFADBDMRUwEwYDVQQDDAxwZXRl
+ci5ib2xpbmcxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+A2NvbTAeFw0yNTA1MDQxNTMzMDlaFw00NTA0MjkxNTMzMDlaMEMxFTATBgNVBAMM
+DHBldGVyLmJvbGluZzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+LGQBGRYDY29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAruUoo0WA
+uoNuq6puKWYeRYiZekz/nsDeK5x/0IEirzcCEvaHr3Bmz7rjo1I6On3gGKmiZs61
+LRmQ3oxy77ydmkGTXBjruJB+pQEn7UfLSgQ0xa1/X3kdBZt6RmabFlBxnHkoaGY5
+mZuZ5+Z7walmv6sFD9ajhzj+oIgwWfnEHkXYTR8I6VLN7MRRKGMPoZ/yvOmxb2DN
+coEEHWKO9CvgYpW7asIihl/9GMpKiRkcYPm9dGQzZc6uTwom1COfW0+ZOFrDVBuV
+FMQRPswZcY4Wlq0uEBLPU7hxnCL9nKK6Y9IhdDcz1mY6HZ91WImNslOSI0S8hRpj
+yGOWxQIhBT3fqCBlRIqFQBudrnD9jSNpSGsFvbEijd5ns7Z9ZMehXkXDycpGAUj1
+to/5cuTWWw1JqUWrKJYoifnVhtE1o1DZ+LkPtWxHtz5kjDG/zR3MG0Ula0UOavlD
+qbnbcXPBnwXtTFeZ3C+yrWpE4pGnl3yGkZj9SMTlo9qnTMiPmuWKQDatAgMBAAGj
+fzB9MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBQE8uWvNbPVNRXZ
+HlgPbc2PCzC4bjAhBgNVHREEGjAYgRZwZXRlci5ib2xpbmdAZ21haWwuY29tMCEG
+A1UdEgQaMBiBFnBldGVyLmJvbGluZ0BnbWFpbC5jb20wDQYJKoZIhvcNAQELBQAD
+ggGBAJbnUwfJQFPkBgH9cL7hoBfRtmWiCvdqdjeTmi04u8zVNCUox0A4gT982DE9
+wmuN12LpdajxZONqbXuzZvc+nb0StFwmFYZG6iDwaf4BPywm2e/Vmq0YG45vZXGR
+L8yMDSK1cQXjmA+ZBKOHKWavxP6Vp7lWvjAhz8RFwqF9GuNIdhv9NpnCAWcMZtpm
+GUPyIWw/Cw/2wZp74QzZj6Npx+LdXoLTF1HMSJXZ7/pkxLCsB8m4EFVdb/IrW/0k
+kNSfjtAfBHO8nLGuqQZVH9IBD1i9K6aSs7pT6TW8itXUIlkIUI2tg5YzW6OFfPzq
+QekSkX3lZfY+HTSp/o+YvKkqWLUV7PQ7xh1ZYDtocpaHwgxe/j3bBqHE+CUPH2vA
+0V/FwdTRWcwsjVoOJTrYcff8pBZ8r2MvtAc54xfnnhGFzeRHfcltobgFxkAXdE6p
+DVjBtqT23eugOqQ73umLcYDZkc36vnqGxUBSsXrzY9pzV5gGr2I8YUxMqf6ATrZt
+L9nRqA==
+-----END CERTIFICATE-----

data/lib/kettle/jem/templates/gem.gemspec.example

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+# {KJ|FREEZE_TOKEN}:freeze
+# To retain chunks of comments & code during kettle-jem templating:
+# Wrap custom sections with freeze markers (e.g., as above and below this comment chunk).
+# kettle-jem will then preserve content between those markers across template runs.
+# {KJ|FREEZE_TOKEN}:unfreeze
+
+gem_version =
+  if Gem.ruby_version >= Gem::Version.new("3.1")
+    # Loading Version into an anonymous module allows version.rb to get code coverage from SimpleCov!
+    # See: https://github.com/simplecov-ruby/simplecov/issues/557#issuecomment-2630782358
+    # See: https://github.com/panorama-ed/memo_wise/pull/397
+    Module.new.tap { |mod| Kernel.load("#{__dir__}/lib/{KJ|GEM_NAME_PATH}/version.rb", mod) }::{KJ|NAMESPACE}::Version::VERSION
+  else
+    require_relative "lib/{KJ|GEM_NAME_PATH}/version"
+    {KJ|NAMESPACE}::Version::VERSION
+  end
+
+Gem::Specification.new do |spec|
+  spec.name = "{KJ|GEM_NAME}"
+  spec.version = gem_version
+  spec.authors = {KJ|AUTHOR:NAMES}
+  spec.email = ["{KJ|AUTHOR:EMAIL}"]
+
+  spec.summary = "{KJ|PROJECT_EMOJI} {KJ|GEMSPEC_PACKAGE_SUMMARY}"
+  spec.description = "{KJ|PROJECT_EMOJI} {KJ|GEMSPEC_PACKAGE_DESCRIPTION}"
+  spec.homepage = "{KJ|README:GH_REPOSITORY_URL}"
+  spec.licenses = ["MIT"]
+  spec.required_ruby_version = ">= 2.3.0"
+
+  # Linux distros often package gems and securely certify them independent
+  #   of the official RubyGem certification process. Allowed via ENV["SKIP_GEM_SIGNING"]
+  # Ref: https://gitlab.com/ruby-oauth/version_gem/-/issues/3
+  # Hence, only enable signing if `SKIP_GEM_SIGNING` is not set in ENV.
+  # See CONTRIBUTING.md
+  unless ENV.include?("SKIP_GEM_SIGNING")
+    user_cert = "certs/#{ENV.fetch("GEM_CERT_USER", ENV["USER"])}.pem"
+    cert_file_path = File.join(__dir__, user_cert)
+    cert_chain = cert_file_path.split(",")
+    cert_chain.select! { |fp| File.exist?(fp) }
+    if cert_file_path && cert_chain.any?
+      spec.cert_chain = cert_chain
+      if $PROGRAM_NAME.end_with?("gem") && ARGV[0] == "build"
+        spec.signing_key = File.join(Gem.user_home, ".ssh", "gem-private_key.pem")
+      end
+    end
+  end
+
+  spec.metadata["homepage_uri"] = "{KJ|HOMEPAGE_URI}"
+  spec.metadata["source_code_uri"] = "#{spec.homepage}/tree/v#{spec.version}"
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/v#{spec.version}/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues"
+  spec.metadata["documentation_uri"] = "https://www.rubydoc.info/gems/#{spec.name}/#{spec.version}"
+  spec.metadata["funding_uri"] = "https://github.com/sponsors/{KJ|GH:USER}"
+  spec.metadata["wiki_uri"] = "#{spec.homepage}/wiki"
+  spec.metadata["news_uri"] = "https://www.railsbling.com/tags/#{spec.name}"
+  spec.metadata["discord_uri"] = "https://discord.gg/3qme4XHNKN"
+  spec.metadata["mailing_list_uri"] = "{KJ|RUBYFORUM:URL}"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  gemspec_root = __dir__
+  relative_package_path = lambda do |path|
+{KJ|GEMSPEC:RELATIVE_PACKAGE_PATH_BODY}
+  end
+  enumerate_package_glob = lambda do |glob|
+{KJ|GEMSPEC:ENUMERATE_PACKAGE_GLOB_BODY}
+  end
+  enumerate_package_files = lambda do |root|
+    enumerate_package_glob.call(File.join(gemspec_root, root, "**", "*"))
+  end
+  package_metadata_files = %w[
+    CHANGELOG.md
+    LICENSE.md
+    README.md
+    sig/{KJ|GEM_NAME_PATH}.rbs
+  ].select { |path| File.exist?(File.join(gemspec_root, path)) }
+
+  # Specify which files are part of the released package.
+  spec.files = [
+    # Root package metadata
+    *package_metadata_files,
+    # Code / tasks / data (NOTE: exe/ is specified via spec.bindir and spec.executables below)
+    *enumerate_package_files.call("lib"),
+    # Executables and executable support scripts
+    *enumerate_package_files.call("exe"){KJ|GEMSPEC:PACKAGE_FILE_INCLUDES}{KJ|RUBY_STYLE:TRAILING_ARRAY_COMMA}
+  ]
+  spec.rdoc_options += [
+    "--title",
+    "#{spec.name} - #{spec.summary}",
+    "--main",
+    "README.md",
+    "--exclude",
+    "^sig/",
+    "--line-numbers",
+    "--inline-source",
+    "--quiet"{KJ|RUBY_STYLE:TRAILING_ARRAY_COMMA}
+  ]
+  spec.bindir = "exe"
+  # Listed files are the relative paths from bindir above.
+  spec.executables = []
+  spec.require_paths = ["lib"]
+
+  # Utilities
+  spec.add_dependency("version_gem", "~> 1.1", ">= 1.1.15")              # ruby >= 2.2.0
+
+  # NOTE: It is preferable to list development dependencies in the gemspec due to increased
+  #       visibility and discoverability.
+  #       However, development dependencies in gemspec will install on
+  #       all versions of Ruby that will run in CI.
+  #       This gem, and its gemspec runtime dependencies, will install on Ruby down to {KJ|MIN_RUBY}.
+  #       This gem, and its gemspec development dependencies, will install on Ruby down to {KJ|MIN_TEST_RUBY}.
+  #       Thus, dev dependencies in gemspec must have
+  #
+  #       required_ruby_version ">= {KJ|MIN_TEST_RUBY}" (or lower)
+  #
+  #       Development dependencies that require strictly newer Ruby versions should be in a "gemfile",
+  #       and preferably a modular one (see gemfiles/modular/*.gemfile).
+
+  # Dev, Test, & Release Tasks
+  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.0")             # ruby >= {KJ|MIN_TEST_RUBY}
+
+  # Security
+  spec.add_development_dependency("bundler-audit", "~> 0.9.3")                      # ruby >= 2.0.0
+
+  # Tasks
+  spec.add_development_dependency("rake", "~> 13.0")                                # ruby >= 2.2.0
+
+  # Debugging
+  spec.add_development_dependency("require_bench", "~> 1.0", ">= 1.0.4")            # ruby >= 2.2.0
+
+  # Testing
+  # Loads version files in anonymous namespaces for coverage without constant redefinition warnings.
+  spec.add_development_dependency("anonymous_loader", "~> 0.1", ">= 0.1.3")         # ruby >= 2.2.0
+  spec.add_development_dependency("appraisal2", "~> 3.2", ">= 3.2.2")               # ruby >= 1.8.7, for testing against multiple versions of dependencies
+  spec.add_development_dependency("kettle-test", "~> 2.0", ">= 2.0.19")            # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("turbo_tests2", "~> 3.2", ">= 3.2.5")           # ruby >= 2.4.0, default kettle-test runner
+
+  # Releasing
+  spec.add_development_dependency("ruby-progressbar", "~> 1.13")                    # ruby >= 0
+  spec.add_development_dependency("stone_checksums", "~> 1.0", ">= 1.0.8")          # ruby >= 2.2.0
+
+  # Git integration (optional)
+  # The 'git' gem is optional; {KJ|GEM_NAME} falls back to shelling out to `git` if it is not present.
+  # The current release of the git gem depends on activesupport, which makes it too heavy to depend on directly
+  # spec.add_dependency("git", ">= 1.19.1")                               # ruby >= 2.3
+
+  # Development tasks
+  # The cake is a lie. erb v2.2, the oldest release, was never compatible with Ruby 2.3.
+  # This means we have no choice but to use the erb that shipped with Ruby 2.3
+  # /opt/hostedtoolcache/Ruby/2.3.8/x64/lib/ruby/gems/2.3.0/gems/erb-2.2.2/lib/erb.rb:670:in `prepare_trim_mode': undefined method `match?' for "-":String (NoMethodError)
+  # spec.add_development_dependency("erb", ">= 2.2")                                  # ruby >= 2.3.0, not SemVer, old rubies get dropped in a patch.
+  spec.add_development_dependency("gitmoji-regex", "~> 2.0", ">= 2.0.11")            # ruby >= 2.4
+
+  # HTTP recording for deterministic specs
+  # In Ruby 3.5 (HEAD) the CGI library has been pared down, so we also need to depend on gem "cgi" for ruby@head
+  # This is done in the "head" appraisal.
+  # See: https://github.com/vcr/vcr/issues/1057
+  # spec.add_development_dependency("vcr", ">= 4")                        # 6.0 claims to support ruby >= 2.3, but fails on ruby 2.4
+  # spec.add_development_dependency("webmock", ">= 3")                    # Last version to support ruby >= 2.3
+end

data/lib/kettle/jem/templates/gemfiles/modular/benchmark/r4/v0.5.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.1
+gem "benchmark", "~> 0.5", ">= 0.5.0" # Removed from Std Lib in Ruby 4.0

data/lib/kettle/jem/templates/gemfiles/modular/benchmark/vHEAD.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.1
+gem "benchmark", github: "ruby/benchmark", branch: "master"

data/lib/kettle/jem/templates/gemfiles/modular/cgi/r4/v0.5.gemfile.example

@@ -0,0 +1 @@
+gem "cgi", "~> 0.5"

data/lib/kettle/jem/templates/gemfiles/modular/cgi/vHEAD.gemfile.example

@@ -0,0 +1 @@
+gem "cgi", ">= 0.5"

data/lib/kettle/jem/templates/gemfiles/modular/changelog.gemfile.example

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# kettle-changelog depends on the current kettle-dev APIs and the structured
+# Markdown merger. Keep it out of older appraisal jobs whose Ruby cannot load
+# its runtime dependency floor.
+{KJ|KETTLE_CHANGELOG_GEMFILE_DEPENDENCY}

data/lib/kettle/jem/templates/gemfiles/modular/coverage.gemfile.example

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# We run code coverage on the latest version of Ruby only.
+
+# Set KETTLE_DEV_DEV=true for local development with path-based dependencies.
+# When false (default / CI), remote released gems are used.
+if ENV.fetch("KETTLE_DEV_DEV", "false").casecmp("false").zero?
+  # Coverage (remote/released)
+  platform :mri do
+    gem "kettle-soup-cover", "~> 3.0", ">= 3.0.9", require: false
+  end
+else
+  eval_gemfile "coverage_local.gemfile"
+end

data/lib/kettle/jem/templates/gemfiles/modular/coverage_local.gemfile.example

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Local path overrides for development.
+# Loaded by the associated non-local gemfile when KETTLE_DEV_DEV != "false".
+
+{KJ|LOCAL_GEMFILE_NOMONO_BOOTSTRAP}
+
+local_gems = %w[{KJ|KETTLE_DEV_LOCAL_GEMS}]
+declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
+local_gems_to_eval = local_gems - %w[{KJ|PACKAGE_NAME}] - declared_gems
+
+# export KETTLE_DEV_DEV=/path/to/my
+platform :mri do
+  eval_nomono_gems(
+    gems: local_gems_to_eval,
+    prefix: "KETTLE_DEV",
+    path_env: "KETTLE_DEV_DEV",
+    vendored_gems_env: "VENDORED_GEMS",
+    vendor_gem_dir_env: "VENDOR_GEM_DIR",
+    debug_env: "KETTLE_DEV_DEBUG",
+    root: ["src", "my", "kettle-dev"]
+  )
+
+  if ENV.fetch("GALTZO_FLOSS_DEV", "false").casecmp("false") != 0
+    eval_nomono_gems(
+      gems: %w[turbo_tests2],
+      prefix: "GALTZO_FLOSS",
+      path_env: "GALTZO_FLOSS_DEV",
+      vendored_gems_env: "GALTZO_FLOSS_VENDORED_GEMS",
+      vendor_gem_dir_env: "GALTZO_FLOSS_VENDOR_GEM_DIR",
+      debug_env: "GALTZO_FLOSS_DEBUG"
+    )
+  end
+end

data/lib/kettle/jem/templates/gemfiles/modular/debug.gemfile.example

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# To retain during kettle-jem templating:
+#     kettle-jem:freeze
+#     # ... your code
+#     kettle-jem:unfreeze
+#
+
+# Ex-Standard Library gems
+# irb is included in main Gemfile (and unlocked_deps Appraisal), so it can't be included here.
+# gem "irb", "~> 1.15", ">= 1.15.2" # removed from stdlib in 3.5
+
+platform :mri do
+  # Debugging - Ensure ENV["DEBUG"] == "true" to use debuggers within spec suite
+  # Use binding.break, binding.b, or debugger in code
+  gem "debug", ">= 1.1"                     # ruby >= 2.7
+
+  # Dev Console - Binding.pry - Irb replacement
+  # gem "pry", "~> 0.14"                     # ruby >= 2.0
+end
+
+gem "gem_bench", "~> 2.0", ">= 2.0.5"

data/lib/kettle/jem/templates/gemfiles/modular/documentation.gemfile.example

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# To retain during kettle-jem templating:
+#     kettle-jem:freeze
+#     # ... your code
+#     kettle-jem:unfreeze
+#
+
+# Documentation
+gem "kramdown", "~> 2.5", ">= 2.5.2", require: false # Ruby >= 2.5
+gem "kramdown-parser-gfm", "~> 1.1", require: false # Ruby >= 2.3
+gem "yaml-converter", "~> 0.2", ">= 0.2.5", require: false # Ruby >= 3.2
+gem "yard", "~> 0.9", ">= 0.9.45", require: false
+gem "yard-junk", "~> 0.1", ">= 0.1.0", require: false # Ruby >= 3.1
+gem "yard-lint", "~> 1.10", ">= 1.10.3", require: false # Ruby >= 3.3
+gem "yard-relative_markdown_links", "~> 0.6", require: false
+
+if ENV.fetch("GALTZO_FLOSS_DEV", "false").casecmp("false").zero?
+  gem "yard-fence", "~> 0.9", ">= 0.9.8", require: false # Ruby >= 3.2
+  gem "yard-timekeeper", "~> 0.2", ">= 0.2.6", require: false
+  gem "yard-yaml", "~> 0.2", ">= 0.2.5", require: false
+else
+  eval_gemfile "documentation_local.gemfile"
+end

data/lib/kettle/jem/templates/gemfiles/modular/documentation_local.gemfile.example

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Local path overrides for development.
+# Loaded by the associated non-local gemfile when GALTZO_FLOSS_DEV != "false".
+
+{KJ|LOCAL_GEMFILE_NOMONO_BOOTSTRAP}
+
+local_gems = %w[yard-fence yard-timekeeper yard-yaml]
+declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
+local_gems_to_eval = local_gems - %w[{KJ|PACKAGE_NAME}] - declared_gems
+
+# export GALTZO_FLOSS_DEV=/path/to/galtzo-floss
+eval_nomono_gems(
+  gems: local_gems_to_eval,
+  prefix: "GALTZO_FLOSS",
+  path_env: "GALTZO_FLOSS_DEV",
+  vendored_gems_env: "GALTZO_FLOSS_VENDORED_GEMS",
+  vendor_gem_dir_env: "GALTZO_FLOSS_VENDOR_GEM_DIR",
+  debug_env: "GALTZO_FLOSS_DEBUG"
+)

data/lib/kettle/jem/templates/gemfiles/modular/erb/r2/v3.0.gemfile.example

@@ -0,0 +1 @@
+gem "erb", "~> 3.0"   # ruby >= 2.7.0

data/lib/kettle/jem/templates/gemfiles/modular/erb/r2.3/default.gemfile.example

@@ -0,0 +1,6 @@
+# The cake is a lie.
+# erb v2.2, the oldest release, was never compatible with Ruby 2.3.
+# In addition, erb does not follow SemVer, and old rubies get dropped in a patch.
+# This means we have no choice but to use the erb that shipped with Ruby 2.3
+# /opt/hostedtoolcache/Ruby/2.3.8/x64/lib/ruby/gems/2.3.0/gems/erb-2.2.2/lib/erb.rb:670:in `prepare_trim_mode': undefined method `match?' for "-":String (NoMethodError)
+# gem "erb", ">= 2.2"   # ruby >= 2.3.0

data/lib/kettle/jem/templates/gemfiles/modular/erb/r2.6/v2.2.gemfile.example

@@ -0,0 +1,3 @@
+# Ruby >= 2.3.0 (claimed, but not true, minimum support is Ruby 2.4)
+# Last version supporting Ruby <= 2.6
+gem "erb", "~> 2.2.2"

data/lib/kettle/jem/templates/gemfiles/modular/erb/r3/v5.0.gemfile.example

@@ -0,0 +1 @@
+gem "erb", "~> 6.0", ">= 6.0.7"   # ruby >= 3.2.0

data/lib/kettle/jem/templates/gemfiles/modular/erb/r3.1/v4.0.gemfile.example

@@ -0,0 +1,2 @@
+# last version compatible with Ruby 3.1
+gem "erb", "~> 4.0"   # ruby >= 2.7.0

data/lib/kettle/jem/templates/gemfiles/modular/erb/r4/v5.0.gemfile.example

@@ -0,0 +1 @@
+gem "erb", "~> 6.0", ">= 6.0.7"   # ruby >= 3.2.0

data/lib/kettle/jem/templates/gemfiles/modular/erb/vHEAD.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 3.2
+gem "erb", github: "ruby/erb", branch: "master"

data/lib/kettle/jem/templates/gemfiles/modular/json/truffleruby_22_3.gemfile.example

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+if RUBY_ENGINE == "truffleruby" && RUBY_ENGINE_VERSION.start_with?("22.3")
+  # TruffleRuby 22.3 ships the json default gem from its emulated MRI Ruby.
+  gem "json", "= 2.5.1"
+end

data/lib/kettle/jem/templates/gemfiles/modular/json/truffleruby_23_0.gemfile.example

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+if RUBY_ENGINE == "truffleruby" && RUBY_ENGINE_VERSION.start_with?("23.0")
+  # TruffleRuby 23.0 ships the json default gem from its emulated MRI Ruby.
+  gem "json", "= 2.6.1"
+end

data/lib/kettle/jem/templates/gemfiles/modular/json/truffleruby_23_1.gemfile.example

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+if RUBY_ENGINE == "truffleruby" && RUBY_ENGINE_VERSION.start_with?("23.1")
+  # TruffleRuby 23.1 ships the json default gem from its emulated MRI Ruby.
+  gem "json", "= 2.6.3"
+end

data/lib/kettle/jem/templates/gemfiles/modular/mutex_m/r2/v0.3.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.5
+gem "mutex_m", "~> 0.2"

data/lib/kettle/jem/templates/gemfiles/modular/mutex_m/r2.4/v0.1.gemfile.example

@@ -0,0 +1,3 @@
+# Ruby >= 0
+# Last version supporting Ruby <= 2.4
+gem "mutex_m", "~> 0.1"

data/lib/kettle/jem/templates/gemfiles/modular/mutex_m/r3/v0.3.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.5
+gem "mutex_m", "~> 0.2"

data/lib/kettle/jem/templates/gemfiles/modular/mutex_m/r4/v0.3.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.5
+gem "mutex_m", "~> 0.2"

data/lib/kettle/jem/templates/gemfiles/modular/mutex_m/vHEAD.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.5 (dependency of omniauth)
+gem "mutex_m", github: "ruby/mutex_m", branch: "master"

data/lib/kettle/jem/templates/gemfiles/modular/optional.gemfile.example

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# To retain during kettle-jem templating:
+#     {KJ|FREEZE_TOKEN}:freeze
+#     # ... your code
+#     {KJ|FREEZE_TOKEN}:unfreeze
+#
+
+# Optional dependencies are not depended on directly, but may be used if present.
+
+# Required for curated binstubs generated by kettle-jem install
+gem "rbs", ">= 3.0", require: false # ruby >= 3.1
+
+# Required for kettle-pre-release
+# URL parsing with Unicode support (falls back to URI if not available)
+gem "addressable", ">= 2.8", "< 3" # ruby >= 2.2