Revert "Deploy 0.2.0"

This reverts commit f7a4aa4.

Author: grynspan

Package.swift

@@ -64,7 +64,15 @@ let package = Package(
         .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
         .product(name: "SwiftCompilerPlugin", package: "swift-syntax"),
       ],
-      swiftSettings: .packageSettings
+      swiftSettings: .packageSettings + [
+        // The only target which needs the ability to import this macro
+        // implementation target's module is its unit test target. Users of the
+        // macros this target implements use them via their declarations in the
+        // Testing module. This target's module is never distributed to users,
+        // but as an additional guard against accidental misuse, this specifies
+        // the unit test target as the only allowable client.
+        .unsafeFlags(["-Xfrontend", "-allowable-client", "-Xfrontend", "TestingMacrosTests"]),
+      ]
     ),
 
     // "Support" targets: These contain C family code and are used exclusively
@@ -109,6 +117,17 @@ extension Array where Element == PackageDescription.SwiftSetting {
   /// Analogous to project-level build settings in an Xcode project.
   static var packageSettings: Self {
     [
+      .unsafeFlags([
+        "-require-explicit-sendable",
+
+        "-Xfrontend", "-define-availability", "-Xfrontend", "_mangledTypeNameAPI:macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0",
+        "-Xfrontend", "-define-availability", "-Xfrontend", "_backtraceAsyncAPI:macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0",
+        "-Xfrontend", "-define-availability", "-Xfrontend", "_clockAPI:macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0",
+        "-Xfrontend", "-define-availability", "-Xfrontend", "_regexAPI:macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0",
+        "-Xfrontend", "-define-availability", "-Xfrontend", "_swiftVersionAPI:macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0",
+
+        "-Xfrontend", "-define-availability", "-Xfrontend", "_distantFuture:macOS 99.0, iOS 99.0, watchOS 99.0, tvOS 99.0",
+      ]),
       .enableExperimentalFeature("StrictConcurrency"),
       .enableUpcomingFeature("ExistentialAny"),
 

Sources/Testing/Events/Clock.swift

@@ -59,7 +59,7 @@ extension Test {
 // MARK: -
 
 @_spi(ExperimentalEventHandling)
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension SuspendingClock.Instant {
   /// Initialize this instant to the equivalent of the same instant on the
   /// testing library's clock.
@@ -89,7 +89,7 @@ extension Test.Clock.Instant {
   /// The value of this property is the equivalent of `self` on the wall clock.
   /// It is suitable for display to the user, but not for fine timing
   /// calculations.
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   public var durationSince1970: Duration {
     Duration(wall)
   }
@@ -126,7 +126,7 @@ extension Test.Clock {
   /// This function is not part of the public interface of the testing library.
   /// It is primarily used by the testing library's own tests. External clients
   /// can use ``sleep(for:tolerance:)`` or ``sleep(until:tolerance:)`` instead.
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   static func sleep(for duration: Duration) async throws {
 #if SWT_NO_UNSTRUCTURED_TASKS
     let timeValue = TimeValue(duration)
@@ -145,7 +145,7 @@ extension Test.Clock {
 // MARK: - Clock
 
 @_spi(ExperimentalEventHandling)
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension Test.Clock: _Concurrency.Clock {
   public typealias Duration = SuspendingClock.Duration
 
@@ -193,7 +193,7 @@ extension Test.Clock.Instant: Equatable, Hashable, Comparable {
 // MARK: - InstantProtocol
 
 @_spi(ExperimentalEventHandling)
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension Test.Clock.Instant: InstantProtocol {
   public typealias Duration = Swift.Duration
 

Sources/Testing/Events/TimeValue.swift

@@ -45,12 +45,12 @@ struct TimeValue: Sendable {
     self.init((Int64(timespec.tv_sec), Int64(timespec.tv_nsec) * 1_000_000_000))
   }
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   init(_ duration: Duration) {
     self.init(duration.components)
   }
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   init(_ instant: SuspendingClock.Instant) {
     self.init(unsafeBitCast(instant, to: Duration.self))
   }
@@ -93,14 +93,14 @@ extension TimeValue: CustomStringConvertible {
 
 // MARK: -
 
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension Duration {
   init(_ timeValue: TimeValue) {
     self.init(secondsComponent: timeValue.seconds, attosecondsComponent: timeValue.attoseconds)
   }
 }
 
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension SuspendingClock.Instant {
   init(_ timeValue: TimeValue) {
     self = unsafeBitCast(Duration(timeValue), to: SuspendingClock.Instant.self)

Sources/Testing/Expectations/ExpectationChecking+Macro.swift

@@ -785,7 +785,7 @@ public func __checkClosureCall<R>(
 private func _description(of error: some Error) -> String {
   let errorDescription = "\"\(error)\""
   let errorType = type(of: error as Any)
-  if #available(macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0, *) {
+  if #available(_regexAPI, *) {
     if errorDescription.contains(String(describing: errorType)) {
       return errorDescription
     }

Sources/Testing/Running/Configuration.swift

@@ -42,7 +42,7 @@ public struct Configuration: Sendable {
   ///
   /// To determine the actual time limit that applies to an instance of
   /// ``Test`` at runtime, use ``Test/adjustedTimeLimit(configuration:)``.
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   public var defaultTestTimeLimit: Duration? {
     get {
       _defaultTestTimeLimit as? Duration
@@ -64,7 +64,7 @@ public struct Configuration: Sendable {
   ///
   /// To determine the actual time limit that applies to an instance of
   /// ``Test`` at runtime, use ``Test/adjustedTimeLimit(configuration:)``.
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   public var maximumTestTimeLimit: Duration? {
     get {
       _maximumTestTimeLimit as? Duration
@@ -82,7 +82,7 @@ public struct Configuration: Sendable {
   /// By default, test time limit granularity is limited to intervals of one
   /// minute (60 seconds.) If finer or coarser granularity is required, the
   /// value of this property can be adjusted.
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   public var testTimeLimitGranularity: Duration {
     get {
       (_testTimeLimitGranularity as? Duration) ?? .seconds(60)

Sources/Testing/Running/EntryPoint.swift

@@ -172,7 +172,7 @@ func configurationForSwiftPMEntryPoint(withArguments args: [String]) throws -> C
   // constructed solely from a string, they are safe to send across isolation
   // boundaries.
   var filters = [Configuration.TestFilter]()
-  if #available(macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0, *) {
+  if #available(_regexAPI, *) {
     if let filterArgIndex = args.firstIndex(of: "--filter"), filterArgIndex < args.endIndex {
       let filterArg = args[args.index(after: filterArgIndex)]
 

Sources/Testing/SourceAttribution/Backtrace.swift

@@ -63,7 +63,7 @@ public struct Backtrace: Sendable {
     let addresses = [UnsafeRawPointer?](unsafeUninitializedCapacity: addressCount) { addresses, initializedCount in
       addresses.withMemoryRebound(to: UnsafeMutableRawPointer?.self) { addresses in
 #if SWT_TARGET_OS_APPLE
-        if #available(macOS 12.0, iOS 15.0, watchOS 8.0, tvOS 15.0, *) {
+        if #available(_backtraceAsyncAPI, *) {
           initializedCount = backtrace_async(addresses.baseAddress!, addresses.count, nil)
         } else {
           initializedCount = .init(backtrace(addresses.baseAddress!, .init(addresses.count)))

Sources/Testing/SourceAttribution/CustomTestStringConvertible.swift

@@ -107,13 +107,13 @@ extension String {
       self.init(describing: value)
     } else if let value = value as? any CustomDebugStringConvertible {
       self.init(reflecting: value)
-    } else if #available(macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0, *), let value = value as? any RawRepresentable, isImportedFromC(valueType) {
+    } else if #available(_mangledTypeNameAPI, *), let value = value as? any RawRepresentable, isImportedFromC(valueType) {
       // Present raw-representable C types, which we assume to be imported
       // enumerations, in a consistent fashion. The case names of C enumerations
       // are not statically visible, so instead present the enumeration type's
       // name along with the raw value of `value`.
       self = "\(valueType)(rawValue: \(String(describingForTest: value.rawValue)))"
-    } else if #available(macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0, *), isSwiftEnumeration(valueType) {
+    } else if #available(_mangledTypeNameAPI, *), isSwiftEnumeration(valueType) {
       // Add a leading period to enumeration cases to more closely match their
       // source representation. SEE: _adHocPrint_unlocked() in the stdlib.
       self = ".\(value)"

Sources/Testing/Support/Additions/TypeAdditions.swift

@@ -34,7 +34,7 @@ func nameComponents(of type: Any.Type) -> [String] {
 /// - Bug: We use the internal Swift standard library function
 ///   `_mangledTypeName()` to derive this information. We should use supported
 ///   API instead. ([swift-#69147](https://github.com/apple/swift/issues/69147))
-@available(macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0, *)
+@available(_mangledTypeNameAPI, *)
 func isSwiftEnumeration(_ type: Any.Type) -> Bool {
   guard let mangledTypeName = _mangledTypeName(type), let lastCharacter = mangledTypeName.last else {
     return false
@@ -58,7 +58,7 @@ func isSwiftEnumeration(_ type: Any.Type) -> Bool {
 /// - Bug: We use the internal Swift standard library function
 ///   `_mangledTypeName()` to derive this information. We should use supported
 ///   API instead. ([swift-#69146](https://github.com/apple/swift/issues/69146))
-@available(macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0, *)
+@available(_mangledTypeNameAPI, *)
 func isImportedFromC(_ type: Any.Type) -> Bool {
   guard let mangledTypeName = _mangledTypeName(type), mangledTypeName.count > 2 else {
     return false

Sources/Testing/Support/Versions.swift

@@ -142,7 +142,7 @@ var testingLibraryVersion: String {
 ///
 /// This value is not part of the public interface of the testing library.
 let swiftStandardLibraryVersion: String = {
-  if #available(macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0, *) {
+  if #available(_swiftVersionAPI, *) {
     return String(describing: _SwiftStdlibVersion.current)
   }
   return "unknown"

Sources/Testing/Testing.docc/TemporaryGettingStarted.md

@@ -41,7 +41,7 @@ In your package's Package.swift file, add the testing library as a dependency:
 
 ```swift
 dependencies: [
-  .package(url: "https://github.com/apple/swift-testing.git", from: "0.2.0"),
+  .package(url: "https://github.com/apple/swift-testing.git", branch: "main"),
 ],
 ```
 

Sources/Testing/Traits/TimeLimitTrait.swift

@@ -13,7 +13,7 @@
 /// To add this trait to a test, use one of the following functions:
 ///
 /// - ``Trait/timeLimit(_:)``
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 public struct TimeLimitTrait: TestTrait, SuiteTrait {
   /// The maximum amount of time a test may run for before timing out.
   public var timeLimit: Duration
@@ -29,7 +29,7 @@ public struct TimeLimitTrait: TestTrait, SuiteTrait {
 
 // MARK: -
 
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension Trait where Self == TimeLimitTrait {
   /// Construct a time limit trait that causes a test to time out if it runs for
   /// too long.
@@ -55,7 +55,7 @@ extension Trait where Self == TimeLimitTrait {
 
 // MARK: -
 
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 extension Test {
   /// The maximum amount of time the cases of this test may run for.
   ///
@@ -123,7 +123,7 @@ extension Test {
 /// and `body` is cancelled.
 ///
 /// This function is not part of the public interface of the testing library.
-@available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+@available(_clockAPI, *)
 func withTimeLimit(
   _ timeLimit: Duration,
   _ body: @escaping @Sendable () async throws -> Void,
@@ -170,7 +170,7 @@ func withTimeLimit(
   _ body: @escaping @Sendable () async throws -> Void,
   timeoutHandler: @escaping @Sendable (_ timeLimit: (seconds: Int64, attoseconds: Int64)) -> Void
 ) async throws {
-  if #available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *),
+  if #available(_clockAPI, *),
      let timeLimit = test.adjustedTimeLimit(configuration: configuration) {
 #if SWT_NO_UNSTRUCTURED_TASKS
     // This environment may not support full concurrency, so check if the body

Tests/TestingTests/ClockTests.swift

@@ -16,7 +16,7 @@ private import TestingInternals
 
 @Suite("Clock API Tests")
 struct ClockTests {
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.Instant basics")
   func clockInstant() async throws {
     let instant1 = Test.Clock.Instant.now
@@ -46,7 +46,7 @@ struct ClockTests {
 #endif
   }
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Creating a SuspendingClock.Instant from Test.Clock.Instant")
   func suspendingInstantInitializer() async throws {
     let instant1 = SuspendingClock.Instant(Test.Clock.Instant.now)
@@ -56,7 +56,7 @@ struct ClockTests {
     #expect(instant1 < instant2)
   }
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.sleep(until:tolerance:) method")
   func sleepUntilTolerance() async throws {
     let instant1 = SuspendingClock.Instant(Test.Clock.Instant.now)
@@ -67,7 +67,7 @@ struct ClockTests {
   }
 
 #if !SWT_NO_UTC_CLOCK
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.Instant.timeComponentsSince1970 property")
   func timeComponentsSince1970() async throws {
     let instant1 = Test.Clock.Instant.now.timeComponentsSince1970
@@ -79,7 +79,7 @@ struct ClockTests {
 #endif
 
 #if !SWT_NO_UTC_CLOCK
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.Instant.durationSince1970 property")
   func durationSince1970() async throws {
     let instant1 = Test.Clock.Instant.now.durationSince1970
@@ -90,7 +90,7 @@ struct ClockTests {
   }
 #endif
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.now property")
   func clockNowProperty() async throws {
     let instant1 = Test.Clock().now
@@ -100,14 +100,14 @@ struct ClockTests {
     #expect(instant1 < instant2)
   }
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.minimumResolution property")
   func clockMinimumResolutionProperty() async throws {
     let minimumResolution = Test.Clock().minimumResolution
     #expect(minimumResolution == SuspendingClock().minimumResolution)
   }
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.Instant.advanced(by:) and .duration(to:) methods")
   func instantAdvancedByAndDurationTo() async throws {
     let offsetNanoseconds = Int64.random(in: -1_000_000_000 ..< 1_000_000_000)
@@ -124,7 +124,7 @@ struct ClockTests {
   }
 
 #if canImport(Foundation)
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Codable")
   func codable() async throws {
     let now = Test.Clock.Instant()
@@ -137,7 +137,7 @@ struct ClockTests {
   }
 #endif
 
-  @available(macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0, *)
+  @available(_clockAPI, *)
   @Test("Clock.Instant.nanoseconds(until:) method",
     arguments: [
       (Duration.zero, 0),

Tests/TestingTests/EventRecorderTests.swift

@@ -90,7 +90,7 @@ struct EventRecorderTests {
   }
 
 #if !os(Windows)
-  @available(macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0, *)
+  @available(_regexAPI, *)
   @Test(
     "Issue counts are summed correctly on test end",
     arguments: [
@@ -140,7 +140,7 @@ struct EventRecorderTests {
   }
 #endif
 
-  @available(macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0, *)
+  @available(_regexAPI, *)
   @Test("Issue counts are omitted on a successful test")
   func issueCountOmittedForPassingTest() async throws {
     let stream = Stream()
@@ -163,7 +163,7 @@ struct EventRecorderTests {
   }
 
 #if !os(Windows)
-  @available(macOS 13.0, iOS 16.0, tvOS 16.0, watchOS 9.0, *)
+  @available(_regexAPI, *)
   @Test("Issue counts are summed correctly on run end")
   func issueCountSummingAtRunEnd() async throws {
     let stream = Stream()

Tests/TestingTests/IssueTests.swift

@@ -1141,7 +1141,7 @@ final class IssueTests: XCTestCase {
   }
 
   func testEnumDescription() async throws {
-    guard #available(macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0, *) else {
+    guard #available(_mangledTypeNameAPI, *) else {
       throw XCTSkip("Unavailable")
     }
 
@@ -1204,7 +1204,7 @@ final class IssueTests: XCTestCase {
   }
 
   func testCEnumDescription() async throws {
-    guard #available(macOS 11.0, iOS 14.0, watchOS 7.0, tvOS 14.0, *) else {
+    guard #available(_mangledTypeNameAPI, *) else {
       throw XCTSkip("Unavailable")
     }