How do I run only one test in XCTest from the command line?

Use command-line arguments like `./YourTests Tests.TestCaseName/testMethodName` to run a single test method, as shown in the README. This works with standalone executables or via SwiftPM's test runner options.

XCTest or Quick for Swift unit testing?

XCTest is better for cross-platform consistency and integration with Swift tools, while Quick offers a BDD-style syntax and more expressive matchers. Choose XCTest if you need Apple's standard API or are targeting multiple platforms without rewriting tests.

What features are missing in swift-corelibs-xctest compared to Xcode's XCTest?

It implements most APIs from Xcode 7+, but may lack newer Xcode-specific features like UI testing APIs or certain performance testing tools. Check Apple's documentation for gaps, as the README notes it doesn't cover all APIs.

How to set up XCTest for standalone usage without Swift Package Manager?

Create an executable linking libXCTest.so, and in main.swift, call XCTMain with an array of test cases wrapped by testCase, as detailed in the README. This allows custom test runners but requires manual setup.

Can I use XCTest on Linux or Windows?

Yes, XCTest supports all platforms Swift runs on, including Linux and Windows, enabling cross-platform testing without code changes. Ensure you have the latest Swift toolchain installed for compatibility.

How to list all tests in an XCTest suite?

Use the --list-tests or --dump-tests-json command-line arguments with your test executable, as shown in the README, to output all available tests in a human-readable or JSON format.

Open-Awesome

swift-corelibs-xctest

Apache-2.0Swiftswift-6.1.1-RELEASE

A Swift core library providing unit test support for Swift packages and applications across all Swift-supported platforms.

Visit Website GitHub

1.2k stars276 forks0 contributors

What is swift-corelibs-xctest?

XCTest is a Swift core library that provides a comprehensive framework for writing and running unit tests in Swift. It enables developers to create tests for Swift packages and applications that can run consistently across all platforms supported by Swift, eliminating the need to rewrite tests for different environments. The library implements most of the testing APIs available in Xcode's XCTest framework.

Target Audience

Swift developers building packages or applications who need reliable, cross-platform unit testing capabilities, particularly those working outside of Xcode or targeting multiple Swift-supported platforms.

Value Proposition

Developers choose XCTest because it provides the familiar XCTest API experience while enabling true cross-platform testing without vendor lock-in to Xcode. It integrates seamlessly with Swift Package Manager and can be used in standalone command-line environments.

Overview

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

Use Cases

Best For

Writing unit tests for Swift packages that need to run on multiple platforms
Testing Swift applications outside of Xcode development environments
Integrating Swift testing into CI/CD pipelines across different operating systems
Maintaining a single test suite for cross-platform Swift projects
Using Swift Package Manager for test execution and management
Creating custom test runners and tooling around Swift tests

Not Ideal For

Projects requiring Xcode-specific testing features not implemented in this version (e.g., certain UI or performance testing APIs)
Teams needing quick test runner setup without manual executable creation and XCTMain invocation
Environments dependent on GUI-based test execution or tight IDE integration (e.g., Xcode's test navigator)
Legacy systems using older Swift versions incompatible with the required recent toolchains

Pros & Cons

Pros

Cross-Platform Consistency

Enables running the same unit tests on all Swift-supported platforms without modification, as stated in the README's goal, enhancing code portability.

SwiftPM Integration

Seamlessly integrates with Swift Package Manager via the `swift test` command, simplifying test execution for packages by locating tests in the `Tests` subdirectory.

Comprehensive API Coverage

Implements most XCTest APIs from Xcode 7 and later, reducing the learning curve for developers familiar with Xcode's testing framework.

Flexible Test Selection

Supports command-line arguments to run specific tests or list available tests, as shown in the README examples, aiding in debugging and CI workflows.

Cons

Incomplete API Coverage

The README admits it implements only the 'majority' of XCTest APIs from Xcode, missing some advanced or niche features that may be needed for specific test scenarios.

Manual Standalone Setup

Requires creating custom executables and manually invoking XCTMain for use without SwiftPM, adding complexity compared to integrated solutions like Xcode.

Toolchain Dependency

Building and contributing requires extremely recent Swift toolchains, as per the README, which can be a barrier due to frequent updates and potential compatibility issues.

Frequently Asked Questions

Related Projects

Quick

The Swift (and Objective-C) testing framework.

Stars9,825

Forks897

Last commit3 months ago

OHHTTPStubs

Stub your network requests easily! Test your apps with fake network data and custom response time, response code and headers!

Stars5,071

Forks597

Last commit2 years ago

Nimble

A Matcher Framework for Swift and Objective-C

Stars4,838

Forks608

Last commit4 months ago

Kiwi

Simple BDD for iOS

Stars4,109

Forks502

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub