bulk_replace 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e2f0997f62fecec1406af2ddd15395323a2143fba04fcf97bc0f3ab84aabfd9b
+  data.tar.gz: a6328fb89e5b00f6ff2c087276bb2310ce230972b686ce75c219c4ea0ee03efc
+SHA512:
+  metadata.gz: 4d7cb74b2fc12a22ce385fed884cdd4e5b060e194ae0337a90a0ff84ef4c81927f51359c1b7b14e1570069e82c240762af01f42bc3e728514cdf0e80998122c1
+  data.tar.gz: 807037ff0e93fca6e4175a9b3bdb1f6194843bc671d1af02b85c0380e8729e8c6ead018dab060e289f545ecabf6604478e6292575fdcb96c717418af1a6cb664

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MikhaiL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,127 @@
+# bulk-replace
+
+A simple CLI tool that bulk-replaces text strings across every file in a directory, writing the results to a new output directory — original files untouched.
+
+Built for the case where you have tens or hundreds of config files that share the same placeholder text and need the real value injected all at once. Works with any plain-text files: WireGuard configs, `.env` templates, INI files, YAML, TOML, and more.
+
+## Features
+
+- **Two modes** — quick inline replacement or a YAML config for multiple substitutions
+- **Recursive** — processes files in nested subdirectories, preserving the original tree structure
+- **Non-destructive** — always writes to a separate output directory; source files are never modified
+- **Zero dependencies** — pure Ruby, nothing outside the standard library at runtime
+
+## Installation
+
+```bash
+gem install bulk_replace
+```
+
+Or add it to your `Gemfile`:
+
+```ruby
+gem "bulk_replace"
+```
+
+## Usage
+
+### Inline mode — one replacement
+
+Pass the old and new strings directly on the command line.
+
+```bash
+bulk-replace \
+  --from "DNS = 8.8.8.8" \
+  --to   "DNS = 1.1.1.1" \
+  --input  ./configs \
+  --output ./configs-new
+```
+
+### Config file mode — multiple replacements
+
+Describe all substitutions in a YAML file and pass it with `--config`.
+
+```bash
+bulk-replace \
+  --config replacements.yml \
+  --input  ./configs \
+  --output ./configs-new
+```
+
+**`replacements.yml`**
+
+```yaml
+replacements:
+  - from: "PrivateKey = PLACEHOLDER"
+    to: "PrivateKey = wOEI9rqqbDwnN8/Bpp/ZkEMEKlMDxVMB8PJHA0XXXXXXX="
+
+  - from: "DNS = 8.8.8.8"
+    to: "DNS = 1.1.1.1"
+
+  - from: "Endpoint = 203.0.113.1:51820"
+    to: "Endpoint = 203.0.113.99:51820"
+```
+
+A fully annotated template is provided in [`replacements.example.yml`](replacements.example.yml).
+
+### All options
+
+| Flag | Description |
+|------|-------------|
+| `--from TEXT` | Text to find (literal, case-sensitive) |
+| `--to TEXT` | Replacement text |
+| `--config PATH` | Path to a YAML config file |
+| `--input DIR` | Directory containing the source files |
+| `--output DIR` | Directory to write the updated files into |
+
+`--config` and `--from`/`--to` are mutually exclusive — use one or the other.
+
+## Example: WireGuard key injection
+
+You generated 50 WireGuard peer configs with a placeholder private key. Now you want to inject the real keys.
+
+```
+configs/
+  peer01.conf
+  peer02.conf
+  ...
+  peer50.conf
+```
+
+Each file contains:
+
+```ini
+[Interface]
+PrivateKey = PLACEHOLDER
+Address    = 10.8.0.1/24
+DNS        = 8.8.8.8
+```
+
+Run:
+
+```bash
+bulk-replace \
+  --from "PrivateKey = PLACEHOLDER" \
+  --to   "PrivateKey = <your_actual_key>" \
+  --input  ./configs \
+  --output ./configs-ready
+```
+
+Result in `configs-ready/` — all files updated, originals intact.
+
+## Development
+
+```bash
+git clone https://github.com/mik2win/bulk-replace
+cd bulk-replace
+bundle install
+bundle exec rspec
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome at [github.com/mik2win/bulk-replace](https://github.com/mik2win/bulk-replace).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/exe/bulk-replace

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/bulk_replace'
+
+begin
+  BulkReplace::CLI.new(ARGV).run
+rescue StandardError => e
+  warn e.message
+  exit 1
+end

data/lib/bulk_replace/cli.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require_relative 'replacement_set'
+require_relative 'runner'
+
+module BulkReplace
+  class CLI
+    def initialize(argv)
+      @argv    = argv
+      @options = {}
+    end
+
+    def run
+      parser.parse!(@argv)
+      validate!
+      Runner.new(
+        input_dir: @options[:input],
+        output_dir: @options[:output],
+        replacements: replacements
+      ).run
+    end
+
+    private
+
+    def parser
+      OptionParser.new do |o|
+        o.on('--from FROM', 'String to replace')   { |v| @options[:from]   = v }
+        o.on('--to TO',     'Replacement string')  { |v| @options[:to]     = v }
+        o.on('--config PATH', 'YAML config file')  { |v| @options[:config] = v }
+        o.on('--input DIR',  'Input directory')    { |v| @options[:input]  = v }
+        o.on('--output DIR', 'Output directory')   { |v| @options[:output] = v }
+      end
+    end
+
+    def validate!
+      raise ArgumentError, '--input is required'  unless @options[:input]
+      raise ArgumentError, '--output is required' unless @options[:output]
+      raise ArgumentError, 'provide --config or both --from and --to' unless valid_mode?
+    end
+
+    def valid_mode?
+      @options[:config] || (@options[:from] && @options[:to])
+    end
+
+    def replacements
+      if @options[:config]
+        ReplacementSet.from_config(@options[:config])
+      else
+        ReplacementSet.from_inline(from: @options[:from], to: @options[:to])
+      end
+    end
+  end
+end

data/lib/bulk_replace/directory_walker.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'pathname'
+
+module BulkReplace
+  class DirectoryWalker
+    def initialize(input_dir)
+      @root = Pathname.new(input_dir)
+    end
+
+    def each_file(&block)
+      @root.glob('**/*').select(&:file?).each do |path|
+        block.call(path.relative_path_from(@root), path)
+      end
+    end
+  end
+end

data/lib/bulk_replace/file_processor.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module BulkReplace
+  class FileProcessor
+    def initialize(replacements)
+      @replacements = replacements
+    end
+
+    def process(content)
+      @replacements.reduce(content) { |text, r| text.gsub(r.from, r.to) }
+    end
+  end
+end

data/lib/bulk_replace/replacement.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module BulkReplace
+  Replacement = Data.define(:from, :to)
+end

data/lib/bulk_replace/replacement_set.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require_relative 'replacement'
+
+module BulkReplace
+  class ReplacementSet
+    def self.from_config(path)
+      raw = YAML.safe_load(File.read(path), symbolize_names: true)
+      unless raw.is_a?(Hash) && raw[:replacements].is_a?(Array)
+        raise ArgumentError,
+              "Config must contain a 'replacements' key"
+      end
+
+      raw[:replacements].map { |r| Replacement.new(**r) }
+    end
+
+    def self.from_inline(from:, to:)
+      [Replacement.new(from: from, to: to)]
+    end
+  end
+end

data/lib/bulk_replace/runner.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'pathname'
+require_relative 'directory_walker'
+require_relative 'file_processor'
+
+module BulkReplace
+  class Runner
+    def initialize(input_dir:, output_dir:, replacements:)
+      @walker    = DirectoryWalker.new(input_dir)
+      @processor = FileProcessor.new(replacements)
+      @output    = Pathname.new(output_dir)
+    end
+
+    def run
+      @walker.each_file { |rel, abs| write(rel, @processor.process(abs.read)) }
+    end
+
+    private
+
+    def write(relative_path, content)
+      dest = @output.join(relative_path)
+      dest.dirname.mkpath
+      dest.write(content)
+    end
+  end
+end

data/lib/bulk_replace/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module BulkReplace
+  VERSION = '0.1.0'
+end

data/lib/bulk_replace.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative 'bulk_replace/version'
+require_relative 'bulk_replace/replacement'
+require_relative 'bulk_replace/replacement_set'
+require_relative 'bulk_replace/file_processor'
+require_relative 'bulk_replace/directory_walker'
+require_relative 'bulk_replace/runner'
+require_relative 'bulk_replace/cli'
+
+module BulkReplace; end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: bulk_replace
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- mik2win
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+executables:
+- bulk-replace
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/bulk-replace
+- lib/bulk_replace.rb
+- lib/bulk_replace/cli.rb
+- lib/bulk_replace/directory_walker.rb
+- lib/bulk_replace/file_processor.rb
+- lib/bulk_replace/replacement.rb
+- lib/bulk_replace/replacement_set.rb
+- lib/bulk_replace/runner.rb
+- lib/bulk_replace/version.rb
+homepage: https://github.com/mik2win/bulk-replace
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+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: 3.6.9
+specification_version: 4
+summary: Bulk-replace text strings across files in a directory
+test_files: []