bash-merge 2.0.6 → 7.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/README.md CHANGED
@@ -1,34 +1,27 @@
1
- [![Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0][🖼️galtzo-i]][🖼️galtzo-discord] [![ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5][🖼️ruby-lang-i]][🖼️ruby-lang] [![kettle-rb Logo by Aboling0, CC BY-SA 4.0][🖼️kettle-rb-i]][🖼️kettle-rb]
2
-
3
- [🖼️galtzo-i]: https://logos.galtzo.com/assets/images/galtzo-floss/avatar-192px.svg
4
- [🖼️galtzo-discord]: https://discord.gg/3qme4XHNKN
5
- [🖼️ruby-lang-i]: https://logos.galtzo.com/assets/images/ruby-lang/avatar-192px.svg
6
- [🖼️ruby-lang]: https://www.ruby-lang.org/
7
- [🖼️kettle-rb-i]: https://logos.galtzo.com/assets/images/kettle-rb/avatar-192px.svg
8
- [🖼️kettle-rb]: https://github.com/kettle-rb
1
+ <a href="https://github.com/structuredmerge"><img alt="structuredmerge Logo by GitHub" src="https://github.com/structuredmerge.png?size=192" width="14%" align="right"/></a>
9
2
 
10
3
  # ☯️ Bash::Merge
11
4
 
12
- [![Version][👽versioni]][bash-merge-gem] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license-ref] [![Downloads Rank][👽dl-ranki]][bash-merge-gem] [![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]][bash-merge-ci] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Supported][🚎6-s-wfi]][🚎6-s-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]
5
+ [![Version][👽versioni]][👽version] [![Ruby Users Forum][✉️ruby-forum-top-img]][✉️ruby-forum] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: AGPL-3.0-only OR PolyForm-Small-Business-1.0.0][📄license-img]][📄license] [![Total downloads][👽dl-ranki]][👽dl-rank] [![CI Current][🚎11-c-wfi]][🚎11-c-wf]
13
6
 
14
- `if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][🖼️galtzo-discord], as I may have missed the [discord notification][🖼️galtzo-discord].
7
+ `if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know on Discord][✉️discord-invite] or [RubyForum][✉️ruby-forum], as I may have missed the notification.
15
8
 
16
- -----
9
+ ---
17
10
 
18
11
  `if ci_badges.map(&:color).all? { it == "green"}` 👇️ send money so I can do more of this. FLOSS maintenance is now my full-time job.
19
12
 
20
- [![OpenCollective Backers][🖇osc-backers-i]][🖇osc-backers] [![OpenCollective Sponsors][🖇osc-sponsors-i]][🖇osc-sponsors] [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate at ko-fi.com][🖇kofi-img]][🖇kofi]
13
+ [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate at ko-fi.com][🖇kofi-img]][🖇kofi]
21
14
 
22
- <details>
23
- <summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
15
+ <details markdown="1">
16
+ <summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
24
17
 
25
18
  I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo).
26
19
 
27
20
  </details>
28
21
 
29
- ## 🌻 Synopsis
22
+ ## 🌻 Synopsis <a href="https://discord.gg/3qme4XHNKN"><img alt="Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px.svg" width="8%" align="right"/></a> <a href="https://ruby-toolbox.com"><img alt="ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5" src="https://logos.galtzo.com/assets/images/ruby-lang/avatar-128px.svg" width="8%" align="right"/></a>
30
23
 
31
- Bash::Merge is a standalone Ruby module that intelligently merges two versions of a Bash script using tree-sitter AST analysis. It's like a smart "git merge" specifically designed for shell scripts. Built on top of [ast-merge][ast-merge], it shares the same architecture as [prism-merge][prism-merge] for Ruby source files.
24
+ Bash::Merge intelligently merges two versions of a Bash script using the StructuredMerge Ruby stack. It is built on [ast-merge][ast-merge] and [tree_haver][tree_haver], with Bash parsing supplied through the current tree-sitter language-pack backend.
32
25
 
33
26
  ### Key Features
34
27
 
@@ -39,7 +32,7 @@ Bash::Merge is a standalone Ruby module that intelligently merges two versions o
39
32
  - **Shebang Handling**: Properly handles `#!/bin/bash` and similar shebangs
40
33
  - **Freeze Block Support**: Respects freeze markers (default: `bash-merge:freeze` / `bash-merge:unfreeze`) for merge control - customizable to match your project's conventions
41
34
  - **Full Provenance**: Tracks origin of every node
42
- - **Standalone**: Minimal dependencies - just `ast-merge` and `ruby_tree_sitter`
35
+ - **StructuredMerge Native**: Depends on `ast-merge` and `tree_haver`; parser availability comes from the registered backend providers
43
36
  - **Customizable**:
44
37
  - `signature_generator` - callable custom signature generators
45
38
  - `preference` - setting of `:template`, `:destination`, or a Hash for per-node-type preferences
@@ -49,16 +42,16 @@ Bash::Merge is a standalone Ruby module that intelligently merges two versions o
49
42
 
50
43
  ### Supported Node Types
51
44
 
52
- | Node Type | Signature Format | Matching Behavior |
53
- | --- | --- | --- |
54
- | Function Definition | `[:function, name]` | Functions match by name |
55
- | Variable Assignment | `[:assignment, name]` | Variables match by name |
56
- | Command | `[:command, name, args...]` | Commands match by name and arguments |
57
- | Comment | `[:comment, text]` | Comments preserved in context |
58
- | Pipeline | `[:pipeline, commands...]` | Pipelines match by command sequence |
59
- | If Statement | `[:if, condition_sig]` | Conditionals match by condition signature |
60
- | For Loop | `[:for, variable]` | For loops match by loop variable |
61
- | While Loop | `[:while, condition_sig]` | While loops match by condition signature |
45
+ | Node Type | Signature Format | Matching Behavior |
46
+ |---------------------|-----------------------------|-------------------------------------------|
47
+ | Function Definition | `[:function, name]` | Functions match by name |
48
+ | Variable Assignment | `[:assignment, name]` | Variables match by name |
49
+ | Command | `[:command, name, args...]` | Commands match by name and arguments |
50
+ | Comment | `[:comment, text]` | Comments preserved in context |
51
+ | Pipeline | `[:pipeline, commands...]` | Pipelines match by command sequence |
52
+ | If Statement | `[:if, condition_sig]` | Conditionals match by condition signature |
53
+ | For Loop | `[:for, variable]` | For loops match by loop variable |
54
+ | While Loop | `[:while, condition_sig]` | While loops match by condition signature |
62
55
 
63
56
  ### Example
64
57
 
@@ -74,211 +67,47 @@ result = merger.merge
74
67
  File.write("merged.sh", result.to_bash)
75
68
  ```
76
69
 
77
- ### The `*-merge` Gem Family
78
-
79
- The `*-merge` gem family provides intelligent, AST-based merging for various file formats. At the foundation is [tree_haver][tree_haver], which provides a unified cross-Ruby parsing API that works seamlessly across MRI, JRuby, and TruffleRuby.
80
-
81
- | Gem | Version / CI | Language<br>/ Format | Parser Backend(s) | Description |
82
- |------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------:|----------------------|-------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
83
- | [tree_haver][tree_haver] | [![Version][tree_haver-gem-i]][tree_haver-gem] <br/> [![CI][tree_haver-ci-i]][tree_haver-ci] | Multi | Supported Backends: MRI C, Rust, FFI, Java, Prism, Psych, Commonmarker, Markly, Citrus, Parslet | **Foundation**: Cross-Ruby adapter for parsing libraries (like Faraday for HTTP) |
84
- | [ast-merge][ast-merge] | [![Version][ast-merge-gem-i]][ast-merge-gem] <br/> [![CI][ast-merge-ci-i]][ast-merge-ci] | Text | internal | **Infrastructure**: Shared base classes and merge logic for all `*-merge` gems |
85
- | [bash-merge][bash-merge] | [![Version][bash-merge-gem-i]][bash-merge-gem] <br/> [![CI][bash-merge-ci-i]][bash-merge-ci] | Bash | [tree-sitter-bash][ts-bash] (via tree_haver) | Smart merge for Bash scripts |
86
- | [commonmarker-merge][commonmarker-merge] | [![Version][commonmarker-merge-gem-i]][commonmarker-merge-gem] <br/> [![CI][commonmarker-merge-ci-i]][commonmarker-merge-ci] | Markdown | [Commonmarker][commonmarker] (via tree_haver) | Smart merge for Markdown (CommonMark via comrak Rust) |
87
- | [dotenv-merge][dotenv-merge] | [![Version][dotenv-merge-gem-i]][dotenv-merge-gem] <br/> [![CI][dotenv-merge-ci-i]][dotenv-merge-ci] | Dotenv | internal | Smart merge for `.env` files |
88
- | [json-merge][json-merge] | [![Version][json-merge-gem-i]][json-merge-gem] <br/> [![CI][json-merge-ci-i]][json-merge-ci] | JSON | [tree-sitter-json][ts-json] (via tree_haver) | Smart merge for JSON files |
89
- | [jsonc-merge][jsonc-merge] | [![Version][jsonc-merge-gem-i]][jsonc-merge-gem] <br/> [![CI][jsonc-merge-ci-i]][jsonc-merge-ci] | JSONC | [tree-sitter-jsonc][ts-jsonc] (via tree_haver) | ⚠️ Proof of concept; Smart merge for JSON with Comments |
90
- | [markdown-merge][markdown-merge] | [![Version][markdown-merge-gem-i]][markdown-merge-gem] <br/> [![CI][markdown-merge-ci-i]][markdown-merge-ci] | Markdown | [Commonmarker][commonmarker] / [Markly][markly] (via tree_haver), [Parslet][parslet] | **Foundation**: Shared base for Markdown mergers with inner code block merging |
91
- | [markly-merge][markly-merge] | [![Version][markly-merge-gem-i]][markly-merge-gem] <br/> [![CI][markly-merge-ci-i]][markly-merge-ci] | Markdown | [Markly][markly] (via tree_haver) | Smart merge for Markdown (CommonMark via cmark-gfm C) |
92
- | [prism-merge][prism-merge] | [![Version][prism-merge-gem-i]][prism-merge-gem] <br/> [![CI][prism-merge-ci-i]][prism-merge-ci] | Ruby | [Prism][prism] (`prism` std lib gem) | Smart merge for Ruby source files |
93
- | [psych-merge][psych-merge] | [![Version][psych-merge-gem-i]][psych-merge-gem] <br/> [![CI][psych-merge-ci-i]][psych-merge-ci] | YAML | [Psych][psych] (`psych` std lib gem) | Smart merge for YAML files |
94
- | [rbs-merge][rbs-merge] | [![Version][rbs-merge-gem-i]][rbs-merge-gem] <br/> [![CI][rbs-merge-ci-i]][rbs-merge-ci] | RBS | [tree-sitter-bash][ts-rbs] (via tree_haver), [RBS][rbs] (`rbs` std lib gem) | Smart merge for Ruby type signatures |
95
- | [toml-merge][toml-merge] | [![Version][toml-merge-gem-i]][toml-merge-gem] <br/> [![CI][toml-merge-ci-i]][toml-merge-ci] | TOML | [Parslet + toml][toml], [Citrus + toml-rb][toml-rb], [tree-sitter-toml][ts-toml] (all via tree_haver) | Smart merge for TOML files |
96
-
97
- #### Backend Platform Compatibility
98
-
99
- tree_haver supports multiple parsing backends, but not all backends work on all Ruby platforms:
100
-
101
- | Platform 👉️<br> TreeHaver Backend 👇️ | MRI | JRuby | TruffleRuby | Notes |
102
- |-------------------------------------------------|:---:|:-----:|:-----------:|----------------------------------------------------------------------------|
103
- | **MRI** ([ruby_tree_sitter][ruby_tree_sitter]) | ✅ | ❌ | ❌ | C extension, MRI only |
104
- | **Rust** ([tree_stump][tree_stump]) | ✅ | ❌ | ❌ | Rust extension via magnus/rb-sys, MRI only |
105
- | **FFI** ([ffi][ffi]) | ✅ | ✅ | ❌ | TruffleRuby's FFI doesn't support `STRUCT_BY_VALUE` |
106
- | **Java** ([jtreesitter][jtreesitter]) | ❌ | ✅ | ❌ | JRuby only, requires grammar JARs |
107
- | **Prism** ([prism][prism]) | ✅ | ✅ | ✅ | Ruby parsing, stdlib in Ruby 3.4+ |
108
- | **Psych** ([psych][psych]) | ✅ | ✅ | ✅ | YAML parsing, stdlib |
109
- | **Citrus** ([citrus][citrus]) | ✅ | ✅ | ✅ | Pure Ruby PEG parser, no native dependencies |
110
- | **Parslet** ([parslet][parslet]) | ✅ | ✅ | ✅ | Pure Ruby PEG parser, no native dependencies |
111
- | **Commonmarker** ([commonmarker][commonmarker]) | ✅ | ❌ | ❓ | Rust extension for Markdown (via [commonmarker-merge][commonmarker-merge]) |
112
- | **Markly** ([markly][markly]) | ✅ | ❌ | ❓ | C extension for Markdown (via [markly-merge][markly-merge]) |
113
-
114
- **Legend**: ✅ = Works, ❌ = Does not work, ❓ = Untested
115
-
116
- **Why some backends don't work on certain platforms**:
117
-
118
- - **JRuby**: Runs on the JVM; cannot load native C/Rust extensions (`.so` files)
119
- - **TruffleRuby**: Has C API emulation via Sulong/LLVM, but it doesn't expose all MRI internals that native extensions require (e.g., `RBasic.flags`, `rb_gc_writebarrier`)
120
- - **FFI on TruffleRuby**: TruffleRuby's FFI implementation doesn't support returning structs by value, which tree-sitter's C API requires
121
-
122
- **Example implementations** for the gem templating use case:
123
-
124
- | Gem | Purpose | Description |
125
- |--------------------------|-----------------|-----------------------------------------------|
126
- | [kettle-dev][kettle-dev] | Gem Development | Gem templating tool using `*-merge` gems |
127
- | [kettle-jem][kettle-jem] | Gem Templating | Gem template library with smart merge support |
128
-
129
- [tree_haver]: https://github.com/kettle-rb/tree_haver
130
- [ast-merge]: https://github.com/kettle-rb/ast-merge
131
- [prism-merge]: https://github.com/kettle-rb/prism-merge
132
- [psych-merge]: https://github.com/kettle-rb/psych-merge
133
- [json-merge]: https://github.com/kettle-rb/json-merge
134
- [jsonc-merge]: https://github.com/kettle-rb/jsonc-merge
135
- [bash-merge]: https://github.com/kettle-rb/bash-merge
136
- [rbs-merge]: https://github.com/kettle-rb/rbs-merge
137
- [dotenv-merge]: https://github.com/kettle-rb/dotenv-merge
138
- [toml-merge]: https://github.com/kettle-rb/toml-merge
139
- [markdown-merge]: https://github.com/kettle-rb/markdown-merge
140
- [markly-merge]: https://github.com/kettle-rb/markly-merge
141
- [commonmarker-merge]: https://github.com/kettle-rb/commonmarker-merge
142
- [kettle-dev]: https://github.com/kettle-rb/kettle-dev
143
- [kettle-jem]: https://github.com/kettle-rb/kettle-jem
144
- [tree_haver-gem]: https://bestgems.org/gems/tree_haver
145
- [ast-merge-gem]: https://bestgems.org/gems/ast-merge
146
- [prism-merge-gem]: https://bestgems.org/gems/prism-merge
147
- [psych-merge-gem]: https://bestgems.org/gems/psych-merge
148
- [json-merge-gem]: https://bestgems.org/gems/json-merge
149
- [jsonc-merge-gem]: https://bestgems.org/gems/jsonc-merge
150
- [bash-merge-gem]: https://bestgems.org/gems/bash-merge
151
- [rbs-merge-gem]: https://bestgems.org/gems/rbs-merge
152
- [dotenv-merge-gem]: https://bestgems.org/gems/dotenv-merge
153
- [toml-merge-gem]: https://bestgems.org/gems/toml-merge
154
- [markdown-merge-gem]: https://bestgems.org/gems/markdown-merge
155
- [markly-merge-gem]: https://bestgems.org/gems/markly-merge
156
- [commonmarker-merge-gem]: https://bestgems.org/gems/commonmarker-merge
157
- [kettle-dev-gem]: https://bestgems.org/gems/kettle-dev
158
- [kettle-jem-gem]: https://bestgems.org/gems/kettle-jem
159
- [tree_haver-gem-i]: https://img.shields.io/gem/v/tree_haver.svg
160
- [ast-merge-gem-i]: https://img.shields.io/gem/v/ast-merge.svg
161
- [prism-merge-gem-i]: https://img.shields.io/gem/v/prism-merge.svg
162
- [psych-merge-gem-i]: https://img.shields.io/gem/v/psych-merge.svg
163
- [json-merge-gem-i]: https://img.shields.io/gem/v/json-merge.svg
164
- [jsonc-merge-gem-i]: https://img.shields.io/gem/v/jsonc-merge.svg
165
- [bash-merge-gem-i]: https://img.shields.io/gem/v/bash-merge.svg
166
- [rbs-merge-gem-i]: https://img.shields.io/gem/v/rbs-merge.svg
167
- [dotenv-merge-gem-i]: https://img.shields.io/gem/v/dotenv-merge.svg
168
- [toml-merge-gem-i]: https://img.shields.io/gem/v/toml-merge.svg
169
- [markdown-merge-gem-i]: https://img.shields.io/gem/v/markdown-merge.svg
170
- [markly-merge-gem-i]: https://img.shields.io/gem/v/markly-merge.svg
171
- [commonmarker-merge-gem-i]: https://img.shields.io/gem/v/commonmarker-merge.svg
172
- [kettle-dev-gem-i]: https://img.shields.io/gem/v/kettle-dev.svg
173
- [kettle-jem-gem-i]: https://img.shields.io/gem/v/kettle-jem.svg
174
- [tree_haver-ci-i]: https://github.com/kettle-rb/tree_haver/actions/workflows/current.yml/badge.svg
175
- [ast-merge-ci-i]: https://github.com/kettle-rb/ast-merge/actions/workflows/current.yml/badge.svg
176
- [prism-merge-ci-i]: https://github.com/kettle-rb/prism-merge/actions/workflows/current.yml/badge.svg
177
- [psych-merge-ci-i]: https://github.com/kettle-rb/psych-merge/actions/workflows/current.yml/badge.svg
178
- [json-merge-ci-i]: https://github.com/kettle-rb/json-merge/actions/workflows/current.yml/badge.svg
179
- [jsonc-merge-ci-i]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/current.yml/badge.svg
180
- [bash-merge-ci-i]: https://github.com/kettle-rb/bash-merge/actions/workflows/current.yml/badge.svg
181
- [rbs-merge-ci-i]: https://github.com/kettle-rb/rbs-merge/actions/workflows/current.yml/badge.svg
182
- [dotenv-merge-ci-i]: https://github.com/kettle-rb/dotenv-merge/actions/workflows/current.yml/badge.svg
183
- [toml-merge-ci-i]: https://github.com/kettle-rb/toml-merge/actions/workflows/current.yml/badge.svg
184
- [markdown-merge-ci-i]: https://github.com/kettle-rb/markdown-merge/actions/workflows/current.yml/badge.svg
185
- [markly-merge-ci-i]: https://github.com/kettle-rb/markly-merge/actions/workflows/current.yml/badge.svg
186
- [commonmarker-merge-ci-i]: https://github.com/kettle-rb/commonmarker-merge/actions/workflows/current.yml/badge.svg
187
- [kettle-dev-ci-i]: https://github.com/kettle-rb/kettle-dev/actions/workflows/current.yml/badge.svg
188
- [kettle-jem-ci-i]: https://github.com/kettle-rb/kettle-jem/actions/workflows/current.yml/badge.svg
189
- [tree_haver-ci]: https://github.com/kettle-rb/tree_haver/actions/workflows/current.yml
190
- [ast-merge-ci]: https://github.com/kettle-rb/ast-merge/actions/workflows/current.yml
191
- [prism-merge-ci]: https://github.com/kettle-rb/prism-merge/actions/workflows/current.yml
192
- [psych-merge-ci]: https://github.com/kettle-rb/psych-merge/actions/workflows/current.yml
193
- [json-merge-ci]: https://github.com/kettle-rb/json-merge/actions/workflows/current.yml
194
- [jsonc-merge-ci]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/current.yml
195
- [bash-merge-ci]: https://github.com/kettle-rb/bash-merge/actions/workflows/current.yml
196
- [rbs-merge-ci]: https://github.com/kettle-rb/rbs-merge/actions/workflows/current.yml
197
- [dotenv-merge-ci]: https://github.com/kettle-rb/dotenv-merge/actions/workflows/current.yml
198
- [toml-merge-ci]: https://github.com/kettle-rb/toml-merge/actions/workflows/current.yml
199
- [markdown-merge-ci]: https://github.com/kettle-rb/markdown-merge/actions/workflows/current.yml
200
- [markly-merge-ci]: https://github.com/kettle-rb/markly-merge/actions/workflows/current.yml
201
- [commonmarker-merge-ci]: https://github.com/kettle-rb/commonmarker-merge/actions/workflows/current.yml
202
- [kettle-dev-ci]: https://github.com/kettle-rb/kettle-dev/actions/workflows/current.yml
203
- [kettle-jem-ci]: https://github.com/kettle-rb/kettle-jem/actions/workflows/current.yml
204
- [prism]: https://github.com/ruby/prism
205
- [psych]: https://github.com/ruby/psych
206
- [ffi]: https://github.com/ffi/ffi
207
- [ts-json]: https://github.com/tree-sitter/tree-sitter-json
208
- [ts-jsonc]: https://gitlab.com/WhyNotHugo/tree-sitter-jsonc
209
- [ts-bash]: https://github.com/tree-sitter/tree-sitter-bash
210
- [ts-rbs]: https://github.com/joker1007/tree-sitter-rbs
211
- [ts-toml]: https://github.com/tree-sitter-grammars/tree-sitter-toml
212
- [dotenv]: https://github.com/bkeepers/dotenv
213
- [rbs]: https://github.com/ruby/rbs
214
- [toml-rb]: https://github.com/emancu/toml-rb
215
- [toml]: https://github.com/jm/toml
216
- [markly]: https://github.com/ioquatix/markly
217
- [commonmarker]: https://github.com/gjtorikian/commonmarker
218
- [ruby_tree_sitter]: https://github.com/Faveod/ruby-tree-sitter
219
- [tree_stump]: https://github.com/joker1007/tree_stump
220
- [jtreesitter]: https://central.sonatype.com/artifact/io.github.tree-sitter/jtreesitter
221
- [citrus]: https://github.com/mjackson/citrus
222
- [parslet]: https://github.com/kschiess/parslet
70
+ [ast-merge]: https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/ast-merge
71
+ [tree_haver]: https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/tree_haver
223
72
 
224
73
  ## 💡 Info you can shake a stick at
225
74
 
226
- | Tokens to Remember | [![Gem name][⛳️name-img]][bash-merge-gem] [![Gem namespace][⛳️namespace-img]][bash-merge] |
227
- | --- | --- |
228
- | Works with JRuby | [![JRuby 10.0 Compat][💎jruby-c-i]][bash-merge-ci] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf] |
229
- | Works with Truffle Ruby | [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎9-t-wf] [![Truffle Ruby 24.1 Compat][💎truby-c-i]][bash-merge-ci] |
230
- | Works with MRI Ruby 3 | [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎6-s-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎6-s-wf] [![Ruby 3.4 Compat][💎ruby-c-i]][bash-merge-ci] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf] |
231
- | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Live Chat on Discord][✉️discord-invite-img-ftb]][🖼️galtzo-discord] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
232
- | Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][bash-merge] [![The best SHA: dQw4w9WgXcQ\!](https://img.shields.io/badge/KLOC-4.308-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue)][🧮kloc] |
75
+ | Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
76
+ |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
77
+ | Works with MRI Ruby 4 | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf]|
78
+ | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Get help from RubyForum][✉️ruby-forum-img]][✉️ruby-forum] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
79
+ | Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on GitHub.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
233
80
  | Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
234
- | Compliance | [![License: MIT][📄license-img]][📄license-ref] [![Compatible with Apache Software Projects: Verified by SkyWalking Eyes][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img][📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
81
+ | Compliance | [![License: AGPL-3.0-only OR PolyForm-Small-Business-1.0.0][📄license-img]][📄license] [![Apache license compatibility: Category X][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
235
82
  | Style | [![Enforced Code Style Linter][💎rlts-img]][💎rlts] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] [![Gitmoji Commits][📌gitmoji-img]][📌gitmoji] [![Compatibility appraised by: appraisal2][💎appraisal2-img]][💎appraisal2] |
236
83
  | Maintainer 🎖️ | [![Follow Me on LinkedIn][💖🖇linkedin-img]][💖🖇linkedin] [![Follow Me on Ruby.Social][💖🐘ruby-mast-img]][💖🐘ruby-mast] [![Follow Me on Bluesky][💖🦋bluesky-img]][💖🦋bluesky] [![Contact Maintainer][🚂maint-contact-img]][🚂maint-contact] [![My technical writing][💖💁🏼‍♂️devto-img]][💖💁🏼‍♂️devto] |
237
- | `...` 💖 | [![Find Me on WellFound:][💖✌️wellfound-img]][💖✌️wellfound] [![Find Me on CrunchBase][💖💲crunchbase-img]][💖💲crunchbase] [![My LinkTree][💖🌳linktree-img]][💖🌳linktree] [![More About Me][💖💁🏼‍♂️aboutme-img]][💖💁🏼‍♂️aboutme] [🧊][💖🧊berg] [🐙][💖🐙hub] [🛖][💖🛖hut] [🧪][💖🧪lab] |
84
+ | `...` 💖 | [![Find Me on WellFound:][💖✌️wellfound-img]][💖✌️wellfound] [![Find Me on CrunchBase][💖💲crunchbase-img]][💖💲crunchbase] [![My LinkTree][💖🌳linktree-img]][💖🌳linktree] [![More About Me][💖💁🏼‍♂️aboutme-img]][💖💁🏼‍♂️aboutme] [🧊][💖🧊berg] [🐙][💖🐙hub] [🛖][💖🛖hut] [🧪][💖🧪lab] |
238
85
 
239
86
  ### Compatibility
240
87
 
241
- Compatible with MRI Ruby 3.2.0+, and concordant releases of JRuby, and TruffleRuby.
88
+ Compatible with MRI Ruby 4.0.0+, and concordant releases of JRuby, and TruffleRuby.
89
+ CI workflows and Appraisals are generated for MRI Ruby 4.0.0+.
90
+ This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
91
+ may be higher than the gem's runtime compatibility floor when legacy Rubies are
92
+ not practical for the current toolchain.
242
93
 
243
- | 🚚 *Amazing* test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚 |
244
- | --- | --- |
245
- | 👟 Check it out\! | ✨ [github.com/appraisal-rb/appraisal2][💎appraisal2] ✨ |
94
+ <a href="https://github.com/kettle-dev"><img alt="kettle-dev Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/kettle-dev/avatar-128px.svg" width="14%" align="right"/></a>
246
95
 
247
- ### Federated DVCS
96
+ The _amazing_ test matrix is powered by the kettle-dev stack.
248
97
 
249
98
  <details markdown="1">
250
- <summary>Find this repo on federated forges (Coming soon!)</summary>
251
-
252
- | Federated [DVCS][💎d-in-dvcs] Repository | Status | Issues | PRs | Wiki | CI | Discussions |
253
- | --- | --- | --- | --- | --- | --- | --- |
254
- | 🧪 [kettle-rb/bash-merge on GitLab][📜src-gl] | The Truth | [💚][🤝gl-issues] | [💚][🤝gl-pulls] | [💚][📜gl-wiki] | 🐭 Tiny Matrix | ➖ |
255
- | 🧊 [kettle-rb/bash-merge on CodeBerg][📜src-cb] | An Ethical Mirror ([Donate][🤝cb-donate]) | [💚][🤝cb-issues] | [💚][🤝cb-pulls] | ➖ | ⭕️ No Matrix | ➖ |
256
- | 🐙 [kettle-rb/bash-merge on GitHub][📜src-gh] | Another Mirror | [💚][🤝gh-issues] | [💚][🤝gh-pulls] | [💚][📜gh-wiki] | 💯 Full Matrix | [💚][gh-discussions] |
257
- | 🎮️ [Discord Server][🖼️galtzo-discord] | [![Live Chat on Discord][✉️discord-invite-img-ftb]][🖼️galtzo-discord] | [Let's][🖼️galtzo-discord] | [talk][🖼️galtzo-discord] | [about][🖼️galtzo-discord] | [this][🖼️galtzo-discord] | [library\!][🖼️galtzo-discord] |
258
-
259
- </details>
260
-
261
- [gh-discussions]: https://github.com/kettle-rb/bash-merge/discussions
262
-
263
- ### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/bash-merge)][🏙️entsup-tidelift]
264
-
265
- Available as part of the Tidelift Subscription.
266
-
267
- <details markdown="1">
268
- <summary>Need enterprise-level guarantees?</summary>
269
-
270
- The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
271
-
272
- [![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]
273
-
274
- - 💡Subscribe for support guarantees covering *all* your FLOSS dependencies
275
- - 💡Tidelift is part of [Sonar][🏙️entsup-tidelift-sonar]
276
- - 💡Tidelift pays maintainers to maintain the software you depend on\!<br/>📊`@`Pointy Haired Boss: An [enterprise support][🏙️entsup-tidelift] subscription is "[never gonna let you down][🧮kloc]", and *supports* open source maintainers
277
- Alternatively:
278
-
279
- - [![Live Chat on Discord][✉️discord-invite-img-ftb]][🖼️galtzo-discord]
280
- - [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork]
281
- - [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]
99
+ <summary>How kettle-dev manages complexity in tests</summary>
100
+
101
+ | Gem | Source | Role | Total downloads |
102
+ |-----|--------|------|---------------------|
103
+ | [appraisal2](https://clickgems.clickhouse.com/dashboard/appraisal2) | [GitHub](https://github.com/appraisal-rb/appraisal2) | multi-dependency Appraisal matrix generation | [![Total downloads for appraisal2](https://img.shields.io/gem/dt/appraisal2.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/appraisal2) |
104
+ | [appraisal2-rubocop](https://clickgems.clickhouse.com/dashboard/appraisal2-rubocop) | [GitHub](https://github.com/appraisal-rb/appraisal2-rubocop) | RuboCop Appraisal generator integration | [![Total downloads for appraisal2-rubocop](https://img.shields.io/gem/dt/appraisal2-rubocop.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/appraisal2-rubocop) |
105
+ | [kettle-dev](https://clickgems.clickhouse.com/dashboard/kettle-dev) | [GitHub](https://github.com/kettle-dev/kettle-dev) | development, release, and CI workflow tooling | [![Total downloads for kettle-dev](https://img.shields.io/gem/dt/kettle-dev.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-dev) |
106
+ | [kettle-jem](https://clickgems.clickhouse.com/dashboard/kettle-jem) | [GitHub](https://github.com/kettle-dev/kettle-jem) | Appraisals & CI workflow templates | [![Total downloads for kettle-jem](https://img.shields.io/gem/dt/kettle-jem.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-jem) |
107
+ | [kettle-soup-cover](https://clickgems.clickhouse.com/dashboard/kettle-soup-cover) | [GitHub](https://github.com/kettle-dev/kettle-soup-cover) | SimpleCov coverage policy and reporting | [![Total downloads for kettle-soup-cover](https://img.shields.io/gem/dt/kettle-soup-cover.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-soup-cover) |
108
+ | [kettle-test](https://clickgems.clickhouse.com/dashboard/kettle-test) | [GitHub](https://github.com/kettle-dev/kettle-test) | standard test runner and coverage harness | [![Total downloads for kettle-test](https://img.shields.io/gem/dt/kettle-test.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-test) |
109
+ | [rubocop-lts](https://clickgems.clickhouse.com/dashboard/rubocop-lts) | [GitHub](https://github.com/rubocop-lts/rubocop-lts) | Ruby-version-aware linting | [![Total downloads for rubocop-lts](https://img.shields.io/gem/dt/rubocop-lts.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/rubocop-lts) |
110
+ | [turbo_tests2](https://clickgems.clickhouse.com/dashboard/turbo_tests2) | [GitHub](https://github.com/galtzo-floss/turbo_tests2) | parallel test execution | [![Total downloads for turbo_tests2](https://img.shields.io/gem/dt/turbo_tests2.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/turbo_tests2) |
282
111
 
283
112
  </details>
284
113
 
@@ -296,188 +125,6 @@ If bundler is not being used to manage dependencies, install the gem by executin
296
125
  gem install bash-merge
297
126
  ```
