Roslyn analyzers enforcing Pandatech async coding conventions.
| Rule | Description |
|---|---|
| PT0001 | Async methods must end with Async |
| PT0002 | Async methods must accept a CancellationToken |
| PT0003 | CancellationToken parameter must be named ct |
| PT0004 | CancellationToken must be the last parameter |
A method is async if it returns Task, Task<T>, ValueTask, or ValueTask<T>.
// ✓ Correct
Task<int> GetValueAsync(int id, CancellationToken ct = default);
// ✗ PT0001: Missing 'Async' suffix
Task<int> GetValue(int id, CancellationToken ct);
// ✗ PT0002: Missing CancellationToken
Task<int> GetValueAsync(int id);
// ✗ PT0003: CancellationToken must be named 'ct'
Task<int> GetValueAsync(int id, CancellationToken token);
// ✗ PT0004: CancellationToken must be last
Task<int> GetValueAsync(CancellationToken ct, int id);The analyzer automatically skips:
| Context | Skipped Rules |
|---|---|
Entry points (Main, top-level statements) |
All rules |
| Interface implementations / overrides | PT0001, PT0002, PT0004 |
Test methods ([Fact], [Test], etc.) |
PT0002, PT0004 |
ASP.NET Core middleware (Invoke/InvokeAsync) |
PT0002, PT0003, PT0004 |
| SignalR hubs and hub interfaces | All rules |
SignalR client interfaces (Hub<TClient>) |
All rules |
All rules include automatic code fixes that handle:
- Interface methods → Updates interface and all implementations
- Virtual/abstract methods → Updates base and all overrides
- Regular methods → Updates the single method
<ItemGroup>
<PackageReference Include="Pandatech.Analyzers" Version="1.0.0" PrivateAssets="all"/>
</ItemGroup>Configure severity in .editorconfig:
dotnet_diagnostic.PT0001.severity = error
dotnet_diagnostic.PT0002.severity = error
dotnet_diagnostic.PT0003.severity = warning
dotnet_diagnostic.PT0004.severity = warning