The XCTest Project, A Swift core library for providing unit test support

Subscribe to updates I use swift-corelibs-xctest

Statistics on swift-corelibs-xctest

Number of watchers on Github 633
Number of open issues 5
Main language Swift
Average time to merge a PR 2 days
Open pull requests 29+
Closed pull requests 14+
Last commit 11 months ago
Repo Created about 3 years ago
Repo Last Updated 11 months ago
Size 595 KB
Homepage swift.org
Organization / Authorapple
Page Updated
Do you use swift-corelibs-xctest? Leave a review!
View open issues (5)
View swift-corelibs-xctest activity
View on github
Fresh, new opensource launches πŸš€πŸš€πŸš€
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating swift-corelibs-xctest for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


The XCTest library is designed to provide a common framework for writing unit tests in Swift, for Swift packages and applications.

This version of XCTest uses the same API as the XCTest you are familiar with from Xcode. Our goal is to enable your project's tests to run on all Swift platforms without having to rewrite them.

Current Status and Project Goals

This project is in the very earliest stages of development. It is scheduled to be part of the Swift 3 release.

Only the most basic functionality is currently present. This year, we have the following goals for the project:

  • Finish implementing support for the most important non-UI testing APIs present in XCTest for Xcode.
  • Develop an effective solution to the problem of test discoverability without the Objective-C runtime.
  • Provide support for efforts to standardize test functionality across the Swift stack.

For more details, visit the Documentation directory.

Using XCTest

Your tests are organized into a simple hierarchy. Each XCTestCase subclass has a set of test methods, each of which should test one part of your code.

You can find all kinds of useful information on using XCTest in Apple's documentation.

Contributing to XCTest

To contribute, you'll need to be able to build this project and and run its test suite. The easiest way to do so is via the Swift build script.

First, follow the instructions in the Swift README to build Swift from source. Confirm you're able to build the Swift project using utils/build-script -R.

Once you are able to build the Swift project, build XCTest and run its tests:

$ cd swift-corelibs-xctest
$ ../swift/utils/build-script --preset corelibs-xctest

This project is only guaranteed to build with the very latest commit on the Swift and swift-corelibs-foundation master branches. You may update to the latest commits using the Swift utils/update-checkout script:

$ ../swift/utils/update-checkout

Using Xcode

To browse files in this project using Xcode, use XCTest.xcworkspace. You may build the project using the SwiftXCTest scheme. Run the SwiftXCTestFunctionalTests scheme to run the tests.

However, in order to successfully build the project in Xcode, you must use an Xcode toolchain with an extremely recent version of Swift. The Swift website provides Xcode toolchains to download, as well as instructions on how to use Xcode with those toolchains. Swift development moves fairly quickly, and so even a week-old toolchain may no longer work.

If none of the toolchains available to download are recent enough to build XCTest, you may build your own toolchain by using the utils/build-toolchain script in the Swift repository.

Keep in mind that the build script invocation in Contributing to XCTest above will always work, regardless of which Swift toolchains you have installed. The Xcode workspace exists simply for the convenience of contributors. It is not necessary to successfully build this project in Xcode in order to contribute.

swift-corelibs-xctest open pull requests (View All Pulls)
  • [XCTAssert] s/__FILE__/#file/g, s/__LINE__/#line/g
  • [RFC] Asynchronous testing API
  • [SR-460] Provide XCTestCase a class to allow overriding setUp() and tearDown()
  • Osx build script
  • Add Unit Testing Infrastructure
  • Migrating to Swift 3
  • [XCTestObservation] Add XCTestSuite announcements
  • General Code Overhaul
  • [README] Encourage using the Swift build script
  • [Tests] Inline expectations and substitute [[@LINE]] numbers
  • [XCTestExpectation] Adding expectationForPredicate constructor
  • Use Linux Glibc and Foundation on Android
  • Disable implicit dependency finding and parallelized builds for Xcode schemes
  • [SR-1417] Add non-optional overloads of XCTAssertEqual and XCTAssertN…
  • Separate public-facing and library-private source files
  • Remove deprecated build script flags.
  • NSBundles changes to rename mainBundle to main
  • [WIP] Update for Swift-3 renaming.
  • [SE-0025] Adapt accessibility for `fileprivate`
  • [SR-1901] Remove workarounds for private symbols
  • [Asynchronous] Move into separate directory
  • Print to stderr, not stdout
  • remove trailing period after "N seconds"
  • Add watchOS, tvOS, iOS platforms support
  • Build a static library version of xctest
  • Fix XCTAssertThrowsError function signature
  • [Highly WIP] Add CMake support
  • [SR-906] Allow continueAfterFailure to be set
  • SR-2100 - Add support for multi-lib systems
swift-corelibs-xctest list of languages used
Other projects in Swift