298
127
 
299
- ### 🔒 Secure Installation
300
-
301
- <details markdown="1">
302
- <summary>For Medium or High Security Installations</summary>
303
-
304
- This gem is cryptographically signed, and has verifiable [SHA-256 and SHA-512][💎SHA_checksums] checksums by
305
- [stone\_checksums][💎stone_checksums]. Be sure the gem you install hasn’t been tampered with
306
- by following the instructions below.
307
-
308
- Add my public key (if you haven’t already, expires 2045-04-29) as a trusted certificate:
309
-
310
- ```console
311
- gem cert --add <(curl -Ls https://raw.github.com/galtzo-floss/certs/main/pboling.pem)
312
- ```
313
-
314
- You only need to do that once. Then proceed to install with:
315
-
316
- ```console
317
- gem install bash-merge -P HighSecurity
318
- ```
319
-
320
- The `HighSecurity` trust profile will verify signed gems, and not allow the installation of unsigned dependencies.
321
-
322
- If you want to up your security game full-time:
323
-
324
- ```console
325
- bundle config set --global trust-policy MediumSecurity
326
- ```
327
-
328
- `MediumSecurity` instead of `HighSecurity` is necessary if not all the gems you use are signed.
329
-
330
- NOTE: Be prepared to track down certs for signed gems and add them the same way you added mine.
331
-
332
- </details>
333
-
334
- ### 🌳 Tree-Sitter Parser Installation
335
-
336
- This gem requires the `tree-sitter-bash` parser library to be installed on your system.
337
- The parser is a native shared library (`.so` on Linux, `.dylib` on macOS) that provides
338
- Bash syntax parsing capabilities.
339
-
340
- #### Option 1: Pre-built Binaries (Recommended)
341
-
342
- Download pre-built parsers from [Faveod/tree-sitter-parsers](https://github.com/Faveod/tree-sitter-parsers/releases):
343
-
344
- **Linux (x64):**
345
-
346
- ```console
347
- # Download and extract
348
- curl -Lo parsers.tar.gz https://github.com/Faveod/tree-sitter-parsers/releases/download/v4.10/tree-sitter-parsers-4.10-linux-x64.tar.gz
349
- tar -xzf parsers.tar.gz
350
-
351
- # Install system-wide (requires sudo)
352
- sudo cp libtree-sitter-bash.so /usr/lib/
353
- sudo ldconfig
354
-
355
- # Or install locally and set environment variable
356
- mkdir -p ~/.local/lib/tree-sitter
357
- cp libtree-sitter-bash.so ~/.local/lib/tree-sitter/
358
- export TREE_SITTER_BASH_PATH="$HOME/.local/lib/tree-sitter/libtree-sitter-bash.so"
359
- ```
360
-
361
- **Debian/Ubuntu (amd64):**
362
-
363
- ```console
364
- curl -Lo parsers.deb https://github.com/Faveod/tree-sitter-parsers/releases/download/v4.10/tree-sitter-parsers-4.10-amd64.deb
365
- sudo dpkg -i parsers.deb
366
- ```
367
-
368
- **macOS (Apple Silicon):**
369
-
370
- ```console
371
- curl -Lo parsers.tar.gz https://github.com/Faveod/tree-sitter-parsers/releases/download/v4.10/tree-sitter-parsers-4.10-macos-arm64.tar.gz
372
- tar -xzf parsers.tar.gz
373
-
374
- # Install to a location and set environment variable
375
- mkdir -p ~/.local/lib/tree-sitter
376
- cp libtree-sitter-bash.dylib ~/.local/lib/tree-sitter/
377
- export TREE_SITTER_BASH_PATH="$HOME/.local/lib/tree-sitter/libtree-sitter-bash.dylib"
378
- ```
379
-
380
- #### Option 2: Build from Source
381
-
382
- ```console
383
- git clone https://github.com/tree-sitter/tree-sitter-bash.git
384
- cd tree-sitter-bash
385
- make
386
- sudo cp libtree-sitter-bash.so /usr/lib/ # Linux
387
- # or
388
- sudo cp libtree-sitter-bash.dylib /usr/local/lib/ # macOS
389
- ```
390
-
391
- #### Option 3: Package Manager
392
-
393
- Some package managers provide tree-sitter parsers:
394
-
395
- **Fedora Atomic (Silverblue, Kinoite, Bazzite, Aurora, etc.):**
396
-
397
- ```console
398
- # Install via rpm-ostree (requires reboot)
399
- rpm-ostree install libtree-sitter-bash
400
-
401
- # The library will be installed to /usr/lib64/libtree-sitter-bash.so
402
- # You may need to set the environment variable:
403
- export TREE_SITTER_BASH_PATH="/usr/lib64/libtree-sitter-bash.so"
404
- ```
405
-
406
- **Fedora (traditional):**
407
-
408
- ```console
409
- sudo dnf install libtree-sitter-bash
410
- ```
411
-
412
- **Arch Linux:**
413
-
414
- ```console
415
- # Check AUR for tree-sitter-bash
416
- yay -S tree-sitter-bash
417
- ```
418
-
419
- #### Environment Variable
420
-
421
- If the parser is not in a standard location (`/usr/lib/`, `/usr/lib64/`, `/usr/local/lib/`),
422
- set the `TREE_SITTER_BASH_PATH` environment variable to point to the parser library:
423
-
424
- ```console
425
- export TREE_SITTER_BASH_PATH="/path/to/libtree-sitter-bash.so"
426
- ```
427
-
428
- **Note:** Some distributions install the library with a version number suffix
429
- (e.g., `libtree-sitter-bash.so.14` instead of `libtree-sitter-bash.so`).
430
- If the gem can't find the parser, check for versioned files and either:
431
-
432
- - Set `TREE_SITTER_BASH_PATH` to the full versioned path, or
433
- - Create a symlink: `sudo ln -s /usr/lib64/libtree-sitter-bash.so.14 /usr/lib64/libtree-sitter-bash.so`
434
- Add this to your shell profile (`.bashrc`, `.zshrc`, etc.) for persistence.
435
-
436
- ### 💎 Ruby Interface Gems
437
-
438
- In addition to the tree-sitter parser library, you need a Ruby gem that provides
439
- bindings to tree-sitter. Choose **one** of the following based on your Ruby implementation:
440
-
441
- | Gem | Ruby Support | Description |
442
- | --- | --- | --- |
443
- | [ruby\_tree\_sitter][ruby_tree_sitter] | MRI only | C extension bindings (recommended for MRI) |
444
- | [tree\_stump][tree_stump] | MRI (maybe JRuby) | Rust-based bindings via Rutie |
445
- | [ffi][ffi] | MRI, JRuby, TruffleRuby | Generic FFI bindings (used by tree\_haver's FFI backend) |
446
-
447
- [ruby_tree_sitter]: https://github.com/Faveod/ruby_tree_sitter
448
- [tree_stump]: https://github.com/nickstenning/tree_stump
449
- [ffi]: https://github.com/ffi/ffi
450
-
451
- #### For MRI Ruby (Recommended)
452
-
453
- ```console
454
- gem install ruby_tree_sitter
455
- ```
456
-
457
- Or add to your Gemfile:
458
-
459
- ```ruby
460
- gem "ruby_tree_sitter", "~> 2.0"
461
- ```
462
-
463
- #### For JRuby or TruffleRuby
464
-
465
- ```console
466
- gem install ffi
467
- ```
468
-
469
- Or add to your Gemfile:
470
-
471
- ```ruby
472
- gem "ffi"
473
- ```
474
-
475
- The `tree_haver` gem (a dependency of bash-merge) will automatically detect and use
476
- the appropriate backend based on which gems are available.
477
-
478
- **Note:** The `ruby_tree_sitter` gem only compiles on MRI Ruby. For JRuby or TruffleRuby,
479
- you must use the FFI backend.
480
-
481
128
  ## ⚙️ Configuration
482
129
 
483
130
  ```ruby
@@ -604,64 +251,6 @@ result = merger.merge
604
251
  # Result includes functions/variables from template that don't exist in destination
605
252
  ```
606
253
 
607
- ## 🦷 FLOSS Funding
608
-
609
- While kettle-rb tools are free software and will always be, the project would benefit immensely from some funding.
610
- Raising a monthly budget of... "dollars" would make the project more sustainable.
611
-
612
- We welcome both individual and corporate sponsors\! We also offer a
613
- wide array of funding channels to account for your preferences
614
- (although currently [Open Collective][🖇osc] is our preferred funding platform).
615
-
616
- **If you're working in a company that's making significant use of kettle-rb tools we'd
617
- appreciate it if you suggest to your company to become a kettle-rb sponsor.**
618
-
619
- You can support the development of kettle-rb tools via
620
- [GitHub Sponsors][🖇sponsor],
621
- [Liberapay][⛳liberapay],
622
- [PayPal][🖇paypal],
623
- [Open Collective][🖇osc]
624
- and [Tidelift][🏙️entsup-tidelift].
625
-
626
- | 📍 NOTE |
627
- | --- |
628
- | If doing a sponsorship in the form of donation is problematic for your company <br/> from an accounting standpoint, we'd recommend the use of Tidelift, <br/> where you can get a support-like subscription instead. |
629
-
630
- ### Open Collective for Individuals
631
-
632
- Support us with a monthly donation and help us continue our activities. \[[Become a backer][🖇osc-backers]\]
633
-
634
- NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
635
-
636
- <!-- OPENCOLLECTIVE-INDIVIDUALS:START -->
637
- No backers yet. Be the first!
638
- <!-- OPENCOLLECTIVE-INDIVIDUALS:END -->
639
-
640
- ### Open Collective for Organizations
641
-
642
- Become a sponsor and get your logo on our README on GitHub with a link to your site. \[[Become a sponsor][🖇osc-sponsors]\]
643
-
644
- NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
645
-
646
- <!-- OPENCOLLECTIVE-ORGANIZATIONS:START -->
647
- No sponsors yet. Be the first!
648
- <!-- OPENCOLLECTIVE-ORGANIZATIONS:END -->
649
-
650
- [kettle-readme-backers]: https://github.com/kettle-rb/bash-merge/blob/main/exe/kettle-readme-backers
651
-
652
- ### Another way to support open-source
653
-
654
- I’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small. Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions. I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).
655
-
656
- If you work at a company that uses my work, please encourage them to support me as a corporate sponsor. My work on gems you use might show up in `bundle fund`.
657
-
658
- I’m developing a new library, [floss\_funding][🖇floss-funding-gem], designed to empower open-source developers like myself to get paid for the work we do, in a sustainable way. Please give it a look.
659
-
660
- **[Floss-Funding.dev]
661
- [🖇floss-funding.dev]: 👉️ No network calls. 👉️ No tracking. 👉️ No oversight. 👉️ Minimal crypto hashing. 💡 Easily disabled nags**
662
-
663
- [![OpenCollective Backers][🖇osc-backers-i]][🖇osc-backers] [![OpenCollective Sponsors][🖇osc-sponsors-i]][🖇osc-sponsors] [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate to my FLOSS efforts at ko-fi.com][🖇kofi-img]][🖇kofi] [![Donate to my FLOSS efforts using Patreon][🖇patreon-img]][🖇patreon]
664
-
665
254
  ## 🔐 Security
