guava's Introduction

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.

Usage
Documentation
Installation

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:

make release_tooling
make carthage_build

guava's People

Contributors

Stargazers

Watchers

Forkers

terky

guava's Issues

Swift 6 Error

When I run Test using Swift 6 mode. I get an error Sending 'self'-isolated value of type 'UInt64' with later accesses to actor-isolated context risks causing data races. Looks like the .zero being set todelayInNanoseconds argument is the culprit.

Note: Settings the value to 0 fixes the issues.