using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CSharp; using Microsoft.CodeAnalysis.Diagnostics; namespace AIStudio.Tests.Models.Generation; /// /// Compiles a snippet in memory so that a generator or an analyzer can be asked what it makes of it. /// /// /// Both of them are code which runs while the app is being built, and both fail quietly when they /// are wrong: a generator which finds nothing produces an empty registry, and an analyzer which /// recognizes nothing reports nothing. Neither shows up as a broken build, so neither can be /// checked by building the app. It has to be done here, against source written for the purpose. /// public static class CompilationHarness { /// /// Everything the test process itself was loaded with, which includes the app assembly. /// /// /// Gathered once. Reading a couple of hundred assemblies off disk per test case would make /// these tests slow enough that somebody stops running them. /// private static readonly Lazy REFERENCES = new(GatherReferences); /// /// Compiles a snippet against the same assemblies the app is built against. /// /// The C# source to compile. /// The compilation. public static CSharpCompilation Compile(string source) { var tree = CSharpSyntaxTree.ParseText(source, new CSharpParseOptions(LanguageVersion.Latest)); var options = new CSharpCompilationOptions(OutputKind.DynamicallyLinkedLibrary, nullableContextOptions: NullableContextOptions.Enable); return CSharpCompilation.Create("SnippetUnderTest", [tree], REFERENCES.Value, options); } /// /// Compiles a snippet and reports what it does not even parse or bind. /// /// /// Worth asking before believing a generator found nothing: a snippet with a typo in it also /// produces an empty result, and the two look exactly alike from the outside. /// /// The compilation to check. /// The errors, each on its own line, or an empty string. public static string ErrorsOf(Compilation compilation) { var errors = compilation.GetDiagnostics() .Where(diagnostic => diagnostic.Severity is DiagnosticSeverity.Error) .Select(diagnostic => diagnostic.ToString()); return string.Join(Environment.NewLine, errors); } /// /// Runs one analyzer over a snippet. /// /// The C# source to analyze. /// The analyzer to run. /// What the analyzer reported. public static async Task> AnalyzeAsync(string source, DiagnosticAnalyzer analyzer) { var compilation = Compile(source); Assert.That(ErrorsOf(compilation), Is.Empty, "The snippet has to compile, or the analyzer is being asked about code which does not exist."); var reported = await compilation.WithAnalyzers([analyzer]).GetAnalyzerDiagnosticsAsync(); return reported; } private static MetadataReference[] GatherReferences() { // // The set the runtime resolves types from, which is exactly what this test assembly was // built against: the framework, the NuGet packages, and the app itself. // if (AppContext.GetData("TRUSTED_PLATFORM_ASSEMBLIES") is not string assemblyPaths) throw new InvalidOperationException("The test host did not say which assemblies it trusts, so no compilation can be built against them."); return assemblyPaths .Split(Path.PathSeparator) .Where(path => path.EndsWith(".dll", StringComparison.OrdinalIgnoreCase) && File.Exists(path)) .Select(path => (MetadataReference) MetadataReference.CreateFromFile(path)) .ToArray(); } }