Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
100644 152 lines (118 sloc) 8.884 kb
3e442f3 Myron Marston Change History file to markdown format and renamed it to changelog.
1 #Changelog
4d68e93 Myron Marston Optimized #stub_requests a bit.
3 ## In Git
ed4a662 Myron Marston The latest FakeWeb passes this spec (was pending before).
5 * Updated to use and require FakeWeb 1.3.0. It includes a fix for a bug related to multiple values for the
6 same response header.
7f58282 Myron Marston Use FakeWeb::Utility.request_uri_as_string rather than our own logic to ...
7 * Use new `FakeWeb::Utility.request_uri_as_string` method rather than our own logic to construct a request uri.
5fc0ba4 Myron Marston Use a localhost regex with FakeWeb.allow_net_connect for the ignore_loca...
8 * Use new `FakeWeb.allow_net_connect = /url regex/` feature to power the `ignore_localhost` VCR option rather
9 then toggling `FakeWeb.allow_net_connect` in our Net::HTTP extension.
4d68e93 Myron Marston Optimized #stub_requests a bit.
10 * Optimized `VCR.http_stubbing_adapter.stub_requests` a bit.
4a465ca Myron Marston 1.1.0 release.
12 ## 1.1.0 (August 22, 2010)
0289298 Myron Marston Removed task runner as it's no longer needed.
3def0be Myron Marston Documentation updates for new :match_requests_on option.
14 * Added `:match_requests_on` cassette option, which determines how VCR matches requests.
0289298 Myron Marston Removed task runner as it's no longer needed.
15 * Removed VCR::TaskRunner and the corresponding rake task definition. The rake task migrated cassettes from the
16 0.3.1 format to the 0.4+ format. If you are still on 0.3.1 or earlier, I recommend you upgrade to 0.4.1 first,
17 migrate your cassettes and deal with migration warnings, then upgrade to the current release.
606e328 Myron Marston Raise an error if is given invalid options.
18 * Added some code to to check the options passed to the cassette and raise an error if any
19 invalid options are passed.
f2bb986 Myron Marston Optimized ERB rendering a bit.
20 * Optimized ERB rendering a bit. Rather than creating a new struct subclass for each time we render an ERB
21 cassette with locals, we keep a cache of reusable struct subclasses based on the desired attributes.
22 [Benchmarking]( reveals this is about 28% faster.
a40025f Myron Marston Updated em-http-request to 0.2.10.
23 * Upgraded tests to use em-http-request 0.2.10 rather than 0.2.7.
0289298 Myron Marston Removed task runner as it's no longer needed.
ce13279 Myron Marston 1.0.3 release.
25 ## 1.0.3 (August 5, 2010)
27 * Upgraded VCR specs to RSpec 2.
28 * Updated `VCR::CucumberTags` so that it uses an `around` hook rather than a `before` hook and an `after` hook.
29 Around hooks were added to Cucumber in the 0.7.3 release, so you'll have to be on that version or higher to use
30 the `VCR::CucumberTags` feature.
31 * Updated the WebMock version requirement to 1.3.3 or greater. 1.3.2 and earlier versions did not properly handle
32 multiple value for the same response header.
33 * Miscellaneous documentation updates.
e13d215 Myron Marston 1.0.2 release.
35 ## 1.0.2 (July 6, 2010)
37 * Fixed VCR to work with [rest-client]( Rest-client extends the Net::HTTP
38 response body string with a module containing additional data, which got serialized to the cassette file YAML
39 and occasionally caused problems when the YAML was deserialized. Bug reported by
40 [Thibaud Guillaume-Gentil](
41 * Setup bundler to manage development dependencies.
ade8181 Myron Marston 1.0.1 release.
43 ## 1.0.1 (July 1, 2010)
45 * Fixed specs and features so they pass on MRI 1.9.2-preview3 and JRuby 1.5.1.
46 * Normalized response and request headers so that they are stored the same (i.e. lower case keys, arrays of values)
47 in the cassette yaml files, regardless of which HTTP library is used. This is the same way Net::HTTP normalizes
48 HTTP headers.
49 * Fixed `VCR.use_cassette` so that it doesn't eject a cassette if an exception occurs while inserting one.
50 * Fixed FakeWeb adapter so that it works for requests that use basic auth. Patch submitted by
51 [Eric Allam](
a5ac5bf Myron Marston 1.0.0 release.
53 ## 1.0.0 (June 22, 2010)
55 * New Features
56 * Added support for [HTTPClient](, [Patron]( and
57 [em-http-request]( when WebMock is used. Any future http libraries
58 WebMock supports should (theoretically, at least) work without any VCR code changes. Thanks to
59 [Bartosz Blimke]( for adding the necessary code to WebMock to make this happen!
60 * Added support for dynamic responses using ERB. A cassette will be evaluated as ERB before the YAML
61 is deserialized if you pass it an `:erb => true` option. You can pass variables using
62 `:erb => { :var1 => 'some value', :var2 => 'another value' }`.
63 * Added `ignore_localhost` configuration setting, which defaults to false. Setting it true does the following:
64 * Localhost requests will proceed as normal. The "Real HTTP connections are disabled" error will not occur.
65 * Localhost requests will not be recorded.
66 * Previously recorded localhost requests will not be replayed.
67 * Exposed the version number:
68 * `VCR.version` => string (in the format "major.minor.patch")
69 * `` => array of integers
70 * `VCR.version.major` => integer
71 * `VCR.version.minor` => integer
72 * `VCR.version.patch` => integer
73 * Added test coverage and documentation of using a regex for non-deterministic URLs (i.e. URLs that include
74 a timestamp as a query parameter). It turns out this feature worked before, and I just didn't realize it :).
76 * Breaking Changes
77 * The `:allow_real_http => lambda { |uri| ... }` cassette option has been removed. There was no way to get
78 this to work with the newly supported http libraries without extensive monkeypatching, and it was mostly
79 useful for localhost requests, which is more easily handled by the new `ignore_localhost` config setting.
80 * Removed methods and options that had been previously deprecated. If you're upgrading from an old version,
81 I recommend upgrading to 0.4.1 first, deal with all the deprecation warnings, then upgrade to 1.0.0.
83 * Misc Changes:
84 * Removed dependency on [jeweler]( Manage the gemspec by hand instead.
85 * Removed some extensions that are no longer necessary.
dfceeb1 Myron Marston 0.4.1 release.
87 ## 0.4.1 May 11, 2010
88 * Fixed a bug: when `Net::HTTPResponse#read_body` was called after VCR had read the body to record a new request,
89 it raised an error (`IOError: Net::HTTPResponse#read_body called twice`). My fix extends Net::HTTPResponse
90 so that it no longer raises this error.
7663252 Myron Marston 0.4.0 release.
92 ## 0.4.0 April 28, 2010
af61cfc Myron Marston Updated CHANGELOG with the info about what is coming in the next release...
93 * Added support for webmock. All the fakeweb-specific code is now in an adapter (as is the webmock code).
95 * Changed the format of the VCR cassettes. The old format was tied directly to Net::HTTP, but webmock supports
96 other HTTP libraries and I plan to allow VCR to use them in the future. Note that this is a breaking change--your
97 old VCR cassettes from prior releases will not work with VCR 0.4.0. However, VCR provides a rake task to assist
98 you in migrating your cassettes to the new format. Simply add `load 'vcr/tasks/vcr.rake'` to your project's Rakefile,
99 and run:
101 $ rake vcr:migrate_cassettes DIR=path/to/cassete/library/directory
103 * The new cassette format records more information about the request (i.e. the request headers and body), so that it
104 can potentially be used with webmock in the future.
106 * Made most of `VCR::Cassette`'s methods private. I had forgotten to make the methods private before, and most of them
107 don't need to be exposed.
109 * Automatically disallow http connections using the appropriate setting of the http stubbing library (fakeweb or webmock).
110 This relieves users from the need to set the option themselves, so they hopefully aren't using either fakeweb or webmock
111 directly, making it much easier to switch between these.
113 * Change documentation from rdoc to markdown format.
115 * Lots of other refactoring.
3e442f3 Myron Marston Change History file to markdown format and renamed it to changelog.
117 ## 0.3.1 April 10, 2010
118 * Fixed a bug: when `Net::HTTP#request` was called with a block that had a return statement, the response was not being recorded.
120 ## 0.3.0 March 24, 2010
121 * Renamed a bunch of methods, replacing them with method names that more clearly fit the VCR/cassette metaphor:
122 * `VCR.create_cassette!` => `VCR.insert_cassette`
123 * `VCR.destroy_cassette!` => `VCR.eject_cassette`
124 * `VCR.with_cassette` => `VCR.use_cassette`
125 * `VCR::Cassette#destroy!` => `VCR::Cassette#eject`
126 * `VCR::Cassette#cache_file` => `VCR::Cassette#file`
127 * `VCR::Config.cache_dir` => `VCR::Config.cassette_library_dir`
128 * `:unregistered` record mode => `:new_episodes` record mode
130 * All the old methods still work, but you'll get deprecation warnings.
132 ## 0.2.0 March 9, 2010
133 * Added `:allow_real_http` cassette option, which allows VCR to work with capybara and a javascript driver.
134 Bug reported by [Ben Hutton](
136 * Deprecated the `default_cassette_record_mode` option. Use `default_cassette_options[:record_mode]` instead.
138 ## 0.1.2 March 4, 2010
139 * Added explanatory note about VCR to `FakeWeb::NetConnectNotAllowedError#message`.
141 * Got things to work for when a cassette records multiple requests made to the same URL with the same HTTP verb,
142 but different responses. We have to register an array of responses with fakeweb.
144 * Fixed our `Net::HTTP` monkey patch so that it only stores the recorded response once per request.
145 Internally, `Net::HTTP#request` recursively calls itself (passing slightly different arguments) in certain circumstances.
147 ## 0.1.1 February 25, 2010
148 * Handle asynchronous HTTP requests (such as for mechanize). Bug reported by [Thibaud Guillaume-Gentil](
150 ## 0.1.0 February 25, 2010
ade8181 Myron Marston 1.0.1 release.
151 * Initial release. Basic recording and replaying of responses works.
Something went wrong with that request. Please try again.