> For the complete documentation index, see [llms.txt](https://andrewmcodes.gitbook.io/vcr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://andrewmcodes.gitbook.io/vcr/test_frameworks/test_unit.md).

# Usage with Test::Unit

To use VCR with Test::Unit, wrap the body of any test method in `VCR.use_cassette`.

## Use `VCR.use_cassette` in a test

*Given* a file named "test/test\_server.rb" with:

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

*Given* a file named "test/test\_helper.rb" with:

```
require 'test/test_server' if ENV['SERVER'] == 'true'
require 'test/unit'
require 'vcr'

VCR.configure do |c|
  c.hook_into :webmock
  c.cassette_library_dir = 'test/fixtures/vcr_cassettes'
  c.default_cassette_options = {
    :match_requests_on => [:method, :host, :path]
  }
end
```

*And* a file named "test/vcr\_example\_test.rb" with:

```
require 'test_helper'

class VCRExampleTest < Test::Unit::TestCase
  def test_use_vcr
    VCR.use_cassette('test_unit_example') do
      response = Net::HTTP.get_response('localhost', '/', $server ? $server.port : 0)
      assert_equal "Hello", response.body
    end
  end
end
```

*And* the directory "test/fixtures/vcr\_cassettes" does not exist

*When* I set the "SERVER" environment variable to "true"

*And* I run `ruby -Itest test/vcr_example_test.rb`

*Then* it should pass with "1 tests, 1 assertions, 0 failures, 0 errors"

*And* the file "test/fixtures/vcr\_cassettes/test\_unit\_example.yml" should contain "Hello"

*When* I set the "SERVER" environment variable to "false"

*And* I run `ruby -Itest test/vcr_example_test.rb`

*Then* it should pass with "1 tests, 1 assertions, 0 failures, 0 errors".