Special Executive for Command-line Test Running and Execution.
A behavior-driven development (BDD) framework and test runner for Swift projects and playgrounds. It's compatible with both OS X and Linux.
describe("a person") {
let person = Person(name: "Kyle")
$0.it("has a name") {
try expect(person.name) == "Kyle"
}
$0.it("returns the name as description") {
try expect(person.description) == "Kyle"
}
}Spectre currently has two built-in reporters, Standard and the Dot reporter.
Custom reporters are supported, make a type that conforms to Reporter.
- Standard
- Dot Reporter (
-t) - Tap Reporter (
--tap)- Test Anything Protocol-compatible output
The default reporter can be configured via an environment variable. For example:
$ env SPECTRE_REPORTER=dot swift test
$ env SPECTRE_REPORTER=tap swift testThe standard reporter produces output as follows:
Using the -t argument, you can use the dot reporter.
try expect(name) == "Kyle"
try expect(name) != "Kyle"try expect(alive).to.beTrue()
try expect(alive).to.beFalse()
try expect(alive).to.beNil()try expect(try write()).toThrow()
try expect(try write()).toThrow(FileError.NoPermission)try expect(5) > 2
try expect(5) >= 2
try expect(5) < 10
try expect(5) <= 10try expect("kyle").to.beOfType(String.self)throw failure("Everything is broken.")You can easily provide your own assertions, you just need to throw a failure when the assertion does not meet expectaions.
The following projects use Spectre:
Check out Commander as an example.
You can use Spectre in an Xcode Playground, open Spectre.playground in
this repository, failures are printed in the console.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent