bash-merge 2.0.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe623f331b7f75cf956604e4fbe0f8c8cf60955bc82ba6a8546a9b7a75a5e9fd
-  data.tar.gz: c392e8e939cf15870303f445e4e37c3036b663469c24a037a984b7c1dc5ee9ab
+  metadata.gz: c67a335db3b9d46652ca59793d480c4087bd88d4233070f0a6b4036a2902f136
+  data.tar.gz: a685d8c63ead508e3583eab6373d9cff3277b39c423315a3ad6aad77a3b5c9d9
 SHA512:
-  metadata.gz: f5e2f494e97dfb16d578380f06a75add04aedee4f2cc2934f59889334aef3065ce5be95568feb7a01ad29b9471874f6ac1a76e7c372b6dc29e09a2fcbef7b45a
-  data.tar.gz: 6092c5a5c70bcf81682dbabec13fd5f1d601b994c41606b6d6d78877dc9d4cd8ac82000e4ac09e283047b0c8834aba6b8a7c8845264da80df8917741933d3510
+  metadata.gz: b32ddf1683fa6fc4ac1e9cfeef550416b54cf7d552eea9707642dd6176be1d7cb2fa4c6c8074770beccc5debbb8c850f53d45c56c8bdaa1208649bae302be820
+  data.tar.gz: bde6435c6ace02b852880ff8c0517e2e79ff03417ce64ef0ee764f1a9c0395fe87b0bdf992e1bc6088971f42ffaf506d8448e98fbff84fb1bc204b17cce79949

checksums.yaml.gz.sig

@@ -1,3 +1 @@
-,��?ACO�6�Mp�k�獎��5׃�~�D����c�̚m������*\D�M��v���uM�k�#��pH;x�1
-?��?���M^�g��'Ӕ�v(�Y��
-��uC+��ZJ4'������ĔxP�uf
+��:?���1���[��dL�J�J<���Lo�u:A���l��5�&�T%��~ߣvT)#83T��ܧ�s�w����f����_SJ�Lx��^�b-{O���3����8(���S?���xx�t@˝(ۛ�k����;Ǖ$�/�]H0)

data/CHANGELOG.md

@@ -30,6 +30,28 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.0.1] - 2026-01-09
+
+- TAG: [v2.0.1][2.0.1t]
+- COVERAGE: 96.34% -- 500/519 lines in 11 files
+- BRANCH COVERAGE: 76.54% -- 124/162 branches in 11 files
+- 96.33% documented
+
+### Added
+
+- FFI backend isolation for test suite
+  - Added `bin/rspec-ffi` script to run FFI specs in isolation (before MRI backend loads)
+  - Added `spec/spec_ffi_helper.rb` for FFI-specific test configuration
+  - Updated Rakefile with `ffi_specs` and `remaining_specs` tasks
+  - The `:test` task now runs FFI specs first, then remaining specs
+- Emitter-based output
+
+### Changed
+
+- ast-merge v3.1.0, adds Ast::Merge::EmitterBase
+- tree_haver v4.0.4, adds error handling for FFI backend
+- major spec refactor
+
 ## [2.0.0] - 2026-01-06
 
 - TAG: [v2.0.0][2.0.0t]
@@ -85,7 +107,9 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
-[Unreleased]: https://github.com/kettle-rb/bash-merge/compare/v2.0.0...HEAD
+[Unreleased]: https://github.com/kettle-rb/bash-merge/compare/v2.0.1...HEAD
+[2.0.1]: https://github.com/kettle-rb/bash-merge/compare/v2.0.0...v2.0.1
+[2.0.1t]: https://github.com/kettle-rb/bash-merge/releases/tag/v2.0.1
 [2.0.0]: https://github.com/kettle-rb/bash-merge/compare/v1.0.2...v2.0.0
 [2.0.0t]: https://github.com/kettle-rb/bash-merge/releases/tag/v2.0.0
 [1.0.2]: https://github.com/kettle-rb/bash-merge/compare/v1.0.1...v1.0.2

data/README.md

@@ -118,12 +118,36 @@ The `*-merge` gem family provides intelligent, AST-based merging for various fil
 | [rbs-merge][rbs-merge]                   | RBS                  | [tree-sitter-bash][ts-rbs] (via tree_haver), [RBS][rbs] (`rbs` std lib gem)                         | Smart merge for Ruby type signatures                                             |
 | [toml-merge][toml-merge]                 | TOML                 | [Citrus + toml-rb][toml-rb] (default, via tree_haver), [tree-sitter-toml][ts-toml] (via tree_haver) | Smart merge for TOML files                                                       |
 
