Module: VCR
- Extended by:
- VCR
- Includes:
- Errors, VariableArgsBlockCaller
- Included in:
- VCR
- Defined in:
- lib/vcr.rb,
lib/vcr/errors.rb,
lib/vcr/structs.rb,
lib/vcr/version.rb,
lib/vcr/cassette.rb,
lib/vcr/util/hooks.rb,
lib/vcr/util/logger.rb,
lib/vcr/deprecations.rb,
lib/vcr/configuration.rb,
lib/vcr/library_hooks.rb,
lib/vcr/linked_cassette.rb,
lib/vcr/middleware/rack.rb,
lib/vcr/request_handler.rb,
lib/vcr/request_ignorer.rb,
lib/vcr/middleware/excon.rb,
lib/vcr/cassette/migrator.rb,
lib/vcr/middleware/faraday.rb,
lib/vcr/cassette/persisters.rb,
lib/vcr/library_hooks/excon.rb,
lib/vcr/cassette/serializers.rb,
lib/vcr/util/version_checker.rb,
lib/vcr/cassette/erb_renderer.rb,
lib/vcr/library_hooks/faraday.rb,
lib/vcr/library_hooks/webmock.rb,
lib/vcr/test_frameworks/rspec.rb,
lib/vcr/library_hooks/typhoeus.rb,
lib/vcr/request_matcher_registry.rb,
lib/vcr/test_frameworks/cucumber.rb,
lib/vcr/util/internet_connection.rb,
lib/vcr/cassette/serializers/json.rb,
lib/vcr/cassette/serializers/syck.rb,
lib/vcr/cassette/serializers/yaml.rb,
lib/vcr/cassette/serializers/psych.rb,
lib/vcr/library_hooks/typhoeus_0.4.rb,
lib/vcr/cassette/http_interaction_list.rb,
lib/vcr/cassette/persisters/file_system.rb,
lib/vcr/cassette/serializers/compressed.rb,
lib/vcr/middleware/excon/legacy_methods.rb,
lib/vcr/util/variable_args_block_caller.rb
Overview
This module is extended onto itself; thus, the methods listed here as instance methods are available directly off of VCR.
The main entry point for VCR.
Defined Under Namespace
Modules: Deprecations, Errors, Hooks, InternetConnection, Middleware, Normalizers, Ping, RSpec, VariableArgsBlockCaller Classes: Cassette, Configuration, CucumberTags, HTTPInteraction, LibraryHooks, LinkedCassette, Logger, Request, RequestHandler, RequestIgnorer, RequestMatcherRegistry, Response, ResponseStatus, VersionChecker
Constant Summary collapse
- CassetteMutex =
Mutex to synchronize access to cassettes in a threaded environment
Mutex.new
- MainThread =
The main thread in which VCR was loaded
Thread.current
Class Method Summary collapse
Instance Method Summary collapse
- #cassette_persisters ⇒ Object
- #cassette_serializers ⇒ Object
-
#cassettes(context = current_context) ⇒ Enumerable
List of all cassettes currently being used.
-
#config ⇒ Object
deprecated
Deprecated.
Use #configure instead.
-
#configuration ⇒ VCR::Configuration
The VCR configuration.
-
#configure {|config| ... } ⇒ void
Used to configure VCR.
-
#cucumber_tags {|t| ... } ⇒ void
Sets up ‘Before` and `After` cucumber hooks in order to use VCR with particular cucumber tags.
-
#current_cassette ⇒ nil, VCR::Cassette
The currently active cassette.
-
#eject_cassette(options = {}) ⇒ VCR::Cassette?
Ejects the current cassette.
- #fibers_available? ⇒ Boolean
- #http_interactions ⇒ Object
-
#insert_cassette(name, options = {}) ⇒ VCR::Cassette
Inserts the named cassette using the given cassette options.
- #library_hooks ⇒ Object
- #link_context(from_thread, to_key) ⇒ Object
- #real_http_connections_allowed? ⇒ Boolean
- #record_http_interaction(interaction) ⇒ Object
- #request_ignorer ⇒ Object
-
#request_matchers ⇒ RequestMatcherRegistry
The request matcher registry.
-
#turn_off!(options = {}) ⇒ void
Turns VCR off, so that it no longer handles every HTTP request.
-
#turn_on! ⇒ void
Turns on VCR, if it has previously been turned off.
-
#turned_off(options = {}) ⇒ void
Turns VCR off for the duration of a block.
-
#turned_on? ⇒ Boolean
Whether or not VCR is turned on.
- #unlink_context(key) ⇒ Object
-
#use_cassette(name, options = {}) {|cassette| ... } ⇒ void
Inserts a cassette using the given name and options, runs the given block, and ejects the cassette.
-
#use_cassettes(cassettes, &block) ⇒ Object
Inserts multiple cassettes the given names.
-
#version ⇒ String
The current VCR version.
Methods included from VariableArgsBlockCaller
Class Method Details
.const_missing(const) ⇒ Object
10 11 12 13 14 |
# File 'lib/vcr/deprecations.rb', line 10 def self.const_missing(const) return super unless const == :Config warn "WARNING: `VCR::Config` is deprecated. Use VCR.configuration instead." configuration end |
Instance Method Details
#cassette_persisters ⇒ Object
355 356 357 |
# File 'lib/vcr.rb', line 355 def cassette_persisters @cassette_persisters end |
#cassette_serializers ⇒ Object
350 351 352 |
# File 'lib/vcr.rb', line 350 def cassette_serializers @cassette_serializers end |
#cassettes(context = current_context) ⇒ Enumerable
Returns list of all cassettes currently being used.
332 333 334 335 336 337 |
# File 'lib/vcr.rb', line 332 def cassettes(context = current_context) linked_context = context[:linked_context] linked_cassettes = cassettes(linked_context) if linked_context LinkedCassette.list(context[:cassettes], Array(linked_cassettes)) end |
#config ⇒ Object
Use #configure instead.
4 5 6 7 |
# File 'lib/vcr/deprecations.rb', line 4 def config warn "WARNING: `VCR.config` is deprecated. Use VCR.configure instead." configure { |c| yield c } end |
#configuration ⇒ VCR::Configuration
Returns the VCR configuration.
230 231 232 |
# File 'lib/vcr.rb', line 230 def configuration @configuration end |
#configure {|config| ... } ⇒ void
This method returns an undefined value.
Used to configure VCR.
225 226 227 |
# File 'lib/vcr.rb', line 225 def configure yield configuration end |
#cucumber_tags {|t| ... } ⇒ void
This method returns an undefined value.
Sets up ‘Before` and `After` cucumber hooks in order to use VCR with particular cucumber tags.
247 248 249 250 |
# File 'lib/vcr.rb', line 247 def (&block) main_object = eval('self', block.binding) yield VCR::CucumberTags.new(main_object) end |
#current_cassette ⇒ nil, VCR::Cassette
The currently active cassette.
48 49 50 |
# File 'lib/vcr.rb', line 48 def current_cassette cassettes.last end |
#eject_cassette(options = {}) ⇒ VCR::Cassette?
Ejects the current cassette. The cassette will no longer be used. In addition, any newly recorded HTTP interactions will be written to disk.
153 154 155 156 157 158 159 |
# File 'lib/vcr.rb', line 153 def eject_cassette( = {}) cassette = cassettes.last cassette.eject() if cassette cassette ensure context_cassettes.delete(cassette) end |
#fibers_available? ⇒ Boolean
378 379 380 |
# File 'lib/vcr.rb', line 378 def fibers_available? @fibers_available end |
#http_interactions ⇒ Object
315 316 317 318 |
# File 'lib/vcr.rb', line 315 def http_interactions return current_cassette.http_interactions if current_cassette VCR::Cassette::HTTPInteractionList::NullList end |
#insert_cassette(name, options = {}) ⇒ VCR::Cassette
If you use this method you must call ‘eject_cassette` when you are done. It is generally recommended that you use #use_cassette unless your code-under-test cannot be run as a block.
Inserts the named cassette using the given cassette options. New HTTP interactions, if allowed by the cassette’s ‘:record` option, will be recorded to the cassette. The cassette’s existing HTTP interactions will be used to stub requests, unless prevented by the cassete’s ‘:record` option.
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 |
# File 'lib/vcr.rb', line 126 def insert_cassette(name, = {}) if turned_on? if cassettes.any? { |c| c.name == name } raise ArgumentError.new("There is already a cassette with the same name (#{name}). You cannot nest multiple cassettes with the same name.") end cassette = Cassette.new(name, ) context_cassettes.push(cassette) cassette elsif !ignore_cassettes? = "VCR is turned off. You must turn it on before you can insert a cassette. " + "Or you can use the `:ignore_cassettes => true` option to completely ignore cassette insertions." raise TurnedOffError.new() end end |
#library_hooks ⇒ Object
345 346 347 |
# File 'lib/vcr.rb', line 345 def library_hooks @library_hooks end |
#link_context(from_thread, to_key) ⇒ Object
368 369 370 |
# File 'lib/vcr.rb', line 368 def link_context(from_thread, to_key) @context[to_key] = get_context(from_thread) end |
#real_http_connections_allowed? ⇒ Boolean
321 322 323 324 |
# File 'lib/vcr.rb', line 321 def real_http_connections_allowed? return current_cassette.recording? if current_cassette !!(configuration.allow_http_connections_when_no_cassette? || !turned_on?) end |
#record_http_interaction(interaction) ⇒ Object
360 361 362 363 364 365 |
# File 'lib/vcr.rb', line 360 def record_http_interaction(interaction) return unless cassette = current_cassette return if VCR.request_ignorer.ignore?(interaction.request) cassette.record_http_interaction(interaction) end |
#request_ignorer ⇒ Object
340 341 342 |
# File 'lib/vcr.rb', line 340 def request_ignorer @request_ignorer end |
#request_matchers ⇒ RequestMatcherRegistry
Returns the request matcher registry.
327 328 329 |
# File 'lib/vcr.rb', line 327 def request_matchers @request_matchers end |
#turn_off!(options = {}) ⇒ void
This method returns an undefined value.
Turns VCR off, so that it no longer handles every HTTP request.
280 281 282 283 284 285 286 287 288 289 290 291 292 293 |
# File 'lib/vcr.rb', line 280 def turn_off!( = {}) if VCR.current_cassette raise CassetteInUseError, "A VCR cassette is currently in use (#{VCR.current_cassette.name}). " + "You must eject it before you can turn VCR off." end set_context_value(:ignore_cassettes, .fetch(:ignore_cassettes, false)) = .keys - [:ignore_cassettes] if .any? raise ArgumentError.new("You passed some invalid options: #{.inspect}") end set_context_value(:turned_off, true) end |
#turn_on! ⇒ void
This method returns an undefined value.
Turns on VCR, if it has previously been turned off.
300 301 302 |
# File 'lib/vcr.rb', line 300 def turn_on! set_context_value(:turned_off, false) end |
#turned_off(options = {}) ⇒ void
This method returns an undefined value.
Turns VCR off for the duration of a block.
260 261 262 263 264 265 266 267 268 |
# File 'lib/vcr.rb', line 260 def turned_off( = {}) turn_off!() begin yield ensure turn_on! end end |
#turned_on? ⇒ Boolean
Normally VCR is always turned on; it will only be off if you have explicitly turned it off.
Returns whether or not VCR is turned on.
310 311 312 |
# File 'lib/vcr.rb', line 310 def turned_on? !context_value(:turned_off) end |
#unlink_context(key) ⇒ Object
373 374 375 |
# File 'lib/vcr.rb', line 373 def unlink_context(key) @context.delete(key) end |
#use_cassette(name, options = {}) {|cassette| ... } ⇒ void
This method returns an undefined value.
Inserts a cassette using the given name and options, runs the given block, and ejects the cassette.
178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 |
# File 'lib/vcr.rb', line 178 def use_cassette(name, = {}, &block) unless block raise ArgumentError, "`VCR.use_cassette` requires a block. " + "If you cannot wrap your code in a block, use " + "`VCR.insert_cassette` / `VCR.eject_cassette` instead." end cassette = insert_cassette(name, ) begin call_block(block, cassette) ensure eject_cassette end end |
#use_cassettes(cassettes, &block) ⇒ Object
Inserts multiple cassettes the given names
cassettes = [
{ name: 'github' },
{ name: 'apple', options: { erb: true } }
] VCR.use_cassettes() do
# make multiple HTTP requests
end
204 205 206 207 208 209 210 211 212 213 |
# File 'lib/vcr.rb', line 204 def use_cassettes(cassettes, &block) cassette = cassettes.pop use_cassette(cassette[:name], cassette[:options] || {}) do if cassettes.empty? block.call else use_cassettes(cassettes, &block) end end end |
#version ⇒ String
This string also has singleton methods:
-
‘major` [Integer] The major version.
-
‘minor` [Integer] The minor version.
-
‘patch` [Integer] The patch version.
-
‘parts` [Array<Integer>] List of the version parts.
Returns the current VCR version.
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
# File 'lib/vcr/version.rb', line 11 def version @version ||= begin string = '5.0.0' def string.parts split('.').map { |p| p.to_i } end def string.major parts[0] end def string.minor parts[1] end def string.patch parts[2] end string end end |