From b6a284d2a695b9e33fb99de03c3a88fca0991808 Mon Sep 17 00:00:00 2001 From: Stuart Montgomery Date: Mon, 10 Feb 2025 14:46:19 -0600 Subject: [PATCH 1/4] Add a document to begin collecting pending ABI changes --- Documentation/ABI/Pending-ABIv1.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 Documentation/ABI/Pending-ABIv1.md diff --git a/Documentation/ABI/Pending-ABIv1.md b/Documentation/ABI/Pending-ABIv1.md new file mode 100644 index 000000000..295696305 --- /dev/null +++ b/Documentation/ABI/Pending-ABIv1.md @@ -0,0 +1,20 @@ +# Pending ABIv1 Changes + +This document collects changes which have been made and are anticipated to be +released in a future ABI/event stream version, but are still pending. + +> [!IMPORTANT] +> This file describes changes which are unreleased, and are subject to change. +> Do not depend on this version or make assumptions that these changes will +> remain part of this ABI version. + +## Issue severity and warning issues + +Introduced a notion of "severity" for issues, and a new "warning" severity level +which is lower than the default "error" level. Clients upgrading from v0 should +begin consulting the severity of recorded issues to determine whether the +associated test should be marked as failing. + +### See Also + +- https://github.com/swiftlang/swift-testing/pull/931 From d15ce7cd4f38b1418a71f54690f13adf31eb91fd Mon Sep 17 00:00:00 2001 From: Jonathan Grynspan Date: Tue, 29 Jul 2025 10:34:05 -0400 Subject: [PATCH 2/4] Add schema version number change --- Documentation/ABI/Pending-ABIv1.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/Documentation/ABI/Pending-ABIv1.md b/Documentation/ABI/Pending-ABIv1.md index 295696305..665fa943a 100644 --- a/Documentation/ABI/Pending-ABIv1.md +++ b/Documentation/ABI/Pending-ABIv1.md @@ -8,6 +8,19 @@ released in a future ABI/event stream version, but are still pending. > Do not depend on this version or make assumptions that these changes will > remain part of this ABI version. +## Schema version numbers + +The schema version can now be specified as a 2- or 3-part version string such as +`"6.3"`. Integers continue to be supported for backwards-compatibility with the +existing "version 0" and Xcode 16 Beta schemas. + +```diff +- ::= "version": 0 ; will be incremented as the format changes ++ ::= "version": ++ ++ ::= 0 | "." | ".." +``` + ## Issue severity and warning issues Introduced a notion of "severity" for issues, and a new "warning" severity level @@ -15,6 +28,18 @@ which is lower than the default "error" level. Clients upgrading from v0 should begin consulting the severity of recorded issues to determine whether the associated test should be marked as failing. +```diff + ::= { + "isKnown": , ; is this a known issue or not? ++ "severity": , ; the severity of the issue ++ "isFailure": , ; did this issue cause the associated test to fail? + ["sourceLocation": ,] ; where the issue occurred, if known + } + ++ ::= "warning" | "error" + ; additional severities may be added in the future +``` + ### See Also - https://github.com/swiftlang/swift-testing/pull/931 From aeaddb79a8d7d17b89eab41a698fac28bcbf1cfa Mon Sep 17 00:00:00 2001 From: Jonathan Grynspan Date: Tue, 29 Jul 2025 11:14:17 -0400 Subject: [PATCH 3/4] Fix typo --- Documentation/ABI/Pending-ABIv1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/ABI/Pending-ABIv1.md b/Documentation/ABI/Pending-ABIv1.md index 665fa943a..bee85b5fe 100644 --- a/Documentation/ABI/Pending-ABIv1.md +++ b/Documentation/ABI/Pending-ABIv1.md @@ -37,7 +37,7 @@ associated test should be marked as failing. } + ::= "warning" | "error" - ; additional severities may be added in the future ++ ; additional severities may be added in the future ``` ### See Also From b86b5557d039cddb1d7ad248d990283ce5a852c5 Mon Sep 17 00:00:00 2001 From: Jonathan Grynspan Date: Mon, 18 Aug 2025 11:57:13 -0400 Subject: [PATCH 4/4] Update Pending-ABIv1.md --- Documentation/ABI/Pending-ABIv1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/ABI/Pending-ABIv1.md b/Documentation/ABI/Pending-ABIv1.md index bee85b5fe..21caa2f88 100644 --- a/Documentation/ABI/Pending-ABIv1.md +++ b/Documentation/ABI/Pending-ABIv1.md @@ -1,4 +1,4 @@ -# Pending ABIv1 Changes +# Pending ABIv6.3 Changes This document collects changes which have been made and are anticipated to be released in a future ABI/event stream version, but are still pending.