File: DiagnosticAnalyzerRunner.cs
Web Access
Project: src\src\Analyzers\Microsoft.AspNetCore.Analyzer.Testing\src\Microsoft.AspNetCore.Analyzer.Testing.csproj (Microsoft.AspNetCore.Analyzer.Testing)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Collections.Generic;
using System.Collections.Immutable;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.Diagnostics;
using Xunit;
 
namespace Microsoft.AspNetCore.Analyzer.Testing;
 
/// <summary>
/// Base type for executing a <see cref="DiagnosticAnalyzer" />. Derived types implemented in the test assembly will
/// correctly resolve reference assemblies required for compilaiton.
/// </summary>
public abstract class DiagnosticAnalyzerRunner
{
    /// <summary>
    /// Given classes in the form of strings, and an DiagnosticAnalyzer to apply to it, return the diagnostics found in the string after converting it to a document.
    /// </summary>
    /// <param name="sources">Classes in the form of strings</param>
    /// <param name="analyzer">The analyzer to be run on the sources</param>
    /// <param name="additionalEnabledDiagnostics">Additional diagnostics to enable at Info level</param>
    /// <param name="getAllDiagnostics">
    /// When <c>true</c>, returns all diagnostics including compilation errors.
    /// Otherwise; only returns analyzer diagnostics.
    /// </param>
    /// <returns>An IEnumerable of Diagnostics that surfaced in the source code, sorted by Location</returns>
    protected Task<Diagnostic[]> GetDiagnosticsAsync(
        string[] sources,
        DiagnosticAnalyzer analyzer,
        string[] additionalEnabledDiagnostics,
        bool getAllDiagnostics = true)
    {
        var project = DiagnosticProject.Create(GetType().Assembly, sources);
        return GetDiagnosticsAsync(new[] { project }, analyzer, additionalEnabledDiagnostics);
    }
 
    /// <summary>
    /// Given an analyzer and a document to apply it to, run the analyzer and gather an array of diagnostics found in it.
    /// The returned diagnostics are then ordered by location in the source document.
    /// </summary>
    /// <param name="projects">Projects that the analyzer will be run on</param>
    /// <param name="analyzer">The analyzer to run on the documents</param>
    /// <param name="additionalEnabledDiagnostics">Additional diagnostics to enable at Info level</param>
    /// <param name="getAllDiagnostics">
    /// When <c>true</c>, returns all diagnostics including compilation errors.
    /// Otherwise only returns analyzer diagnostics.
    /// </param>
    /// <returns>An IEnumerable of Diagnostics that surfaced in the source code, sorted by Location</returns>
    protected async Task<Diagnostic[]> GetDiagnosticsAsync(
        IEnumerable<Project> projects,
        DiagnosticAnalyzer analyzer,
        string[] additionalEnabledDiagnostics,
        bool getAllDiagnostics = true)
    {
        var diagnostics = new List<Diagnostic>();
        foreach (var project in projects)
        {
            var compilation = await project.GetCompilationAsync();
 
            // Enable any additional diagnostics
            var options = ConfigureCompilationOptions(compilation.Options);
            if (additionalEnabledDiagnostics.Length > 0)
            {
                options = compilation.Options
                    .WithSpecificDiagnosticOptions(
                        additionalEnabledDiagnostics.ToDictionary(s => s, s => ReportDiagnostic.Info));
            }
 
            var compilationWithAnalyzers = compilation
                .WithOptions(options)
                .WithAnalyzers(ImmutableArray.Create(analyzer));
 
            if (getAllDiagnostics)
            {
                var diags = await compilationWithAnalyzers.GetAllDiagnosticsAsync();
 
                Assert.DoesNotContain(diags, d => d.Id == "AD0001");
 
                // Filter out non-error diagnostics not produced by our analyzer
                // We want to KEEP errors because we might have written bad code. But sometimes we leave warnings in to make the
                // test code more convenient
                diags = diags.Where(d => d.Severity == DiagnosticSeverity.Error || analyzer.SupportedDiagnostics.Any(s => s.Id.Equals(d.Id))).ToImmutableArray();
 
                foreach (var diag in diags)
                {
                    if (diag.Location == Location.None || diag.Location.IsInMetadata)
                    {
                        diagnostics.Add(diag);
                    }
                    else
                    {
                        foreach (var document in projects.SelectMany(p => p.Documents))
                        {
                            var tree = await document.GetSyntaxTreeAsync();
                            if (tree == diag.Location.SourceTree)
                            {
                                diagnostics.Add(diag);
                            }
                        }
                    }
                }
            }
            else
            {
                diagnostics.AddRange(await compilationWithAnalyzers.GetAnalyzerDiagnosticsAsync());
            }
        }
 
        return diagnostics.OrderBy(d => d.Location.SourceSpan.Start).ToArray();
    }
 
    protected virtual CompilationOptions ConfigureCompilationOptions(CompilationOptions options)
    {
        return options.WithOutputKind(OutputKind.DynamicallyLinkedLibrary);
    }
}