From 6b21ff89f34f3f1085594698a7b84eab09bbbb65 Mon Sep 17 00:00:00 2001 From: Michael Gottesman Date: Fri, 25 Jul 2025 10:48:59 -0700 Subject: [PATCH 1/2] [swift-snapshot-tool] Fix the description in the README of branch specification to match how we do it today. Today one uses --development, --release_5_0, --release_6_0, --release_6_2, etc instead of previously how we specify it. --- utils/swift_snapshot_tool/README.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/utils/swift_snapshot_tool/README.md b/utils/swift_snapshot_tool/README.md index 769f48d805098..3a08b212f70dc 100644 --- a/utils/swift_snapshot_tool/README.md +++ b/utils/swift_snapshot_tool/README.md @@ -23,6 +23,10 @@ value is at. This allows for one to get a sense of the range of time in between two bisect numbers since one can look at the range in between them and how time varies. +One can specify a branch of snapshots to list. By default uses +--development. Also supports the options --release_5_0, --release_6_0, +--release_6_2. + ## Run ``` @@ -56,7 +60,8 @@ Options: an error was fixed. - branch: This controls the specific branch of snapshots that are downloaded. By - default uses development. Also supports the options 5.0 and 6.0. + default uses --development. Also supports the options --release_5_0, + --release_6_0, --release_6_2. ## Bisect @@ -94,4 +99,5 @@ Options: an error was fixed. - branch: This controls the specific branch of snapshots that are downloaded. By - default uses development. Also supports the options 5.0 and 6.0. + default uses --development. Also supports the options --release_5_0, + --release_6_0, --release_6_2. From f7251e5fbc10d1b4c88a67d2140789aa6d91e5b3 Mon Sep 17 00:00:00 2001 From: Michael Gottesman Date: Fri, 25 Jul 2025 10:49:55 -0700 Subject: [PATCH 2/2] [swift-snapshot-tool] Add to the README a helper blurb about how to run tests against Swift Testing Swift Testing is in the downloadable toolchains but is not in the normal library lookup path, so one needs to specify it explicitly with a -I command so it is found by the test command. --- utils/swift_snapshot_tool/README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/utils/swift_snapshot_tool/README.md b/utils/swift_snapshot_tool/README.md index 3a08b212f70dc..05b133b66a42f 100644 --- a/utils/swift_snapshot_tool/README.md +++ b/utils/swift_snapshot_tool/README.md @@ -101,3 +101,15 @@ Options: - branch: This controls the specific branch of snapshots that are downloaded. By default uses --development. Also supports the options --release_5_0, --release_6_0, --release_6_2. + +# FAQ and Helpful Tips + +## Bisecting against examples using Swift Testing + +Swift Testing is not stored in the normal place in a toolchain. To test against +such an example that uses swift testing pass into ones script the following -I +command: + +``` +xcrun ${SWIFTC} "${@:1}" -o binary -parse-as-library -I ${SWIFT_LIBRARY_PATH}/testing +```