betamax 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5b5fbb5686ea27e8f9fd4f21eb6a086c4949a7461f848e385f2fb64a23fd333
-  data.tar.gz: 24c0341506d19c85757c88d408343390d76810c92c13717eda21735e2de32f18
+  metadata.gz: b13224e3fa5f820802a68dc000dbabab4a023eff18250e3b0af5e9fb36f98092
+  data.tar.gz: 70fb0889db8f8b4df8b7b60527895f27d806bda46164990670cec559e5e0b29c
 SHA512:
-  metadata.gz: df2ce112b5ca2b706212e9963208757726e00ba7df005306feae2d58bd8a40347927a7f6e3cdd71df2b717b537fd9f2df855af836dfdba28af5d4f8723dd475b
-  data.tar.gz: bf29734cdb839478aa0e555292cd850c91baae0adb7d628e620bbab011ad1379e7143d47b837f858845c32430c3ce8313959b462d1151afb99739fcde412e15e
+  metadata.gz: '0698af118ee8b4a7900e8fa490548b9967e4c91c5fa1cb7d7543b5f55aaf71ab1993a8b6efdfa80467c830e86f24227be5f42e3b0509bb628657914c49f01003'
+  data.tar.gz: ea48915b0269d20c9810d7a65a8519c0b9a6b84cdab6dd918822ba92da084fbd427b0d2145ce7f27757a5bacf39d9476a7646e0fcf2fbbbcbff2a26d64db51e6

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## 0.2.0
+
+- Add Minitest support via `Betamax::Minitest#with_betamax`.
+- Clear the active player when a test raises, so a later test cannot record onto a stale player.
+
 ## 0.1.1 - 2026-06-15
 
 - Add UNLICENSE

data/README.md

@@ -1,6 +1,6 @@
 # Betamax
 
