Latest 0.0.4
Homepage https://github.com/atetlaw/shawshank
License MIT
Platforms ios 9.0
Authors

Shawshank

"I guess it comes down to a simple choice, really. Get busy testing or get busy crying."

https://www.youtube.com/watch?v=djigcpyzBUQ

As seen in Testing Tips & Tricks from WWDC2018 Using an URLProtocol subclass is a great way to mock responses from network calls in unit tests, but it can be laborious to setup. The goal of Shawshank was to make mocking a network response a one-liner.

It does 2 things: creates a way to match network requests, and specifies what sort of response to return if the match is true.

Installation

Carthage

In your Cartfile use:

github "atetlaw/shawshank"

Shawshank only needs to be added to your unit testing target not your app’s main target. Remember to add the Carthage run script phase to your testing target, as well as adding Shawshank.framework to your Link Binaries With Libraries phase (Just click on the + button, the Add Other... button, and select the Shawshank.framework file in the Carthage/Build folder.)

Cocoapods

Add pod 'Shawshank' to your Podfile, but limit it to your testing target like so:

target 'MyAppTests' do
    pod 'Shawshank'
end

Where MyAppTests is the name of your app’s unit test target. Then run a pod install.

API Examples

Swift

// Match any requests to `http:www.example.com` and return the HTTP status: Not Permitted
Shawshank.take(matching: .scheme("http") && .host("www.example.com")).httpStatus(.notPermitted)
let json = Bundle(for: ShankPublicAPITests.self).json(named: "test")
Shawshank.take(matching: .scheme("http") && .host("www.example.com")).fixture(json)
Shawshank.take { (components: URLComponents) in
    return components.host == "www.example.com" && components.port == 82
}.fixture(JSONDataFixture(["test":"json"]))

Unit Test Example

func testShawshankMatchingDataTaskRespondingWithJSONDataFixture() {
    let testRequest = URLRequest(url: URL(string: "http://www.example.com")!)

    Shawshank.take(matching: .scheme("http") && .host("www.example.com")).fixture(JSONDataFixture(["test":"json"]))

    let expect = expectation(description: "response successful")
    URLSession.shared.dataTask(with: testRequest) { (data, response, error) -> Void in
        guard let httpResponse = response as? HTTPURLResponse else { return }
        XCTAssertNil(error)
        XCTAssertEqual(httpResponse.statusCode, 200)
        XCTAssertNotNil(data)

        guard let data = data else { XCTFail(); return }
        guard let json = try? JSONSerialization.jsonObject(with: data, options:[]) as? Dictionary<String, String> else { XCTFail(); return }

        XCTAssertEqual(json?["test"], "json")
        expect.fulfill()
    }.resume()

    waitForExpectations(timeout: 1, handler: nil)
}

Ackowledgments

Inspiration

Latest podspec

{
    "name": "Shawshank",
    "version": "0.0.4",
    "license": "MIT",
    "summary": "Easy stubbing for network calls in Swift unit tests",
    "homepage": "https://github.com/atetlaw/shawshank",
    "authors": {
        "Andrew Tetlaw": "[email protected]"
    },
    "source": {
        "git": "https://github.com/atetlaw/shawshank.git",
        "tag": "0.0.4"
    },
    "source_files": "Shawshank/*.swift",
    "platforms": {
        "ios": "9.0"
    },
    "swift_version": "4.2"
}

Pin It on Pinterest

Share This