backspin 0.14.0 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2fd83cd35c05021e0df8e585060247f0bee2fd1034d43861bf462bbb1d67101
-  data.tar.gz: 1ee344e3596a9442d17dbbaab2aaa541d676fb2f734d13b28ad34d49948b684b
+  metadata.gz: 075a4844c3bb93c3123497426d6f95e2cbc28b82b608f7bf5e6ff4968b4a5ff2
+  data.tar.gz: 60cfc30a385d234e330339d5cd70873b277af40a1c305b0781713f804b559190
 SHA512:
-  metadata.gz: 9be21d06b0087032243e2df85bfffa060fa9a8f411ce4733a125fffbdbe40ac58d2637d1f18f9b70831730917ef9aa0baff38f6021439d37c444984f7acee886
-  data.tar.gz: 2720731b166213d551c0dd58e7478e23d20637b1d4157945fcac090298ff5059fdce1c86e3e98e20087fc5bd27de52a522b35e1a124158c914c23ede4fa53dfe
+  metadata.gz: 294564bdac99b664bf8a1ed078f67736db43ab389b314d7b9c482884826d5ef6021a359d1c4d3d31a137dd0b3df44616f61dddf5cdb47478fe79c128583e36e0
+  data.tar.gz: eaa2e5d9d5c121fe6672cf5c49eee8644c6462cf86fe49fbabca69d0bbb29ae5bac368b9fa0ae20f56f2437f0fc01e13c3b7e13662b1fdfb41530e5df3bbf546

data/.circleci/config.yml

@@ -50,5 +50,5 @@ workflows:
       - test:
           matrix:
             parameters:
-              ruby-version: ["3.2", "3.3", "3.4", "4.0"]
+              ruby-version: ["3.3", "3.4", "4.0"]
       - lint

data/.github/workflows/release.yml

@@ -21,4 +21,4 @@ jobs:
     uses: rsanheim/.github/.github/workflows/gem-release.yml@4ced52859dd60019b930a3f2023424e77b37ee2a
     with:
       gem: backspin
-      ruby-version: "4.0.0"
+      ruby-version: "4.0.7"

data/.gitignore

@@ -7,7 +7,6 @@
 /tmp/
 /.claude
 /.cursor
-/checksums/
 
 /backspin*.gem
 # rspec failure tracking

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.15.1
+* Drop ruby 3.2 support; housekeeping and dependency clean up; 
+## 0.15.0
+* Added `stdin:` to `Backspin.run` and `Backspin.compare` to pipe a String into the command, replacing `sh -c` wrappers. For `compare`, give a side as `{command:, stdin:}`. Stdin is saved on every snapshot like stdout and stderr (empty when not given), so re-recorded files gain a `stdin` line, but it is not compared.
+* Changed `Backspin.compare` to skip credential scrubbing, so filters, matchers, and diffs see raw output and scrubbing can no longer hide mismatches (generic patterns could turn different paths into identical star runs). `run` and `capture` still scrub.
+* Added `env:` to `Backspin.compare` side Hashes (`{command:, env:, stdin:}`), so each command can get its own environment. A side's env replaces the top-level `env:` for that side, and each snapshot records the env it ran with.
+
 ## 0.14.0
 * Improved verification errors with per-field summaries for stdout, stderr, and exit status, plus three lines of context around output changes. Long diffs are limited to 50 lines; set `BACKSPIN_FULL_DIFF=1` to show the full diff.
 * Preserved custom matcher failure reasons and made missing final newlines visible in output diffs.

data/CLAUDE.md

@@ -27,7 +27,8 @@ bin/rake install     # Install gem locally for testing
 bin/rake build       # Build the gem locally
 ```
 
-Releases use a pull request that updates `lib/backspin/version.rb` and adds a matching nonempty section to `CHANGELOG.md`. Use normal premerge CI to establish readiness. After merge to `main`, the shared GitHub Actions workflow rechecks the version and changelog, invokes `rubygems/release-gem@v1` and Bundler for tagging and gem publication, then creates the GitHub release from the changelog notes. Invalid release notes prevent publication. See `CONTRIBUTING.md` for trusted publisher setup.
+Use the [shared release guide](https://github.com/rsanheim/.github#readme) and
+[Backspin quick reference](CONTRIBUTING.md#release-maintainer-setup) for releases.
 
 ### Code Quality
 ```bash

