bash-merge 1.0.0

data/sig/bash/merge.rbs

@@ -0,0 +1,260 @@
+# Type signatures for bash-merge gem
+# Smart merge for Bash scripts using tree-sitter AST analysis
+
+module Bash
+  module Merge
+    VERSION: String
+
+    # Base error class for bash-merge errors
+    class Error < StandardError
+    end
+
+    # Error raised when template Bash file has syntax errors
+    class TemplateParseError < Error
+      attr_reader errors: Array[untyped]
+      attr_reader content: String?
+
+      def initialize: (?String? message, ?errors: Array[untyped], ?content: String?) -> void
+    end
+
+    # Error raised when destination Bash file has syntax errors
+    class DestinationParseError < Error
+      attr_reader errors: Array[untyped]
+      attr_reader content: String?
+
+      def initialize: (?String? message, ?errors: Array[untyped], ?content: String?) -> void
+    end
+
+    # Debug logging utility for Bash::Merge
+    module DebugLogger
+      extend Ast::Merge::DebugLogger
+
+      def self.env_var_name: () -> String
+      def self.env_var_name=: (String name) -> String
+      def self.log_prefix: () -> String
+      def self.log_prefix=: (String prefix) -> String
+      def self.enabled?: () -> bool
+      def self.debug: (String message, ?Hash[Symbol, untyped] context) -> void
+      def self.info: (String message) -> void
+      def self.warning: (String message) -> void
+      def self.time: [T] (String operation) { () -> T } -> T
+      def self.extract_node_info: (untyped node) -> Hash[Symbol, untyped]
+    end
+
+    # Freeze block node for Bash scripts
+    class FreezeNode < Ast::Merge::FreezeNode
+      InvalidStructureError: singleton(Ast::Merge::FreezeNode::InvalidStructureError)
+      Location: singleton(Ast::Merge::FreezeNode::Location)
+
+      attr_reader lines: Array[String]
+
+      def initialize: (
+        start_line: Integer,
+        end_line: Integer,
+        lines: Array[String],
+        ?start_marker: String?,
+        ?end_marker: String?,
+        ?pattern_type: Symbol
+      ) -> void
+
+      def signature: () -> Array[Symbol | String]
+      def function_definition?: () -> bool
+      def variable_assignment?: () -> bool
+      def command?: () -> bool
+      def slice: () -> String?
+      def inspect: () -> String
+
+      private
+
+      def validate_structure!: () -> void
+    end
+
+    # Wrapper for tree-sitter Bash nodes
+    class NodeWrapper
+      attr_reader node: untyped
+      attr_reader start_line: Integer
+      attr_reader end_line: Integer
+      attr_reader source: String
+      attr_reader analysis: FileAnalysis?
+
+      def initialize: (
+        untyped node,
+        String source,
+        ?analysis: FileAnalysis?
+      ) -> void
+
+      def location: () -> Ast::Merge::FreezeNode::Location
+      def signature: () -> Array[untyped]
+      def freeze_node?: () -> bool
+      def function_definition?: () -> bool
+      def variable_assignment?: () -> bool
+      def command?: () -> bool
+      def comment?: () -> bool
+      def name: () -> String?
+      def value: () -> String?
+      def slice: () -> String?
+      def text: () -> String
+      def type: () -> Symbol
+      def inspect: () -> String
+    end
+
+    # Comment tracker for Bash files
+    class CommentTracker
+      attr_reader comments: Array[Hash[Symbol, untyped]]
+      attr_reader source: String
+      attr_reader lines: Array[String]
+
+      def initialize: (String source) -> void
+
+      def extract_comments: () -> Array[Hash[Symbol, untyped]]
+      def comments_for_line: (Integer line) -> Array[Hash[Symbol, untyped]]
+      def leading_comments_for: (Integer line) -> Array[Hash[Symbol, untyped]]
+      def trailing_comment_for: (Integer line) -> Hash[Symbol, untyped]?
+      def shebang?: (String line) -> bool
+    end
+
+    # File analysis for Bash scripts
+    class FileAnalysis
+      include Ast::Merge::FileAnalysisBase
+
+      DEFAULT_FREEZE_TOKEN: String
+      PARSER_SEARCH_PATHS: Array[String]
+
+      attr_reader source: String
+      attr_reader lines: Array[String]
+      attr_reader ast: untyped
+      attr_reader statements: Array[NodeWrapper | FreezeNode]
+      attr_reader freeze_blocks: Array[FreezeNode]
+      attr_reader freeze_token: String
+      attr_reader signature_generator: (^(untyped) -> Array[untyped]?)?
+      attr_reader comment_tracker: CommentTracker
+      attr_reader errors: Array[untyped]
+
+      def self.find_parser_path: () -> String?
+
+      def initialize: (
+        String source,
+        ?freeze_token: String,
+        ?signature_generator: (^(untyped) -> Array[untyped]?)?,
+        ?parser_path: String?
+      ) -> void
+
+      def valid?: () -> bool
+      def nodes: () -> Array[NodeWrapper | FreezeNode]
+      def line_at: (Integer line_num) -> String?
+      def normalized_line: (Integer line_num) -> String?
+      def in_freeze_block?: (Integer line_num) -> bool
+      def freeze_block_at: (Integer line_num) -> FreezeNode?
+      def signature_at: (Integer index) -> Array[untyped]?
+      def generate_signature: (untyped node) -> Array[untyped]?
+      def compute_node_signature: (untyped node) -> Array[untyped]?
+
+      private
+
+      def parse_bash: () -> void
+      def extract_nodes: (untyped tree_node) -> Array[NodeWrapper]
+      def extract_freeze_blocks: () -> Array[FreezeNode]
+      def integrate_nodes_and_freeze_blocks: () -> Array[NodeWrapper | FreezeNode]
+    end
+
+    # Result of a Bash merge operation
+    class MergeResult < Ast::Merge::MergeResult
+      DECISION_KEPT_TEMPLATE: Symbol
+      DECISION_KEPT_DEST: Symbol
+      DECISION_MERGED: Symbol
+      DECISION_ADDED: Symbol
+      DECISION_FREEZE_BLOCK: Symbol
+
+      attr_reader lines: Array[Hash[Symbol, untyped]]
+      attr_reader decisions: Array[Hash[Symbol, untyped]]
+      attr_reader statistics: Hash[Symbol, Integer]
+
+      def initialize: (
+        ?template_analysis: FileAnalysis?,
+        ?dest_analysis: FileAnalysis?,
+        ?conflicts: Array[Hash[Symbol, untyped]],
+        ?frozen_blocks: Array[FreezeNode],
+        ?stats: Hash[Symbol, untyped]
+      ) -> void
+
+      def add_line: (
+        String line,
+        decision: Symbol,
+        source: Symbol,
+        ?original_line: Integer?
+      ) -> void
+
+      def add_lines: (
+        Array[String] lines,
+        decision: Symbol,
+        source: Symbol,
+        ?start_line: Integer?
+      ) -> void
+
+      def add_blank_line: (?decision: Symbol, ?source: Symbol) -> void
+      def add_freeze_block: (FreezeNode freeze_node) -> void
+      def to_bash: () -> String
+      def content: () -> Array[Hash[Symbol, untyped]]
+      def content_string: () -> String
+      def empty?: () -> bool
+
+      private
+
+      def track_statistics: (Symbol decision, Symbol source) -> void
+    end
+
+    # Smart merger for Bash scripts
+    class SmartMerger
+      include Ast::Merge::MergerConfig
+
+      attr_reader template_analysis: FileAnalysis
+      attr_reader dest_analysis: FileAnalysis
+      attr_reader signature_match_preference: (Symbol | Hash[Symbol, Symbol])
+      attr_reader add_template_only_nodes: bool
+
+      def initialize: (
+        String template_content,
+        String dest_content,
+        ?signature_match_preference: (Symbol | Hash[Symbol, Symbol]),
+        ?add_template_only_nodes: bool,
+        ?freeze_token: String,
+        ?signature_generator: (^(untyped) -> Array[untyped]?)?,
+        ?node_splitter: Hash[Symbol, untyped]?,
+        ?parser_path: String?
+      ) -> void
+
+      def merge: () -> MergeResult
+
+      private
+
+      def perform_merge: () -> MergeResult
+      def merge_nodes: (MergeResult result) -> void
+    end
+
+    # Conflict resolver for Bash merges
+    class ConflictResolver
+      attr_reader template_analysis: FileAnalysis
+      attr_reader dest_analysis: FileAnalysis
+      attr_reader signature_match_preference: (Symbol | Hash[Symbol, Symbol])
+      attr_reader add_template_only_nodes: bool
+
+      def initialize: (
+        FileAnalysis template_analysis,
+        FileAnalysis dest_analysis,
+        ?signature_match_preference: (Symbol | Hash[Symbol, Symbol]),
+        ?add_template_only_nodes: bool
+      ) -> void
+
+      def resolve: (untyped boundary, MergeResult result) -> void
+    end
+
+    # Emitter for reconstructing Bash output
+    class Emitter
+      attr_reader result: MergeResult
+
+      def initialize: (MergeResult result) -> void
+
+      def emit: () -> String
+    end
+  end
+end

