backspin 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59bc6e711951434fc84dd2c2694f69aa5b00ef3bf878b81c5b4e97beeb430ad6
-  data.tar.gz: f9784962ef86ad73e0eb1c8388217700e477bc60ce0528b5dd16f08bc5c2f637
+  metadata.gz: f44a53c1983fd41c2660bc9652c158b2193e880e0e1339fa49c882d26fdd0852
+  data.tar.gz: 3b53d9ba92db35ad66c128bc049762e06c307472827fe2d4b795427c7e668bdf
 SHA512:
-  metadata.gz: e4151f4a28909e1a80706a30520b268f5114124230df9869a3603d5502194f4885ca8dff19e15a9a8ffe5f559b14695614f9f113c66e82ccc105de5b7ae17006
-  data.tar.gz: a66f71d1a4b2e9404ca39178920d8b88686f5e8cec2fe62f282b1cda9de031c1041cdfa1007ee9dc725c24cfb1c4dad5445213091a20c0faf23165705a8d264e
+  metadata.gz: 28909c63f9befbe8a0ae208328b9c527b3f1ca28417a66e96afad6ee9be41c2fa157ede63e4c5073f049ac59ab9c336a5fde7b97e109b7efc61480942ddc1a58
+  data.tar.gz: e63c8c4fff6ac690575ffadfe48efd6b4d0bc2267680e1c99637a888edcf3034bb315d96efedc400bfabdf5f8a9aa7912dfef03771b86a6a69769efe1bdcaac6

data/CLAUDE.md

@@ -62,7 +62,7 @@ bin/rake standard               # Run Standard Ruby linter
 ### Testing Approach
 
 - Integration-focused tests that exercise the full stack
-- Default record directory is `spec/backspin_data` (can be configured)
+- Default record directory is `fixtures/backspin` (can be configured)
 - Tests use real shell commands (`echo`, `date`, etc.)
 - Configuration is reset between tests to avoid side effects
 - **Important**: Backspin specs MUST be as local and un-DRY as possible. Each spec should be self-contained with its own setup, expectations, and cleanup if needed. Avoid shared contexts or helpers that hide important test details.
@@ -76,7 +76,7 @@ bin/rake standard               # Run Standard Ruby linter
 4. Run tests with `rake spec`
 
 ### Debugging Tests
-- Records are saved to `spec/backspin_data/` by default
+- Records are saved to `fixtures/backspin/` by default
 - Check YAML files to see recorded command outputs
 
 ### Updating Credential Patterns

data/CONTRIBUTING.md

@@ -99,7 +99,7 @@ Backspin is a Ruby gem for characterization testing of command-line interfaces.
 
 #### Debugging Tests
 
-- Records are saved to `spec/backspin_data/` by default
+- Records are saved to `fixtures/backspin/` by default
 - Check YAML files to see recorded command outputs
 
 ## Testing
@@ -125,7 +125,7 @@ Backspin uses integration-focused tests that exercise the full stack. When writi
 - 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 `spec/backspin_data/`
+- Verify new or updated test records in `fixtures/backspin/`
 
 Example test structure:
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    backspin (0.4.0)
+    backspin (0.4.1)
       ostruct (~> 0.5.0)
       rspec-mocks (~> 3.0)
 

data/README.md