data/CONTRIBUTING.md

@@ -1,199 +1,22 @@
-# Contributing to Backspin
+# Contributing
 
-Thank you for your interest in contributing to Backspin! This guide will help you get started with development and walk you through the contribution process.
-
-Note that Backspin is in early development and the API _will_ change before stabilizing at 1.0.
-
-## Table of Contents
-
-- [Getting Started](#getting-started)
-- [Development Setup](#development-setup)
-- [Making Changes](#making-changes)
-- [Testing](#testing)
-- [Submitting Changes](#submitting-changes)
-- [Release Maintainer Setup](#release-maintainer-setup)
-- [Code Style](#code-style)
-- [Reporting Issues](#reporting-issues)
-- [Feature Requests](#feature-requests)
-
-## Getting Started
-
-Backspin is a Ruby gem for characterization testing of command-line interfaces. It records and verifies CLI interactions by capturing stdout, stderr, and exit status from shell commands, similar to how VCR works for HTTP interactions.
-
-### Prerequisites
-
-- Ruby 3.2, 3.3, 3.4, or 4.0
-- Bundler
-- Git
+Ideas welcome. PRs cool. Just ensure your 
+Backspin is in early development and the API _will_ change before stabilizing at 1.0.
 
 ## Development Setup
 
-1. Fork and clone the repository:
-   ```bash
-   git clone https://github.com/rsanheim/backspin.git
-   cd backspin
-   ```
-
-2. Run the setup script:
-   ```bash
-   bin/setup
-   ```
-
-3. Run the full build (specs & standardrb linting) to ensure everything is working:
-   ```bash
-   bin/rake spec
-   ```
-
-## Making Changes
-
-### Development Workflow
-
-1. Create a feature branch:
-   ```bash
-   git checkout -b feature/your-feature-name
-   ```
-
-2. Make your changes following the project conventions
-
-3. Run tests frequently:
-   ```bash
-   bin/rake spec
-   ```
-
-4. Run the linter:
-   ```bash
-   bin/rake standard
-   ```
-
-5. Commit your changes with clear, descriptive messages
-
-### Architecture Overview
-
-**Core Components:**
-
-- **Backspin Module** (`lib/backspin.rb`)
-  - Main API: `run` (direct command execution and block capture), `capture` (alias for block form)
-  - Credential scrubbing logic
-  - Configuration management
-
-- **Snapshot Class** (`lib/backspin/snapshot.rb`)
-  - Represents a single execution snapshot
-  - Stores: command type, args, env, stdout, stderr, status, recorded_at
-
-- **BackspinResult Class** (`lib/backspin/backspin_result.rb`)
-  - Return object from `Backspin.run` / `Backspin.capture`
-  - Exposes `actual` and `expected` snapshots plus verify details
-
-- **Record Class** (`lib/backspin/record.rb`)
-  - Manages YAML record files
-  - Handles record/verify sequencing
-
-### Common Development Tasks
-
-#### Adding New Features
-
-1. Write integration tests in `spec/backspin/`
-2. Implement in appropriate module (usually `lib/backspin.rb`)
-3. Update README.md if adding public API
-4. Run the the full build
-
-#### Updating Credential Patterns
-
-- Add patterns to `DEFAULT_CREDENTIAL_PATTERNS` in `lib/backspin.rb`
-- Test with appropriate fixtures in specs
-
-#### Debugging Tests
-
-- Records are saved to `fixtures/backspin/` by default
-- Check YAML files to see recorded command outputs
-
-## Testing
-
-### Running Tests
-
 ```bash
-# Run all tests
+git clone https://github.com/rsanheim/backspin.git
+cd backspin
+bin/setup
+# run full build
 bin/rake spec
-
-# Run specific test file
-bundle exec rspec spec/backspin/record_spec.rb
-
-# Run specific test
-bundle exec rspec spec/backspin/record_spec.rb:42
 ```
 
-### Writing Tests
-
-Backspin uses integration-focused tests that exercise the full stack. When writing tests:
-
-- Keep specs self-contained with their own setup, expectations, and cleanup
-- Avoid shared contexts or helpers that hide important test details
-- Use real shell commands (`echo`, `date`, etc.) for testing
-- Ensure configuration is reset between tests to avoid side effects
-- Verify new or updated test records in `fixtures/backspin/`
-
-Example test structure:
-
-```ruby
-RSpec.describe "Feature name" do
-  it "does something specific" do
-    result = Backspin.run(["echo", "hello"], name: "my_test_record")
-
-    expect(result.actual.stdout).to eq("hello\n")
-  end
-end
-```
-
-## Submitting Changes
-
-### Pull Request Process
-
-1. Ensure all tests pass
-2. Update documentation if needed
-3. Add entries to CHANGELOG.md following the existing format
-4. Push your branch and create a pull request
-5. Provide a clear description of your changes
-6. Link any related issues
-
-### Pull Request Guidelines
-
-- Keep changes focused and atomic
-- Include tests for new functionality
-- Update examples in README.md if changing public APIs
-- Ensure CI passes (tests against Ruby 3.2, 3.3, 3.4, and 4.0)
-
 ## Release Maintainer Setup
 
-Before the first automated release, configure a RubyGems trusted publisher for the `backspin` gem using the [reusable workflow setup](https://guides.rubygems.org/trusted-publishing/#using-reusable-workflows):
-
-- Repository owner: `rsanheim`
-- Repository name: `backspin`
-- Workflow filename: `gem-release.yml`
-- Workflow Repository Owner: `rsanheim`
-- Workflow Repository Name: `.github`
-- Environment: `release`
-
-The workflow filename identifies the shared reusable workflow. The caller is `.github/workflows/release.yml`, which grants GitHub OIDC permission (`id-token: write`). No long-lived RubyGems API key is needed.
-
-Release pull requests update `lib/backspin/version.rb` and add a nonempty `## VERSION` section to `CHANGELOG.md`; the section body becomes the GitHub release notes. Keep the version change and its notes in the same pull request. Use the normal premerge CI checks to establish release readiness. Merging to `main` starts the release workflow, which rechecks the version and changelog before publishing; invalid release notes prevent publication. Ordinary merges do not publish anything.
-
-If publication fails before the gem is uploaded, fix the cause and manually run the Release workflow on `main`, setting `previous-ref` to the tag before the version increase. Confirm the target version is still unpublished before retrying.
-
-The shared release workflow is pinned in `.github/workflows/release.yml`. Update that commit deliberately when adopting shared release changes. Bundler's standard `build`, `install`, and `release` tasks remain available; the automated workflow is the normal publishing path.
-
-## Code Style
-
-Backspin uses [Standard Ruby](https://github.com/standardrb/standard) for code formatting. Run the linter before committing:
-
-```bash
-bin/rake standard
-```
-
-To automatically fix issues:
-
-```bash
-bin/rake standard:fix
-```
+Setup, trusted publishing, workflow updates, verification, and recovery live in
+[the shared release guide](https://github.com/rsanheim/.github#readme).
 
 ## Reporting Issues
 
@@ -201,39 +24,13 @@ bin/rake standard:fix
 
 When reporting bugs, please include *full logs* including:
 
-1. Ruby version (`ruby -v`) and ruby version manager info
+1. full ruby version (`ruby -v`) 
 2. Backspin version
-3. Minimal reproduction code
+3. reproduction code
 4. Expected behavior vs actual behavior
 5. Full error messages and stack traces
-6. Relevant YAML record files (sanitized of sensitive data)
-
-### Security Issues
-
-For security vulnerabilities, please email the maintainers directly rather than opening a public issue.
-
-## Feature Requests
-
-We welcome feature requests! When proposing new features:
-
-1. Check existing issues to avoid duplicates
-2. Describe the use case and motivation
-3. Provide code examples of how the feature would work
-4. Be open to discussion and alternative approaches
-
-## Additional Resources
-
-- [Project README](README.md)
-- [CLAUDE.md](CLAUDE.md) - AI assistant guidance
-- [RSpec Documentation](https://rspec.info/)
-- [Standardrb linting](https://github.com/standardrb/standard)
+6. Relevant YAML record files if applicable (sanitized of sensitive data)
 
 ## Questions?
 
-If you have questions about contributing, feel free to:
-
-- Open an issue for discussion
-- Check existing issues and pull requests
-- Review the test suite for examples
-
-Thank you for contributing to Backspin!
+If you have questions about contributing, feel free to open an issue and holler

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    backspin (0.14.0)
+    backspin (0.15.1)
       logger
 
 GEM
@@ -9,11 +9,11 @@ GEM
   specs:
     ast (2.4.3)
     diff-lcs (1.6.2)
-    json (2.21.1)
+    json (3.0.2)
     language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     logger (1.7.0)
-    parallel (1.28.0)
+    parallel (2.3.0)
     parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
@@ -21,7 +21,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
-    regexp_parser (2.12.0)
+    regexp_parser (2.13.1)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -35,8 +35,8 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.88.2)
-      json (~> 2.3)
+    rubocop (1.91.0)
+      json (>= 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
       parallel (>= 1.10)
@@ -54,10 +54,10 @@ GEM
       rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.47.1, < 2.0)
     ruby-progressbar (1.13.0)
-    standard (1.56.0)
+    standard (1.57.0)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
-      rubocop (~> 1.88.0)
+      rubocop (~> 1.91.0)
       standard-custom (~> 1.0.0)
       standard-performance (~> 1.8)
     standard-custom (1.0.2)
@@ -67,13 +67,15 @@ GEM
       lint_roller (~> 1.1)
       rubocop-performance (~> 1.26.0)
     timecop (0.9.11)
-    unicode-display_width (3.2.0)
-      unicode-emoji (~> 4.1)
-    unicode-emoji (4.2.0)
+    unicode-display_width (3.3.0)
+      unicode-emoji (~> 4.3)
+    unicode-emoji (4.3.0)
 
 PLATFORMS
+  aarch64-linux
   arm64-darwin-24
   ruby
+  x86_64-linux
 
 DEPENDENCIES
   backspin!
@@ -83,4 +85,4 @@ DEPENDENCIES
   timecop (~> 0.9)
 
 BUNDLED WITH
-  4.0.16
+  4.0.22

data/README.md

@@ -92,6 +92,26 @@ result.verified?        # true when they match
 
 Only stdout, stderr, and exit status are compared, so the two commands can differ in argv and environment without any normalization. `filter` and `matcher` work exactly as they do for `Backspin.run`, and a mismatch raises `Backspin::VerificationError` unless `raise_on_verification_failure` is disabled.
 
+To pipe data into a command's stdin, give that side as a Hash with `command:` and `stdin:`:
+
+```ruby
+Backspin.compare(
+  reference: {command: ["jq", "."], stdin: '{"a": 1}'},
+  actual: {command: ["my-jq", "."], stdin: '{"a": 1}'}
+)
+```
+
+A side Hash can also take `env:`, which replaces the top-level `env:` for that side:
+
+```ruby
+Backspin.compare(
+  reference: {command: ["jq", "."], env: {"HOME" => reference_home}},
+  actual: {command: ["my-jq", "."], env: {"HOME" => actual_home}}
+)
+```
+
+`compare` records nothing, so it does not scrub credentials. Filters, matchers, and failure diffs see raw output.
+
 If the reference command produces no output at all - usually a sign it failed to start rather than that its output is genuinely empty - `compare` raises `Backspin::ReferenceCommandError` instead of comparing empty to empty.
 
 ### Recording Modes
@@ -143,6 +163,7 @@ record_count: 3                            # increments on each write
 snapshot:
   command_type: "Open3::Capture3"
   args: ["echo", "hello"]
+  stdin: ""
   stdout: "hello\n"
   stderr: ""
   status: 0
@@ -164,6 +185,14 @@ Backspin.run(
 
 If `env:` is not provided, it is not passed to `Open3.capture3` and is not recorded.
 
+### Standard Input
+
+```ruby
+Backspin.run(["cat"], name: "with_stdin", stdin: "hello from stdin")
+```
+
+`stdin:` is passed to `Open3.capture3` as `stdin_data:` and saved in the record, but only stdout, stderr, and exit status are verified. `stdin:` is not supported with the block form.
+
 ### Custom Matchers
 
 For cases where full matching isn't suitable, you can override via `matcher:`. **NOTE**: If you provide
@@ -278,7 +307,7 @@ You can configure Backspin's behavior globally:
 Backspin.configure do |config|
   config.raise_on_verification_failure = false # default is true
   config.backspin_dir = "spec/fixtures/cli_records" # default is "fixtures/backspin"
-  config.scrub_credentials = false # default is true
+  config.scrub_credentials = false # default is true; scrubs run/capture records
 end
 ```
 
@@ -331,7 +360,7 @@ end
 
 If the CLI interaction you are recording contains sensitive data in stdout/stderr, you should be careful to make sure it is not recorded to YAML.
 
-By default, Backspin automatically tries to scrub common credential patterns from recorded stdout, stderr, args, and env values. Always review your record files before commiting them to source control.
+Backspin scrubs credentials from everything it records: by default it tries to scrub common credential patterns from stdout, stderr, args, env, and stdin before `run` and `capture` save them. `compare` records nothing, so it does not scrub. Always review your record files before commiting them to source control.
 
 ```ruby
 # This will automatically scrub AWS keys, API tokens, passwords, etc.
@@ -374,11 +403,9 @@ To install this gem onto your local machine, run `bundle exec rake install`.
 
 ### Releasing
 
-Open a pull request that updates `lib/backspin/version.rb` and adds a nonempty matching version section to `CHANGELOG.md` (for example, `## 0.14.0`). CI checks the effective gemspec version and fails if a version change has no release notes.
-
-Use the normal premerge CI checks to establish release readiness. After the pull request merges into `main`, the shared workflow rechecks the version and changelog, then invokes `rubygems/release-gem@v1`. The official action uses OIDC trusted publishing and Bundler's standard release task to build the gem, create and push `vVERSION`, and publish to RubyGems. After the action succeeds, the shared workflow creates a GitHub release using that changelog section. Invalid release notes prevent publication. Commits that leave the gem version unchanged do not trigger a release.
-
-The release implementation lives in [`rsanheim/.github`](https://github.com/rsanheim/.github) and is pinned to a commit in `.github/workflows/release.yml`. See [the maintainer setup](CONTRIBUTING.md#release-maintainer-setup) before enabling releases.
+See the [shared release guide](https://github.com/rsanheim/.github#readme) for
+setup and operation, and the [Backspin quick reference](CONTRIBUTING.md#release-maintainer-setup)
+for the files to update in a release PR.
 
 ## Contributing
 

data/fixtures/projects/dummy_cli_gem/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../../..
   specs:
-    backspin (0.14.0)
+    backspin (0.15.0)
       logger
 
 PATH
@@ -40,7 +40,7 @@ DEPENDENCIES
   rspec (~> 3)
 
 CHECKSUMS
-  backspin (0.14.0)
+  backspin (0.15.0)
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   dummy_cli_gem (0.1.0)
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203

data/lib/backspin/snapshot.rb

@@ -3,14 +3,16 @@
 module Backspin
   # Represents a single captured execution snapshot.
   class Snapshot
-    attr_reader :command_type, :args, :env, :stdout, :stderr, :status, :recorded_at
+    attr_reader :command_type, :args, :env, :stdin, :stdout, :stderr, :status, :recorded_at
 
-    def initialize(command_type:, args:, env: nil, stdout: "", stderr: "", status: 0, recorded_at: nil)
+    def initialize(command_type:, args:, env: nil, stdin: "", stdout: "", stderr: "", status: 0, recorded_at: nil, scrub: Backspin.configuration.scrub_credentials)
+      @scrub = scrub
       @command_type = command_type
       @args = sanitize_args(args)
       @env = env.nil? ? nil : sanitize_env(env)
-      @stdout = Backspin.scrub_text((stdout || "").dup).freeze
-      @stderr = Backspin.scrub_text((stderr || "").dup).freeze
+      @stdin = scrub_string((stdin || "").dup).freeze
+      @stdout = scrub_string((stdout || "").dup).freeze
+      @stderr = scrub_string((stderr || "").dup).freeze
       @status = status || 0
       @recorded_at = recorded_at.nil? ? nil : recorded_at.dup.freeze
       @serialized_hash = build_serialized_hash
@@ -42,6 +44,7 @@ module Backspin
         command_type: command_type,
         args: data["args"],
         env: data["env"],
+        stdin: data["stdin"],
         stdout: data["stdout"],
         stderr: data["stderr"],
         status: data["status"],
@@ -55,6 +58,7 @@ module Backspin
       data = {
         "command_type" => command_type.name,
         "args" => args,
+        "stdin" => stdin,
         "stdout" => stdout,
         "stderr" => stderr,
         "status" => status,
@@ -64,25 +68,25 @@ module Backspin
       deep_freeze(data)
     end
 
-    def scrub_args(value)
-      return value unless Backspin.configuration.scrub_credentials && value
+    def scrub_string(text)
+      @scrub ? Backspin.scrub_text(text) : text
+    end
 
+    def scrub_args(value)
       case value
       when String
-        Backspin.scrub_text(value)
+        scrub_string(value)
       when Array
         value.map { |entry| scrub_args(entry) }
       when Hash
-        value.transform_values { |entry| entry.is_a?(String) ? Backspin.scrub_text(entry) : entry }
+        value.transform_values { |entry| entry.is_a?(String) ? scrub_string(entry) : entry }
       else
         value
       end
     end
 
     def scrub_env(value)
-      return value unless Backspin.configuration.scrub_credentials && value
-
-      value.transform_values { |entry| entry.is_a?(String) ? Backspin.scrub_text(entry) : entry }
+      value.transform_values { |entry| entry.is_a?(String) ? scrub_string(entry) : entry }
     end
 
     def sanitize_args(value)

data/lib/backspin/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Backspin
-  VERSION = "0.14.0"
+  VERSION = "0.15.1"
 end

data/lib/backspin.rb

@@ -76,17 +76,19 @@ module Backspin
     # @param command [String, Array] Command to execute via Open3.capture3
     # @param name [String] Name for the record file
     # @param env [Hash] Environment variables to pass to Open3.capture3
+    # @param stdin [String] Data written to the command's stdin (recorded, not compared)
     # @param mode [Symbol] Recording mode - :auto, :record, :verify
     # @param matcher [Proc, Hash] Custom matcher for verification
     # @param filter [Proc] Custom filter for recorded data/canonicalization
     # @param filter_on [Symbol] Filter application mode - :both (default), :record
     # @return [BackspinResult] Aggregate result for this run
-    def run(command = nil, name:, env: nil, mode: :auto, matcher: nil, filter: nil, filter_on: :both, &block)
+    def run(command = nil, name:, env: nil, stdin: nil, mode: :auto, matcher: nil, filter: nil, filter_on: :both, &block)
       validate_filter_on!(filter_on)
 
       if block_given?
         raise ArgumentError, "command must be omitted when using a block" unless command.nil?
         raise ArgumentError, "env is not supported when using a block" unless env.nil?
+        raise ArgumentError, "stdin is not supported when using a block" unless stdin.nil?
 
         return perform_capture(name, mode: mode, matcher: matcher, filter: filter, filter_on: filter_on, &block)
       end
@@ -97,6 +99,7 @@ module Backspin
         command,
         name: name,
         env: env,
+        stdin: stdin,
         mode: mode,
         matcher: matcher,
         filter: filter,
@@ -126,22 +129,31 @@ module Backspin
     # Only stdout, stderr, and status are compared, so the two commands may
     # differ in argv and env without any normalization.
     #
-    # @param reference [String, Array] Command that defines the correct output
-    # @param actual [String, Array] Command under test
+    # Either side may be a Hash of {command:, env:, stdin:} to give that command
+    # its own env or stdin. A side's env replaces the top-level env for that
+    # side. Stdin is recorded on each snapshot, not compared.
+    #
+    # Credentials are not scrubbed, so the filter, matcher, and diff see raw output.
+    #
+    # @param reference [String, Array, Hash] Command that defines the correct output
+    # @param actual [String, Array, Hash] Command under test
     # @param env [Hash] Environment variables passed to both commands
     # @param matcher [Proc, Hash] Custom matcher for verification
     # @param filter [Proc] Custom filter applied to both sides before comparing
     # @return [BackspinResult] expected = reference, actual = command under test
     def compare(reference:, actual:, env: nil, matcher: nil, filter: nil)
-      normalized_env = normalize_env(env)
+      reference_command, reference_env, reference_stdin = reference.is_a?(Hash) ? reference.values_at(:command, :env, :stdin) : [reference, nil, nil]
+      actual_command, actual_env, actual_stdin = actual.is_a?(Hash) ? actual.values_at(:command, :env, :stdin) : [actual, nil, nil]
+      reference_env = normalize_env(reference_env || env)
+      actual_env = normalize_env(actual_env || env)
 
-      expected_snapshot, = capture_command_snapshot(reference, normalized_env)
+      expected_snapshot, = capture_command_snapshot(reference_command, reference_env, reference_stdin, scrub: false)
       if expected_snapshot.stdout.empty? && expected_snapshot.stderr.empty?
         raise ReferenceCommandError,
           "Reference command produced no output (exit status #{expected_snapshot.status}): #{reference.inspect}"
       end
 
-      actual_snapshot, = capture_command_snapshot(actual, normalized_env)
+      actual_snapshot, = capture_command_snapshot(actual_command, actual_env, actual_stdin, scrub: false)
 
       command_diff = CommandDiff.new(
         expected: expected_snapshot,
@@ -188,7 +200,7 @@ module Backspin
       result
     end
 
-    def perform_command_run(command, name:, env:, mode:, matcher:, filter:, filter_on:)
+    def perform_command_run(command, name:, env:, stdin:, mode:, matcher:, filter:, filter_on:)
       record_path = Record.build_record_path(name)
       mode = determine_mode(mode, record_path)
       validate_mode!(mode)
@@ -199,7 +211,7 @@ module Backspin
 
       result = case mode
       when :record
-        actual_snapshot, output = capture_command_snapshot(command, normalized_env)
+        actual_snapshot, output = capture_command_snapshot(command, normalized_env, stdin)
         record.set_snapshot(actual_snapshot)
         record.save(filter: filter)
         BackspinResult.new(
@@ -217,7 +229,7 @@ module Backspin
           raise RecordFormatError, "Invalid record format: expected Open3::Capture3 for run"
         end
 
-        actual_snapshot, output = capture_command_snapshot(command, normalized_env)
+        actual_snapshot, output = capture_command_snapshot(command, normalized_env, stdin)
         command_diff = CommandDiff.new(
           expected: expected_snapshot,
           actual: actual_snapshot,
@@ -243,16 +255,18 @@ module Backspin
       result
     end
 
-    def capture_command_snapshot(command, env)
-      stdout, stderr, status = execute_command(command, env)
+    def capture_command_snapshot(command, env, stdin, scrub: configuration.scrub_credentials)
+      stdout, stderr, status = execute_command(command, env, stdin)
       snapshot = Snapshot.new(
         command_type: Open3::Capture3,
         args: command,
         env: env,
+        stdin: stdin,
         stdout: stdout,
         stderr: stderr,
         status: status.exitstatus,
-        recorded_at: Time.now.utc.iso8601
+        recorded_at: Time.now.utc.iso8601,
+        scrub: scrub
       )
       [snapshot, [stdout, stderr, status]]
     end
@@ -264,13 +278,13 @@ module Backspin
       env.empty? ? nil : env
     end
 
-    def execute_command(command, env)
+    def execute_command(command, env, stdin)
       case command
       when String
-        env ? Open3.capture3(env, command) : Open3.capture3(command)
+        env ? Open3.capture3(env, command, stdin_data: stdin) : Open3.capture3(command, stdin_data: stdin)
       when Array
         raise ArgumentError, "command array cannot be empty" if command.empty?
-        env ? Open3.capture3(env, *command) : Open3.capture3(*command)
+        env ? Open3.capture3(env, *command, stdin_data: stdin) : Open3.capture3(*command, stdin_data: stdin)
       else
         raise ArgumentError, "command must be a String or Array"
       end

data/mise.toml

@@ -1,3 +1,3 @@
 [tools]
-ruby = "4.0.0"
+ruby = "4.0.7"
 "github:rsanheim/plur" = { version = "latest", minimum_release_age = "0s" }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: backspin
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.1
 platform: ruby
 authors:
 - Rob Sanheim
@@ -106,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Record and replay CLI interactions for testing
 test_files: []