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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2023 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
//
/// A type representing a location in source code.
public struct SourceLocation: Sendable {
/// The file ID of the source file.
///
/// ## See Also
///
/// - ``moduleName``
/// - ``fileName``
public var fileID: String {
didSet {
precondition(!fileID.isEmpty)
precondition(fileID.contains("/"))
}
}
/// The name of the source file.
///
/// The name of the source file is derived from this instance's ``fileID``
/// property. It consists of the substring of the file ID after the last
/// forward-slash character (`"/"`.) For example, if the value of this
/// instance's ``fileID`` property is `"FoodTruck/WheelTests.swift"`, the
/// file name is `"WheelTests.swift"`.
///
/// The structure of file IDs is described in the documentation for
/// [`#fileID`](https://developer.apple.com/documentation/swift/fileID())
/// in the Swift standard library.
///
/// ## See Also
///
/// - ``fileID``
/// - ``moduleName``
public var fileName: String {
let lastSlash = fileID.lastIndex(of: "/")!
return String(fileID[fileID.index(after: lastSlash)...])
}
/// The name of the module containing the source file.
///
/// The name of the module is derived from this instance's ``fileID``
/// property. It consists of the substring of the file ID up to the first
/// forward-slash character (`"/"`.) For example, if the value of this
/// instance's ``fileID`` property is `"FoodTruck/WheelTests.swift"`, the
/// module name is `"FoodTruck"`.
///
/// The structure of file IDs is described in the documentation for the
/// [`#fileID`](https://developer.apple.com/documentation/swift/fileID())
/// macro in the Swift standard library.
///
/// ## See Also
///
/// - ``fileID``
/// - ``fileName``
/// - [`#fileID`](https://developer.apple.com/documentation/swift/fileID())
public var moduleName: String {
let firstSlash = fileID.firstIndex(of: "/")!
return String(fileID[..<firstSlash])
}
/// The path to the source file.
///
/// - Warning: This property is provided temporarily to aid in integrating the
/// testing library with existing tools such as Swift Package Manager. It
/// will be removed in a future release.
public var _filePath: String
/// The line in the source file.
public var line: Int {
didSet {
precondition(line > 0)
}
}
/// The column in the source file.
public var column: Int {
didSet {
precondition(column > 0)
}
}
public init(fileID: String, filePath: String, line: Int, column: Int) {
self.fileID = fileID
self._filePath = filePath
self.line = line
self.column = column
}
}
// MARK: - Equatable, Hashable, Comparable
extension SourceLocation: Equatable, Hashable, Comparable {
public static func ==(lhs: Self, rhs: Self) -> Bool {
lhs.line == rhs.line && lhs.column == rhs.column && lhs.fileID == rhs.fileID
}
public func hash(into hasher: inout Hasher) {
hasher.combine(fileID)
hasher.combine(line)
hasher.combine(column)
}
public static func <(lhs: Self, rhs: Self) -> Bool {
// Tests are sorted in the order in which they appear in source, with file
// IDs sorted alphabetically in the neutral locale.
if lhs.fileID < rhs.fileID {
return true
} else if lhs.fileID == rhs.fileID {
if lhs.line < rhs.line {
return true
} else if lhs.line == rhs.line {
return lhs.column < rhs.column
}
}
return false
}
}
// MARK: - CustomStringConvertible, CustomDebugStringConvertible
extension SourceLocation: CustomStringConvertible, CustomDebugStringConvertible {
public var description: String {
return "\(fileName):\(line):\(column)"
}
public var debugDescription: String {
return "\(fileID):\(line):\(column)"
}
}
// MARK: - Codable
extension SourceLocation: Codable {}
|