666
255
 
667
256
  See [SECURITY.md][🔐security].
@@ -669,78 +258,36 @@ See [SECURITY.md][🔐security].
669
258
  ## 🤝 Contributing
670
259
 
671
260
  If you need some ideas of where to help, you could work on adding more code coverage,
672
- or if it is already 💯 (see [below](#code-coverage)) check [reek](REEK), [issues][🤝gh-issues], or [PRs][🤝gh-pulls],
261
+ or if it is already 💯 (see [below](#code-coverage)) check [issues][🤝gh-issues] or [PRs][🤝gh-pulls],
673
262
  or use the gem and think about how it could be better.
674
263
 
675
264
  We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
676
265
 
677
266
  See [CONTRIBUTING.md][🤝contributing] for more detailed instructions.
678
267
 
679
- ### 🚀 Release Instructions
680
-
681
- See [CONTRIBUTING.md][🤝contributing].
682
-
683
268
  ### Code Coverage
684
269
 
685
- [![Coverage Graph][🏀codecov-g]][🏀codecov]
686
-
687
- [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls]
688
-
689
- [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov]
690
-
691
- ### 🪇 Code of Conduct
692
-
693
- Everyone interacting with this project's codebases, issue trackers,
694
- chat rooms and mailing lists agrees to follow the [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct].
695
-
696
- ## 🌈 Contributors
697
-
698
- [![Contributors][🖐contributors-img]][🖐contributors]
699
-
700
- Made with [contributors-img][🖐contrib-rocks].
701
-
702
- Also see GitLab Contributors: <https://gitlab.com/kettle-rb/bash-merge/-/graphs/main>
703
-
704
- <details>
705
- <summary>⭐️ Star History</summary>
706
-
707
- <a href="https://star-history.com/#kettle-rb/bash-merge&Date">
708
- <picture>
709
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kettle-rb/bash-merge&type=Date&theme=dark" />
710
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kettle-rb/bash-merge&type=Date" />
711
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kettle-rb/bash-merge&type=Date" />
712
- </picture>
713
- </a>
270
+ <details markdown="1">
271
+ <summary>Coverage service badges</summary>
714
272
 
715
273
  </details>
716
274
 
717
275
  ## 📌 Versioning
718
276
 
719
- This Library adheres to [![Semantic Versioning 2.0.0][📌semver-img]][📌semver].
720
- Violations of this scheme should be reported as bugs.
721
- Specifically, if a minor or patch version is released that breaks backward compatibility,
722
- a new version should be immediately released that restores compatibility.
723
- Breaking changes to the public API will only be introduced with new major versions.
724
-
725
- > dropping support for a platform is both obviously and objectively a breaking change <br/>
726
- > —Jordan Harband ([@ljharb](https://github.com/ljharb), maintainer of SemVer) [in SemVer issue 716][📌semver-breaking]
727
-
728
- I understand that policy doesn't work universally ("exceptions to every rule\!"),
729
- but it is the policy here.
730
- As such, in many cases it is good to specify a dependency on this library using
731
- the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
277
+ This library follows [![Semantic Versioning 2.0.0][📌semver-img]][📌semver] for its public API where practical.
278
+ For most applications, prefer the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
732
279
 
733
280
  For example:
734
281
 
735
282
  ```ruby
736
- spec.add_dependency("bash-merge", "~> 1.0")
283
+ spec.add_dependency("bash-merge", "~> 7.0")
737
284
  ```
738
285
 
739
286
  <details markdown="1">
740
287
  <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
741
288
 
742
- SemVer should, IMO, but doesn't explicitly, say that dropping support for specific Platforms
743
- is a *breaking change* to an API, and for that reason the bike shedding is endless.
289
+ Dropping support for a platform can be a breaking change for affected users.
290
+ If a release changes supported platforms, it should be called out clearly in the changelog and versioned with that impact in mind.
744
291
 
745
292
  To get a better understanding of how SemVer is intended to work over a project's lifetime,
746
293
  read this article from the creator of SemVer:
@@ -753,68 +300,19 @@ See [CHANGELOG.md][📌changelog] for a list of releases.
753
300
 
754
301
  ## 📄 License
755
302
 
756
- The gem is available as open source under the terms of
757
- the [MIT License][📄license] [![License: MIT][📄license-img]][📄license-ref].
758
- See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].
759
-
760
- ### © Copyright
761
-
762
- <ul>
763
- <li>
764
- Copyright (c) 2025-2026 Peter H. Boling, of
765
- <a href="https://discord.gg/3qme4XHNKN">
766
- Galtzo.com
767
- <picture>
768
- <img src="https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px-blank.svg" alt="Galtzo.com Logo (Wordless) by Aboling0, CC BY-SA 4.0" width="24">
769
- </picture>
770
- </a>, and bash-merge contributors.
771
- </li>
772
- </ul>
773
-
774
- ## 🤑 A request for help
775
-
776
- Maintainers have teeth and need to pay their dentists.
777
- After getting laid off in an RIF in March, and encountering difficulty finding a new one,
778
- I began spending most of my time building open source tools.
779
- I'm hoping to be able to pay for my kids' health insurance this month,
780
- so if you value the work I am doing, I need your support.
781
- Please consider sponsoring me or the project.
782
-
783
- To join the community or get help 👇️ Join the Discord.
784
-
785
- [![Live Chat on Discord][✉️discord-invite-img-ftb]][🖼️galtzo-discord]
786
-
787
- To say "thanks\!" ☝️ Join the Discord or 👇️ send money.
788
-
789
- [![Sponsor kettle-rb/bash-merge on Open Source Collective][🖇osc-all-bottom-img]][🖇osc] 💌 [![Sponsor me on GitHub Sponsors][🖇sponsor-bottom-img]][🖇sponsor] 💌 [![Sponsor me on Liberapay][⛳liberapay-bottom-img]][⛳liberapay] 💌 [![Donate on PayPal][🖇paypal-bottom-img]][🖇paypal]
790
-
791
- ### Please give the project a star ⭐ ♥.
303
+ The gem is available under the following licenses: [AGPL-3.0-only](https://github.com/structuredmerge/structuredmerge-ruby/blob/main/AGPL-3.0-only.md), [PolyForm-Small-Business-1.0.0](https://github.com/structuredmerge/structuredmerge-ruby/blob/main/PolyForm-Small-Business-1.0.0.md).
304
+ See [LICENSE.md][📄license] for details.
792
305
 
793
- Thanks for RTFM. ☺️
306
+ If none of the available licenses suit your use case, please [contact us](mailto:floss@galtzo.com) to discuss a custom commercial license.
794
307
 
795
308
  [⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
796
309
  [⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge&logo=liberapay&color=a51611
797
310
  [⛳liberapay]: https://liberapay.com/pboling/donate
798
- [🖇osc-all-img]: https://img.shields.io/opencollective/all/kettle-rb
799
- [🖇osc-sponsors-img]: https://img.shields.io/opencollective/sponsors/kettle-rb
800
- [🖇osc-backers-img]: https://img.shields.io/opencollective/backers/kettle-rb
801
- [🖇osc-backers]: https://opencollective.com/kettle-rb#backer
802
- [🖇osc-backers-i]: https://opencollective.com/kettle-rb/backers/badge.svg?style=flat
803
- [🖇osc-sponsors]: https://opencollective.com/kettle-rb#sponsor
804
- [🖇osc-sponsors-i]: https://opencollective.com/kettle-rb/sponsors/badge.svg?style=flat
805
- [🖇osc-all-bottom-img]: https://img.shields.io/opencollective/all/kettle-rb?style=for-the-badge
806
- [🖇osc-sponsors-bottom-img]: https://img.shields.io/opencollective/sponsors/kettle-rb?style=for-the-badge
807
- [🖇osc-backers-bottom-img]: https://img.shields.io/opencollective/backers/kettle-rb?style=for-the-badge
808
- [🖇osc]: https://opencollective.com/kettle-rb
809
311
  [🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
810
312
  [🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge&logo=github
811
313
  [🖇sponsor]: https://github.com/sponsors/pboling
812
- [🖇polar-img]: https://img.shields.io/badge/polar-donate-a51611.svg?style=flat
813
- [🖇polar]: https://polar.sh/pboling
814
314
  [🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
815
- [🖇kofi]: https://ko-fi.com/O5O86SNP4
816
- [🖇patreon-img]: https://img.shields.io/badge/patreon-donate-a51611.svg?style=flat
817
- [🖇patreon]: https://patreon.com/galtzo
315
+ [🖇kofi]: https://ko-fi.com/pboling
818
316
  [🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat
819
317
  [🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte&emoji=&slug=pboling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff
820
318
  [🖇buyme]: https://www.buymeacoffee.com/pboling
@@ -827,19 +325,22 @@ Thanks for RTFM. ☺️
827
325
  [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
828
326
  [✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge&logo=dailydotdev&logoColor=white
829
327
  [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
328
+ [✉️ruby-forum-top-img]: https://img.shields.io/discourse/topics?server=https%3A%2F%2Fwww.rubyforum.org&style=flat&logo=discourse&label=Ruby%20Users%20Forum
329
+ [✉️ruby-forum-img]: https://img.shields.io/discourse/topics?server=https%3A%2F%2Fwww.rubyforum.org&style=for-the-badge&logo=discourse&label=Ruby%20Users%20Forum
330
+ [✉️ruby-forum]: https://www.rubyforum.org/tag/structuredmerge
830
331
  [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
831
- [⛳️gem-namespace]: https://github.com/kettle-rb/bash-merge
332
+ [⛳️gem-namespace]: https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/bash-merge
832
333
  [⛳️namespace-img]: https://img.shields.io/badge/namespace-Bash::Merge-3C2D2D.svg?style=square&logo=ruby&logoColor=white
833
- [⛳️gem-name]: https://bestgems.org/gems/bash-merge
334
+ [⛳️gem-name]: https://clickgems.clickhouse.com/dashboard/bash-merge
834
335
  [⛳️name-img]: https://img.shields.io/badge/name-bash--merge-3C2D2D.svg?style=square&logo=rubygems&logoColor=red
835
- [⛳️tag-img]: https://img.shields.io/github/tag/kettle-rb/bash-merge.svg
836
- [⛳️tag]: http://github.com/kettle-rb/bash-merge/releases
336
+ [⛳️tag-img]: https://img.shields.io/github/tag/structuredmerge/structuredmerge-ruby.svg
337
+ [⛳️tag]: https://github.com/structuredmerge/structuredmerge-ruby/releases
837
338
  [🚂maint-blog]: http://www.railsbling.com/tags/bash-merge
838
339
  [🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge&logo=rubyonrails&logoColor=orange
839
340
  [🚂maint-contact]: http://www.railsbling.com/contact
840
341
  [🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red
841
342
  [💖🖇linkedin]: http://www.linkedin.com/in/peterboling
842
- [💖🖇linkedin-img]: https://img.shields.io/badge/PeterBoling-LinkedIn-0B66C2?style=flat&logo=newjapanprowrestling
343
+ [💖🖇linkedin-img]: https://img.shields.io/badge/LinkedIn-Profile-0B66C2?style=flat&logo=newjapanprowrestling
843
344
  [💖✌️wellfound]: https://wellfound.com/u/peter-boling
844
345
  [💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat&logo=wellfound
845
346
  [💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling
@@ -868,103 +369,63 @@ Thanks for RTFM. ☺️
868
369
  [💁🏼‍♂️peterboling]: http://www.peterboling.com
869
370
  [🚂railsbling]: http://www.railsbling.com
870
371
  [📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
871
- [📜src-gl]: https://gitlab.com/kettle-rb/bash-merge/
372
+ [📜src-gl]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/tree/main/gems/bash-merge
872
373
  [📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
873
- [📜src-cb]: https://codeberg.org/kettle-rb/bash-merge
874
- [📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=Github&logoColor=green
875
- [📜src-gh]: https://github.com/kettle-rb/bash-merge
374
+ [📜src-cb]: https://codeberg.org/structuredmerge/structuredmerge-ruby/src/branch/main/gems/bash-merge
375
+ [📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=GitHub&logoColor=green
376
+ [📜src-gh]: https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/bash-merge
876
377
  [📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
877
378
  [📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
878
- [📜gl-wiki]: https://gitlab.com/kettle-rb/bash-merge/-/wikis/home
879
- [📜gh-wiki]: https://github.com/kettle-rb/bash-merge/wiki
880
- [📜gl-wiki-img]: https://img.shields.io/badge/wiki-examples-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
881
- [📜gh-wiki-img]: https://img.shields.io/badge/wiki-examples-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
882
- [👽dl-rank]: https://bestgems.org/gems/bash-merge
883
- [👽dl-ranki]: https://img.shields.io/gem/rd/bash-merge.svg
884
- [👽oss-help]: https://www.codetriage.com/kettle-rb/bash-merge
885
- [👽oss-helpi]: https://www.codetriage.com/kettle-rb/bash-merge/badges/users.svg
886
- [👽version]: https://bestgems.org/gems/bash-merge
379
+ [📜gl-wiki]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/wikis/home
380
+ [📜gh-wiki]: https://github.com/structuredmerge/structuredmerge-ruby/wiki
381
+ [📜gl-wiki-img]: https://img.shields.io/badge/wiki-gitlab-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
382
+ [📜gh-wiki-img]: https://img.shields.io/badge/wiki-github-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
383
+ [👽dl-rank]: https://clickgems.clickhouse.com/dashboard/bash-merge
384
+ [👽dl-ranki]: https://img.shields.io/gem/dt/bash-merge.svg
385
+ [👽version]: https://clickgems.clickhouse.com/dashboard/bash-merge
887
386
  [👽versioni]: https://img.shields.io/gem/v/bash-merge.svg
888
- [🏀qlty-mnt]: https://qlty.sh/gh/kettle-rb/projects/bash-merge
889
- [🏀qlty-mnti]: https://qlty.sh/gh/kettle-rb/projects/bash-merge/maintainability.svg
890
- [🏀qlty-cov]: https://qlty.sh/gh/kettle-rb/projects/bash-merge/metrics/code?sort=coverageRating
891
- [🏀qlty-covi]: https://qlty.sh/gh/kettle-rb/projects/bash-merge/coverage.svg
892
- [🏀codecov]: https://codecov.io/gh/kettle-rb/bash-merge
893
- [🏀codecovi]: https://codecov.io/gh/kettle-rb/bash-merge/graph/badge.svg
894
- [🏀coveralls]: https://coveralls.io/github/kettle-rb/bash-merge?branch=main
895
- [🏀coveralls-img]: https://coveralls.io/repos/github/kettle-rb/bash-merge/badge.svg?branch=main
896
- [🖐codeQL]: https://github.com/kettle-rb/bash-merge/security/code-scanning
897
- [🖐codeQL-img]: https://github.com/kettle-rb/bash-merge/actions/workflows/codeql-analysis.yml/badge.svg
898
- [🚎2-cov-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/coverage.yml
899
- [🚎2-cov-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/coverage.yml/badge.svg
900
- [🚎3-hd-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/heads.yml
901
- [🚎3-hd-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/heads.yml/badge.svg
902
- [🚎5-st-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/style.yml
903
- [🚎5-st-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/style.yml/badge.svg
904
- [🚎6-s-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/supported.yml
905
- [🚎6-s-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/supported.yml/badge.svg
906
- [🚎9-t-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/truffle.yml
907
- [🚎9-t-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/truffle.yml/badge.svg
908
- [🚎11-c-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/current.yml
909
- [🚎11-c-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/current.yml/badge.svg
910
- [🚎12-crh-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/dep-heads.yml
911
- [🚎12-crh-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/dep-heads.yml/badge.svg
912
- [🚎13-🔒️-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/locked_deps.yml
913
- [🚎13-🔒️-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/locked_deps.yml/badge.svg
914
- [🚎14-🔓️-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/unlocked_deps.yml
915
- [🚎14-🔓️-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/unlocked_deps.yml/badge.svg
916
- [🚎15-🪪-wf]: https://github.com/kettle-rb/bash-merge/actions/workflows/license-eye.yml
917
- [🚎15-🪪-wfi]: https://github.com/kettle-rb/bash-merge/actions/workflows/license-eye.yml/badge.svg
918
- [💎ruby-3.2i]: https://img.shields.io/badge/Ruby-3.2-CC342D?style=for-the-badge&logo=ruby&logoColor=white
919
- [💎ruby-3.3i]: https://img.shields.io/badge/Ruby-3.3-CC342D?style=for-the-badge&logo=ruby&logoColor=white
387
+ [🚎11-c-wf]: https://github.com/structuredmerge/structuredmerge-ruby/actions/workflows/current.yml
388
+ [🚎11-c-wfi]: https://github.com/structuredmerge/structuredmerge-ruby/actions/workflows/current.yml/badge.svg
920
389
  [💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
921
- [💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
922
- [💎truby-23.1i]: https://img.shields.io/badge/Truffle_Ruby-23.1-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
923
- [💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
924
- [💎truby-headi]: https://img.shields.io/badge/Truffle_Ruby-HEAD-34BCB1?style=for-the-badge&logo=ruby&logoColor=blue
925
- [💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge&logo=ruby&logoColor=green
926
- [💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge&logo=ruby&logoColor=blue
927
- [🤝gh-issues]: https://github.com/kettle-rb/bash-merge/issues
928
- [🤝gh-pulls]: https://github.com/kettle-rb/bash-merge/pulls
929
- [🤝gl-issues]: https://gitlab.com/kettle-rb/bash-merge/-/issues
930
- [🤝gl-pulls]: https://gitlab.com/kettle-rb/bash-merge/-/merge_requests
931
- [🤝cb-issues]: https://codeberg.org/kettle-rb/bash-merge/issues
932
- [🤝cb-pulls]: https://codeberg.org/kettle-rb/bash-merge/pulls
390
+ [🤝gh-issues]: https://github.com/structuredmerge/structuredmerge-ruby/issues
391
+ [🤝gh-pulls]: https://github.com/structuredmerge/structuredmerge-ruby/pulls
392
+ [🤝gl-issues]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/issues
393
+ [🤝gl-pulls]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/merge_requests
394
+ [🤝cb-issues]: https://codeberg.org/structuredmerge/structuredmerge-ruby/issues
395
+ [🤝cb-pulls]: https://codeberg.org/structuredmerge/structuredmerge-ruby/pulls
933
396
  [🤝cb-donate]: https://donate.codeberg.org/
934
- [🤝contributing]: CONTRIBUTING.md
935
- [🏀codecov-g]: https://codecov.io/gh/kettle-rb/bash-merge/graphs/tree.svg
397
+ [🤝contributing]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/CONTRIBUTING.md
936
398
  [🖐contrib-rocks]: https://contrib.rocks
937
- [🖐contributors]: https://github.com/kettle-rb/bash-merge/graphs/contributors
938
- [🖐contributors-img]: https://contrib.rocks/image?repo=kettle-rb/bash-merge
939
- [🚎contributors-gl]: https://gitlab.com/kettle-rb/bash-merge/-/graphs/main
940
- [🪇conduct]: CODE_OF_CONDUCT.md
399
+ [🖐contributors]: https://github.com/structuredmerge/structuredmerge-ruby/graphs/contributors
400
+ [🖐contributors-img]: https://contrib.rocks/image?repo=structuredmerge/structuredmerge-ruby
401
+ [🪇conduct]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/CODE_OF_CONDUCT.md
941
402
  [🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg
942
403
  [📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
943
404
  [📌semver]: https://semver.org/spec/v2.0.0.html
944
405
  [📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat
945
406
  [📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
946
407
  [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
947
- [📌changelog]: CHANGELOG.md
408
+ [📌changelog]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/CHANGELOG.md
948
409
  [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
949
410
  [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
950
411
  [📌gitmoji]: https://gitmoji.dev
951
412
  [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
952
413
  [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
953
- [🧮kloc-img]: https://img.shields.io/badge/KLOC-0.539-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
954
- [🔐security]: SECURITY.md
414
+ [🧮kloc-img]: https://img.shields.io/badge/KLOC-0.810-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
415
+ [🔐security]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/SECURITY.md
955
416
  [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
956
417
  [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
957
- [📄license]: LICENSE.txt
958
- [📄license-ref]: https://opensource.org/licenses/MIT
959
- [📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
960
- [📄license-compat]: https://dev.to/galtzo/how-to-check-license-compatibility-41h0
961
- [📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache
418
+ [📄license]: LICENSE.md
419
+ [📄license-ref]: LICENSE.md
420
+ [📄license-img]: https://img.shields.io/badge/License-AGPL--3.0--only_OR_PolyForm--Small--Business--1.0.0-259D6C.svg
421
+ [📄license-compat]: https://www.apache.org/legal/resolved.html#category-x
422
+ [📄license-compat-img]: https://img.shields.io/badge/Apache_Incompatible:_Category_X-%E2%9C%97-C0392B.svg?style=flat&logo=Apache
962
423
  [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
963
424
  [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
964
425
  [🚎yard-current]: http://rubydoc.info/gems/bash-merge
965
426
  [🚎yard-head]: https://bash-merge.galtzo.com
966
427
  [💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums
967
- [💎SHA_checksums]: https://gitlab.com/kettle-rb/bash-merge/-/tree/main/checksums
428
+ [💎SHA_checksums]: https://gitlab.com/structuredmerge/structuredmerge-ruby/-/tree/main/checksums
968
429
  [💎rlts]: https://github.com/rubocop-lts/rubocop-lts
969
430
  [💎rlts-img]: https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white
970
431
  [💎appraisal2]: https://github.com/appraisal-rb/appraisal2