metadata

@@ -0,0 +1,353 @@
+--- !ruby/object:Gem::Specification
+name: bash-merge
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Peter H. Boling
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEgDCCAuigAwIBAgIBATANBgkqhkiG9w0BAQsFADBDMRUwEwYDVQQDDAxwZXRl
+  ci5ib2xpbmcxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+  A2NvbTAeFw0yNTA1MDQxNTMzMDlaFw00NTA0MjkxNTMzMDlaMEMxFTATBgNVBAMM
+  DHBldGVyLmJvbGluZzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+  LGQBGRYDY29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAruUoo0WA
+  uoNuq6puKWYeRYiZekz/nsDeK5x/0IEirzcCEvaHr3Bmz7rjo1I6On3gGKmiZs61
+  LRmQ3oxy77ydmkGTXBjruJB+pQEn7UfLSgQ0xa1/X3kdBZt6RmabFlBxnHkoaGY5
+  mZuZ5+Z7walmv6sFD9ajhzj+oIgwWfnEHkXYTR8I6VLN7MRRKGMPoZ/yvOmxb2DN
+  coEEHWKO9CvgYpW7asIihl/9GMpKiRkcYPm9dGQzZc6uTwom1COfW0+ZOFrDVBuV
+  FMQRPswZcY4Wlq0uEBLPU7hxnCL9nKK6Y9IhdDcz1mY6HZ91WImNslOSI0S8hRpj
+  yGOWxQIhBT3fqCBlRIqFQBudrnD9jSNpSGsFvbEijd5ns7Z9ZMehXkXDycpGAUj1
+  to/5cuTWWw1JqUWrKJYoifnVhtE1o1DZ+LkPtWxHtz5kjDG/zR3MG0Ula0UOavlD
+  qbnbcXPBnwXtTFeZ3C+yrWpE4pGnl3yGkZj9SMTlo9qnTMiPmuWKQDatAgMBAAGj
+  fzB9MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBQE8uWvNbPVNRXZ
+  HlgPbc2PCzC4bjAhBgNVHREEGjAYgRZwZXRlci5ib2xpbmdAZ21haWwuY29tMCEG
+  A1UdEgQaMBiBFnBldGVyLmJvbGluZ0BnbWFpbC5jb20wDQYJKoZIhvcNAQELBQAD
+  ggGBAJbnUwfJQFPkBgH9cL7hoBfRtmWiCvdqdjeTmi04u8zVNCUox0A4gT982DE9
+  wmuN12LpdajxZONqbXuzZvc+nb0StFwmFYZG6iDwaf4BPywm2e/Vmq0YG45vZXGR
+  L8yMDSK1cQXjmA+ZBKOHKWavxP6Vp7lWvjAhz8RFwqF9GuNIdhv9NpnCAWcMZtpm
+  GUPyIWw/Cw/2wZp74QzZj6Npx+LdXoLTF1HMSJXZ7/pkxLCsB8m4EFVdb/IrW/0k
+  kNSfjtAfBHO8nLGuqQZVH9IBD1i9K6aSs7pT6TW8itXUIlkIUI2tg5YzW6OFfPzq
+  QekSkX3lZfY+HTSp/o+YvKkqWLUV7PQ7xh1ZYDtocpaHwgxe/j3bBqHE+CUPH2vA
+  0V/FwdTRWcwsjVoOJTrYcff8pBZ8r2MvtAc54xfnnhGFzeRHfcltobgFxkAXdE6p
+  DVjBtqT23eugOqQ73umLcYDZkc36vnqGxUBSsXrzY9pzV5gGr2I8YUxMqf6ATrZt
+  L9nRqA==
+  -----END CERTIFICATE-----
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tree_haver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.2
+- !ruby/object:Gem::Dependency
+  name: ast-merge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.6
+- !ruby/object:Gem::Dependency
+  name: version_gem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.9
+- !ruby/object:Gem::Dependency
+  name: kettle-dev
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: require_bench
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.4
+- !ruby/object:Gem::Dependency
+  name: appraisal2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: kettle-soup-cover
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+- !ruby/object:Gem::Dependency
+  name: kettle-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.7
+- !ruby/object:Gem::Dependency
+  name: ruby-progressbar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: stone_checksums
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: gitmoji-regex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+description: "☯️ Bash::Merge provides smart Bash script merging that preserves comments,
+  understands shell structure, and supports freeze blocks for protecting destination
+  content. Perfect for merging configuration scripts and shell templates with customized
+  destination files."
+email:
+- floss@galtzo.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- CITATION.cff
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- FUNDING.md
+- LICENSE.txt
+- README.md
+- REEK
+- RUBOCOP.md
+- SECURITY.md
+files:
+- CHANGELOG.md
+- CITATION.cff
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- FUNDING.md
+- LICENSE.txt
+- README.md
+- REEK
+- RUBOCOP.md
+- SECURITY.md
+- lib/bash-merge.rb
+- lib/bash/merge.rb
+- lib/bash/merge/comment_tracker.rb
+- lib/bash/merge/conflict_resolver.rb
+- lib/bash/merge/debug_logger.rb
+- lib/bash/merge/emitter.rb
+- lib/bash/merge/file_analysis.rb
+- lib/bash/merge/freeze_node.rb
+- lib/bash/merge/merge_result.rb
+- lib/bash/merge/node_wrapper.rb
+- lib/bash/merge/smart_merger.rb
+- lib/bash/merge/version.rb
+- sig/bash/merge.rbs
+homepage: https://github.com/kettle-rb/bash-merge
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://bash-merge.galtzo.com/
+  source_code_uri: https://github.com/kettle-rb/bash-merge/tree/v1.0.0
+  changelog_uri: https://github.com/kettle-rb/bash-merge/blob/v1.0.0/CHANGELOG.md
+  bug_tracker_uri: https://github.com/kettle-rb/bash-merge/issues
+  documentation_uri: https://www.rubydoc.info/gems/bash-merge/1.0.0
+  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
+  discord_uri: https://discord.gg/3qme4XHNKN
+  rubygems_mfa_required: 'true'
+rdoc_options:
+- "--title"
+- bash-merge - ☯️ Intelligent Bash script merging using tree-sitter AST analysis
+- "--main"
+- README.md
+- "--exclude"
+- "^sig/"
+- "--line-numbers"
+- "--inline-source"
+- "--quiet"
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: "☯️ Intelligent Bash script merging using tree-sitter AST analysis"
+test_files: []

metadata.gz.sig

@@ -0,0 +1,3 @@
+&XC�=�U-qtU����*X]��5w<��Є�Lp�0_����XD���@k>���(iD/��o���:z���4**LD������;}i��G�ޯ���Sj�)�����|���"�eDE�O,͘ �\��G��X�����H�?p$���m�O�t�������ʒ1�;���~BVz+�7����\Vo��g��*��t�w�0�*
�j`mf̾�-_q��?���C��6�}�ʔ_��d4�F
+ ��ݔxM�{��
+�+��IZѸ��8E�}��خ�9�E��f�mMZ�z�[1w��0�a6vu��&��KI!@W�ʦ