swift-testing-revolutionary converts test cases written in XCTest to swift-testing

This tool provides three ways to use. As an Xcode Plugin, as a Command Plugin, or as a command line tool.

In default, all test files will be overwritten unless you passed --dry-run flag. Please make sure to backup your test files before running this tool.

For Xcode project, it's better to use as a Xcode plugin.

• File > Swift Packages > Add Package Dependency
• Add https://github.com/giginet/swift-testing-revolutionary.git Select "Up to Next Major" with "0.1.0"

For Swift packages, it's better to use as a package plugin.

let package = Package(
    name: "MyPackage",
    dependencies: [
        .package(url: "https://github.com/giginet/swift-testing-revolutionary", from: "0.1.0"),
    ]
)

You can pass the directories or files you want to convert.

$ swift package plugin --allow-writing-to-package-directory swift-testing-revolutionary Tests/ MyTests1.swift MyTests2.swift

Install this tool and run it from the command line.

$ swift-testing-revolutionary path/to/Tests

$ mint install giginet/swift-testing-revolutionary 

$ git clone https://github.com/giginet/swift-testing-revolutionary
$ cd swift-testing-revolutionary
$ swift package experimental-install

Download swift-testing-revolutionary.artifactbundle.zip from Releases and unzip it.

You can pass some options to the command.

In the default, all test classes would be converted to structs.

// Before
final class MyModelTests: XCTestCase { }

// After
@Suite struct MyModelTests { } // Enabled (Default)
@Suite final class MyModelTests { } // Disabled

If the test case contains tearDown method. This tool always converts them to de-initializers. However, deinit can't be defined in the struct so this option should be passed for such cases.

In the default, all test methods would be stripped test prefix.

// Before
func testProperty() { }

// After
@Test func property() { } // Enabled (Default)
@Test func testProperty() { } // Disabled

In the default, all test classes would be annotated with @Suite.

// Before
final class MyModelTests: XCTestCase { }

// After
@Suite struct MyModelTests { } // Enabled (Default)
struct MyModelTests { } // Disabled

See this article in swift-testing documentation.

Migrating a test from XCTest | Documentation

Currently, this tool supports following conversions referred above documentation.

• Import statements of XCTest (import XCTest)
• Test classes to structs (final class XXXTests: XCTestCase)
• Setup and teardown functions (setUp, tearDown)
• Test methods func testXXX()
• Assertion functions (XCTAssert~)
• Check for optional values (XCTUnwrap)
• Record Issues (XCTFail)
• Continue or halt after test failures (continueAfterFailure)
• Validate asynchronous behaviors (XCTExpectation)
• Control whether a test runs (XCTSkipIf, XCTSkipUnless)
• Annotate known issues (XCTExpectFailure)

Unsupported features have to be converted manually.

MIT License