jsonc-merge 1.0.0

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.
Files changed (28) hide show
  1. checksums.yaml +7 -0
  2. checksums.yaml.gz.sig +0 -0
  3. data/CHANGELOG.md +48 -0
  4. data/CITATION.cff +20 -0
  5. data/CODE_OF_CONDUCT.md +134 -0
  6. data/CONTRIBUTING.md +227 -0
  7. data/FUNDING.md +74 -0
  8. data/LICENSE.txt +21 -0
  9. data/README.md +992 -0
  10. data/REEK +0 -0
  11. data/RUBOCOP.md +71 -0
  12. data/SECURITY.md +21 -0
  13. data/lib/jsonc/merge/comment_tracker.rb +195 -0
  14. data/lib/jsonc/merge/conflict_resolver.rb +373 -0
  15. data/lib/jsonc/merge/debug_logger.rb +43 -0
  16. data/lib/jsonc/merge/emitter.rb +163 -0
  17. data/lib/jsonc/merge/file_analysis.rb +325 -0
  18. data/lib/jsonc/merge/freeze_node.rb +102 -0
  19. data/lib/jsonc/merge/merge_result.rb +154 -0
  20. data/lib/jsonc/merge/node_wrapper.rb +328 -0
  21. data/lib/jsonc/merge/smart_merger.rb +154 -0
  22. data/lib/jsonc/merge/version.rb +12 -0
  23. data/lib/jsonc/merge.rb +123 -0
  24. data/lib/jsonc-merge.rb +6 -0
  25. data/sig/json/merge.rbs +259 -0
  26. data.tar.gz.sig +1 -0
  27. metadata +333 -0
  28. metadata.gz.sig +3 -0
