MockFive 0.03

You want to add pod 'MockFive', '~> 0.03' similar to the following to your Podfile:

target 'MyApp' do
  pod 'MockFive', '~> 0.03'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try MockFive

MockFive 0.03

By
Daniel Burbank
www.pairtree.io

MockFive Installation and Use

Add pod 'MockFive' to your Podfile or drag MockFive.swift from the MockFive folder into your project.

Make your mock object conform to Mock and add let mockFiveLock = lock() anywhere in the struct or class. Now you can begin using mock()! Call mock() within a function body to record its invocation in myMockObject.invocations, and to stub in alternative implementations at runtime.

Manual Mocking Made Easier

Using MockFive allows objects to report what functions have been called on them, and allows run-time method stubbing. Because MockFive uses reflection to generate its messages, the mock() method guarantees that testing strings always match production code. The Mock protocol may be adopted by both struct mocks and class mocks.

Examples

Protocol Mocking

import MockFive

struct CustomModel { var id: Int }

protocol MockworthyProtocol {
    func method()
    func complexMethod(arg: Int, model: CustomModel, others: Any?...) -> (Int, String)
}

struct MockImplementation: MockworthyProtocol, Mock {
    let mockFiveLock = lock()

    func method() { stub(identifier: "method") }
    func complexMethod(arg: Int, model: CustomModel, others: Any?...) -> (Int, String) {
        return stub(identifier: "complexMethod", arguments: arg, model.id, others) { (37, "stub string") }
    }
}

var mock = MockImplementation()

// Invocation records
mock.method()
mock.complexMethod(7, model: CustomModel(id: 982), others: 7, nil, 0.23, [0,9]) // (37, "stub string")

mock.invocations[0] // "method()"
mock.invocations[1] // "complexMethod(_: 7, model: 982, others: [Optional(7), nil, Optional(0.23), Optional([0, 9])]) -> (Int, String)"

// Function stubbing
mock.registerStub("complexMethod") { (90, "Total \(42 + 9)") }
mock.complexMethod(9, model: CustomModel(id: 7)) // (90, "Total 51")

Class Mocking

import MockFive

struct CustomModel { var id: Int }

class MockworthyClass {
    func method() {}
    func complexMethod(arg: Int, model: CustomModel, others: Any?...) -> (Int, String) { return (9, "potatos") }
}

class MockwortheClassMock: MockworthyClass, Mock {
    let mockFiveLock = lock()

    override func method() { stub(identifier: "method") { super.method() } }
    override func complexMethod(arg: Int, model: CustomModel, others: Any?...) -> (Int, String) {
        return stub(identifier: "complexMethod", arguments: arg, model.id, others) { super.complexMethod(arg, model: model, others: others) }
    }
}

// Invocation records
var mock = MockwortheClassMock()
mock.method()
mock.complexMethod(7, model: CustomModel(id: 982), others: 7, nil, 0.23, [0,9]) // (37, "stub string")

mock.invocations[0] // "method()"
mock.invocations[1] // "complexMethod(_: 7, model: 982, others: [Optional(7), nil, Optional(0.23), Optional([0, 9])]) -> (Int, String)"

// Function stubbing
mock.registerStub("complexMethod") { (90, "Total \(42 + 9)") }
mock.complexMethod(9, model: CustomModel(id: 9)) // (90, "Total 51")

See more examples in TestTrack.playground in the project!