@@ -1,4 +1,9 @@
-# Backspin   [![Gem Version](https://badge.fury.io/rb/backspin.svg)](https://badge.fury.io/rb/backspin) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/rsanheim/backspin/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/rsanheim/backspin/tree/main)
+# Backspin 
+
+[![Ruby](https://img.shields.io/badge/ruby-%23CC342D.svg?style=flat&logo=ruby&logoColor=white)](https://www.ruby-lang.org/)
+[![Gem Version](https://img.shields.io/gem/v/backspin)](https://rubygems.org/gems/backspin)
+[![CircleCI](https://img.shields.io/circleci/build/github/rsanheim/backspin/main)](https://circleci.com/gh/rsanheim/backspin)
+[![Last Commit](https://img.shields.io/github/last-commit/rsanheim/backspin/main)](https://github.com/rsanheim/backspin/commits/main)
 
 Backspin records and replays CLI interactions in Ruby for easy snapshot testing of command-line interfaces. Currently supports `Open3.capture3` and `system` and requires `rspec-mocks`.  More system calls and test integrations are welcome - send a PR!
 
@@ -62,7 +67,7 @@ end
 result = Backspin.run("echo_test", mode: :record) do
   Open3.capture3("echo hello")
 end
-# This will save the output to `spec/backspin_data/echo_test.yml`.
+# This will save the output to `fixtures/backspin/echo_test.yml`.
 
 # Explicit verify mode: Always verify against existing recording
 result = Backspin.run("echo_test", mode: :verify) do

data/fixtures/backspin/all_mode_filter.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'second'"
+  stdout: 'filtered output 2
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/credential_filter.yml

@@ -0,0 +1,18 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'My"
+  - API
+  - key
+  - is
+  - "********************'"
+  stdout: 'MY API KEY IS ********************
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/echo_hello.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - hello
+  stdout: 'hello
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/echo_verify.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - hello
+  stdout: 'hello
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/episodes_filter.yml

@@ -0,0 +1,26 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'episode"
+  - 1'
+  stdout: 'EPISODE 1
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'episode"
+  - 2'
+  stdout: 'EPISODE 2
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/failure_test.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - expected
+  stdout: 'expected
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/full_data_filter.yml

@@ -0,0 +1,17 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - bash
+  - "-c"
+  - echo 'stdout message' && echo 'stderr message' >&2 && exit 42
+  stdout: 'stdout message
+
+    '
+  stderr: 'stderr message
+
+    '
+  status: 42
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/mixed_calls.yml

@@ -0,0 +1,24 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - echo
+  - from
+  - system
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - from
+  - capture3
+  stdout: 'from capture3
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/multi_command.yml

@@ -0,0 +1,34 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - first
+  stdout: 'first
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - second
+  stdout: 'second
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - third
+  stdout: 'third
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/multi_command_filter.yml

@@ -0,0 +1,26 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'Count:"
+  - 42'
+  stdout: 'Count: X
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'Total:"
+  - 100'
+  stdout: 'Total: X
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/multi_field_filter.yml

@@ -0,0 +1,13 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - bash
+  - "-c"
+  - echo 'out' && echo 'err' >&2 && exit 1
+  stdout: modified stdout
+  stderr: modified stderr
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/multi_system.yml

@@ -0,0 +1,20 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - echo
+  - first
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Kernel::System
+  args:
+  - echo
+  - second
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/nil_filter.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'test'"
+  stdout: 'test
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/none_mode_test.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'original'"
+  stdout: 'original
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/path_test.yml

@@ -0,0 +1,17 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'File"
+  - saved
+  - to
+  - "/Users/testuser/project/output.txt'"
+  stdout: 'File saved to PROJECT_ROOT/output.txt
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/playback_system.yml

@@ -0,0 +1,12 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - echo
+  - recorded
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/playback_test.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - original
+  stdout: 'original
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/stderr_test.yml

@@ -0,0 +1,19 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - sh
+  - "-c"
+  - "'echo"
+  - error
+  - ">&2;"
+  - exit
+  - 1'
+  stdout: ''
+  stderr: 'error
+
+    '
+  status: 1
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/system_echo.yml

@@ -0,0 +1,12 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - echo
+  - hello
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/system_false.yml

@@ -0,0 +1,18 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - 'true'
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'
+- command_type: Kernel::System
+  args:
+  - 'false'
+  stdout: ''
+  stderr: ''
+  status: 1
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/timestamp_test.yml

@@ -0,0 +1,18 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'Test"
+  - run
+  - at
+  - '2024-01-15'
+  - 10:30:45'
+  stdout: 'Test run at TIMESTAMP
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/use_record_filter.yml

@@ -0,0 +1,15 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - echo
+  - "'hello"
+  - world'
+  stdout: 'HELLO WORLD
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/verify_system.yml

@@ -0,0 +1,12 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - echo
+  - hello
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/verify_system_diff.yml

@@ -0,0 +1,11 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Kernel::System
+  args:
+  - 'true'
+  stdout: ''
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/fixtures/backspin/version_test.yml

@@ -0,0 +1,14 @@
+---
+first_recorded_at: '2025-05-01T12:00:00Z'
+format_version: '2.0'
+commands:
+- command_type: Open3::Capture3
+  args:
+  - ruby
+  - "--version"
+  stdout: 'ruby 3.4.4 (2025-05-14 revision a38531fd3f) +PRISM [arm64-darwin24]
+
+    '
+  stderr: ''
+  status: 0
+  recorded_at: '2025-05-01T12:00:00Z'

data/lib/backspin/version.rb

@@ -1,3 +1,3 @@
 module Backspin
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

data/lib/backspin.rb

@@ -21,7 +21,7 @@ module Backspin
   # Configuration for Backspin
   class Configuration
     attr_accessor :scrub_credentials
-    # The directory where backspin will store its files - defaults to spec/backspin_data
+    # The directory where backspin will store its files - defaults to fixtures/backspin
     attr_accessor :backspin_dir
     # Regex patterns to scrub from saved output
     attr_reader :credential_patterns
@@ -29,7 +29,7 @@ module Backspin
     def initialize
       @scrub_credentials = true
       @credential_patterns = default_credential_patterns
-      @backspin_dir = Pathname(Dir.pwd).join("spec", "backspin_data")
+      @backspin_dir = Pathname(Dir.pwd).join("fixtures", "backspin")
     end
 
     def add_credential_pattern(pattern)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: backspin
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Rob Sanheim
@@ -62,6 +62,31 @@ files:
 - bin/rake
 - bin/rspec
 - bin/setup
+- fixtures/backspin/all_mode_filter.yml
+- fixtures/backspin/credential_filter.yml
+- fixtures/backspin/echo_hello.yml
+- fixtures/backspin/echo_verify.yml
+- fixtures/backspin/episodes_filter.yml
+- fixtures/backspin/failure_test.yml
+- fixtures/backspin/full_data_filter.yml
+- fixtures/backspin/mixed_calls.yml
+- fixtures/backspin/multi_command.yml
+- fixtures/backspin/multi_command_filter.yml
+- fixtures/backspin/multi_field_filter.yml
+- fixtures/backspin/multi_system.yml
+- fixtures/backspin/nil_filter.yml
+- fixtures/backspin/none_mode_test.yml
+- fixtures/backspin/path_test.yml
+- fixtures/backspin/playback_system.yml
+- fixtures/backspin/playback_test.yml
+- fixtures/backspin/stderr_test.yml
+- fixtures/backspin/system_echo.yml
+- fixtures/backspin/system_false.yml
+- fixtures/backspin/timestamp_test.yml
+- fixtures/backspin/use_record_filter.yml
+- fixtures/backspin/verify_system.yml
+- fixtures/backspin/verify_system_diff.yml
+- fixtures/backspin/version_test.yml
 - lib/backspin.rb
 - lib/backspin/command.rb
 - lib/backspin/command_diff.rb