dnrops
/
SwiftLint
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Refactor rule list documentation (#4763)

This commit is contained in:
Danny Mösch 2023-02-13 21:22:10 +01:00 committed by GitHub
parent ad29864d7f
commit ec38c244fd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 22 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
CHANGELOG.md
View File

@ -17,6 +17,7 @@
* None.
#### Enhancements
* Add local links to rule descriptions to every rule listed
in `Rule Directory.md`.
[kattouf](https://github.com/kattouf)

52
Source/SwiftLintFramework/Documentation/RuleListDocumentation.swift
View File

@ -42,30 +42,32 @@ public struct RuleListDocumentation {
## Default Rules
\(defaultRuleDocumentations
.map { "* [`\($0.ruleIdentifier)`](\($0.ruleIdentifier).md): \($0.ruleName)" }
.joined(separator: "\n"))
\(defaultRuleDocumentations.map(makeListEntry).joined(separator: "\n"))
## Opt-In Rules
## Opt-in Rules
\(optInRuleDocumentations
.map { "* [`\($0.ruleIdentifier)`](\($0.ruleIdentifier).md): \($0.ruleName)" }
.joined(separator: "\n"))
\(optInRuleDocumentations.map(makeListEntry).joined(separator: "\n"))
## Analyzer Rules
\(analyzerRuleDocumentations
.map { "* [`\($0.ruleIdentifier)`](\($0.ruleIdentifier).md): \($0.ruleName)" }
.joined(separator: "\n"))
\(analyzerRuleDocumentations.map(makeListEntry).joined(separator: "\n"))
"""
}
private func makeListEntry(from rule: RuleDocumentation) -> String {
"* [`\(rule.ruleIdentifier)`](\(rule.ruleIdentifier).md): \(rule.ruleName)"
}
private var swiftSyntaxDashboardContents: String {
let linterRuleDocumentations = ruleDocumentations.filter(\.isLinterRule)
let rulesUsingSourceKit = linterRuleDocumentations.filter(\.usesSourceKit)
let rulesNotUsingSourceKit = linterRuleDocumentations.filter { !$0.usesSourceKit }
let percentUsingSourceKit = Int(rulesUsingSourceKit.count * 100 / linterRuleDocumentations.count)
let enabledSourceKitRules = rulesUsingSourceKit.filter(\.isEnabledByDefault)
let disabledSourceKitRules = rulesUsingSourceKit.filter(\.isDisabledByDefault)
let enabledSourceKitFreeRules = rulesNotUsingSourceKit.filter(\.isEnabledByDefault)
let disabledSourceKitFreeRules = rulesNotUsingSourceKit.filter(\.isDisabledByDefault)
return """
# Swift Syntax Dashboard
@ -80,35 +82,23 @@ public struct RuleListDocumentation {
## Rules Using SourceKit
### Enabled By Default (\(rulesUsingSourceKit.filter(\.isEnabledByDefault).count))
### Default Rules (\(enabledSourceKitRules.count))
\(rulesUsingSourceKit
.filter(\.isEnabledByDefault)
.map { "* `\($0.ruleIdentifier)`: \($0.ruleName)" }
.joined(separator: "\n"))
\(enabledSourceKitRules.map(makeListEntry).joined(separator: "\n"))
### Opt-In (\(rulesUsingSourceKit.filter(\.isDisabledByDefault).count))
### Opt-in Rules (\(disabledSourceKitRules.count))
\(rulesUsingSourceKit
.filter(\.isDisabledByDefault)
.map { "* `\($0.ruleIdentifier)`: \($0.ruleName)" }
.joined(separator: "\n"))
\(disabledSourceKitRules.map(makeListEntry).joined(separator: "\n"))
## Rules Not Using SourceKit
## Rules not Using SourceKit
### Enabled By Default (\(rulesNotUsingSourceKit.filter(\.isEnabledByDefault).count))
### Default Rules (\(enabledSourceKitFreeRules.count))
\(rulesNotUsingSourceKit
.filter(\.isEnabledByDefault)
.map { "* `\($0.ruleIdentifier)`: \($0.ruleName)" }
.joined(separator: "\n"))
\(enabledSourceKitFreeRules.map(makeListEntry).joined(separator: "\n"))
### Opt-In (\(rulesNotUsingSourceKit.filter(\.isDisabledByDefault).count))
### Opt-in Rules (\(disabledSourceKitFreeRules.count))
\(rulesNotUsingSourceKit
.filter(\.isDisabledByDefault)
.map { "* `\($0.ruleIdentifier)`: \($0.ruleName)" }
.joined(separator: "\n"))
\(disabledSourceKitFreeRules.map(makeListEntry).joined(separator: "\n"))
"""
}