What's New




  • Adds Matchers for Result that match against submatchers or equatable values.
  • Use DocC for documentation.
  • Make PollingDefaults threadsafe.

What's Changed

  • Make PollingDefaults threadsafe by @younata in #1122
  • Bump softprops/action-gh-release from 1 to 2 by @dependabot in #1128
  • Depend on CwlPreconditionTesting 2.2.0 for Cocoapods by @younata in #1129
  • Add matchers for Result that match against submatchers, or for equatable values. by @younata in #1134
  • Use docc for documentation, instead of having it all in a single, giant README. by @younata in #1135
  • Get documentation deploying working. by @younata in #1136
  • Improve documentation articles by adding short abstracts to them. by @younata in #1137
  • Fix a typo in the name of this framework. 🤦🏻‍♀️ by @younata in #1138
  • Bump actions/checkout from 3 to 4 by @dependabot in #1139

Full Changelog: v13.2.1...v13.3.0


Build Status CocoaPods Carthage Compatible Platforms

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"))


Nimble's documentation is now lives in Sources/Nimble/Nimble.docc as a Documentation Catalog. You can easily browse it quick.github.io/Nimble.

Installing Nimble

Nimble can be used on its own, or in conjunction with its sister project, Quick. To install both Quick and Nimble, follow the installation instructions in the Quick Documentation.

Nimble can currently be installed in one of four ways: Swift Package Manager, CocoaPods, Carthage or with git submodules.

Swift Package Manager


To install Nimble via Xcode's Swift Package Manager Integration: Select your project configuration, then the project tab, then the Package Dependencies tab. Click on the "plus" button at the bottom of the list, then follow the wizard to add Quick to your project. Specify https://github.com/Quick/Nimble.git as the url, and be sure to add Nimble as a dependency of your unit test target, not your app target.


To use Nimble with Swift Package Manager to test your applications, add Nimble to your Package.Swift and link it with your test target:

// swift-tools-version:5.7

import PackageDescription

let package = Package(
    name: "MyAwesomeLibrary",
    products: [
        // ...
    dependencies: [
        // ...
        .package(url:  "https://github.com/Quick/Nimble.git", from: "13.0.0"),
    targets: [
        // Targets are the basic building blocks of a package. A target can define a module or a test suite.
        // Targets can depend on other targets in this package, and on products in packages this package depends on.
            name: "MyAwesomeLibrary",
            dependencies: ...),
            name: "MyAwesomeLibraryTests",
            dependencies: ["MyAwesomeLibrary", "Nimble"]),

Please note that if you install Nimble using Swift Package Manager, then raiseException is not available.


To use Nimble in CocoaPods to test your macOS, iOS, tvOS or watchOS applications, add Nimble to your podfile and add the use_frameworks! line to enable Swift support for CocoaPods.

platform :ios, '13.0'

source 'https://github.com/CocoaPods/Specs.git'

# Whatever pods you need for your app go here

target 'YOUR_APP_NAME_HERE_Tests', :exclusive => true do
  pod 'Nimble'

Finally run pod install.


To use Nimble in Carthage to test your macOS, iOS, tvOS or watchOS applications, add Nimble to your Cartfile.private:

github "Quick/Nimble" ~> 13.2

Then follow the rest of the Carthage Quick Start and link Nimble with your unit tests.

Git Submodules

To use Nimble as a submodule to test your macOS, iOS or tvOS applications, follow these 4 easy steps:

  1. Clone the Nimble repository
  2. Add Nimble.xcodeproj to the Xcode workspace for your project
  3. Link Nimble.framework to your test target
  4. Start writing expectations!

For more detailed instructions on each of these steps, read How to Install Quick. Ignore the steps involving adding Quick to your project in order to install just Nimble.

Privacy Statement

Nimble is a library that is only used for testing and should never be included in the binary submitted to App Store Connect.

Despite not being shipped to Apple, Nimble does not and will never collect any kind of analytics or tracking.


  • Swift Tools 5.9.0
View More Packages from this Author


Last updated: Thu May 30 2024 01:41:25 GMT-0900 (Hawaii-Aleutian Daylight Time)