1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
# Traits
<!--
This source file is part of the Swift.org open source project
Copyright (c) 2023–2024 Apple Inc. and the Swift project authors
Licensed under Apache License v2.0 with Runtime Library Exception
See https://swift.org/LICENSE.txt for license information
See https://swift.org/CONTRIBUTORS.txt for Swift project authors
-->
Annotate test functions and suites, and customize their behavior.
## Overview
Pass built-in traits to test functions or suite types to comment, categorize,
classify, and modify the runtime behavior of test suites and test functions.
Implement the ``TestTrait``, and ``SuiteTrait`` protocols to create your own
types that customize the behavior of your tests.
## Topics
### Customizing runtime behaviors
- <doc:EnablingAndDisabling>
- <doc:LimitingExecutionTime>
- ``Trait/enabled(if:_:sourceLocation:)``
- ``Trait/enabled(_:sourceLocation:_:)``
- ``Trait/disabled(_:sourceLocation:)``
- ``Trait/disabled(if:_:sourceLocation:)``
- ``Trait/disabled(_:sourceLocation:_:)``
- ``Trait/timeLimit(_:)-4kzjp``
### Running tests serially or in parallel
- <doc:Parallelization>
- ``Trait/serialized``
### Annotating tests
- <doc:AddingTags>
- <doc:AddingComments>
- <doc:AssociatingBugs>
- <doc:BugIdentifiers>
- ``Tag()``
- ``Trait/bug(_:_:)``
- ``Trait/bug(_:id:_:)-10yf5``
- ``Trait/bug(_:id:_:)-3vtpl``
### Handling issues
- ``Trait/compactMapIssues(_:)``
- ``Trait/filterIssues(_:)``
### Creating custom traits
- ``Trait``
- ``TestTrait``
- ``SuiteTrait``
- ``TestScoping``
### Supporting types
- ``Bug``
- ``Comment``
- ``ConditionTrait``
- ``IssueHandlingTrait``
- ``ParallelizationTrait``
- ``Tag``
- ``Tag/List``
- ``TimeLimitTrait``
|