-Betamax allows for the recording and playback of arbitrary Ruby objects to simplify testing external dependencies.
+Betamax allows for the recording and playback of arbitrary Ruby objects to simplify testing external dependencies. Think of it like the [VCR](https://github.com/vcr/vcr) gem, but for any complicated object, not just HTTP interactions. This gem was originally developed to write a test suite for a MiniDisc NetMD Walkman library, where the recording and playback of real USB traffic was desired.
 
 ## Installation
 
@@ -18,11 +18,59 @@ gem install betamax
 
 ## Usage
 
-TODO: Write usage instructions here
+Currently this gem supports testing with RSpec. First, require the gem in your spec helper:
+
+```ruby
+# File: spec/spec_helper.rb
+
+require 'betamax'
+```
+
+Then, record an object. The first time you run your test, a recording will be created in `spec/betamax_tapes/`. Subsequent test runs will playback from your recording. Make sure to tag your example as `:betamax` to enable recording and playback.
+
+```ruby
+RSpec.describe 'a MiniDisc device' do
+  let(:walkman) do
+    usb_device = LibUSB::Context.devices(idProduct: 0x0084).first
+
+    MiniDisc::Device.new usb_device: Betamax.record(usb_device)
+  end
+
+  it 'has a tracklist', :betamax do
+    walkman.open do |disc|
+      disc.tracks.first.title.should == 'Song of the Highwire Shrimper'
+    end
+  end
+end
+
+```
+
+In the above example, the test will continue to work even if the USB device is no longer present. If for some reason changes to your code change the interaction with your recorded object, your test will fail. This could be because methods were called in a different order, block arguments changed, method calls were expected but did not take place, etc.
+
+### Minitest
+
+Include `Betamax::Minitest` in your test class and surround the recorded interaction with `with_betamax`. Tapes are named after the test class and method and stored in `test/betamax_tapes/` (override with `tapes_folder:`).
+
+```ruby
+class WalkmanTest < Minitest::Test
+  include Betamax::Minitest
+
+  def test_tracklist
+    with_betamax do
+      usb_device = LibUSB::Context.devices(idProduct: 0x0084).first
+      walkman = MiniDisc::Device.new usb_device: Betamax.record(usb_device)
+
+      walkman.open do |disc|
+        assert_equal 'Song of the Highwire Shrimper', disc.tracks.first.title
+      end
+    end
+  end
+end
+```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake` to run the RSpec and Minitest suites and RuboCop. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 

data/Rakefile

@@ -1,10 +1,15 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
 
 RSpec::Core::RakeTask.new :spec
 
-require "rubocop/rake_task"
+Rake::TestTask.new :test do |task|
+  task.libs << 'lib'
+  task.pattern = 'test/**/*_test.rb'
+end
 
 RuboCop::RakeTask.new
 
-task default: %i[spec rubocop]
+task default: %i[spec test rubocop]

data/lib/betamax/errors.rb

@@ -3,7 +3,7 @@ module Betamax
     class Error < StandardError; end
 
     class NoTapeInserted < Error
-      def initialize message = "No tape inserted"
+      def initialize message = 'No tape inserted'
         super
       end
     end
@@ -51,7 +51,7 @@ module Betamax
 
     class UnusedRecordings < PlaybackError
       def initialize unused_methods
-        method_names = unused_methods.map(&:method_name).join(", ")
+        method_names = unused_methods.map(&:method_name).join(', ')
         super "Recording has #{unused_methods.size} unused method(s): #{method_names}"
       end
     end

data/lib/betamax/minitest.rb

@@ -0,0 +1,27 @@
+module Betamax
+  module Minitest
+    DEFAULT_TAPES_FOLDER = Pathname.new 'test/betamax_tapes/'
+
+    # Adapts a Minitest test and block to the example interface Player expects.
+    class Example
+      attr_reader :metadata
+
+      def initialize test, &block
+        @metadata = { description: test.name, example_group: { description: test.class.name } }
+        @block = block
+      end
+
+      def run
+        @block.call
+      end
+
+      def exception
+        nil
+      end
+    end
+
+    def with_betamax(tapes_folder: DEFAULT_TAPES_FOLDER, &)
+      Player.new(Example.new(self, &), tapes_folder: Pathname.new(tapes_folder)).play
+    end
+  end
+end

data/lib/betamax/player.rb

@@ -13,6 +13,8 @@ module Betamax
       insert_tape
       @example.run
       eject_tape unless @example.exception
+    ensure
+      Fiber[:betamax_player] = nil
     end
 
     def record object

data/lib/betamax/rspec.rb

@@ -1,6 +1,6 @@
 module Betamax
   module RSpec
-    DEFAULT_TAPES_FOLDER = Pathname.new "spec/betamax_tapes/"
+    DEFAULT_TAPES_FOLDER = Pathname.new 'spec/betamax_tapes/'
 
     def play_rspec example, tapes_folder: DEFAULT_TAPES_FOLDER
       Player.new(example, tapes_folder:).play

data/lib/betamax/tape.rb

@@ -1,5 +1,5 @@
-require "fileutils"
-require "yaml"
+require 'fileutils'
+require 'yaml'
 
 module Betamax
   class Tape
@@ -20,11 +20,11 @@ module Betamax
 
     def self.from_rspec_example example, tapes_folder:
       name = cassette_name_for example.metadata
-      name.gsub! "::", "_"
-      name.gsub!(/[\s-]+/, "_")
-      name.gsub! %r{[^a-zA-Z0-9_/]}, ""
+      name.gsub! '::', '_'
+      name.gsub!(/[\s-]+/, '_')
+      name.gsub! %r{[^a-zA-Z0-9_/]}, ''
 
-      filename = Pathname.new(name).sub_ext ".yaml"
+      filename = Pathname.new(name).sub_ext '.yaml'
       full_path = tapes_folder / filename
 
       new full_path
@@ -44,7 +44,7 @@ module Betamax
         current = current[:parent_example_group]
       end
 
-      description_parts.join "/"
+      description_parts.join '/'
     end
 
     def load
@@ -66,7 +66,7 @@ module Betamax
         version: Recording::VERSION,
         objects: { default: proxy }
 
-      File.open @path, "w" do |file|
+      File.open @path, 'w' do |file|
         file.puts recording.to_yaml
       end
     end

data/lib/betamax/version.rb

@@ -1,3 +1,3 @@
 module Betamax
-  VERSION = "0.1.1".freeze
+  VERSION = '0.2.0'.freeze
 end

data/lib/betamax.rb

@@ -1,16 +1,17 @@
-require "pathname"
-
-require_relative "betamax/errors"
-require_relative "betamax/method_player"
-require_relative "betamax/method_recorder"
-require_relative "betamax/player"
-require_relative "betamax/recorded_method"
-require_relative "betamax/recorded_object"
-require_relative "betamax/recorded_yielding"
-require_relative "betamax/recording"
-require_relative "betamax/rspec"
-require_relative "betamax/tape"
-require_relative "betamax/version"
+require 'pathname'
+
+require_relative 'betamax/errors'
+require_relative 'betamax/method_player'
+require_relative 'betamax/method_recorder'
+require_relative 'betamax/minitest'
+require_relative 'betamax/player'
+require_relative 'betamax/recorded_method'
+require_relative 'betamax/recorded_object'
+require_relative 'betamax/recorded_yielding'
+require_relative 'betamax/recording'
+require_relative 'betamax/rspec'
+require_relative 'betamax/tape'
+require_relative 'betamax/version'
 
 module Betamax
   extend RSpec

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: betamax
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - John DeSilva
@@ -25,6 +25,7 @@ files:
 - lib/betamax/errors.rb
 - lib/betamax/method_player.rb
 - lib/betamax/method_recorder.rb
+- lib/betamax/minitest.rb
 - lib/betamax/player.rb
 - lib/betamax/recorded_method.rb
 - lib/betamax/recorded_object.rb
@@ -48,14 +49,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Record and playback of arbitrary Ruby objects
 test_files: []