rspec-cassette 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67dfa93eac9cae1c07b731184e9011207a44ba31f961f14662aac20c84dca3b7
-  data.tar.gz: ed094afc5cb2feccb559efb357999421faca1e6711eb5817ffde979d928b9230
+  metadata.gz: 19c996b45d630d32c304464a67035dbed686c5af31202511c7d2e6d75f32f2b9
+  data.tar.gz: 78d562bd3206c5766381b5ee2bc82d6f9cf378a024f42ed266c66fba5972a7a1
 SHA512:
-  metadata.gz: 28419926d4f0d91d682d0edce2a745f6245dd167c3ea83ff3d8276ae34357b4dfeffd656875bc8ce34ba0d439dcd87cb78e55ca1b7cceb9d8b490248c78f56c3
-  data.tar.gz: 32552c50d74803caf941e65bc4f31ef2584c9d7a2a973ef6f58437ce36862299e303718e691d71d7bf6223f6e831f92bdf5c7c225ab70852b10d40224dd2ff64
+  metadata.gz: e287877c9526172a2833fc232e59373eb4690384306a26964a21a57a0ed2bc5b81d5d21f06e76324f1385a6b0dbcc32703d494754431451a2dabcdb436da2f27
+  data.tar.gz: 7ca0839f025367842756ef94a832b1ac13b89d86706d72eace920a74956316c88a48c1ec3585b0fd9f8b95ab63cab83ccb1324a321fbde151070e47c15f593af

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.4.0 (2026-02-17)
+
+- Add `ignore_request` block support for custom passthrough conditions.
+- Extend `NetConnectManager` to translate `ignore_request` blocks into WebMock-compatible `allow` matchers.
+- Add net connection controls compatible with VCR migration use cases:
+  - `allow_http_connections_when_no_cassette`
+  - `ignore_localhost`
+  - `ignore_hosts`
+- Add `NetConnectManager` and wire it into the RSpec around hook to enforce and restore WebMock net-connect behavior per example.
+
 ## 0.3.0 (2026-02-17)
 
 - Improve sanitization to support non-ASCII characters in cassette names derived from VCR metadata.

data/README.md

@@ -26,6 +26,10 @@ require "rspec/cassette/rspec_helper"
 RSpec::Cassette.configure do |config|
   config.cassettes_dir = "spec/fixtures/cassettes"
   config.default_match_on = %i[method uri]
+  config.allow_http_connections_when_no_cassette = false
+  config.ignore_localhost = true
+  config.ignore_hosts = ["selenium-hub", "chromedriver"]
+  config.ignore_request { |request| URI(request.uri).port == 9200 }
 end
 ```
 
@@ -68,6 +72,35 @@ it "matches body", use_cassette: "users/index", cassette_options: { match_on: %i
 end
 ```
 
+## Network Connection Controls
+
+By default, `rspec-cassette` now blocks outgoing HTTP connections when no cassette is active:
+
+```ruby
+RSpec::Cassette.configure do |config|
+  config.allow_http_connections_when_no_cassette = false
+end
+```
+
+Allow passthrough for localhost or specific hosts:
+
+```ruby
+RSpec::Cassette.configure do |config|
+  config.ignore_localhost = true
+  config.ignore_hosts = ["selenium-hub", "chromedriver"]
+end
+```
+
+Use `ignore_request` for custom conditions:
+
+```ruby
+RSpec::Cassette.configure do |config|
+  config.ignore_request do |request|
+    URI(request.uri).port == 9200
+  end
+end
+```
+
 ## Migration Guide
 
 Before:
@@ -94,6 +127,10 @@ end
 | --- | --- | --- |
 | `cassettes_dir` | `spec/fixtures/cassettes` | Base directory for cassette files |
 | `default_match_on` | `[:method, :uri]` | WebMock matchers to apply |
+| `allow_http_connections_when_no_cassette` | `false` | Allow real HTTP when no cassette is active |
+| `ignore_localhost` | `false` | Allow localhost requests while other outgoing requests are blocked |
+| `ignore_hosts` | `[]` | Allow specific hosts while other outgoing requests are blocked |
+| `ignore_request` | none | Register predicate blocks to allow specific requests |
 
 ## Development
 

data/lib/rspec/cassette/configuration.rb

@@ -3,11 +3,24 @@
 module RSpec
   module Cassette
     class Configuration
-      attr_accessor :cassettes_dir, :default_match_on
+      attr_accessor :cassettes_dir,
+                    :default_match_on,
+                    :allow_http_connections_when_no_cassette,
+                    :ignore_localhost,
+                    :ignore_hosts
+      attr_reader :ignore_request_blocks
 
       def initialize
         @cassettes_dir = "spec/fixtures/cassettes"
         @default_match_on = %i[method uri]
+        @allow_http_connections_when_no_cassette = false
+        @ignore_localhost = false
+        @ignore_hosts = []
+        @ignore_request_blocks = []
+      end
+
+      def ignore_request(&block)
+        @ignore_request_blocks << block if block
       end
     end
   end

data/lib/rspec/cassette/net_connect_manager.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "webmock"
+
+module RSpec
+  module Cassette
+    class NetConnectManager
+      IgnoredRequest = Struct.new(:uri)
+
+      def initialize(configuration)
+        @configuration = configuration
+      end
+
+      def disable!
+        return if @configuration.allow_http_connections_when_no_cassette
+
+        options = {}
+        options[:allow_localhost] = true if @configuration.ignore_localhost
+
+        allow_list = build_allow_list
+        options[:allow] = allow_list unless allow_list.empty?
+
+        WebMock.disable_net_connect!(**options)
+      end
+
+      def restore!
+        return if @configuration.allow_http_connections_when_no_cassette
+
+        WebMock.allow_net_connect!
+      end
+
+      private
+
+      def build_allow_list
+        allow_list = @configuration.ignore_hosts.dup
+        allow_list.concat(ignore_request_matchers)
+        allow_list
+      end
+
+      def ignore_request_matchers
+        @configuration.ignore_request_blocks.map do |block|
+          lambda do |uri|
+            block.call(IgnoredRequest.new(uri.to_s))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rspec/cassette/rspec_helper.rb

@@ -24,8 +24,15 @@ RSpec.configure do |config|
   config.include RSpec::Cassette::RSpecHelper
 
   config.around(:each) do |example|
-    resolved = RSpec::Cassette::MetadataResolver.new(example).resolve
-    use_cassette(resolved[:cassette_name], **resolved[:cassette_options]) if resolved
-    example.run
+    manager = RSpec::Cassette::NetConnectManager.new(RSpec::Cassette.configuration)
+    manager.disable!
+
+    begin
+      resolved = RSpec::Cassette::MetadataResolver.new(example).resolve
+      use_cassette(resolved[:cassette_name], **resolved[:cassette_options]) if resolved
+      example.run
+    ensure
+      manager.restore!
+    end
   end
 end

data/lib/rspec/cassette/version.rb

@@ -2,6 +2,6 @@
 
 module RSpec
   module Cassette
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

data/lib/rspec/cassette.rb

@@ -6,6 +6,7 @@ require_relative "cassette/configuration"
 require_relative "cassette/cassette"
 require_relative "cassette/interaction"
 require_relative "cassette/metadata_resolver"
+require_relative "cassette/net_connect_manager"
 require_relative "cassette/stub_registrar"
 
 module RSpec

data/sig/rspec/cassette.rbs

@@ -13,6 +13,11 @@ module RSpec
     class Configuration
       attr_accessor cassettes_dir: String
       attr_accessor default_match_on: Array[Symbol]
+      attr_accessor allow_http_connections_when_no_cassette: bool
+      attr_accessor ignore_localhost: bool
+      attr_accessor ignore_hosts: Array[String]
+      attr_reader ignore_request_blocks: Array[Proc]
+      def ignore_request: () { (untyped request) -> untyped } -> void
     end
 
     def self.configuration: () -> Configuration
@@ -46,5 +51,11 @@ module RSpec
       def initialize: (untyped example) -> void
       def resolve: () -> Hash[Symbol, untyped]?
     end
+
+    class NetConnectManager
+      def initialize: (Configuration configuration) -> void
+      def disable!: () -> void
+      def restore!: () -> void
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rspec-cassette
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -54,6 +54,7 @@ files:
 - lib/rspec/cassette/errors.rb
 - lib/rspec/cassette/interaction.rb
 - lib/rspec/cassette/metadata_resolver.rb
+- lib/rspec/cassette/net_connect_manager.rb
 - lib/rspec/cassette/rspec_helper.rb
 - lib/rspec/cassette/stub_registrar.rb
 - lib/rspec/cassette/version.rb