+#### Backend Platform Compatibility
+
+tree_haver supports multiple parsing backends, but not all backends work on all Ruby platforms:
+
+| Platform 👉️<br> TreeHaver Backend 👇️         | MRI | JRuby | TruffleRuby | Notes                                               |
+|------------------------------------------------|:---:|:-----:|:-----------:|-----------------------------------------------------|
+| **MRI** ([ruby_tree_sitter][ruby_tree_sitter]) |  ✅  |   ❌   |      ❌      | C extension, MRI only                               |
+| **Rust** ([tree_stump][tree_stump])            |  ✅  |   ❌   |      ❌      | Rust extension via magnus/rb-sys, MRI only          |
+| **FFI**                                        |  ✅  |   ✅   |      ❌      | TruffleRuby's FFI doesn't support `STRUCT_BY_VALUE` |
+| **Java** ([jtreesitter][jtreesitter])          |  ❌  |   ✅   |      ❌      | JRuby only, requires grammar JARs                   |
+| **Prism**                                      |  ✅  |   ✅   |      ✅      | Ruby parsing, stdlib in Ruby 3.4+                   |
+| **Psych**                                      |  ✅  |   ✅   |      ✅      | YAML parsing, stdlib                                |
+| **Citrus**                                     |  ✅  |   ✅   |      ✅      | Pure Ruby, no native dependencies                   |
+| **Commonmarker**                               |  ✅  |   ❌   |      ❓      | Rust extension for Markdown                         |
+| **Markly**                                     |  ✅  |   ❌   |      ❓      | C extension for Markdown                            |
+
+**Legend**: ✅ = Works, ❌ = Does not work, ❓ = Untested
+
+**Why some backends don't work on certain platforms**:
+
+- **JRuby**: Runs on the JVM; cannot load native C/Rust extensions (`.so` files)
+- **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`)
+- **FFI on TruffleRuby**: TruffleRuby's FFI implementation doesn't support returning structs by value, which tree-sitter's C API requires
+
 **Example implementations** for the gem templating use case:
 
-| Gem | Purpose | Description |
-| --- | --- | --- |
-| [kettle-dev](https://github.com/kettle-rb/kettle-dev) | Gem Development | Gem templating tool using `*-merge` gems |
-| [kettle-jem](https://github.com/kettle-rb/kettle-jem) | Gem Templating | Gem template library with smart merge support |
+| Gem                      | Purpose         | Description                                   |
+|--------------------------|-----------------|-----------------------------------------------|
+| [kettle-dev][kettle-dev] | Gem Development | Gem templating tool using `*-merge` gems      |
+| [kettle-jem][kettle-jem] | Gem Templating  | Gem template library with smart merge support |
 
 [tree_haver]: https://github.com/kettle-rb/tree_haver
 [ast-merge]: https://github.com/kettle-rb/ast-merge
@@ -143,16 +167,18 @@ The `*-merge` gem family provides intelligent, AST-based merging for various fil
 [prism]: https://github.com/ruby/prism
 [psych]: https://github.com/ruby/psych
 [ts-json]: https://github.com/tree-sitter/tree-sitter-json
+[ts-jsonc]: https://gitlab.com/WhyNotHugo/tree-sitter-jsonc
 [ts-bash]: https://github.com/tree-sitter/tree-sitter-bash
+[ts-rbs]: https://github.com/joker1007/tree-sitter-rbs
 [ts-toml]: https://github.com/tree-sitter-grammars/tree-sitter-toml
+[dotenv]: https://github.com/bkeepers/dotenv
 [rbs]: https://github.com/ruby/rbs
 [toml-rb]: https://github.com/emancu/toml-rb
 [markly]: https://github.com/ioquatix/markly
 [commonmarker]: https://github.com/gjtorikian/commonmarker
-
-
-[ts-jsonc]: https://gitlab.com/WhyNotHugo/tree-sitter-jsonc
-[dotenv]: https://github.com/bkeepers/dotenv
+[ruby_tree_sitter]: https://github.com/Faveod/ruby-tree-sitter
+[tree_stump]: https://github.com/joker1007/tree_stump
+[jtreesitter]: https://central.sonatype.com/artifact/io.github.tree-sitter/jtreesitter
 
 ## 💡 Info you can shake a stick at
 
@@ -877,7 +903,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.109-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.519-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/lib/bash/merge/conflict_resolver.rb

@@ -9,9 +9,6 @@ module Bash
     #   resolver = ConflictResolver.new(template_analysis, dest_analysis)
     #   resolver.resolve(result)
     class ConflictResolver < ::Ast::Merge::ConflictResolverBase
-      # Alias for backward compatibility with existing API
-      alias_method :preference, :preference
-
       # Creates a new ConflictResolver
       #
       # @param template_analysis [FileAnalysis] Analyzed template file
@@ -33,6 +30,7 @@ module Bash
           match_refiner: match_refiner,
           **options
         )
+        @emitter = Emitter.new
       end
 
       # Resolve conflicts and populate the result
@@ -43,6 +41,9 @@ module Bash
           template_nodes = @template_analysis.nodes
           dest_nodes = @dest_analysis.nodes
 
+          # Clear emitter for fresh merge
+          @emitter.clear
+
           # Build signature maps
           template_by_sig = build_signature_map(template_nodes, @template_analysis)
           dest_by_sig = build_signature_map(dest_nodes, @dest_analysis)
@@ -51,17 +52,24 @@ module Bash
           processed_template_sigs = ::Set.new
           processed_dest_sigs = ::Set.new
 
-          # Process nodes in order, preferring destination order when nodes match
-          merge_nodes(
+          # Process nodes via emitter
+          merge_nodes_to_emitter(
             template_nodes,
             dest_nodes,
             template_by_sig,
             dest_by_sig,
             processed_template_sigs,
             processed_dest_sigs,
-            result,
           )
 
+          # Transfer emitter output to result
+          emitted_content = @emitter.to_s
+          unless emitted_content.empty?
+            emitted_content.lines.each do |line|
+              result.add_line(line.chomp, decision: MergeResult::DECISION_MERGED, source: :merged)
+            end
+          end
+
           DebugLogger.debug("Conflict resolution complete", {
             template_nodes: template_nodes.size,
             dest_nodes: dest_nodes.size,
@@ -72,18 +80,14 @@ module Bash
 
       private
 
-      def merge_nodes(template_nodes, dest_nodes, template_by_sig, dest_by_sig, processed_template_sigs, processed_dest_sigs, result)
-        # Determine the output order based on preference
-        # We'll iterate through destination nodes first (to preserve dest order for matches)
-        # then add any template-only nodes if configured
-
+      def merge_nodes_to_emitter(template_nodes, dest_nodes, template_by_sig, dest_by_sig, processed_template_sigs, processed_dest_sigs)
         # First pass: Process destination nodes and find matches
         dest_nodes.each do |dest_node|
           dest_sig = @dest_analysis.generate_signature(dest_node)
 
           # Freeze blocks from destination are always preserved
           if freeze_node?(dest_node)
-            add_node_to_result(dest_node, result, :destination, DECISION_FREEZE_BLOCK)
+            emit_freeze_block(dest_node)
             processed_dest_sigs << dest_sig if dest_sig
             next
           end
@@ -93,18 +97,18 @@ module Bash
             template_info = template_by_sig[dest_sig].first
             template_node = template_info[:node]
 
-            # Decide which to keep based on preference
+            # Decide which to emit based on preference
             if @preference == :destination
-              add_node_to_result(dest_node, result, :destination, DECISION_KEPT_DEST)
+              emit_node(dest_node, @dest_analysis)
             else
-              add_node_to_result(template_node, result, :template, DECISION_KEPT_TEMPLATE)
+              emit_node(template_node, @template_analysis)
             end
 
             processed_dest_sigs << dest_sig
             processed_template_sigs << dest_sig
           else
             # Destination-only node - always keep
-            add_node_to_result(dest_node, result, :destination, DECISION_KEPT_DEST)
+            emit_node(dest_node, @dest_analysis)
             processed_dest_sigs << dest_sig if dest_sig
           end
         end
@@ -118,43 +122,44 @@ module Bash
           # Skip if already processed (matched with dest)
           next if template_sig && processed_template_sigs.include?(template_sig)
 
-          # Skip freeze blocks from template (they shouldn't exist, but just in case)
+          # Skip freeze blocks from template
           next if freeze_node?(template_node)
 
           # Add template-only node
-          add_node_to_result(template_node, result, :template, DECISION_ADDED)
+          emit_node(template_node, @template_analysis)
           processed_template_sigs << template_sig if template_sig
         end
       end
 
-      def add_node_to_result(node, result, source, decision)
-        if freeze_node?(node)
-          result.add_freeze_block(node)
-        elsif node.is_a?(NodeWrapper)
-          add_wrapper_to_result(node, result, source, decision)
-        else
-          DebugLogger.debug("Unknown node type", {node_type: node.class.name})
+      # Emit a single node to the emitter
+      # @param node [NodeWrapper] Node to emit
+      # @param analysis [FileAnalysis] Analysis for accessing source
+      def emit_node(node, analysis)
+        return if freeze_node?(node)
+
+        # Emit leading comments
+        if node.start_line
+          leading = analysis.comment_tracker.leading_comments_before(node.start_line)
+          leading.each do |comment|
+            @emitter.emit_tracked_comment(comment)
+          end
         end
-      end
-
-      def add_wrapper_to_result(wrapper, result, source, decision)
-        return unless wrapper.start_line && wrapper.end_line
 
-        analysis = (source == :template) ? @template_analysis : @dest_analysis
-
-        # Include leading comments
-        leading = analysis.comment_tracker.leading_comments_before(wrapper.start_line)
-        leading.each do |comment|
-          result.add_line(comment[:raw], decision: decision, source: source, original_line: comment[:line])
+        # Emit the node content
+        if node.start_line && node.end_line
+          lines = []
+          (node.start_line..node.end_line).each do |line_num|
+            line = analysis.line_at(line_num)
+            lines << line if line
+          end
+          @emitter.emit_raw_lines(lines)
         end
+      end
 
-        # Add the node content
-        (wrapper.start_line..wrapper.end_line).each do |line_num|
-          line = analysis.line_at(line_num)
-          next unless line
-
-          result.add_line(line.chomp, decision: decision, source: source, original_line: line_num)
-        end
+      # Emit a freeze block
+      # @param freeze_node [FreezeNode] Freeze block to emit
+      def emit_freeze_block(freeze_node)
+        @emitter.emit_raw_lines(freeze_node.lines)
       end
     end
   end

data/lib/bash/merge/emitter.rb

@@ -6,27 +6,28 @@ module Bash
     # This class provides utilities for emitting Bash while maintaining
     # the original structure, comments, and style choices.
     #
+    # Inherits common emitter functionality from Ast::Merge::EmitterBase.
+    #
     # @example Basic usage
     #   emitter = Emitter.new
     #   emitter.emit_comment("This is a comment")
     #   emitter.emit_line("echo 'hello'")
-    class Emitter
-      # @return [Array<String>] Output lines
-      attr_reader :lines
-
-      # @return [Integer] Current indentation level
-      attr_reader :indent_level
+    class Emitter < Ast::Merge::EmitterBase
+      # Initialize subclass-specific state
+      def initialize_subclass_state(**options)
+        # Bash doesn't need separator tracking like JSON
+      end
 
-      # @return [Integer] Spaces per indent level
-      attr_reader :indent_size
+      # Clear subclass-specific state
+      def clear_subclass_state
+        # Nothing to clear for Bash
+      end
 
-      # Initialize a new emitter
-      #
-      # @param indent_size [Integer] Number of spaces per indent level
-      def initialize(indent_size: 2)
-        @lines = []
-        @indent_level = 0
-        @indent_size = indent_size
+      # Emit a tracked comment from CommentTracker
+      # @param comment [Hash] Comment with :text, :indent
+      def emit_tracked_comment(comment)
+        indent = " " * (comment[:indent] || 0)
+        @lines << "#{indent}# #{comment[:text]}"
       end
 
       # Emit a comment line
@@ -44,22 +45,6 @@ module Bash
         end
       end
 
-      # Emit leading comments
-      #
-      # @param comments [Array<Hash>] Comment hashes from CommentTracker
-      def emit_leading_comments(comments)
-        comments.each do |comment|
-          # Preserve original indentation from comment
-          indent = " " * (comment[:indent] || 0)
-          @lines << "#{indent}# #{comment[:text]}"
-        end
-      end
-
-      # Emit a blank line
-      def emit_blank_line
-        @lines << ""
-      end
-
       # Emit a shebang line
       #
       # @param interpreter [String] Interpreter path (e.g., "/bin/bash")
@@ -85,12 +70,12 @@ module Bash
       # @param name [String] Function name
       def emit_function_start(name)
         @lines << "#{current_indent}#{name}() {"
-        @indent_level += 1
+        indent
       end
 
       # Emit a function definition end
       def emit_function_end
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent}}"
       end
 
@@ -99,28 +84,28 @@ module Bash
       # @param condition [String] Condition expression
       def emit_if_start(condition)
         @lines << "#{current_indent}if #{condition}; then"
-        @indent_level += 1
+        indent
       end
 
       # Emit an elif clause
       #
       # @param condition [String] Condition expression
       def emit_elif(condition)
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent}elif #{condition}; then"
-        @indent_level += 1
+        indent
       end
 
       # Emit an else clause
       def emit_else
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent}else"
-        @indent_level += 1
+        indent
       end
 
       # Emit an if statement end
       def emit_fi
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent}fi"
       end
 
@@ -130,12 +115,12 @@ module Bash
       # @param items [String] Items to iterate over
       def emit_for_start(var, items)
         @lines << "#{current_indent}for #{var} in #{items}; do"
-        @indent_level += 1
+        indent
       end
 
-      # Emit a for loop end
+      # Emit a for/while loop end
       def emit_done
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent}done"
       end
 
@@ -144,7 +129,7 @@ module Bash
       # @param condition [String] Condition expression
       def emit_while_start(condition)
         @lines << "#{current_indent}while #{condition}; do"
-        @indent_level += 1
+        indent
       end
 
       # Emit a case statement start
@@ -152,7 +137,7 @@ module Bash
       # @param expression [String] Expression to match
       def emit_case_start(expression)
         @lines << "#{current_indent}case #{expression} in"
-        @indent_level += 1
+        indent
       end
 
       # Emit a case pattern
@@ -160,18 +145,18 @@ module Bash
       # @param pattern [String] Pattern to match
       def emit_case_pattern(pattern)
         @lines << "#{current_indent}#{pattern})"
-        @indent_level += 1
+        indent
       end
 
       # Emit a case pattern terminator
       def emit_case_pattern_end
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent};;"
       end
 
       # Emit a case statement end
       def emit_esac
-        @indent_level -= 1 if @indent_level > 0
+        dedent
         @lines << "#{current_indent}esac"
       end
 
@@ -182,36 +167,11 @@ module Bash
         @lines << "#{current_indent}#{line}"
       end
 
-      # Emit raw lines (for preserving existing content)
-      #
-      # @param raw_lines [Array<String>] Lines to emit as-is
-      def emit_raw_lines(raw_lines)
-        raw_lines.each { |line| @lines << line.chomp }
-      end
-
-      # Get the output as a single string
+      # Get the output as a Bash string
       #
       # @return [String]
       def to_bash
-        content = @lines.join("\n")
-        content += "\n" unless content.empty? || content.end_with?("\n")
-        content
-      end
-
-      # Alias for consistency with other merge gems
-      # @return [String]
-      alias_method :to_s, :to_bash
-
-      # Clear the output
-      def clear
-        @lines = []
-        @indent_level = 0
-      end
-
-      private
-
-      def current_indent
-        " " * (@indent_level * @indent_size)
+        to_s
       end
     end
   end

data/lib/bash/merge/version.rb

@@ -5,7 +5,7 @@ module Bash
     # Version information for Bash::Merge
     module Version
       # Current version of the bash-merge gem
-      VERSION = "2.0.0"
+      VERSION = "2.0.1"
     end
     VERSION = Version::VERSION # traditional location
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bash-merge
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Peter H. Boling
@@ -43,40 +43,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '4.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.3
+        version: 4.0.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '4.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.3
+        version: 4.0.4
 - !ruby/object:Gem::Dependency
   name: ast-merge
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 3.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
   name: version_gem
   requirement: !ruby/object:Gem::Requirement
@@ -315,10 +315,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://bash-merge.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/bash-merge/tree/v2.0.0
-  changelog_uri: https://github.com/kettle-rb/bash-merge/blob/v2.0.0/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/bash-merge/tree/v2.0.1
+  changelog_uri: https://github.com/kettle-rb/bash-merge/blob/v2.0.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/bash-merge/issues
-  documentation_uri: https://www.rubydoc.info/gems/bash-merge/2.0.0
+  documentation_uri: https://www.rubydoc.info/gems/bash-merge/2.0.1
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/bash-merge/wiki
   news_uri: https://www.railsbling.com/tags/bash-merge