Add NEEG004 analyzer to detect ToString() on enums with [EnumExtensions] or EnumExtensions<T> - #196

Implements analyzer to detect ToString() calls on enums decorated with [EnumExtensions] or referenced in EnumExtensions<T> assembly attributes and suggest ToStringFast() replacement for better performance.

Changes

• ToStringAnalyzer (NEEG004): Information-level diagnostic for ToString() calls (with or without format specifiers) on enums with [EnumExtensions] attribute or external enums referenced in EnumExtensions<T> assembly attributes
  • Handles format specifiers: only suggests replacement for compatible formats (empty string, "G", "g")
  • Does not flag incompatible format specifiers like "x", "X", "d", "D"
  • Detects external enum types declared via [assembly: EnumExtensions<T>()] attributes (e.g., DateTimeKind, FileShare)
• ToStringCodeFixProvider: Batch fixer to replace ToString() → ToStringFast() with trivia preservation
  • Removes format parameters when replacing with ToStringFast()
• Test coverage: 32 test cases covering various contexts (expressions, return statements, multiple enums, attribute configurations, format specifiers, external enum types)

Example

// Direct attribute on enum
[EnumExtensions]
public enum Status { Active, Inactive }

// External enum via assembly attribute
[assembly: EnumExtensions<System.DateTimeKind>()]

// Before: NEEG004 info diagnostic
var text1 = status.ToString();
var text2 = status.ToString("G");
var text3 = dateTimeKind.ToString();

// After fix applied
var text1 = status.ToStringFast();
var text2 = status.ToStringFast();
var text3 = dateTimeKind.ToStringFast();

// Not flagged (incompatible format specifiers)
var hex = status.ToString("x");  // No diagnostic

Analyzer triggers on:

• Enums with [EnumExtensions] attribute
• External enums referenced in EnumExtensions<T> assembly attributes
• Only for compatible format specifiers

• Fixes Create analyzer to detect usages of ToString() and suggest replacing with ToStringFast() #187

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.