merindorium / guava

A Swift test double library. Guava - looks like an apple but it's not.

Guava

Guava helps you to make your unit tests more flexible. It allows you to replace parts of your system under test with a test double objects.

---

Table of Contents

• Usage
• Documentation
• Installation
  • Carthage
  • Swift Package Manager
  • Manual

Features

Guava provides several types of test doubles:

• Stub
• Spy
• Fake

Usage

import Guava
import XCTest

protocol Calculator {

    func multiply(_ lhs: Int, _ rhs: Int) -> Int
}

final class CalculatorTestDouble: Calculator {

    let multiplyMethod = TestDoubleFactory<Int>()

    func multiply(_ lhs: Int, _ rhs: Int) -> Int {
        return multiplyMethod.invoke(arguments: [lhs, rhs])
    }
}

final class CalculatorTestCase: XCTestCase {

    func testMultiply() {
        let stubValue = 5
        let calculatorTestDouble = CalculatorTestDouble()

        calculatorTestDouble.multiplyMethod.stub(stubValue)

        let result = calculatorTestDouble.multiply(3, 3)
        XCTAssertEqual(result, stubValue)
    }
}

Documentation

See Documentation section.

Installation

Carthage

Update your Cartfile with:

github "merindorium/Guava"

Swift Package Manager

To use Guava with SPM update your Package.swift.

import PackageDescription

let package = Package(
    name: "ExampleProject",
    dependencies: [
        .package(url: "https://github.com/merindorium/Guava.git", from: "v1.2.0")
    ],
    ...
)

Manual

⚠️ This will install Carthage on your system

You could manually build Guava for iOS and MacOS by using:

1. make release_tooling
2. make carthage_build