@@ -159,7 +159,7 @@ Here are some concrete examples:
159
159
160
160
### Interoperability Modes
161
161
162
- - ** Warning-only ** : Test failures that were previously ignored are reported as
162
+ - ** Advisory ** : Test failures that were previously ignored are reported as
163
163
runtime warning issues. It also includes runtime warning issues for XCTest API
164
164
usage in a Swift Testing context. This is for projects which do not want to
165
165
see new test failures surfaced due to interoperability.
@@ -178,7 +178,7 @@ Configure the interoperability mode when running tests using the
178
178
179
179
| Interop Mode | Issue behaviour across framework boundary | ` SWIFT_TESTING_XCTEST_INTEROP_MODE ` |
180
180
| ------------ | -------------------------------------------------------------------------- | ---------------------------------------------- |
181
- | Warning-only | XCTest API: ⚠️ Runtime Warning Issue. All Issues: ⚠️ Runtime Warning Issue | ` warning-only ` |
181
+ | Advisory | XCTest API: ⚠️ Runtime Warning Issue. All Issues: ⚠️ Runtime Warning Issue | ` warning-only ` |
182
182
| Permissive | XCTest API: ⚠️ Runtime Warning Issue. All Issues: ❌ Test Failure | ` permissive ` , or empty value, or invalid value |
183
183
| Strict | XCTest API: 💥 ` fatalError ` . Swift Testing API: ❌ Test Failure | ` strict ` |
184
184
@@ -195,7 +195,7 @@ lead to situations where previously "passing" test code now starts showing
195
195
failures. We believe this should be a net positive if it can highlight actual
196
196
bugs you would have missed previously.
197
197
198
- You can use ` SWIFT_TESTING_XCTEST_INTEROP_MODE=warning-only ` in the short-term
198
+ You can use ` SWIFT_TESTING_XCTEST_INTEROP_MODE=advisory ` in the short-term
199
199
to revert any changes to test pass/fail outcomes as a result of
200
200
interoperability.
201
201
@@ -249,7 +249,7 @@ should make it clear that this is not intended to be a permanent measure.
249
249
In a similar vein, we considered ` SWIFT_TESTING_XCTEST_INTEROP_MODE=off ` as a
250
250
way to completely turn off interoperability. Some projects may additionally have
251
251
an issue handling trait that promotes warnings to errors, which means that
252
- warning-only mode could still cause test failures.
252
+ advisory mode could still cause test failures.
253
253
254
254
However, in the scenario above, we think users who set up tests to elevate
255
255
warnings as errors would be interested in increased visibility of testing issues
@@ -282,7 +282,7 @@ disruptive to the testing flow.
282
282
- ** CLI option through SwiftPM:**
283
283
284
284
```
285
- swift test --interop-mode=warning-only
285
+ swift test --interop-mode=advisory
286
286
```
287
287
288
288
This could be offered in addition to the proposed environment variable option,
0 commit comments