Port 'Top Level Statements' code style PR to 17.3

src/Analyzers/CSharp/Analyzers/CSharpAnalyzers.projitems

@@ -22,6 +22,9 @@
     <Compile Include="$(MSBuildThisFileDirectory)ConvertNamespace\ConvertNamespaceAnalysis.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConvertNamespace\ConvertToBlockScopedNamespaceDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConvertNamespace\ConvertToFileScopedNamespaceDiagnosticAnalyzer.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)ConvertProgram\ConvertProgramAnalysis_TopLevelStatements.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)ConvertProgram\ConvertProgramAnalysis_ProgramMain.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)ConvertProgram\ConvertToTopLevelStatementsDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ConvertTypeofToNameof\CSharpConvertTypeOfToNameOfDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)ForEachCast\CSharpForEachCastDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)NewLines\ConsecutiveBracePlacement\ConsecutiveBracePlacementDiagnosticAnalyzer.cs" />
@@ -62,6 +65,7 @@
     <Compile Include="$(MSBuildThisFileDirectory)SimplifyLinqExpression\CSharpSimplifyLinqExpressionDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)SimplifyPropertyPattern\CSharpSimplifyPropertyPatternDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)SimplifyPropertyPattern\SimplifyPropertyPatternHelpers.cs" />
+    <Compile Include="$(MSBuildThisFileDirectory)ConvertProgram\ConvertToProgramMainDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)UseAutoProperty\CSharpUseAutoPropertyAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)UseCoalesceExpression\CSharpUseCoalesceExpressionDiagnosticAnalyzer.cs" />
     <Compile Include="$(MSBuildThisFileDirectory)UseCoalesceExpression\CSharpUseCoalesceExpressionForNullableDiagnosticAnalyzer.cs" />

src/Analyzers/CSharp/Analyzers/CSharpAnalyzersResources.resx

@@ -358,4 +358,11 @@
   <data name="Use_is_object_check" xml:space="preserve">
     <value>Use 'is object' check</value>
   </data>
+  <data name="Convert_to_Program_Main_style_program" xml:space="preserve">
+    <value>Convert to 'Program.Main' style program</value>
+    <comment>{Locked="Program.Main"} this is the C# syntax we are going to generate</comment>
+  </data>
+  <data name="Convert_to_top_level_statements" xml:space="preserve">
+    <value>Convert to top-level statements</value>
+  </data>
 </root>

src/Analyzers/CSharp/Analyzers/ConvertProgram/ConvertProgramAnalysis_ProgramMain.cs

