Mockingjay alternatives and similar libraries
Based on the "Testing" category.
Alternatively, view Mockingjay alternatives based on common mentions on social networks and blogs.
-
Quick
Quick is a behavior-driven development framework for Swift and Objective-C. -
OHHTTPStubs
A testing library designed to stub your network requests easily. -
UI Testing Cheat Sheet
Answers to common "How do I test this with UI Testing?" questions with a working example app. -
XCTest
The XCTest Project, A Swift core library for providing unit test support. -
SwiftCheck
A testing library that automatically generates random data for testing program properties. -
Buildasaur
Automatic testing of your Pull Requests on GitHub and BitBucket using Xcode Server. -
Mocker
Mock Alamofire and URLSession requests without touching your code implementation -
Erik
An headless browser to access and manipulate webpages using javascript allowing to run functional tests. -
Mockit
A simple mocking framework for Swift, inspired by the famous Mockito for Java. -
AutoMockable
A framework that leverages the type system to let you easily create mocked instances of your data types.
Scout APM - Leading-edge performance monitoring starting at $39/month
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest. Visit our partner's website for more details.
Do you think we are missing an alternative of Mockingjay or a related project?
README
Mockingjay
An elegant library for stubbing HTTP requests in Swift, allowing you to stub any HTTP/HTTPS using NSURLConnection
or NSURLSession
. That includes any request made from libraries such as Alamofire and AFNetworking.
Installation
CocoaPods is the recommended installation method.
pod 'Mockingjay'
Usage
Mockingjay has full integration to XCTest and you simply just need to register a stub, it will automatically be unloaded at the end of your test case. It will also work with the Quick behaviour-driven development framework.
Simple stub using a URI Template, returning a response with the given JSON encoded structure
let body = [ "user": "Kyle" ]
stub(uri("/{user}/{repository}"), json(body))
The uri
function takes a URL or path which can have a URI Template. Such as the following:
https://github.com/kylef/WebLinking.swift
https://github.com/kylef/{repository}
/kylef/{repository}
/kylef/URITemplate.swift
Stubbing a specific HTTP method with a JSON structure
let body = [ "description": "Kyle" ]
stub(http(.put, uri: "/kylef/Mockingjay"), json(body))
Stubbing everything request to result in an error
let error = NSError()
stub(everything, failure(error))
Stub with a specific HTTP response
stub(everything, http(status: 404))
Note, the http
builder can take a set of headers and a body too.
Stub
The stub
method in Mockingjay takes two functions or closures, one to match the request and another to build the response. This allows you to easily extend the syntax to provide your own specific functions.
stub(matcher, builder)
Matchers
A matcher is simply a function that takes a request and returns a boolean value for if the stub matches the request.
func matcher(request:URLRequest) -> Bool {
return true // Let's match this request
}
stub(matcher, failure(error))
Builders
Builders are very similar to a matcher, it takes a request, and it returns either a success or failure response.
func builder(request: URLRequest) -> Response {
let response = HTTPURLResponse(url: request.url!, statusCode: 200, httpVersion: nil, headerFields: nil)!
return .success(response, .noContent)
}
stub(matcher, builder)
Generics
You can make use of the builtin generic matchers and builders. These can be used alone, or in conjunction with custom components.
Builtin Matchers
everything
- Matches every given request.uri(template)
- Matches using a URI Template.http(method, template)
- Matches using a HTTP Method and URI Template.
Builtin Builders
failure(error)
- Builds a response using the given error.http(status, headers, data)
- Constructs a HTTP response using the given status, headers and data.json(body, status, headers)
- Constructs a JSON HTTP response after serialising the given body as JSON data.jsonData(data, status, headers)
- Constructs a JSON HTTP response with raw JSON data.
Using JSON files as test fixtures
During setUp
, load the JSON file as NSData
and use jsonData
.
override func setUp() {
super.setUp()
let url = Bundle(for: type(of: self)).url(forResource: "fixture", withExtension: "json")!
let data = try! Data(contentsOf: url)
stub(matcher, jsonData(data))
}
License
Mockingjay is licensed under the BSD license. See [LICENSE](LICENSE) for more info.
*Note that all licence references and agreements mentioned in the Mockingjay README section above
are relevant to that project's source code only.