VCRURLConnection 0.2.4

VCRURLConnection 0.2.4

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2017

Maintained by Dustin Barker.


Downloads

Total135,042
Week0
Month24,667

Installs

Apps4,347
Test Targets8,027
powered by Segment

GitHub

Stars371
Watchers11
Forks40
Issues8
Contributors9
Pull Requests0

Code

Files22
LOCLines of Code 734


  • By
  • Dustin Barker

VCRURLConnection is an iOS and OSX API to record and replay HTTP interactions, inspired by VCR

VCRURLConnection is still in the very early stages of development, all bug reports, feature requests, and general feedback are greatly appreciated!

Recording

[VCR start];
 
NSString *path = @"http://example.com/example";
NSURL *url = [NSURL URLWithString:path];
NSURLRequest *request = [NSURLRequest requestWithURL:url];

// use either NSURLSession or NSURLConnection
NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request];
[task resume];
 
// NSURLSession makes a real network request and VCRURLConnection
// will record the request/response pair.

// once async request is complete or application is ready to exit:
[VCR save:@"/path/to/cassette.json"]; // copy the output file into your project

Replaying

NSURL *cassetteURL = [NSURL fileURLWithPath:@"/path/to/cassette.json"];
[VCR loadCassetteWithContentsOfURL:cassetteURL];
[VCR start];

// request an HTTP interaction that was recorded to cassette.json
NSString *path = @"http://example.com/example";
NSURL *url = [NSURL URLWithString:path];
NSURLRequest *request = [NSURLRequest requestWithURL:url];

// use either NSURLSession or NSURLConnection
NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request];
[task resume];
 
// The cassette has a recording for this request, so no network request
// is made. Instead NSURLConnectionDelegate methods are called with the
// previously recorded response.

Installation

Manual

  • Download VCRURLConnection and try out the included example app
  • Include the files in the VCRURLConnection folder in your test target

Getting Started

  • Run your tests once to record all HTTP interactions
  • Copy the recorded json file (the file whose path is returned by [VCR save]) into your project
  • Subsequent test runs will use the recorded HTTP interactions instead of the network
  • All recordings are stored in a single JSON file, which you can edit by hand

License

VCRURLConnection is released under the MIT license

Contact

Dustin Barker

[email protected]

VCRURLConnection uses the following open source components: