A Mac and iOS Playgrounds Unit Testing library based on Nimble.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Added issue/pr templates Feb 26, 2017
Playgrounds Updated project to use colors vs bools for return values -- improving… Feb 25, 2017
Screenshots Updated screnshots Feb 25, 2017
Spry.xcodeproj Added fastlane for running tests from command line Feb 24, 2017
Tests Updated project to use colors vs bools for return values -- improving… Feb 25, 2017
fastlane Added fastfile to the project Feb 24, 2017
.gitignore Updated gitignore Feb 24, 2017
.travis.yml UPdated travis Feb 25, 2017
CONTRIBUTING.md Removed some references to the process for Nimble Feb 26, 2017
LICENSE Added Quick's Apache license Feb 26, 2017


Travis Platforms Xcode Playgrounds iPad Playgrounds License


Spry is a Swift Playgrounds Unit Testing library based on Nimble.

The best thing about Spry is that the API matches Nimble perfectly. Which means once you've created your code and tests in a Playground, you can copy them directly into your Xcode project without needing to (re)write them again :)

Nimble: The code in this library has been copied directly from the Nimble project. However it is currently a stripped down version.


There are a couple of ways you can download Spry.


You can download a Playground including the latest version of Spry. Consider this a boilerplate template. It includes Spry in the Sources folder of the Playground, so you can simply start writing tests alongside your code in the Playground.

iPad Playgrounds
Xcode Playgrounds


You can also download or checkout this repo and simply copy the files into your existing Playground manually. Simply copy the entire Spry folder into your Playground's Sources folder. Easy Peasy!


Spry is a stripped down (Lite) version of Nimble that includes a subset of Nimble's Matchers.

Note: This is a port of Nimble only, since Quick doesn't really make sense in the context of a Playground.

The following features are NOT supported (since they are a part of Quick):


The following features are already implemented:

  • expect
  • to
  • beAKindOf
  • beAnInstanceOf
  • beCloseTo
  • beEmpty
  • beginWith
  • beGreaterThan
  • beGreaterThanOrEqualTo
  • beIdenticalTo
  • beLessThan
  • beLessThanOrEqualTo
  • beLogical
  • beNil
  • beVoid
  • containElementSatisfying
  • contain
  • endWith
  • equal
  • haveCount
  • match
  • satisfyAnyOf

The following features are not yet implemented:

  • toEventually
  • async
  • matchError
  • throwError
  • failWithMessage


Using Spry is as simple as writing an expect case:

func add<T: ExpressibleByIntegerLiteral>(_ x: T, _ y: T) -> T {
    return x + y

// Spry test case
expect(add(4, 5)).to(equal(9))

If you're already familiar with Nimble, then you already know how to use Spry.

For full details on how to write your tests with Spry, I suggest reading over the Nimble docs. Keeping in mind that not all features are currently included.