Skip to content

Implementing analyzer to prefer WebApplicationBuilder.Configuration over Configure methods #42351

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jun 29, 2022
Merged
Original file line number Diff line number Diff line change
Expand Up @@ -79,4 +79,14 @@ internal static class DiagnosticDescriptors
DiagnosticSeverity.Error,
isEnabledByDefault: true,
helpLinkUri: "https://aka.ms/aspnet/analyzers");

internal static readonly DiagnosticDescriptor DisallowConfigureAppConfigureHostBuilder = new(
"ASP0013",
"Suggest switching from using Configure methods to WebApplicationBuilder.Configuration",
"Suggest using WebApplicationBuilder.Configuration instead of {0}",
"Usage",
DiagnosticSeverity.Warning,
isEnabledByDefault: true,
helpLinkUri: "https://aka.ms/aspnet/analyzers");

}
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ public class WebApplicationBuilderAnalyzer : DiagnosticAnalyzer
DiagnosticDescriptors.DoNotUseConfigureWebHostWithConfigureHostBuilder,
DiagnosticDescriptors.DoNotUseConfigureWithConfigureWebHostBuilder,
DiagnosticDescriptors.DoNotUseUseStartupWithConfigureWebHostBuilder,
DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder,
});

public override void Initialize(AnalysisContext context)
Expand All @@ -44,6 +45,14 @@ public override void Initialize(AnalysisContext context)
wellKnownTypes.HostingAbstractionsWebHostBuilderExtensions,
wellKnownTypes.WebHostBuilderExtensions,
};
INamedTypeSymbol[] configureAppTypes =
{
wellKnownTypes.ConfigureHostBuilder,
wellKnownTypes.ConfigureWebHostBuilder,
wellKnownTypes.WebHostBuilderExtensions,
wellKnownTypes.HostingHostBuilderExtensions,
};
INamedTypeSymbol[] configureHostTypes = { wellKnownTypes.ConfigureHostBuilder };

compilationStartAnalysisContext.RegisterOperationAction(operationAnalysisContext =>
{
Expand Down Expand Up @@ -98,6 +107,54 @@ public override void Initialize(AnalysisContext context)
invocation));
}

// var builder = WebApplication.CreateBuilder();
// builder.WebHost.ConfigureAppConfiguration(builder => {});
if (IsDisallowedMethod(
operationAnalysisContext,
invocation,
targetMethod,
wellKnownTypes.ConfigureWebHostBuilder,
"ConfigureAppConfiguration",
configureAppTypes))
{
operationAnalysisContext.ReportDiagnostic(
CreateDiagnostic(
DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder,
invocation));
}

// var builder = WebApplication.CreateBuilder();
// builder.Host.ConfigureAppConfiguration(builder => {});
if (IsDisallowedMethod(
operationAnalysisContext,
invocation,
targetMethod,
wellKnownTypes.ConfigureHostBuilder,
"ConfigureAppConfiguration",
configureAppTypes))
{
operationAnalysisContext.ReportDiagnostic(
CreateDiagnostic(
DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder,
invocation));
}

// var builder = WebApplication.CreateBuilder();
// builder.Host.ConfigureHostConfiguration(builder => {});
if (IsDisallowedMethod(
operationAnalysisContext,
invocation,
targetMethod,
wellKnownTypes.ConfigureHostBuilder,
"ConfigureHostConfiguration",
configureHostTypes))
{
operationAnalysisContext.ReportDiagnostic(
CreateDiagnostic(
DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder,
invocation));
}

static Diagnostic CreateDiagnostic(DiagnosticDescriptor descriptor, IInvocationOperation operation)
{
// Take the location for the whole invocation operation as a starting point.
Expand Down Expand Up @@ -147,7 +204,7 @@ static Diagnostic CreateDiagnostic(DiagnosticDescriptor descriptor, IInvocationO
location = Location.Create(operation.Syntax.SyntaxTree, targetSpan);
}

return Diagnostic.Create(descriptor, location);
return Diagnostic.Create(descriptor, location, methodName);
}

}, OperationKind.Invocation);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,13 +42,20 @@ public static bool TryCreate(Compilation compilation, [NotNullWhen(true)] out We
return false;
}

const string HostingHostBuilderExtensions = "Microsoft.Extensions.Hosting.HostingHostBuilderExtensions";
if (compilation.GetTypeByMetadataName(HostingHostBuilderExtensions) is not { } hostingHostBuilderExtensions)
{
return false;
}

wellKnownTypes = new WellKnownTypes
{
ConfigureHostBuilder = configureHostBuilder,
ConfigureWebHostBuilder = configureWebHostBuilder,
GenericHostWebHostBuilderExtensions = genericHostWebHostBuilderExtensions,
HostingAbstractionsWebHostBuilderExtensions = hostingAbstractionsWebHostBuilderExtensions,
WebHostBuilderExtensions = webHostBuilderExtensions,
HostingHostBuilderExtensions = hostingHostBuilderExtensions,
};

return true;
Expand All @@ -59,4 +66,5 @@ public static bool TryCreate(Compilation compilation, [NotNullWhen(true)] out We
public INamedTypeSymbol GenericHostWebHostBuilderExtensions { get; private init; }
public INamedTypeSymbol HostingAbstractionsWebHostBuilderExtensions { get; private init; }
public INamedTypeSymbol WebHostBuilderExtensions { get; private init; }
public INamedTypeSymbol HostingHostBuilderExtensions { get; private init; }
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,210 @@
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

using System.Globalization;
using Microsoft.AspNetCore.Analyzer.Testing;

namespace Microsoft.AspNetCore.Analyzers.WebApplicationBuilder;
public partial class DisallowConfigureAppConfigureHostBuilderTest
{
private TestDiagnosticAnalyzerRunner Runner { get; } = new(new WebApplicationBuilderAnalyzer());

[Fact]
public async Task ConfigurationBuilderRunsWithoutDiagnostic()
{
// Arrange
var source = @"
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddJsonFile(""foo.json"", optional: true);
";
// Act
var diagnostic = await Runner.GetDiagnosticsAsync(source);

// Assert
Assert.Empty(diagnostic);
}

[Fact]
public async Task ConfigureAppHostBuilderProducesDiagnostic()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Configuration;
var builder = WebApplication.CreateBuilder(args);
builder.Host./*MM*/ConfigureAppConfiguration(builder =>
{
builder.AddJsonFile(""foo.json"", optional: true);
});
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
var diagnostic = Assert.Single(diagnostics);
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.DefaultMarkerLocation, diagnostic.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureAppConfiguration", diagnostic.GetMessage(CultureInfo.InvariantCulture));
}

[Fact]
public async Task ConfigureHostHostBuilderProducesDiagnostic()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
var builder = WebApplication.CreateBuilder(args);
builder.Host./*MM*/ConfigureHostConfiguration(builder =>
{
builder.AddJsonFile(""foo.json"", optional: true);
});
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
var diagnostic = Assert.Single(diagnostics);
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.DefaultMarkerLocation, diagnostic.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureHostConfiguration", diagnostic.GetMessage(CultureInfo.InvariantCulture));
}

[Fact]
public async Task ConfigureAppWebHostBuilderProducesDiagnostic()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
var builder = WebApplication.CreateBuilder(args);
builder.WebHost./*MM*/ConfigureAppConfiguration(builder =>
{
builder.AddJsonFile(""foo.json"", optional: true);
});
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
var diagnostic = Assert.Single(diagnostics);
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.DefaultMarkerLocation, diagnostic.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureAppConfiguration", diagnostic.GetMessage(CultureInfo.InvariantCulture));
}

[Fact]
public async Task ConfigureAppWebHostBuilderWithContextProducesDiagnostic()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
var builder = WebApplication.CreateBuilder(args);
builder.WebHost./*MM*/ConfigureAppConfiguration((context, webHostBuilder) => { });
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
var diagnostic = Assert.Single(diagnostics);
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.DefaultMarkerLocation, diagnostic.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureAppConfiguration", diagnostic.GetMessage(CultureInfo.InvariantCulture));
}
[Fact]
public async Task ConfigureAppWebHostBuilderProducesDiagnosticInMain()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
public static class Test
{
public static void Main(string[]args) {
var builder = WebApplication.CreateBuilder(args);
builder.WebHost./*MM*/ConfigureAppConfiguration(builder => { });
}
}
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
var diagnostic = Assert.Single(diagnostics);
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.DefaultMarkerLocation, diagnostic.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureAppConfiguration", diagnostic.GetMessage(CultureInfo.InvariantCulture));
}
[Fact]
public async Task ConfigureAppWebHostOnBuilderProducesDiagnosticInMain()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
public static class Test
{
public static void Main(string[]args) {
var builder = WebApplication.CreateBuilder(args);
var webhost = builder.WebHost;
webhost./*MM*/ConfigureAppConfiguration(builder => { });
}
}
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
var diagnostic = Assert.Single(diagnostics);
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.DefaultMarkerLocation, diagnostic.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureAppConfiguration", diagnostic.GetMessage(CultureInfo.InvariantCulture));
}
[Fact]
public async Task TwoInvocationsProduceTwoDiagnostic()
{
// Arrange
var source = TestSource.Read(@"
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
var builder = WebApplication.CreateBuilder(args);
builder.Host./*MM1*/ConfigureHostConfiguration(builder =>
{
builder.AddJsonFile(""foo.json"", optional: true);
});
builder.WebHost./*MM2*/ConfigureAppConfiguration(builder =>
{
builder.AddJsonFile(""foo.json"", optional: true);
});
");

// Act
var diagnostics = await Runner.GetDiagnosticsAsync(source.Source);

// Assert
Assert.Equal(2, diagnostics.Length);
var diagnostic1 = diagnostics[0];
var diagnostic2 = diagnostics[1];
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic1.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.MarkerLocations["MM1"], diagnostic1.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureHostConfiguration", diagnostic1.GetMessage(CultureInfo.InvariantCulture));
Assert.Same(DiagnosticDescriptors.DisallowConfigureAppConfigureHostBuilder, diagnostic2.Descriptor);
AnalyzerAssert.DiagnosticLocation(source.MarkerLocations["MM2"], diagnostic2.Location);
Assert.Equal("Suggest using WebApplicationBuilder.Configuration instead of ConfigureAppConfiguration", diagnostic2.GetMessage(CultureInfo.InvariantCulture));
}
}
1 change: 0 additions & 1 deletion src/Http/samples/MinimalSample/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,6 @@
Username: {Environment.UserName}
Date and Time: {DateTime.Now}
""");

var outer = app.MapGroup("/outer");
var inner = outer.MapGroup("/inner");

Expand Down