🎨 Template bootstrap by kettle-jem v1.0.0

Author: pboling

.kettle-jem.yml

@@ -77,6 +77,14 @@
 #
 # Everything else should be set explicitly here or via ENV.
 
+# This project's identifying emoji.
+# Used as the leading emoji in the README H1 heading and in the gemspec
+# summary and description. Every gem should have its own unique emoji.
+#
+# Set this to a single emoji that represents your gem. Examples: 🪙 🔑 🛠️ 🔮
+# This key is REQUIRED. kettle-jem will abort if it is absent.
+# ENV override: KJ_PROJECT_EMOJI
+project_emoji: ""
 # Engines this project supports.
 # List the Ruby engines that your gem targets. kettle-jem uses this to decide
 # which CI workflows, README compatibility rows, and badge references to

CONTRIBUTING.md

@@ -14,13 +14,15 @@ Take a look at the `reek` list which is the file called `REEK` and find somethin
 
 Follow these instructions:
 
-1. Fork the repository
-2. Create a feature branch (`git checkout -b my-new-feature`)
-3. Make some fixes.
-4. Commit changes (`git commit -am 'Added some feature'`)
-5. Push to the branch (`git push origin my-new-feature`)
-6. Make sure to add tests for it. This is important, so it doesn't break in a future release.
-7. Create new Pull Request.
+1. Join the Discord: [![Live Chat on Discord][✉️discord-invite-img]][✉️discord-invite]
+2. Fork the repository
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Make some fixes.
+5. Commit your changes (`git commit -am 'Added some feature'`)
+6. Push to the branch (`git push origin my-new-feature`)
+7. Make sure to add tests for it. This is important, so it doesn't break in a future release.
+8. Create new Pull Request.
+9. Announce it in the channel for this org in the [Discord][✉️discord-invite]!
 
 ```shell
 bin/rake -T
@@ -42,15 +44,6 @@ Coverage (kettle-soup-cover / SimpleCov)
 Executables shipped by dependencies, such as kettle-dev, and stone_checksums, are available
 after running `bin/setup`. These include:
 
-- gem_checksums
-- kettle-changelog
-- kettle-commit-msg
-- kettle-dev-setup
-- kettle-dvcs
-- kettle-pre-release
-- kettle-readme-backers
-- kettle-release
-
 - K_SOUP_COV_DO: Enable coverage collection (default: true in `mise.toml`)
 - K_SOUP_COV_FORMATTERS: Comma-separated list of formatters (html, xml, rcov, lcov, json, tty)
 - K_SOUP_COV_MIN_LINE: Minimum line coverage threshold (integer, e.g., 100)
@@ -78,6 +71,15 @@ Git hooks and commit message helpers (exe/kettle-commit-msg)
 - GIT_HOOK_FOOTER_SENTINEL: Required when footer append is enabled — a unique first-line sentinel to prevent duplicates
 - GIT_HOOK_FOOTER_APPEND_DEBUG: Extra debug output in the footer template (true/false)
 
+- gem_checksums
+- kettle-changelog
+- kettle-commit-msg
+- kettle-dev-setup
+- kettle-dvcs
+- kettle-pre-release
+- kettle-readme-backers
+- kettle-release
+
 There are many Rake tasks available as well. You can see them by running:
 
 For a quick starting point, this repository’s `mise.toml` defines the shared defaults, and `.env.local` can override them locally. Copy `.env.local.example` to `.env.local`, use `KEY=value` lines, and either activate `mise` in your shell or run commands through `mise exec -C /path/to/project -- ...`.
@@ -232,3 +234,4 @@ NOTE: To build without signing the gem set `SKIP_GEM_SIGNING` to any value in th
 [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
 [🚎appraisal2]: https://github.com/appraisal-rb/appraisal2
 [🏃‍♂️runner-tool-cache]: https://github.com/ruby/ruby-builder/releases/tag/toolcache
+[✉️discord-invite]: https://discord.gg/3qme4XHNKN

README.md

@@ -7,7 +7,7 @@
 [🖼️ruby-oauth-i]: https://logos.galtzo.com/assets/images/ruby-oauth/avatar-192px.svg
 [🖼️ruby-oauth]: https://github.com/ruby-oauth
 
-# 🍲 VersionGem
+# 🔖 VersionGem
 
 [![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license-ref] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![Open Source Helpers][👽oss-helpi]][👽oss-help] [![CodeCov Test Coverage][🏀codecovi]][🏀codecov] [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls] [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov] [![QLTY Maintainability][🏀qlty-mnti]][🏀qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![CodeQL][🖐codeQL-img]][🖐codeQL] [![Apache SkyWalking Eyes License Compatibility Check][🚎15-🪪-wfi]][🚎15-🪪-wf]
 

gemfiles/modular/templating.gemfile

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+remote = ENV.fetch("KETTLE_RB_DEV", "false").casecmp("false").zero?
+
+# Cross-platform parsers
 gem "toml"
 gem "parslet"
 gem "prism", "~> 1.6"
@@ -17,6 +20,10 @@ platform :mri do
     "~> 2.1",
     require: false # DO NOT LOAD, because conflicts with FFI
 
+  if remote
+    # AST parsing for advanced templating.
+    # Kettle-rb's Merge Recipes (released)
+  end
   # AST parsing for advanced templating.
   # Set KETTLE_RB_DEV=true (or path) for local development with path-based dependencies.
   # When false (default / CI), gemspec runtime dependencies are used (no extras needed here).
@@ -27,3 +34,8 @@ platform :mri do
     eval_gemfile "templating_local.gemfile"
   end
 end
+
+# Set KETTLE_RB_DEV=true (or path) for local development with path-based dependencies.
+# When false (default / CI), released gems are used and explicit parser pins are needed.
+# Local path overrides — merge gems bring their own parser dependencies
+eval_gemfile "templating_local.gemfile" unless remote

lib/version_gem.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "version_gem"
 require_relative "version_gem/version"
 
 require_relative "version_gem/basic"

mise.toml

@@ -1,35 +1,34 @@
 # Shared development environment for this gem.
 # Local overrides belong in .env.local (loaded via dotenvy through mise).
-
 [env]
+DEBUG = "false"
+FLOSS_CFG_FUND_DEBUG = "false"
+FLOSS_CFG_FUND_LOGFILE = "tmp/log/debug.log"
+FUNDING_ORG = "ruby-oauth"
+KETTLE_DEV_DEBUG = "false"
+KETTLE_TEST_SILENT = "true"
 KJ_PROJECT_EMOJI = "🔖"
+K_SOUP_COV_COMMAND_NAME = "Test Coverage"
+K_SOUP_COV_DO = "true"
+K_SOUP_COV_FORMATTERS = "html,xml,rcov,lcov,json,tty"
+K_SOUP_COV_MIN_BRANCH = "76"
+K_SOUP_COV_MIN_HARD = "true"
+K_SOUP_COV_MIN_LINE = "92"
+K_SOUP_COV_MULTI_FORMATTERS = "true"
+K_SOUP_COV_OPEN_BIN = ""
+MAX_ROWS = "1"
+OPENCOLLECTIVE_HANDLE = "ruby-oauth"
+RUBOCOP_LTS_LOCAL = "false"
 TREE_SITTER_BASH_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-bash.so"
 TREE_SITTER_CSS_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-css.so"
 TREE_SITTER_JAVASCRIPT_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-javascript.so"
-TREE_SITTER_JSON_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-json.so"
 TREE_SITTER_JSONC_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-jsonc.so"
+TREE_SITTER_JSON_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-json.so"
 TREE_SITTER_PYTHON_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-python.so"
 TREE_SITTER_RBS_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-rbs.so"
 TREE_SITTER_RUBY_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-ruby.so"
 TREE_SITTER_TOML_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-toml.so"
 TREE_SITTER_YAML_PATH = "/home/pboling/.local/lib/tree-sitter/libtree-sitter-yaml.so"
-K_SOUP_COV_DO = "true"
-K_SOUP_COV_COMMAND_NAME = "Test Coverage"
-K_SOUP_COV_FORMATTERS = "html,xml,rcov,lcov,json,tty"
-K_SOUP_COV_MIN_BRANCH = "76"
-K_SOUP_COV_MIN_LINE = "92"
-K_SOUP_COV_MIN_HARD = "true"
-K_SOUP_COV_MULTI_FORMATTERS = "true"
-K_SOUP_COV_OPEN_BIN = ""
-MAX_ROWS = "1"
-KETTLE_TEST_SILENT = "true"
-KETTLE_DEV_DEBUG = "false"
-DEBUG = "false"
-FLOSS_CFG_FUND_DEBUG = "false"
-FLOSS_CFG_FUND_LOGFILE = "tmp/log/debug.log"
-RUBOCOP_LTS_LOCAL = "false"
-OPENCOLLECTIVE_HANDLE = "ruby-oauth"
-FUNDING_ORG = "ruby-oauth"
-_.path = ["exe", "bin"]
 _.file = { path = ".env.local", redact = true }
+_.path = ["exe", "bin"]
 _.source = ".config/mise/env.sh"

parsers.toml

@@ -0,0 +1,19 @@
+# tsdl configuration — tree-sitter grammar versions
+# https://github.com/stackmystack/tsdl
+#
+# Run: tsdl build --out-dir /usr/local/lib
+# Or let .devcontainer/scripts/setup-tree-sitter.sh handle it.
+
+out-dir = "/usr/local/lib"
+
+[parsers]
+json = "v0.24.8"
+bash = "v0.25.1"
+
+[parsers.toml]
+ref = "v0.7.0"
+from = "https://github.com/tree-sitter-grammars/tree-sitter-toml"
+
+[parsers.rbs]
+ref = "v0.2.2"
+from = "https://github.com/joker1007/tree-sitter-rbs"

version_gem.gemspec

@@ -29,8 +29,8 @@ Gem::Specification.new do |spec|
   spec.authors = ["Peter Boling"]
   spec.email = ["floss@galtzo.com", "oauth-ruby@googlegroups.com"]
 
-  spec.summary = "🍲 Enhance your VERSION! Sugar for Version modules."
-  spec.description = "🍲 Versions are good. Versions are cool. Versions will win."
+  spec.summary = "🔖 Enhance your VERSION! Sugar for Version modules."
+  spec.description = "🔖 Versions are good. Versions are cool. Versions will win."
   spec.homepage = "https://github.com/ruby-oauth/version_gem"
   spec.licenses = ["MIT"]
   spec.required_ruby_version = ">= 2.2"