@@ -0,0 +1,80 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Linq;
+using Microsoft.CodeAnalysis.CodeStyle;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Microsoft.CodeAnalysis.Shared.Extensions;
+using Microsoft.CodeAnalysis.Text;
+using Roslyn.Utilities;
+using Microsoft.CodeAnalysis.CSharp.Extensions;
+
+namespace Microsoft.CodeAnalysis.CSharp.Analyzers.ConvertProgram
+{
+    internal static partial class ConvertProgramAnalysis
+    {
+        public static bool IsApplication(Compilation compilation)
+            => IsApplication(compilation.Options);
+
+        public static bool IsApplication(CompilationOptions options)
+            => options.OutputKind is OutputKind.ConsoleApplication or OutputKind.WindowsApplication;
+
+        public static bool CanOfferUseProgramMain(
+            CodeStyleOption2<bool> option,
+            CompilationUnitSyntax root,
+            Compilation compilation,
+            bool forAnalyzer)
+        {
+            // We only have to check if the first member is a global statement.  Global statements following anything
+            // else is not legal.
+            if (!root.IsTopLevelProgram())
+                return false;
+
+            if (!CanOfferUseProgramMain(option, forAnalyzer))
+                return false;
+
+            // resiliency check for later on.  This shouldn't happen but we don't want to crash if we are in a weird
+            // state where we have top level statements but no 'Program' type.
+            var programType = compilation.GetBestTypeByMetadataName(WellKnownMemberNames.TopLevelStatementsEntryPointTypeName);
+            if (programType == null)
+                return false;
+
+            if (programType.GetMembers(WellKnownMemberNames.TopLevelStatementsEntryPointMethodName).FirstOrDefault() is not IMethodSymbol)
+                return false;
+
+            return true;
+        }
+
+        private static bool CanOfferUseProgramMain(CodeStyleOption2<bool> option, bool forAnalyzer)
+        {
+            var userPrefersProgramMain = option.Value == false;
+            var analyzerDisabled = option.Notification.Severity == ReportDiagnostic.Suppress;
+            var forRefactoring = !forAnalyzer;
+
+            // If the user likes Program.Main, then we offer to conver to Program.Main from the diagnostic analyzer.
+            // If the user prefers Top-level-statements then we offer to use Program.Main from the refactoring provider.
+            // If the analyzer is disabled completely, the refactoring is enabled in both directions.
+            var canOffer = userPrefersProgramMain == forAnalyzer || (forRefactoring && analyzerDisabled);
+            return canOffer;
+        }
+
+        public static Location GetUseProgramMainDiagnosticLocation(CompilationUnitSyntax root, bool isHidden)
+        {
+            // if the diagnostic is hidden, show it anywhere from the top of the file through the end of the last global
+            // statement.  That way the user can make the change anywhere in teh top level code.  Otherwise, just put
+            // the diagnostic on the start of the first global statement.
+            if (!isHidden)
+                return root.Members.OfType<GlobalStatementSyntax>().First().GetFirstToken().GetLocation();
+
+            // note: the legal start has to come after any #pragma directives.  We don't want this to be suppressed, but
+            // then have the span of the diagnostic end up outside the suppression.
+            var lastPragma = root.GetFirstToken().LeadingTrivia.LastOrDefault(t => t.Kind() is SyntaxKind.PragmaWarningDirectiveTrivia);
+            var start = lastPragma == default ? 0 : lastPragma.FullSpan.End;
+
+            return Location.Create(
+                root.SyntaxTree,
+                TextSpan.FromBounds(start, root.Members.OfType<GlobalStatementSyntax>().Last().FullSpan.End));
+        }
+    }
+}

src/Analyzers/CSharp/Analyzers/ConvertProgram/ConvertProgramAnalysis_TopLevelStatements.cs

@@ -0,0 +1,156 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Linq;
+using System.Threading;
+using Microsoft.CodeAnalysis.CodeStyle;
+using Microsoft.CodeAnalysis.CSharp.Extensions;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Microsoft.CodeAnalysis.Shared.Extensions;
+using Roslyn.Utilities;
+
+namespace Microsoft.CodeAnalysis.CSharp.Analyzers.ConvertProgram
+{
+    internal static partial class ConvertProgramAnalysis
+    {
+        public static bool CanOfferUseTopLevelStatements(CodeStyleOption2<bool> option, bool forAnalyzer)
+        {
+            var userPrefersTopLevelStatements = option.Value == true;
+            var analyzerDisabled = option.Notification.Severity == ReportDiagnostic.Suppress;
+            var forRefactoring = !forAnalyzer;
+
+            // If the user likes top level statements, then we offer to convert to them from the diagnostic analyzer.
+            // If the user prefers Program.Main then we offer to use top-level-statements from the refactoring provider.
+            // If the analyzer is disabled completely, the refactoring is enabled in both directions.
+            var canOffer = userPrefersTopLevelStatements == forAnalyzer || (forRefactoring && analyzerDisabled);
+            return canOffer;
+        }
+
+        public static Location GetUseTopLevelStatementsDiagnosticLocation(MethodDeclarationSyntax methodDeclaration, bool isHidden)
+        {
+            // if the diagnostic is hidden, show it anywhere on the main method. Otherwise, just put the diagnostic on
+            // the the 'Main' identifier.
+            return isHidden ? methodDeclaration.GetLocation() : methodDeclaration.Identifier.GetLocation();
+        }
+
+        public static string? GetMainTypeName(Compilation compilation)
+        {
+            var mainTypeFullName = compilation.Options.MainTypeName;
+            var mainTypeName = mainTypeFullName?.Split('.').Last();
+            return mainTypeName;
+        }
+
+        public static bool IsProgramMainMethod(
+            SemanticModel semanticModel,
+            MethodDeclarationSyntax methodDeclaration,
+            string? mainTypeName,
+            CancellationToken cancellationToken,
+            out bool canConvertToTopLevelStatements)
+        {
+            canConvertToTopLevelStatements = false;
+
+            // Quick syntactic checks to allow us to avoid most methods.  We basically filter out anything that isn't
+            // `static Main` immediately.
+            //
+            // For simplicity, we require the method to have a body so that we don't have to care about
+            // expression-bodied members later.
+            if (!methodDeclaration.Modifiers.Any(SyntaxKind.StaticKeyword) ||
+                methodDeclaration.TypeParameterList is not null ||
+                methodDeclaration.Identifier.ValueText != WellKnownMemberNames.EntryPointMethodName ||
+                methodDeclaration.Parent is not TypeDeclarationSyntax containingTypeDeclaration ||
+                methodDeclaration.Body == null)
+            {
+                return false;
+            }
+
+            // If the compilation options specified a type name that Main should be found in, then do a quick check that
+            // our containing type matches that.
+            if (mainTypeName != null && containingTypeDeclaration.Identifier.ValueText != mainTypeName)
+                return false;
+
+            // If the user renamed the 'args' parameter, we can't convert to top level statements.
+            if (methodDeclaration.ParameterList.Parameters.Count == 1 &&
+                methodDeclaration.ParameterList.Parameters[0].Identifier.ValueText != "args")
+            {
+                return false;
+            }
+
+            // Found a suitable candidate.  See if this matches the entrypoint the compiler has actually chosen.
+            var entryPointMethod = semanticModel.Compilation.GetEntryPoint(cancellationToken);
+            if (entryPointMethod == null)
+                return false;
+
+            var thisMethod = semanticModel.GetDeclaredSymbol(methodDeclaration);
+            if (!entryPointMethod.Equals(thisMethod))
+                return false;
+
+            // We found the entrypoint.  However, we can only effectively convert this to top-level-statements
+            // if the existing type is amenable to that.
+            canConvertToTopLevelStatements = TypeCanBeConverted(entryPointMethod.ContainingType, containingTypeDeclaration);
+            return true;
+        }
+
+        private static bool TypeCanBeConverted(INamedTypeSymbol containingType, TypeDeclarationSyntax typeDeclaration)
+        {
+            // Can't convert if our Program type derives or implements anything special.
+            if (containingType.BaseType?.SpecialType != SpecialType.System_Object)
+                return false;
+
+            if (containingType.AllInterfaces.Length > 0)
+                return false;
+
+            // Too complex to convert many parts to top-level statements.  Just bail on this for now.
+            if (containingType.DeclaringSyntaxReferences.Length > 1)
+                return false;
+
+            // Too complex to support converting a nested type.
+            if (containingType.ContainingType != null)
+                return false;
+
+            // If the type wasn't internal it might have been public and something outside this assembly might be using it.
+            if (containingType.DeclaredAccessibility == Accessibility.Public)
+                return false;
+
+            // type can't be converted with attributes.
+            if (typeDeclaration.AttributeLists.Count > 0)
+                return false;
+
+            // can't convert doc comments to top level statements.
+            if (typeDeclaration.GetLeadingTrivia().Any(t => t.IsDocComment()))
+                return false;
+
+            // All the members of the type need to be private/static.  And we can only have fields or methods. that's to
+            // ensure that no one else was calling into this type, and that we can convert everything in the type to
+            // either locals or local-functions.
+
+            foreach (var member in typeDeclaration.Members)
+            {
+                // method can't be converted with attributes.  While a local function could support it, it would likely
+                // change the meaning of the program if reflection is being used to try to find this method.
+                if (member.AttributeLists.Count > 0)
+                    return false;
+
+                // if not private, can't convert as something may be referencing it.
+                if (member.Modifiers.Any(m => m.Kind() is SyntaxKind.PublicKeyword or SyntaxKind.ProtectedKeyword or SyntaxKind.InternalKeyword))
+                    return false;
+
+                if (!member.Modifiers.Any(SyntaxKind.StaticKeyword))
+                    return false;
+
+                if (member is not FieldDeclarationSyntax and not MethodDeclarationSyntax)
+                    return false;
+
+                // if a method, it has to actually have a body so we can convert it to a local function.
+                if (member is MethodDeclarationSyntax { Body: null, ExpressionBody: null })
+                    return false;
+
+                // can't convert doc comments to top level statements.
+                if (member.GetLeadingTrivia().Any(t => t.IsDocComment()))
+                    return false;
+            }
+
+            return true;
+        }
+    }
+}

src/Analyzers/CSharp/Analyzers/ConvertProgram/ConvertToProgramMainDiagnosticAnalyzer.cs

@@ -0,0 +1,65 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+using System.Collections.Immutable;
+using Microsoft.CodeAnalysis.CodeStyle;
+using Microsoft.CodeAnalysis.CSharp.Analyzers.ConvertProgram;
+using Microsoft.CodeAnalysis.CSharp.CodeStyle;
+using Microsoft.CodeAnalysis.CSharp.Syntax;
+using Microsoft.CodeAnalysis.Diagnostics;
+
+namespace Microsoft.CodeAnalysis.CSharp.TopLevelStatements
+{
+    using static ConvertProgramAnalysis;
+
+    [DiagnosticAnalyzer(LanguageNames.CSharp)]
+    internal sealed class ConvertToProgramMainDiagnosticAnalyzer : AbstractBuiltInCodeStyleDiagnosticAnalyzer
+    {
+        public ConvertToProgramMainDiagnosticAnalyzer()
+            : base(
+                  IDEDiagnosticIds.UseProgramMainId,
+                  EnforceOnBuildValues.UseProgramMain,
+                  CSharpCodeStyleOptions.PreferTopLevelStatements,
+                  LanguageNames.CSharp,
+                  new LocalizableResourceString(nameof(CSharpAnalyzersResources.Convert_to_Program_Main_style_program), CSharpAnalyzersResources.ResourceManager, typeof(CSharpAnalyzersResources)))
+        {
+        }
+
+        public override DiagnosticAnalyzerCategory GetAnalyzerCategory()
+            => DiagnosticAnalyzerCategory.SemanticDocumentAnalysis;
+
+        protected override void InitializeWorker(AnalysisContext context)
+        {
+            context.RegisterCompilationStartAction(context =>
+            {
+                if (!IsApplication(context.Compilation))
+                    return;
+
+                context.RegisterSyntaxNodeAction(ProcessCompilationUnit, SyntaxKind.CompilationUnit);
+            });
+        }
+
+        private void ProcessCompilationUnit(SyntaxNodeAnalysisContext context)
+        {
+            var options = context.Options;
+            var root = (CompilationUnitSyntax)context.Node;
+
+            var optionSet = options.GetAnalyzerOptionSet(root.SyntaxTree, context.CancellationToken);
+            var option = optionSet.GetOption(CSharpCodeStyleOptions.PreferTopLevelStatements);
+
+            if (!CanOfferUseProgramMain(option, root, context.Compilation, forAnalyzer: true))
+                return;
+
+            var severity = option.Notification.Severity;
+
+            context.ReportDiagnostic(DiagnosticHelper.Create(
+                this.Descriptor,
+                GetUseProgramMainDiagnosticLocation(
+                    root, isHidden: severity.WithDefaultSeverity(DiagnosticSeverity.Hidden) == ReportDiagnostic.Hidden),
+                severity,
+                ImmutableArray<Location>.Empty,
+                ImmutableDictionary<string, string?>.Empty));
+        }
+    }
+}