Connect with us


Nimble – A Matcher Framework for Swift and Objective-C

Use Nimble to express the expected outcomes of Swift or Objective-C expressions. Inspired by Cedar.

// Swift
expect(1 + 1).to(equal(2))
expect(1.2).to(beCloseTo(1.1, within: 0.1))
expect(3) > 2
expect(["Atlantic", "Pacific"]).toNot(contain("Mississippi"))

Some Background: Expressing Outcomes Using Assertions in XCTest

Apple’s Xcode includes the XCTest framework, which provides assertion macros to test whether code behaves properly. For example, to assert that 1 + 1 = 2, XCTest has you write:

// Swift

XCTAssertEqual(1 + 1, 2, "expected one plus one to equal two")

Or, in Objective-C:

// Objective-C

XCTAssertEqual(1 + 1, 2, @"expected one plus one to equal two");

XCTest assertions have a couple of drawbacks:

  1. Not enough macros. There’s no easy way to assert that a string contains a particular substring, or that a number is less than or equal to another.
  2. It’s hard to write asynchronous tests. XCTest forces you to write a lot of boilerplate code.

Nimble addresses these concerns.

Nimble on GitHub:
Platform: iOS
⭐️: 4.7K