New Episodes

The :new_episodes record mode will:

  • Record new interactions.

  • Replay previously recorded interactions.

    It is similar to the :once record mode, but will always record new interactions, even if you have an existing recorded one that is similar (but not identical, based on the :match_request_on option).

Background ()

Given a file named "setup.rb" with:

$server = start_sinatra_app do
  get('/') { 'Hello' }
end

require 'vcr'

VCR.configure do |c|
  c.hook_into                :webmock
  c.cassette_library_dir     = 'cassettes'
end

And a previously recorded cassette file "cassettes/example.yml" with:

--- 
http_interactions: 
- request: 
    method: get
    uri: http://example.com/foo
    body: 
      encoding: UTF-8
      string: ""
    headers: {}
  response: 
    status: 
      code: 200
      message: OK
    headers: 
      Content-Length: 
      - "20"
    body: 
      encoding: UTF-8
      string: example.com response
    http_version: "1.1"
  recorded_at: Tue, 01 Nov 2011 04:58:44 GMT
recorded_with: VCR 2.0.0

Previously recorded responses are replayed

Given a file named "replay_recorded_response.rb" with:

require 'setup'

VCR.use_cassette('example', :record => :new_episodes) do
  response = Net::HTTP.get_response('example.com', '/foo')
  puts "Response: #{response.body}"
end

When I run ruby replay_recorded_response.rb

Then it should pass with "Response: example.com response".

New requests get recorded

Given a file named "record_new_requests.rb" with:

require 'setup'

VCR.use_cassette('example', :record => :new_episodes) do
  response = Net::HTTP.get_response('localhost', '/', $server.port)
  puts "Response: #{response.body}"
end

When I run ruby record_new_requests.rb

Then it should pass with "Response: Hello"

And the file "cassettes/example.yml" should contain each of these:

| example.com response | | Hello |

Last updated