Swiftpack.co - akkyie/Tablier as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by akkyie.
akkyie/Tablier 0.5.0
A micro-framework for Table Driven Tests.
⭐️ 27
🕓 1 week ago
.package(url: "https://github.com/akkyie/Tablier.git", from: "0.5.0")

Tablier

Build Status codecov Swift 5 CocoaPods compatible Carthage compatible SPM compatible Supports iOS, macOS, tvOS and Linux MIT License

A micro-framework for Table Driven Tests.

A screenshot to see how it works

Features

  • ☑️ Dead simple syntax
  • ☑️ Run sync and async tests in parallel
  • ☑️ No additional dependency aside from XCTest
  • ☑️ Use with Quick, or any other XCTest-based testing frameworks
  • ☑️ Fully tested itself

Installation

Swift Package Manager

.package(url: "https://github.com/akkyie/Tablier", from: <#version#>)

Cocoapods

target 'YourTests' do
    inherit! :search_paths
    pod 'Tablier'
end

Usage

Synchronous Recipe

You can define a test recipe to test your classes, structs or functions.

final class MyParseTests: XCTestCase {
    func testMyParse() {
        let recipe = Recipe<String, Int>(sync: { input in
            // `myParse` here is what you want to test
            let output: Int = try myParse(input) // it fails if an error is thrown
            return output
        })
...

Then you can list inputs and expected outputs for the recipe, to run the actual test for it.

...
        recipe.assert(with: self) {
            $0.when("1").expect(1)
            $0.when("1234567890").expect(1234567890)
            $0.when("-0x42").expect(-0x42)
        }
    }
}

Asynchronous Recipe

Defining a recipe with an asynchronous completion is also supported.

let recipe = Recipe<String, Int>(async: { input, complete in
    myComplexAndSlowParse(input) { (result: Int?, error: Error?) in
        complete(result, error)
    }
})

Since Swift 5.5, you can use AsyncRecipe to define asynchronous recipes with async/await syntax:

let recipe = AsyncRecipe<String, Int> { input in
    try await myComplexAndSlowParse(input)
}

Note

Note

When an error is thrown in the sync initalizer or the completion handler is called with an error, the test case is considered as failed for now. Testing errors will be supported in the future.

Examples

License

MIT. See LICENSE.

GitHub

link
Stars: 27
Last commit: 1 week ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

0.4.0
44 weeks ago
  • Drop support for Swift 4

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics