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
|
/*
This source file is part of the Swift.org open source project
Copyright (c) 2021 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
*/
import Foundation
import Markdown
/**
The severity of a diagnostic.
Diagnostics have a severity in order to give the user an indication of what a message means to them and whether it's immediately actionable or blocking.
*/
public enum DiagnosticSeverity: Int, Codable, CustomStringConvertible {
/**
An error.
Errors should ideally be actionable and give the user a clear indication of what must be done to fix the error. An error severity should be used if further progress can't be made in some process or workflow.
*/
case error = 1
/**
A warning.
Warnings should ideally be actionable and give the user a clear indication of what must be done to fix the error. A warning severity should be used for issues that don't block progress but the user ought to address as soon as possible.
*/
case warning = 2
/**
Information.
Information needn't be immediately actionable but should be useful to the user. Recommendations should be saved for the `hint` diagnostic severity.
> Note: this maps to `analyzer` style information.
*/
case information = 3
/**
A hint.
A hint may be used to provide recommendations to resolve errors or warnings or may provide recommendations to the user proactively.
*/
case hint = 4
public var description: String {
switch self {
case .error:
return "error"
case .warning:
return "warning"
case .information:
return "note"
case .hint:
return "notice"
}
}
}
extension DiagnosticSeverity: Comparable {
public static func < (lhs: DiagnosticSeverity, rhs: DiagnosticSeverity) -> Bool {
return lhs.rawValue < rhs.rawValue
}
}
extension DiagnosticSeverity {
public init?(_ string: String?) {
switch string {
case "error":
self = .error
case "warning":
self = .warning
case "information", "info", "note":
self = .information
case "hint", "notice":
self = .hint
default:
return nil
}
}
}
|
