kettle-rb

A collection of freeze-dried and vacuum-sealed Yak shavings for Ruby development & testing.

AST Merging and Templating Gems

Gem	Format	Parser	Description
tree_haver	ASTs	ALL	Cross-Ruby adapter for the tree-sitter & citrus parsing libraries; supporting MRI Ruby, JRuby, & TruffleRuby
ast-merge	Text	internal	Shared infrastructure for all `*-merge` gems
prism-merge	Ruby	Prism	Smart merge for Ruby source files
psych-merge	YAML	Psych	Smart merge for YAML files
json-merge	JSON	tree-sitter-json	Smart merge for JSON files
jsonc-merge	JSONC	tree-sitter-jsonc	⚠️ Proof of concept; Smart merge for JSON with Comments
bash-merge	Bash	tree-sitter-bash	Smart merge for Bash scripts
rbs-merge	RBS	RBS	Smart merge for Ruby type signatures
dotenv-merge	Dotenv	internal (dotenv)	Smart merge for `.env` files
toml-merge	TOML	tree-sitter-toml	Smart merge for TOML files
markdown-merge	Markdown	base classes	Shared foundation for Markdown mergers
markly-merge	Markdown	Markly	Smart merge for Markdown (CommonMark via libcmark-gfm)
commonmarker-merge	Markdown	Commonmarker	Smart merge for Markdown (CommonMark via comrak)

Example implementations for the gem templating use case:

Gem	Purpose	Description
kettle-jem	Gem Templating	Gem template library with smart merge support

Gem	Purpose	Description
kettle-dev	Gem Development	Complete rake & dev harness for Ruby development; tasks for coverage, GHA console, linting, debugging, etc.

Gem	Purpose	Description
kettle-test	Spec Development	Complete RSpec test harness, temporal manipulation, silent output testing, block expectations, etc.
kettle-soup-cover	Test Coverage Harness	A Covered Kettle of SOUP. Configure SimpleCov in 4 LOC for every CI platform, w/ 12-factor ENV-based controls

Gem	Purpose	Description
kettle-wash	Spec Development	Coming soon! Runner up name: "constant_change". Provides a pattern for resetting constants for consistent deterministic results.