data/README.md ADDED
@@ -0,0 +1,992 @@
1
+ | 📍 NOTE |
2
+ |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
3
+ | RubyGems (the [GitHub org][rubygems-org], not the website) [suffered][draper-security] a [hostile takeover][ellen-takeover] in September 2025. |
4
+ | Ultimately [4 maintainers][simi-removed] were [hard removed][martin-removed] and a reason has been given for only 1 of those, while 2 others resigned in protest. |
5
+ | It is a [complicated story][draper-takeover] which is difficult to [parse quickly][draper-lies]. |
6
+ | Simply put - there was active policy for adding or removing maintainers/owners of [rubygems][rubygems-maint-policy] and [bundler][bundler-maint-policy], and those [policies were not followed][policy-fail]. |
7
+ | I'm adding notes like this to gems because I [don't condone theft][draper-theft] of repositories or gems from their rightful owners. |
8
+ | If a similar theft happened with my repos/gems, I'd hope some would stand up for me. |
9
+ | Disenfranchised former-maintainers have started [gem.coop][gem-coop]. |
10
+ | Once available I will publish there exclusively; unless RubyCentral makes amends with the community. |
11
+ | The ["Technology for Humans: Joel Draper"][reinteractive-podcast] podcast episode by [reinteractive][reinteractive] is the most cogent summary I'm aware of. |
12
+ | See [here][gem-naming], [here][gem-coop] and [here][martin-ann] for more info on what comes next. |
13
+ | What I'm doing: A (WIP) proposal for [bundler/gem scopes][gem-scopes], and a (WIP) proposal for a federated [gem server][gem-server]. |
14
+
15
+ [rubygems-org]: https://github.com/rubygems/
16
+ [draper-security]: https://joel.drapper.me/p/ruby-central-security-measures/
17
+ [draper-takeover]: https://joel.drapper.me/p/ruby-central-takeover/
18
+ [ellen-takeover]: https://pup-e.com/blog/goodbye-rubygems/
19
+ [simi-removed]: https://www.reddit.com/r/ruby/s/gOk42POCaV
20
+ [martin-removed]: https://bsky.app/profile/martinemde.com/post/3m3occezxxs2q
21
+ [draper-lies]: https://joel.drapper.me/p/ruby-central-fact-check/
22
+ [draper-theft]: https://joel.drapper.me/p/ruby-central/
23
+ [reinteractive]: https://reinteractive.com/ruby-on-rails
24
+ [gem-coop]: https://gem.coop
25
+ [gem-naming]: https://github.com/gem-coop/gem.coop/issues/12
26
+ [martin-ann]: https://martinemde.com/2025/10/05/announcing-gem-coop.html
27
+ [gem-scopes]: https://github.com/galtzo-floss/bundle-namespace
28
+ [gem-server]: https://github.com/galtzo-floss/gem-server
29
+ [reinteractive-podcast]: https://youtu.be/_H4qbtC5qzU?si=BvuBU90R2wAqD2E6
30
+ [bundler-maint-policy]: https://github.com/ruby/rubygems/blob/b1ab33a3d52310a84d16b193991af07f5a6a07c0/doc/bundler/playbooks/TEAM_CHANGES.md
31
+ [rubygems-maint-policy]: https://github.com/ruby/rubygems/blob/b1ab33a3d52310a84d16b193991af07f5a6a07c0/doc/rubygems/POLICIES.md?plain=1#L187-L196
32
+ [policy-fail]: https://www.reddit.com/r/ruby/comments/1ove9vp/rubycentral_hates_this_one_fact/
33
+
34
+ [![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]
35
+
36
+ [🖼️galtzo-i]: https://logos.galtzo.com/assets/images/galtzo-floss/avatar-192px.svg
37
+ [🖼️galtzo-discord]: https://discord.gg/3qme4XHNKN
38
+ [🖼️ruby-lang-i]: https://logos.galtzo.com/assets/images/ruby-lang/avatar-192px.svg
39
+ [🖼️ruby-lang]: https://www.ruby-lang.org/
40
+ [🖼️kettle-rb-i]: https://logos.galtzo.com/assets/images/kettle-rb/avatar-192px.svg
41
+ [🖼️kettle-rb]: https://github.com/kettle-rb
42
+
43
+ # ☯️ Jsonc::Merge
44
+
45
+ [![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] [![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]
46
+
47
+ `if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][🖼️galtzo-discord], as I may have missed the [discord notification][🖼️galtzo-discord].
48
+
49
+ -----
50
+
51
+ `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.
52
+
53
+ [![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]
54
+
55
+ ## 🌻 Synopsis
56
+
57
+ Jsonc::Merge is a standalone Ruby module that intelligently merges two versions of a JSONC (JSON with Comments) file using tree-sitter AST analysis. It's like a smart "git merge" specifically designed for JSONC configuration files. Built on top of [ast-merge][ast-merge], it shares the same architecture as [prism-merge][prism-merge] for Ruby source files.
58
+
59
+ For standard JSON (without comments) support, see the [json-merge][json-merge] gem.
60
+
61
+ ### Key Features
62
+
63
+ - **Tree-Sitter Powered**: Uses tree-sitter-jsonc for accurate AST parsing
64
+ - **JSONC Support**: Handles JSON with Comments (`//` and `/* */` style)
65
+ - **Intelligent**: Matches objects and arrays by structural signatures
66
+ - **Comment-Preserving**: Comments in JSONC files are preserved in context
67
+ - **Freeze Block Support**: Respects freeze markers (default: `jsonc-merge:freeze` / `jsonc-merge:unfreeze`) for merge control - customizable to match your project's conventions
68
+ - **Full Provenance**: Tracks origin of every node
69
+ - **Standalone**: Minimal dependencies - just `ast-merge` and `ruby_tree_sitter`
70
+ - **Customizable**:
71
+ - `signature_generator` - callable custom signature generators
72
+ - `preference` - setting of `:template`, `:destination`, or a Hash for per-node-type preferences
73
+ - `node_splitter` - Hash mapping node types to callables for per-node-type merge customization (see [ast-merge][ast-merge] docs)
74
+ - `add_template_only_nodes` - setting to retain nodes that do not exist in destination
75
+ - `freeze_token` - customize freeze block markers (default: `"jsonc-merge"`)
76
+
77
+ ### Supported Node Types
78
+
79
+ | Node Type | Signature Format | Matching Behavior |
80
+ |-----------|--------------------------------|--------------------------------------|
81
+ | Object | `[:object, key_signatures...]` | Objects match by their key structure |
82
+ | Array | `[:array, element_count]` | Arrays match by position and type |
83
+ | Pair | `[:pair, key_name]` | Key-value pairs match by key name |
84
+ | String | `[:string, value]` | Strings match by value |
85
+ | Number | `[:number, value]` | Numbers match by value |
86
+ | Boolean | `[:boolean, value]` | Booleans match by value |
87
+ | Null | `[:null]` | Null values always match |
88
+
89
+ ### Example
90
+
91
+ ```ruby
92
+ require "jsonc/merge"
93
+
94
+ template = File.read("template.jsonc")
95
+ destination = File.read("destination.jsonc")
96
+
97
+ merger = Jsonc::Merge::SmartMerger.new(template, destination)
98
+ result = merger.merge
99
+
100
+ File.write("merged.jsonc", result.to_jsonc)
101
+ ```
102
+
103
+ ### JSONC Example with Freeze Blocks
104
+
105
+ ```jsonc
106
+ {
107
+ // jsonc-merge:freeze Secret configuration
108
+ "api_key": "my-secret-key",
109
+ "api_secret": "my-secret-value",
110
+ // jsonc-merge:unfreeze
111
+
112
+ "debug": false,
113
+ "log_level": "info"
114
+ }
115
+ ```
116
+
117
+ ### The `*-merge` Gem Family
118
+
119
+ 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.
120
+
121
+ | Gem | Version / CI | Language<br>/ Format | Parser Backend(s) | Description |
122
+ |------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------:|----------------------|-------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
123
+ | [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) |
124
+ | [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 |
125
+ | [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 |
126
+ | [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) |
127
+ | [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 |
128
+ | [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 |
129
+ | [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 |
130
+ | [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 |
131
+ | [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) |
132
+ | [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 |
133
+ | [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 |
134
+ | [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 |
135
+ | [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 |
136
+
137
+ #### Backend Platform Compatibility
138
+
139
+ tree_haver supports multiple parsing backends, but not all backends work on all Ruby platforms:
140
+
141
+ | Platform 👉️<br> TreeHaver Backend 👇️ | MRI | JRuby | TruffleRuby | Notes |
142
+ |-------------------------------------------------|:---:|:-----:|:-----------:|----------------------------------------------------------------------------|
143
+ | **MRI** ([ruby_tree_sitter][ruby_tree_sitter]) | ✅ | ❌ | ❌ | C extension, MRI only |
144
+ | **Rust** ([tree_stump][tree_stump]) | ✅ | ❌ | ❌ | Rust extension via magnus/rb-sys, MRI only |
145
+ | **FFI** ([ffi][ffi]) | ✅ | ✅ | ❌ | TruffleRuby's FFI doesn't support `STRUCT_BY_VALUE` |
146
+ | **Java** ([jtreesitter][jtreesitter]) | ❌ | ✅ | ❌ | JRuby only, requires grammar JARs |
147
+ | **Prism** ([prism][prism]) | ✅ | ✅ | ✅ | Ruby parsing, stdlib in Ruby 3.4+ |
148
+ | **Psych** ([psych][psych]) | ✅ | ✅ | ✅ | YAML parsing, stdlib |
149
+ | **Citrus** ([citrus][citrus]) | ✅ | ✅ | ✅ | Pure Ruby PEG parser, no native dependencies |
150
+ | **Parslet** ([parslet][parslet]) | ✅ | ✅ | ✅ | Pure Ruby PEG parser, no native dependencies |
151
+ | **Commonmarker** ([commonmarker][commonmarker]) | ✅ | ❌ | ❓ | Rust extension for Markdown (via [commonmarker-merge][commonmarker-merge]) |
152
+ | **Markly** ([markly][markly]) | ✅ | ❌ | ❓ | C extension for Markdown (via [markly-merge][markly-merge]) |
153
+
154
+ **Legend**: ✅ = Works, ❌ = Does not work, ❓ = Untested
155
+
156
+ **Why some backends don't work on certain platforms**:
157
+
158
+ - **JRuby**: Runs on the JVM; cannot load native C/Rust extensions (`.so` files)
159
+ - **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`)
160
+ - **FFI on TruffleRuby**: TruffleRuby's FFI implementation doesn't support returning structs by value, which tree-sitter's C API requires
161
+
162
+ **Example implementations** for the gem templating use case:
163
+
164
+ | Gem | Purpose | Description |
165
+ |--------------------------|-----------------|-----------------------------------------------|
166
+ | [kettle-dev][kettle-dev] | Gem Development | Gem templating tool using `*-merge` gems |
167
+ | [kettle-jem][kettle-jem] | Gem Templating | Gem template library with smart merge support |
168
+
169
+ [tree_haver]: https://github.com/kettle-rb/tree_haver
170
+ [ast-merge]: https://github.com/kettle-rb/ast-merge
171
+ [prism-merge]: https://github.com/kettle-rb/prism-merge
172
+ [psych-merge]: https://github.com/kettle-rb/psych-merge
173
+ [json-merge]: https://github.com/kettle-rb/json-merge
174
+ [jsonc-merge]: https://github.com/kettle-rb/jsonc-merge
175
+ [bash-merge]: https://github.com/kettle-rb/bash-merge
176
+ [rbs-merge]: https://github.com/kettle-rb/rbs-merge
177
+ [dotenv-merge]: https://github.com/kettle-rb/dotenv-merge
178
+ [toml-merge]: https://github.com/kettle-rb/toml-merge
179
+ [markdown-merge]: https://github.com/kettle-rb/markdown-merge
180
+ [markly-merge]: https://github.com/kettle-rb/markly-merge
181
+ [commonmarker-merge]: https://github.com/kettle-rb/commonmarker-merge
182
+ [kettle-dev]: https://github.com/kettle-rb/kettle-dev
183
+ [kettle-jem]: https://github.com/kettle-rb/kettle-jem
184
+ [tree_haver-gem]: https://bestgems.org/gems/tree_haver
185
+ [ast-merge-gem]: https://bestgems.org/gems/ast-merge
186
+ [prism-merge-gem]: https://bestgems.org/gems/prism-merge
187
+ [psych-merge-gem]: https://bestgems.org/gems/psych-merge
188
+ [json-merge-gem]: https://bestgems.org/gems/json-merge
189
+ [jsonc-merge-gem]: https://bestgems.org/gems/jsonc-merge
190
+ [bash-merge-gem]: https://bestgems.org/gems/bash-merge
191
+ [rbs-merge-gem]: https://bestgems.org/gems/rbs-merge
192
+ [dotenv-merge-gem]: https://bestgems.org/gems/dotenv-merge
193
+ [toml-merge-gem]: https://bestgems.org/gems/toml-merge
194
+ [markdown-merge-gem]: https://bestgems.org/gems/markdown-merge
195
+ [markly-merge-gem]: https://bestgems.org/gems/markly-merge
196
+ [commonmarker-merge-gem]: https://bestgems.org/gems/commonmarker-merge
197
+ [kettle-dev-gem]: https://bestgems.org/gems/kettle-dev
198
+ [kettle-jem-gem]: https://bestgems.org/gems/kettle-jem
199
+ [tree_haver-gem-i]: https://img.shields.io/gem/v/tree_haver.svg
200
+ [ast-merge-gem-i]: https://img.shields.io/gem/v/ast-merge.svg
201
+ [prism-merge-gem-i]: https://img.shields.io/gem/v/prism-merge.svg
202
+ [psych-merge-gem-i]: https://img.shields.io/gem/v/psych-merge.svg
203
+ [json-merge-gem-i]: https://img.shields.io/gem/v/json-merge.svg
204
+ [jsonc-merge-gem-i]: https://img.shields.io/gem/v/jsonc-merge.svg
205
+ [bash-merge-gem-i]: https://img.shields.io/gem/v/bash-merge.svg
206
+ [rbs-merge-gem-i]: https://img.shields.io/gem/v/rbs-merge.svg
207
+ [dotenv-merge-gem-i]: https://img.shields.io/gem/v/dotenv-merge.svg
208
+ [toml-merge-gem-i]: https://img.shields.io/gem/v/toml-merge.svg
209
+ [markdown-merge-gem-i]: https://img.shields.io/gem/v/markdown-merge.svg
210
+ [markly-merge-gem-i]: https://img.shields.io/gem/v/markly-merge.svg
211
+ [commonmarker-merge-gem-i]: https://img.shields.io/gem/v/commonmarker-merge.svg
212
+ [kettle-dev-gem-i]: https://img.shields.io/gem/v/kettle-dev.svg
213
+ [kettle-jem-gem-i]: https://img.shields.io/gem/v/kettle-jem.svg
214
+ [tree_haver-ci-i]: https://github.com/kettle-rb/tree_haver/actions/workflows/current.yml/badge.svg
215
+ [ast-merge-ci-i]: https://github.com/kettle-rb/ast-merge/actions/workflows/current.yml/badge.svg
216
+ [prism-merge-ci-i]: https://github.com/kettle-rb/prism-merge/actions/workflows/current.yml/badge.svg
217
+ [psych-merge-ci-i]: https://github.com/kettle-rb/psych-merge/actions/workflows/current.yml/badge.svg
218
+ [json-merge-ci-i]: https://github.com/kettle-rb/json-merge/actions/workflows/current.yml/badge.svg
219
+ [jsonc-merge-ci-i]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/current.yml/badge.svg
220
+ [bash-merge-ci-i]: https://github.com/kettle-rb/bash-merge/actions/workflows/current.yml/badge.svg
221
+ [rbs-merge-ci-i]: https://github.com/kettle-rb/rbs-merge/actions/workflows/current.yml/badge.svg
222
+ [dotenv-merge-ci-i]: https://github.com/kettle-rb/dotenv-merge/actions/workflows/current.yml/badge.svg
223
+ [toml-merge-ci-i]: https://github.com/kettle-rb/toml-merge/actions/workflows/current.yml/badge.svg
224
+ [markdown-merge-ci-i]: https://github.com/kettle-rb/markdown-merge/actions/workflows/current.yml/badge.svg
225
+ [markly-merge-ci-i]: https://github.com/kettle-rb/markly-merge/actions/workflows/current.yml/badge.svg
226
+ [commonmarker-merge-ci-i]: https://github.com/kettle-rb/commonmarker-merge/actions/workflows/current.yml/badge.svg
227
+ [kettle-dev-ci-i]: https://github.com/kettle-rb/kettle-dev/actions/workflows/current.yml/badge.svg
228
+ [kettle-jem-ci-i]: https://github.com/kettle-rb/kettle-jem/actions/workflows/current.yml/badge.svg
229
+ [tree_haver-ci]: https://github.com/kettle-rb/tree_haver/actions/workflows/current.yml
230
+ [ast-merge-ci]: https://github.com/kettle-rb/ast-merge/actions/workflows/current.yml
231
+ [prism-merge-ci]: https://github.com/kettle-rb/prism-merge/actions/workflows/current.yml
232
+ [psych-merge-ci]: https://github.com/kettle-rb/psych-merge/actions/workflows/current.yml
233
+ [json-merge-ci]: https://github.com/kettle-rb/json-merge/actions/workflows/current.yml
234
+ [jsonc-merge-ci]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/current.yml
235
+ [bash-merge-ci]: https://github.com/kettle-rb/bash-merge/actions/workflows/current.yml
236
+ [rbs-merge-ci]: https://github.com/kettle-rb/rbs-merge/actions/workflows/current.yml
237
+ [dotenv-merge-ci]: https://github.com/kettle-rb/dotenv-merge/actions/workflows/current.yml
238
+ [toml-merge-ci]: https://github.com/kettle-rb/toml-merge/actions/workflows/current.yml
239
+ [markdown-merge-ci]: https://github.com/kettle-rb/markdown-merge/actions/workflows/current.yml
240
+ [markly-merge-ci]: https://github.com/kettle-rb/markly-merge/actions/workflows/current.yml
241
+ [commonmarker-merge-ci]: https://github.com/kettle-rb/commonmarker-merge/actions/workflows/current.yml
242
+ [kettle-dev-ci]: https://github.com/kettle-rb/kettle-dev/actions/workflows/current.yml
243
+ [kettle-jem-ci]: https://github.com/kettle-rb/kettle-jem/actions/workflows/current.yml
244
+ [prism]: https://github.com/ruby/prism
245
+ [psych]: https://github.com/ruby/psych
246
+ [ffi]: https://github.com/ffi/ffi
247
+ [ts-json]: https://github.com/tree-sitter/tree-sitter-json
248
+ [ts-jsonc]: https://gitlab.com/WhyNotHugo/tree-sitter-jsonc
249
+ [ts-bash]: https://github.com/tree-sitter/tree-sitter-bash
250
+ [ts-rbs]: https://github.com/joker1007/tree-sitter-rbs
251
+ [ts-toml]: https://github.com/tree-sitter-grammars/tree-sitter-toml
252
+ [dotenv]: https://github.com/bkeepers/dotenv
253
+ [rbs]: https://github.com/ruby/rbs
254
+ [toml-rb]: https://github.com/emancu/toml-rb
255
+ [toml]: https://github.com/jm/toml
256
+ [markly]: https://github.com/ioquatix/markly
257
+ [commonmarker]: https://github.com/gjtorikian/commonmarker
258
+ [ruby_tree_sitter]: https://github.com/Faveod/ruby-tree-sitter
259
+ [tree_stump]: https://github.com/joker1007/tree_stump
260
+ [jtreesitter]: https://central.sonatype.com/artifact/io.github.tree-sitter/jtreesitter
261
+ [citrus]: https://github.com/mjackson/citrus
262
+ [parslet]: https://github.com/kschiess/parslet
263
+
264
+ ## 💡 Info you can shake a stick at
265
+
266
+ | Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
267
+ |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
268
+ | Works with JRuby | [![JRuby 10.0 Compat][💎jruby-c-i]][🚎11-c-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf] |
269
+ | Works with Truffle Ruby | [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎9-t-wf] [![Truffle Ruby 24.1 Compat][💎truby-c-i]][🚎11-c-wf] |
270
+ | 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]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf] |
271
+ | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![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] |
272
+ | 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] |
273
+ | 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] |
274
+ | 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] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
275
+ | 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] |
276
+ | 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] |
277
+ | `...` 💖 | [![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] |
278
+
279
+ ### Compatibility
280
+
281
+ Compatible with MRI Ruby 3.2.0+, and concordant releases of JRuby, and TruffleRuby.
282
+
283
+ | 🚚 _Amazing_ test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚 |
284
+ |------------------------------------------------|--------------------------------------------------------|
285
+ | 👟 Check it out! | ✨ [github.com/appraisal-rb/appraisal2][💎appraisal2] ✨ |
286
+
287
+ ### Federated DVCS
288
+
289
+ <details markdown="1">
290
+ <summary>Find this repo on federated forges (Coming soon!)</summary>
291
+
292
+ | Federated [DVCS][💎d-in-dvcs] Repository | Status | Issues | PRs | Wiki | CI | Discussions |
293
+ |--------------------------------------------------|-----------------------------------------------------------------------|---------------------------|--------------------------|---------------------------|--------------------------|------------------------------|
294
+ | 🧪 [kettle-rb/jsonc-merge on GitLab][📜src-gl] | The Truth | [💚][🤝gl-issues] | [💚][🤝gl-pulls] | [💚][📜gl-wiki] | 🐭 Tiny Matrix | ➖ |
295
+ | 🧊 [kettle-rb/jsonc-merge on CodeBerg][📜src-cb] | An Ethical Mirror ([Donate][🤝cb-donate]) | [💚][🤝cb-issues] | [💚][🤝cb-pulls] | ➖ | ⭕️ No Matrix | ➖ |
296
+ | 🐙 [kettle-rb/jsonc-merge on GitHub][📜src-gh] | Another Mirror | [💚][🤝gh-issues] | [💚][🤝gh-pulls] | [💚][📜gh-wiki] | 💯 Full Matrix | [💚][gh-discussions] |
297
+ | 🎮️ [Discord Server][✉️discord-invite] | [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] | [Let's][✉️discord-invite] | [talk][✉️discord-invite] | [about][✉️discord-invite] | [this][✉️discord-invite] | [library!][✉️discord-invite] |
298
+
299
+ </details>
300
+
301
+ [gh-discussions]: https://github.com/kettle-rb/jsonc-merge/discussions
302
+
303
+ ### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/jsonc-merge)][🏙️entsup-tidelift]
304
+
305
+ Available as part of the Tidelift Subscription.
306
+
307
+ <details markdown="1">
308
+ <summary>Need enterprise-level guarantees?</summary>
309
+
310
+ 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.
311
+
312
+ [![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]
313
+
314
+ - 💡Subscribe for support guarantees covering _all_ your FLOSS dependencies
315
+ - 💡Tidelift is part of [Sonar][🏙️entsup-tidelift-sonar]
316
+ - 💡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
317
+
318
+ Alternatively:
319
+
320
+ - [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
321
+ - [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork]
322
+ - [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]
323
+
324
+ </details>
325
+
326
+ ## ✨ Installation
327
+
328
+ Install the gem and add to the application's Gemfile by executing:
329
+
330
+ ```console
331
+ bundle add jsonc-merge
332
+ ```
333
+
334
+ If bundler is not being used to manage dependencies, install the gem by executing:
335
+
336
+ ```console
337
+ gem install jsonc-merge
338
+ ```
339
+
340
+ ### 🔒 Secure Installation
341
+
342
+ <details markdown="1">
343
+ <summary>For Medium or High Security Installations</summary>
344
+
345
+ This gem is cryptographically signed, and has verifiable [SHA-256 and SHA-512][💎SHA_checksums] checksums by
346
+ [stone_checksums][💎stone_checksums]. Be sure the gem you install hasn’t been tampered with
347
+ by following the instructions below.
348
+
349
+ Add my public key (if you haven’t already, expires 2045-04-29) as a trusted certificate:
350
+
351
+ ```console
352
+ gem cert --add <(curl -Ls https://raw.github.com/galtzo-floss/certs/main/pboling.pem)
353
+ ```
354
+
355
+ You only need to do that once. Then proceed to install with:
356
+
357
+ ```console
358
+ gem install jsonc-merge -P HighSecurity
359
+ ```
360
+
361
+ The `HighSecurity` trust profile will verify signed gems, and not allow the installation of unsigned dependencies.
362
+
363
+ If you want to up your security game full-time:
364
+
365
+ ```console
366
+ bundle config set --global trust-policy MediumSecurity
367
+ ```
368
+
369
+ `MediumSecurity` instead of `HighSecurity` is necessary if not all the gems you use are signed.
370
+
371
+ NOTE: Be prepared to track down certs for signed gems and add them the same way you added mine.
372
+
373
+ </details>
374
+
375
+ ### 🌳 Tree-Sitter Parser Installation
376
+
377
+ This gem requires the `tree-sitter-json` parser library to be installed on your system.
378
+ The parser is a native shared library (`.so` on Linux, `.dylib` on macOS) that provides
379
+ JSON/JSONC syntax parsing capabilities, including support for comments in JSONC files.
380
+
381
+ #### Option 1: Pre-built Binaries (Recommended)
382
+
383
+ Download pre-built parsers from [Faveod/tree-sitter-parsers](https://github.com/Faveod/tree-sitter-parsers/releases):
384
+
385
+ **Linux (x64):**
386
+
387
+ ```console
388
+ # Download and extract
389
+ 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
390
+ tar -xzf parsers.tar.gz
391
+
392
+ # Install system-wide (requires sudo)
393
+ sudo cp libtree-sitter-json.so /usr/lib/
394
+ sudo ldconfig
395
+
396
+ # Or install locally and set environment variable
397
+ mkdir -p ~/.local/lib/tree-sitter
398
+ cp libtree-sitter-json.so ~/.local/lib/tree-sitter/
399
+ export TREE_SITTER_JSON_PATH="$HOME/.local/lib/tree-sitter/libtree-sitter-json.so"
400
+ ```
401
+
402
+ **Debian/Ubuntu (amd64):**
403
+
404
+ ```console
405
+ curl -Lo parsers.deb https://github.com/Faveod/tree-sitter-parsers/releases/download/v4.10/tree-sitter-parsers-4.10-amd64.deb
406
+ sudo dpkg -i parsers.deb
407
+ ```
408
+
409
+ **macOS (Apple Silicon):**
410
+
411
+ ```console
412
+ 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
413
+ tar -xzf parsers.tar.gz
414
+
415
+ # Install to a location and set environment variable
416
+ mkdir -p ~/.local/lib/tree-sitter
417
+ cp libtree-sitter-json.dylib ~/.local/lib/tree-sitter/
418
+ export TREE_SITTER_JSON_PATH="$HOME/.local/lib/tree-sitter/libtree-sitter-json.dylib"
419
+ ```
420
+
421
+ #### Option 2: Build from Source
422
+
423
+ ```console
424
+ git clone https://github.com/tree-sitter/tree-sitter-json.git
425
+ cd tree-sitter-json
426
+ make
427
+ sudo cp libtree-sitter-json.so /usr/lib/ # Linux
428
+ # or
429
+ sudo cp libtree-sitter-json.dylib /usr/local/lib/ # macOS
430
+ ```
431
+
432
+ #### Option 3: Package Manager
433
+
434
+ Some package managers provide tree-sitter parsers:
435
+
436
+ **Fedora Atomic (Silverblue, Kinoite, Bazzite, Aurora, etc.):**
437
+
438
+ ```console
439
+ # Install via rpm-ostree (requires reboot)
440
+ rpm-ostree install libtree-sitter-json
441
+
442
+ # The library will be installed to /usr/lib64/libtree-sitter-json.so
443
+ # You may need to set the environment variable:
444
+ export TREE_SITTER_JSON_PATH="/usr/lib64/libtree-sitter-json.so"
445
+ ```
446
+
447
+ **Fedora (traditional):**
448
+
449
+ ```console
450
+ sudo dnf install libtree-sitter-json
451
+ ```
452
+
453
+ **Arch Linux:**
454
+
455
+ ```console
456
+ # Check AUR for tree-sitter-json
457
+ yay -S tree-sitter-json
458
+ ```
459
+
460
+ #### Environment Variable
461
+
462
+ If the parser is not in a standard location (`/usr/lib/`, `/usr/lib64/`, `/usr/local/lib/`),
463
+ set the `TREE_SITTER_JSON_PATH` environment variable to point to the parser library:
464
+
465
+ ```console
466
+ export TREE_SITTER_JSON_PATH="/path/to/libtree-sitter-json.so"
467
+ ```
468
+
469
+ **Note:** Some distributions install the library with a version number suffix
470
+ (e.g., `libtree-sitter-json.so.14` instead of `libtree-sitter-json.so`).
471
+ If the gem can't find the parser, check for versioned files and either:
472
+
473
+ - Set `TREE_SITTER_JSON_PATH` to the full versioned path, or
474
+ - Create a symlink: `sudo ln -s /usr/lib64/libtree-sitter-json.so.14 /usr/lib64/libtree-sitter-json.so`
475
+
476
+ Add this to your shell profile (`.bashrc`, `.zshrc`, etc.) for persistence.
477
+
478
+ ### 💎 Ruby Interface Gems
479
+
480
+ In addition to the tree-sitter parser library, you need a Ruby gem that provides
481
+ bindings to tree-sitter. Alternatively, on JRuby the jtreesitter maven package works. Choose **one** of the following based on your Ruby implementation:
482
+
483
+ | package | Ruby Support | Description |
484
+ |----------------------------------------------------------------------------------------|-------------------------|----------------------------------------------------------|
485
+ | [ruby\_tree\_sitter][ruby_tree_sitter] | MRI only | C extension bindings (recommended for MRI) |
486
+ | [tree\_stump][tree_stump] | MRI only | Rust-based bindings via rbs_sys and magnus |
487
+ | [ffi][ffi] | MRI, JRuby, TruffleRuby | Generic FFI bindings (used by tree\_haver's FFI backend) |
488
+ | [jtreesitter][jtreesitter] | JRuby | used by tree\_haver's Java backend) |
489
+
490
+ [ruby_tree_sitter]: https://github.com/Faveod/ruby_tree_sitter
491
+ [tree_stump]: https://github.com/nickstenning/tree_stump
492
+ [ffi]: https://github.com/ffi/ffi
493
+ [jtreesitter]: https://central.sonatype.com/artifact/io.github.tree-sitter/jtreesitter
494
+
495
+ #### For MRI Ruby (Recommended)
496
+
497
+ ```console
498
+ gem install ruby_tree_sitter
499
+ ```
500
+
501
+ Or add to your Gemfile:
502
+
503
+ ```ruby
504
+ gem "ruby_tree_sitter", "~> 2.0", require: "tree_sitter"
505
+ ```
506
+
507
+ #### For JRuby or TruffleRuby
508
+
509
+ ```console
510
+ gem install ffi
511
+ ```
512
+
513
+ Or add to your Gemfile:
514
+
515
+ ```ruby
516
+ gem "ffi"
517
+ ```
518
+
519
+ The `tree_haver` gem (a dependency of jsonc-merge) will automatically detect and use
520
+ the appropriate backend based on which gems are available.
521
+
522
+ **Note:** The `ruby_tree_sitter` gem only compiles on MRI Ruby. For JRuby or TruffleRuby,
523
+ you must use the FFI backend.
524
+
525
+ ## ⚙️ Configuration
526
+
527
+ ```ruby
528
+ merger = Jsonc::Merge::SmartMerger.new(
529
+ template_content,
530
+ dest_content,
531
+ # Which version to prefer when nodes match
532
+ # :destination (default) - keep destination values
533
+ # :template - use template values
534
+ preference: :destination,
535
+
536
+ # Whether to add template-only nodes to the result
537
+ # false (default) - only include properties that exist in destination
538
+ # true - include all template properties
539
+ add_template_only_nodes: false,
540
+
541
+ # Token for freeze block markers
542
+ # Default: "jsonc-merge"
543
+ # Looks for: // jsonc-merge:freeze / // jsonc-merge:unfreeze
544
+ freeze_token: "jsonc-merge",
545
+
546
+ # Custom signature generator (optional)
547
+ # Receives a node, returns a signature array or nil
548
+ signature_generator: ->(node) { [:pair, node.key] if node.type == :pair },
549
+ )
550
+ ```
551
+
552
+ ## 🔧 Basic Usage
553
+
554
+ ### Simple Merge
555
+
556
+ ```ruby
557
+ require "jsonc/merge"
558
+
559
+ # Template defines the structure
560
+ template = <<~JSONC
561
+ {
562
+ // Application settings
563
+ "name": "my-app",
564
+ "version": "1.0.0",
565
+ "debug": false,
566
+
567
+ /* Database configuration */
568
+ "database": {
569
+ "host": "localhost",
570
+ "port": 5432
571
+ }
572
+ }
573
+ JSONC
574
+
575
+ # Destination has customizations
576
+ destination = <<~JSONC
577
+ {
578
+ // Application settings
579
+ "name": "my-app",
580
+ "version": "2.0.0",
581
+ "custom_setting": true,
582
+
583
+ /* Database configuration */
584
+ "database": {
585
+ "host": "production.example.com",
586
+ "port": 5432,
587
+ "pool_size": 25
588
+ }
589
+ }
590
+ JSONC
591
+
592
+ merger = Jsonc::Merge::SmartMerger.new(template, destination)
593
+ result = merger.merge
594
+ puts result.to_jsonc
595
+ ```
596
+
597
+ ### Using Freeze Blocks
598
+
599
+ Freeze blocks protect sections from being overwritten during merge:
600
+
601
+ ```jsonc
602
+ {
603
+ "name": "my-app",
604
+
605
+ // jsonc-merge:freeze Secret configuration
606
+ "api_key": "my_production_api_key",
607
+ "api_secret": "super_secret_value",
608
+ // jsonc-merge:unfreeze
609
+
610
+ "debug": false
611
+ }
612
+ ```
613
+
614
+ Content between `// jsonc-merge:freeze` and `// jsonc-merge:unfreeze` markers is preserved from the destination file, regardless of what the template contains.
615
+
616
+ ### Adding Template-Only Properties
617
+
618
+ ```ruby
619
+ merger = Jsonc::Merge::SmartMerger.new(
620
+ template,
621
+ destination,
622
+ add_template_only_nodes: true,
623
+ )
624
+ result = merger.merge
625
+ # Result includes properties from template that don't exist in destination
626
+ ```
627
+
628
+ ## 🦷 FLOSS Funding
629
+
630
+ While kettle-rb tools are free software and will always be, the project would benefit immensely from some funding.
631
+ Raising a monthly budget of... "dollars" would make the project more sustainable.
632
+
633
+ We welcome both individual and corporate sponsors! We also offer a
634
+ wide array of funding channels to account for your preferences
635
+ (although currently [Open Collective][🖇osc] is our preferred funding platform).
636
+
637
+ **If you're working in a company that's making significant use of kettle-rb tools we'd
638
+ appreciate it if you suggest to your company to become a kettle-rb sponsor.**
639
+
640
+ You can support the development of kettle-rb tools via
641
+ [GitHub Sponsors][🖇sponsor],
642
+ [Liberapay][⛳liberapay],
643
+ [PayPal][🖇paypal],
644
+ [Open Collective][🖇osc]
645
+ and [Tidelift][🏙️entsup-tidelift].
646
+
647
+ | 📍 NOTE |
648
+ |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
649
+ | 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. |
650
+
651
+ ### Open Collective for Individuals
652
+
653
+ Support us with a monthly donation and help us continue our activities. [[Become a backer][🖇osc-backers]]
654
+
655
+ NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
656
+
657
+ <!-- OPENCOLLECTIVE-INDIVIDUALS:START -->
658
+ No backers yet. Be the first!
659
+ <!-- OPENCOLLECTIVE-INDIVIDUALS:END -->
660
+
661
+ ### Open Collective for Organizations
662
+
663
+ Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor][🖇osc-sponsors]]
664
+
665
+ NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
666
+
667
+ <!-- OPENCOLLECTIVE-ORGANIZATIONS:START -->
668
+ No sponsors yet. Be the first!
669
+ <!-- OPENCOLLECTIVE-ORGANIZATIONS:END -->
670
+
671
+ [kettle-readme-backers]: https://github.com/kettle-rb/jsonc-merge/blob/main/exe/kettle-readme-backers
672
+
673
+ ### Another way to support open-source
674
+
675
+ 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).
676
+
677
+ 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`.
678
+
679
+ 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.
680
+
681
+ **[Floss-Funding.dev][🖇floss-funding.dev]: 👉️ No network calls. 👉️ No tracking. 👉️ No oversight. 👉️ Minimal crypto hashing. 💡 Easily disabled nags**
682
+
683
+ [![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]
684
+
685
+ ## 🔐 Security
686
+
687
+ See [SECURITY.md][🔐security].
688
+
689
+ ## 🤝 Contributing
690
+
691
+ If you need some ideas of where to help, you could work on adding more code coverage,
692
+ or if it is already 💯 (see [below](#code-coverage)) check [reek](REEK), [issues][🤝gh-issues], or [PRs][🤝gh-pulls],
693
+ or use the gem and think about how it could be better.
694
+
695
+ We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
696
+
697
+ See [CONTRIBUTING.md][🤝contributing] for more detailed instructions.
698
+
699
+ ### 🚀 Release Instructions
700
+
701
+ See [CONTRIBUTING.md][🤝contributing].
702
+
703
+ ### Code Coverage
704
+
705
+ [![Coverage Graph][🏀codecov-g]][🏀codecov]
706
+
707
+ [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls]
708
+
709
+ [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov]
710
+
711
+ ### 🪇 Code of Conduct
712
+
713
+ Everyone interacting with this project's codebases, issue trackers,
714
+ chat rooms and mailing lists agrees to follow the [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct].
715
+
716
+ ## 🌈 Contributors
717
+
718
+ [![Contributors][🖐contributors-img]][🖐contributors]
719
+
720
+ Made with [contributors-img][🖐contrib-rocks].
721
+
722
+ Also see GitLab Contributors: [https://gitlab.com/kettle-rb/jsonc-merge/-/graphs/main][🚎contributors-gl]
723
+
724
+ <details>
725
+ <summary>⭐️ Star History</summary>
726
+
727
+ <a href="https://star-history.com/#kettle-rb/jsonc-merge&Date">
728
+ <picture>
729
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kettle-rb/jsonc-merge&type=Date&theme=dark" />
730
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kettle-rb/jsonc-merge&type=Date" />
731
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kettle-rb/jsonc-merge&type=Date" />
732
+ </picture>
733
+ </a>
734
+
735
+ </details>
736
+
737
+ ## 📌 Versioning
738
+
739
+ This Library adheres to [![Semantic Versioning 2.0.0][📌semver-img]][📌semver].
740
+ Violations of this scheme should be reported as bugs.
741
+ Specifically, if a minor or patch version is released that breaks backward compatibility,
742
+ a new version should be immediately released that restores compatibility.
743
+ Breaking changes to the public API will only be introduced with new major versions.
744
+
745
+ > dropping support for a platform is both obviously and objectively a breaking change <br/>
746
+ >—Jordan Harband ([@ljharb](https://github.com/ljharb), maintainer of SemVer) [in SemVer issue 716][📌semver-breaking]
747
+
748
+ I understand that policy doesn't work universally ("exceptions to every rule!"),
749
+ but it is the policy here.
750
+ As such, in many cases it is good to specify a dependency on this library using
751
+ the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
752
+
753
+ For example:
754
+
755
+ ```ruby
756
+ spec.add_dependency("jsonc-merge", "~> 1.0")
757
+ ```
758
+
759
+ <details markdown="1">
760
+ <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
761
+
762
+ SemVer should, IMO, but doesn't explicitly, say that dropping support for specific Platforms
763
+ is a *breaking change* to an API, and for that reason the bike shedding is endless.
764
+
765
+ To get a better understanding of how SemVer is intended to work over a project's lifetime,
766
+ read this article from the creator of SemVer:
767
+
768
+ - ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
769
+
770
+ </details>
771
+
772
+ See [CHANGELOG.md][📌changelog] for a list of releases.
773
+
774
+ ## 📄 License
775
+
776
+ The gem is available as open source under the terms of
777
+ the [MIT License][📄license] [![License: MIT][📄license-img]][📄license-ref].
778
+ See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].
779
+
780
+ ### © Copyright
781
+
782
+ <ul>
783
+ <li>
784
+ Copyright (c) 2025-2026 Peter H. Boling, of
785
+ <a href="https://discord.gg/3qme4XHNKN">
786
+ Galtzo.com
787
+ <picture>
788
+ <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">
789
+ </picture>
790
+ </a>, and jsonc-merge contributors.
791
+ </li>
792
+ </ul>
793
+
794
+ ## 🤑 A request for help
795
+
796
+ Maintainers have teeth and need to pay their dentists.
797
+ After getting laid off in an RIF in March, and encountering difficulty finding a new one,
798
+ I began spending most of my time building open source tools.
799
+ I'm hoping to be able to pay for my kids' health insurance this month,
800
+ so if you value the work I am doing, I need your support.
801
+ Please consider sponsoring me or the project.
802
+
803
+ To join the community or get help 👇️ Join the Discord.
804
+
805
+ [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
806
+
807
+ To say "thanks!" ☝️ Join the Discord or 👇️ send money.
808
+
809
+ [![Sponsor kettle-rb/jsonc-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]
810
+
811
+ ### Please give the project a star ⭐ ♥.
812
+
813
+ Thanks for RTFM. ☺️
814
+
815
+ [⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
816
+ [⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge&logo=liberapay&color=a51611
817
+ [⛳liberapay]: https://liberapay.com/pboling/donate
818
+ [🖇osc-all-img]: https://img.shields.io/opencollective/all/kettle-rb
819
+ [🖇osc-sponsors-img]: https://img.shields.io/opencollective/sponsors/kettle-rb
820
+ [🖇osc-backers-img]: https://img.shields.io/opencollective/backers/kettle-rb
821
+ [🖇osc-backers]: https://opencollective.com/kettle-rb#backer
822
+ [🖇osc-backers-i]: https://opencollective.com/kettle-rb/backers/badge.svg?style=flat
823
+ [🖇osc-sponsors]: https://opencollective.com/kettle-rb#sponsor
824
+ [🖇osc-sponsors-i]: https://opencollective.com/kettle-rb/sponsors/badge.svg?style=flat
825
+ [🖇osc-all-bottom-img]: https://img.shields.io/opencollective/all/kettle-rb?style=for-the-badge
826
+ [🖇osc-sponsors-bottom-img]: https://img.shields.io/opencollective/sponsors/kettle-rb?style=for-the-badge
827
+ [🖇osc-backers-bottom-img]: https://img.shields.io/opencollective/backers/kettle-rb?style=for-the-badge
828
+ [🖇osc]: https://opencollective.com/kettle-rb
829
+ [🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
830
+ [🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge&logo=github
831
+ [🖇sponsor]: https://github.com/sponsors/pboling
832
+ [🖇polar-img]: https://img.shields.io/badge/polar-donate-a51611.svg?style=flat
833
+ [🖇polar]: https://polar.sh/pboling
834
+ [🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
835
+ [🖇kofi]: https://ko-fi.com/O5O86SNP4
836
+ [🖇patreon-img]: https://img.shields.io/badge/patreon-donate-a51611.svg?style=flat
837
+ [🖇patreon]: https://patreon.com/galtzo
838
+ [🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat
839
+ [🖇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
840
+ [🖇buyme]: https://www.buymeacoffee.com/pboling
841
+ [🖇paypal-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=flat&logo=paypal
842
+ [🖇paypal-bottom-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=for-the-badge&logo=paypal&color=0A0A0A
843
+ [🖇paypal]: https://www.paypal.com/paypalme/peterboling
844
+ [🖇floss-funding.dev]: https://floss-funding.dev
845
+ [🖇floss-funding-gem]: https://github.com/galtzo-floss/floss_funding
846
+ [✉️discord-invite]: https://discord.gg/3qme4XHNKN
847
+ [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
848
+ [✉️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
849
+ [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
850
+ [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
851
+ [⛳️gem-namespace]: https://github.com/kettle-rb/jsonc-merge
852
+ [⛳️namespace-img]: https://img.shields.io/badge/namespace-Json::Merge-3C2D2D.svg?style=square&logo=ruby&logoColor=white
853
+ [⛳️gem-name]: https://bestgems.org/gems/jsonc-merge
854
+ [⛳️name-img]: https://img.shields.io/badge/name-json--merge-3C2D2D.svg?style=square&logo=rubygems&logoColor=red
855
+ [⛳️tag-img]: https://img.shields.io/github/tag/kettle-rb/jsonc-merge.svg
856
+ [⛳️tag]: http://github.com/kettle-rb/jsonc-merge/releases
857
+ [🚂maint-blog]: http://www.railsbling.com/tags/jsonc-merge
858
+ [🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge&logo=rubyonrails&logoColor=orange
859
+ [🚂maint-contact]: http://www.railsbling.com/contact
860
+ [🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red
861
+ [💖🖇linkedin]: http://www.linkedin.com/in/peterboling
862
+ [💖🖇linkedin-img]: https://img.shields.io/badge/PeterBoling-LinkedIn-0B66C2?style=flat&logo=newjapanprowrestling
863
+ [💖✌️wellfound]: https://wellfound.com/u/peter-boling
864
+ [💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat&logo=wellfound
865
+ [💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling
866
+ [💖💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=flat&logo=crunchbase
867
+ [💖🐘ruby-mast]: https://ruby.social/@galtzo
868
+ [💖🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https://ruby.social&style=flat&logo=mastodon&label=Ruby%20@galtzo
869
+ [💖🦋bluesky]: https://bsky.app/profile/galtzo.com
870
+ [💖🦋bluesky-img]: https://img.shields.io/badge/@galtzo.com-0285FF?style=flat&logo=bluesky&logoColor=white
871
+ [💖🌳linktree]: https://linktr.ee/galtzo
872
+ [💖🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=flat&logo=linktree
873
+ [💖💁🏼‍♂️devto]: https://dev.to/galtzo
874
+ [💖💁🏼‍♂️devto-img]: https://img.shields.io/badge/dev.to-0A0A0A?style=flat&logo=devdotto&logoColor=white
875
+ [💖💁🏼‍♂️aboutme]: https://about.me/peter.boling
876
+ [💖💁🏼‍♂️aboutme-img]: https://img.shields.io/badge/about.me-0A0A0A?style=flat&logo=aboutme&logoColor=white
877
+ [💖🧊berg]: https://codeberg.org/pboling
878
+ [💖🐙hub]: https://github.org/pboling
879
+ [💖🛖hut]: https://sr.ht/~galtzo/
880
+ [💖🧪lab]: https://gitlab.com/pboling
881
+ [👨🏼‍🏫expsup-upwork]: https://www.upwork.com/freelancers/~014942e9b056abdf86?mp_source=share
882
+ [👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
883
+ [👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
884
+ [👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
885
+ [🏙️entsup-tidelift]: https://tidelift.com/subscription/pkg/rubygems-jsonc-merge?utm_source=rubygems-jsonc-merge&utm_medium=referral&utm_campaign=readme
886
+ [🏙️entsup-tidelift-img]: https://img.shields.io/badge/Tidelift_and_Sonar-Enterprise_Support-FD3456?style=for-the-badge&logo=sonar&logoColor=white
887
+ [🏙️entsup-tidelift-sonar]: https://blog.tidelift.com/tidelift-joins-sonar
888
+ [💁🏼‍♂️peterboling]: http://www.peterboling.com
889
+ [🚂railsbling]: http://www.railsbling.com
890
+ [📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
891
+ [📜src-gl]: https://gitlab.com/kettle-rb/jsonc-merge/
892
+ [📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
893
+ [📜src-cb]: https://codeberg.org/kettle-rb/jsonc-merge
894
+ [📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=Github&logoColor=green
895
+ [📜src-gh]: https://github.com/kettle-rb/jsonc-merge
896
+ [📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
897
+ [📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
898
+ [📜gl-wiki]: https://gitlab.com/kettle-rb/jsonc-merge/-/wikis/home
899
+ [📜gh-wiki]: https://github.com/kettle-rb/jsonc-merge/wiki
900
+ [📜gl-wiki-img]: https://img.shields.io/badge/wiki-examples-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
901
+ [📜gh-wiki-img]: https://img.shields.io/badge/wiki-examples-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
902
+ [👽dl-rank]: https://bestgems.org/gems/jsonc-merge
903
+ [👽dl-ranki]: https://img.shields.io/gem/rd/jsonc-merge.svg
904
+ [👽oss-help]: https://www.codetriage.com/kettle-rb/jsonc-merge
905
+ [👽oss-helpi]: https://www.codetriage.com/kettle-rb/jsonc-merge/badges/users.svg
906
+ [👽version]: https://bestgems.org/gems/jsonc-merge
907
+ [👽versioni]: https://img.shields.io/gem/v/jsonc-merge.svg
908
+ [🏀qlty-mnt]: https://qlty.sh/gh/kettle-rb/projects/jsonc-merge
909
+ [🏀qlty-mnti]: https://qlty.sh/gh/kettle-rb/projects/jsonc-merge/maintainability.svg
910
+ [🏀qlty-cov]: https://qlty.sh/gh/kettle-rb/projects/jsonc-merge/metrics/code?sort=coverageRating
911
+ [🏀qlty-covi]: https://qlty.sh/gh/kettle-rb/projects/jsonc-merge/coverage.svg
912
+ [🏀codecov]: https://codecov.io/gh/kettle-rb/jsonc-merge
913
+ [🏀codecovi]: https://codecov.io/gh/kettle-rb/jsonc-merge/graph/badge.svg
914
+ [🏀coveralls]: https://coveralls.io/github/kettle-rb/jsonc-merge?branch=main
915
+ [🏀coveralls-img]: https://coveralls.io/repos/github/kettle-rb/jsonc-merge/badge.svg?branch=main
916
+ [🖐codeQL]: https://github.com/kettle-rb/jsonc-merge/security/code-scanning
917
+ [🖐codeQL-img]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/codeql-analysis.yml/badge.svg
918
+ [🚎2-cov-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/coverage.yml
919
+ [🚎2-cov-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/coverage.yml/badge.svg
920
+ [🚎3-hd-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/heads.yml
921
+ [🚎3-hd-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/heads.yml/badge.svg
922
+ [🚎5-st-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/style.yml
923
+ [🚎5-st-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/style.yml/badge.svg
924
+ [🚎6-s-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/supported.yml
925
+ [🚎6-s-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/supported.yml/badge.svg
926
+ [🚎9-t-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/truffle.yml
927
+ [🚎9-t-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/truffle.yml/badge.svg
928
+ [🚎11-c-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/current.yml
929
+ [🚎11-c-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/current.yml/badge.svg
930
+ [🚎12-crh-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/dep-heads.yml
931
+ [🚎12-crh-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/dep-heads.yml/badge.svg
932
+ [🚎13-🔒️-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/locked_deps.yml
933
+ [🚎13-🔒️-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/locked_deps.yml/badge.svg
934
+ [🚎14-🔓️-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/unlocked_deps.yml
935
+ [🚎14-🔓️-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/unlocked_deps.yml/badge.svg
936
+ [🚎15-🪪-wf]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/license-eye.yml
937
+ [🚎15-🪪-wfi]: https://github.com/kettle-rb/jsonc-merge/actions/workflows/license-eye.yml/badge.svg
938
+ [💎ruby-3.2i]: https://img.shields.io/badge/Ruby-3.2-CC342D?style=for-the-badge&logo=ruby&logoColor=white
939
+ [💎ruby-3.3i]: https://img.shields.io/badge/Ruby-3.3-CC342D?style=for-the-badge&logo=ruby&logoColor=white
940
+ [💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
941
+ [💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
942
+ [💎truby-23.1i]: https://img.shields.io/badge/Truffle_Ruby-23.1-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
943
+ [💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
944
+ [💎truby-headi]: https://img.shields.io/badge/Truffle_Ruby-HEAD-34BCB1?style=for-the-badge&logo=ruby&logoColor=blue
945
+ [💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge&logo=ruby&logoColor=green
946
+ [💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge&logo=ruby&logoColor=blue
947
+ [🤝gh-issues]: https://github.com/kettle-rb/jsonc-merge/issues
948
+ [🤝gh-pulls]: https://github.com/kettle-rb/jsonc-merge/pulls
949
+ [🤝gl-issues]: https://gitlab.com/kettle-rb/jsonc-merge/-/issues
950
+ [🤝gl-pulls]: https://gitlab.com/kettle-rb/jsonc-merge/-/merge_requests
951
+ [🤝cb-issues]: https://codeberg.org/kettle-rb/jsonc-merge/issues
952
+ [🤝cb-pulls]: https://codeberg.org/kettle-rb/jsonc-merge/pulls
953
+ [🤝cb-donate]: https://donate.codeberg.org/
954
+ [🤝contributing]: CONTRIBUTING.md
955
+ [🏀codecov-g]: https://codecov.io/gh/kettle-rb/jsonc-merge/graphs/tree.svg
956
+ [🖐contrib-rocks]: https://contrib.rocks
957
+ [🖐contributors]: https://github.com/kettle-rb/jsonc-merge/graphs/contributors
958
+ [🖐contributors-img]: https://contrib.rocks/image?repo=kettle-rb/jsonc-merge
959
+ [🚎contributors-gl]: https://gitlab.com/kettle-rb/jsonc-merge/-/graphs/main
960
+ [🪇conduct]: CODE_OF_CONDUCT.md
961
+ [🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg
962
+ [📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
963
+ [📌semver]: https://semver.org/spec/v2.0.0.html
964
+ [📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat
965
+ [📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
966
+ [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
967
+ [📌changelog]: CHANGELOG.md
968
+ [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
969
+ [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
970
+ [📌gitmoji]: https://gitmoji.dev
971
+ [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
972
+ [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
973
+ [🧮kloc-img]: https://img.shields.io/badge/KLOC-0.687-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
974
+ [🔐security]: SECURITY.md
975
+ [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
976
+ [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
977
+ [📄license]: LICENSE.txt
978
+ [📄license-ref]: https://opensource.org/licenses/MIT
979
+ [📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
980
+ [📄license-compat]: https://dev.to/galtzo/how-to-check-license-compatibility-41h0
981
+ [📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache
982
+ [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
983
+ [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
984
+ [🚎yard-current]: http://rubydoc.info/gems/jsonc-merge
985
+ [🚎yard-head]: https://jsonc-merge.galtzo.com
986
+ [💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums
987
+ [💎SHA_checksums]: https://gitlab.com/kettle-rb/jsonc-merge/-/tree/main/checksums
988
+ [💎rlts]: https://github.com/rubocop-lts/rubocop-lts
989
+ [💎rlts-img]: https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white
990
+ [💎appraisal2]: https://github.com/appraisal-rb/appraisal2
991
+ [💎appraisal2-img]: https://img.shields.io/badge/appraised_by-appraisal2-34495e.svg?plastic&logo=ruby&logoColor=white
992
+ [💎d-in-dvcs]: https://railsbling.com/posts/dvcs/put_the_d_in_dvcs/