commit | 2e41263c38ef81340a04edd3d73450b198769959 | [log] [tgz] |
---|---|---|
author | Tony Parker <anthony.parker@apple.com> | Fri Nov 20 12:47:03 2015 -0800 |
committer | Tony Parker <anthony.parker@apple.com> | Fri Nov 20 12:49:27 2015 -0800 |
tree | 018ccd20fa08263fdc324614719419a6c8dccb58 | |
parent | 8b8156bd282a30b9ae48bb6c9732bf905586fcc8 [diff] |
Add a new public function to invoke a list of tests. This new function will call exit() with the correct value, depending on the result of the test run.
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.
This project is 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. In the next year, we have the following goals for the project:
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 documenation.
The rest of this document will focus on how this version of XCTest differs from the one shipped with Xcode.
When running on the Objective-C runtime, XCTest is able to find all of your tests by simply asking the runtime for the subclasses of XCTestCase
. It then finds the methods that start with the string test
. This functionality is not currently present when running on the Swift runtime. Therefore, you must currently provide an additional property called allTests
in your XCTestCase
subclass. This method lists all of the tests in the test class. The rest of your test case subclass still contains your test methods.
class TestNSURL : XCTestCase { var allTests : [(String, () -> ())] { return [ ("test_URLStrings", test_URLStrings), ("test_fileURLWithPath_relativeToURL", test_fileURLWithPath_relativeToURL ), ("test_fileURLWithPath", test_fileURLWithPath), ("test_fileURLWithPath_isDirectory", test_fileURLWithPath_isDirectory), // Other tests go here ] } func test_fileURLWithPath_relativeToURL() { // Write your test here. Most of the XCTAssert macros you are familiar with are available. XCTAssertTrue(theBestNumber == 42, "The number is wrong") } // Other tests go here }
Also, this version of XCTest does not use the external test runner binary. Instead, create your own executable which links libXCTest.so
. In your main.swift
, invoke the XCTMain
function with a test cases that you wish to run. For example:
XCTMain([TestNSString, TestNSArray, TestNSDictionary])
The XCTMain
function does not return, and will cause your test app to exit with either 0
for success or 1
for failure.
We are currently investigating ideas on how to make these additional steps for test discovery automatic when running on the Swift runtime.