Add CI Yaml file for CSharp Parser (#8510)

* Add CI yaml file for csharp parser

* Install csharp parser tool during deployment

Author: chidozieononiwu

src/dotnet/APIView/apiview.yml

@@ -1,3 +1,11 @@
+parameters:
+  - name: AzureSdkForNetDevOpsFeed
+    type: string
+    default: 'https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json'
+  - name: CSharpAPIParserVersion
+    type: string
+    default: '1.0.0-dev.20240626.4'
+
 trigger:
   branches:
     include:
@@ -311,6 +319,10 @@ extends:
                     echo Installing npm packages
                     call npm install --prefix D:\home\site\wwwroot --force
                     call npm run-script build --prefix D:\home\site\wwwroot --force
+                    echo Installing .NET tool
+                    call mkdir D:\home\site\wwwroot\csharp-parser
+                    call dotnet tool install --add-source ${{ parameters.AzureSdkForNetDevOpsFeed }} --version  ${{ parameters.CSharpAPIParserVersion }} --tool-path D:\home\site\wwwroot\csharp-parser CSharpAPIParser
+                    echo Installing Python tools
                     call D:\home\site\wwwroot\Python\python -m pip uninstall api-stub-generator
                     call D:\home\site\wwwroot\Python\python -m pip install pylint==2.13.9 pylint-guidelines-checker==0.0.6 api-stub-generator==0.3.2 --index-url "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-python/pypi/simple/"
                   enableCustomDeployment: true

tools/apiview/parsers/CONTRIBUTING.md

@@ -65,7 +65,7 @@ Previously APIview tokens were created as a flat list assigned to the `CodeFileT
 
 ## Serialization
 
-Serialize the generated code file to JSON and then compress the file using Gzip compression. Try to make the json as small as possible by ignoring null values and empty collections.
+Serialize the generated code file to JSON with Gzip compression. The output file should have `.json.tgz` extension. Try to make the json as small as possible by ignoring null values and empty collections.
 Don't worry about indentation that will be handled by the tree structure. In the case you want to have indentation between the tokens then use `TabSpace` token kind.
 
 ## Examples

…csharp-api-parser/CSharpAPIParser.csproj …r/CSharpAPIParser/CSharpAPIParser.csprojtools/apiview/parsers/csharp-api-parser/CSharpAPIParser.csproj renamed to tools/apiview/parsers/csharp-api-parser/CSharpAPIParser/CSharpAPIParser.csproj tools/apiview/parsers/csharp-api-parser/CSharpAPIParser.csproj renamed to tools/apiview/parsers/csharp-api-parser/CSharpAPIParser/CSharpAPIParser.csproj

@@ -15,8 +15,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\..\..\..\src\dotnet\APIView\APIView\APIView.csproj" />
-    <ProjectReference Include="..\..\..\..\src\dotnet\Azure.ClientSdk.Analyzers\Azure.ClientSdk.Analyzers\Azure.ClientSdk.Analyzers.csproj" />
+    <ProjectReference Include="..\..\..\..\..\src\dotnet\APIView\APIView\APIView.csproj" />
+    <ProjectReference Include="..\..\..\..\..\src\dotnet\Azure.ClientSdk.Analyzers\Azure.ClientSdk.Analyzers\Azure.ClientSdk.Analyzers.csproj" />
   </ItemGroup>
 
 </Project>

…iew/parsers/csharp-api-parser/Program.cs …rp-api-parser/CSharpAPIParser/Program.cstools/apiview/parsers/csharp-api-parser/Program.cs renamed to tools/apiview/parsers/csharp-api-parser/CSharpAPIParser/Program.cs tools/apiview/parsers/csharp-api-parser/Program.cs renamed to tools/apiview/parsers/csharp-api-parser/CSharpAPIParser/Program.cs

@@ -747,7 +747,7 @@ private bool IsAccessible(ISymbol s)
                 case Accessibility.Public:
                     return true;
                 case Accessibility.Internal:
-                    return s.GetAttributes().Any(a => a.AttributeClass.Name == "FriendAttribute");
+                    return s.GetAttributes().Any(a => a.AttributeClass?.Name == "FriendAttribute");
                 default:
                     return IsAccessibleExplicitInterfaceImplementation(s);
             }

…-api-parser/TreeToken/CodeFileBuilder.cs …rpAPIParser/TreeToken/CodeFileBuilder.cstools/apiview/parsers/csharp-api-parser/TreeToken/CodeFileBuilder.cs renamed to tools/apiview/parsers/csharp-api-parser/CSharpAPIParser/TreeToken/CodeFileBuilder.cs tools/apiview/parsers/csharp-api-parser/TreeToken/CodeFileBuilder.cs renamed to tools/apiview/parsers/csharp-api-parser/CSharpAPIParser/TreeToken/CodeFileBuilder.cs

@@ -0,0 +1,27 @@
+# NOTE: Please refer to https://aka.ms/azsdk/engsys/ci-yaml before editing this file.
+trigger:
+  branches:
+    include:
+      - main
+      - feature/*
+      - release/*
+      - hotfix/*
+  paths:
+    include:
+      - tools/apiview/parsers/csharp-api-parser
+
+pr:
+  branches:
+    include:
+      - main
+      - feature/*
+      - release/*
+      - hotfix/*
+  paths:
+    include:
+      - tools/apiview/parsers/csharp-api-parser
+
+extends:
+  template: /eng/pipelines/templates/stages/archetype-sdk-tool-dotnet.yml
+  parameters:
+    PackageDirectory: $(Build.SourcesDirectory)/tools/apiview/parsers/csharp-api-parser/CSharpAPIParser

tools/apiview/parsers/csharp-api-parser/ci.yml

@@ -7,7 +7,7 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "APIView", "..\..\..\..\src\
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Azure.ClientSdk.Analyzers", "..\..\..\..\src\dotnet\Azure.ClientSdk.Analyzers\Azure.ClientSdk.Analyzers\Azure.ClientSdk.Analyzers.csproj", "{4ECD9A58-ABEB-4285-A5D7-7CDA8A558AE0}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CSharpAPIParser", "CSharpAPIParser.csproj", "{EB159E3D-9732-4EB3-A3C2-817475B9D749}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "CSharpAPIParser", "CSharpAPIParser\CSharpAPIParser.csproj", "{EB159E3D-9732-4EB3-A3C2-817475B9D749}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution