Initial scaffolding and partial implementation of ilasm in C# (#122112)

Co-authored-by: Copilot <[email protected]>

Author: jkoritzinsky

eng/Subsets.props

@@ -253,6 +253,7 @@
     <SubsetName Include="Tools.Cdac" Description="Diagnostic data contract reader and related projects." />
     <SubsetName Include="Tools.ILLinkTests" OnDemand="true" Description="Unit tests for the tools.illink subset." />
     <SubsetName Include="Tools.CdacTests" OnDemand="true" Description="Unit tests for the diagnostic data contract reader." />
+    <SubsetName Include="Tools.ILAsm" OnDemand="true" Description="Build only the managed ilasm tool." />
 
     <!-- Host -->
     <SubsetName Include="Host" Description="The .NET hosts, packages, hosting libraries, and tests. Equivalent to: $(DefaultHostSubsets)" />
@@ -547,6 +548,11 @@
       Test="true" Category="tools"/>
   </ItemGroup>
 
+  <ItemGroup Condition="$(_subset.Contains('+tools.ilasm+'))">
+    <ProjectToBuild Include="$(ToolsProjectRoot)ilasm\src\ILAssembler\ILAssembler.csproj" Category="tools" />
+    <ProjectToBuild Include="$(ToolsProjectRoot)ilasm\tests\ILAssembler.Tests\ILAssembler.Tests.csproj" Category="tools" Test="true" />
+  </ItemGroup>
+
   <ItemGroup Condition="$(_subset.Contains('+clr.nativecorelib+'))">
     <ProjectToBuild Include="$(CoreClrProjectRoot)crossgen-corelib.proj" Category="clr" />
   </ItemGroup>

eng/Versions.props

@@ -141,6 +141,8 @@
     <MicrosoftBuildUtilitiesCoreVersion>17.11.48</MicrosoftBuildUtilitiesCoreVersion>
     <DotnetSosVersion>7.0.412701</DotnetSosVersion>
     <DotnetSosTargetFrameworkVersion>6.0</DotnetSosTargetFrameworkVersion>
+    <Antlr4CodeGeneratorVersion>4.6.6</Antlr4CodeGeneratorVersion>
+    <Antlr4RuntimeVersion>4.6.6</Antlr4RuntimeVersion>
     <!-- Testing -->
     <MicrosoftNETCoreCoreDisToolsVersion>1.6.0</MicrosoftNETCoreCoreDisToolsVersion>
     <MicrosoftNETTestSdkVersion>17.4.0-preview-20220707-01</MicrosoftNETTestSdkVersion>

eng/pipelines/coreclr/ilasm.yml

@@ -8,6 +8,7 @@ pr:
     include:
     - src/coreclr/ilasm/*
     - src/coreclr/ildasm/*
+    - src/tools/ilasm/*
 
 schedules:
 - cron: "0 19 * * 6"
@@ -34,3 +35,20 @@ extends:
     - windows_x86
     - windows_arm64
     testGroup: ilasm
+
+    stages:
+      - stage: Managed_ILAsm
+        displayName: Managed IL Assembler Tests
+        dependsOn: []
+        jobs:
+          - template: /eng/pipelines/common/platform-matrix.yml
+            parameters:
+              jobTemplate: /eng/pipelines/common/global-build-job.yml
+              buildConfig: Debug
+              platforms:
+              - windows_x64
+              jobParameters:
+                nameSuffix: ILAsm
+                buildArgs: -s tools.ilasm -c $(_BuildConfig) -test
+                timeoutInMinutes: 120
+        condition: and(succeeded(), ne(variables['Build.Reason'], 'Schedule'))

eng/pipelines/coreclr/templates/jit-outerloop-pipeline.yml

@@ -4,6 +4,9 @@ parameters:
   - name: testGroup
     type: string
     default: outerloop
+  - name: stages
+    type: stageList
+    default: []
 
 extends:
   template:  /eng/pipelines/common/templates/pipeline-with-resources.yml
@@ -55,3 +58,5 @@ extends:
             testGroup: ${{ parameters.testGroup }}
             liveLibrariesBuildConfig: Release
             unifiedArtifactsName: BuildArtifacts_$(osGroup)$(osSubgroup)_$(archType)_$(_BuildConfig)
+    - ${{ each stage in parameters.stages }}:
+        - ${{ stage }}

src/tools/ilasm/ilasm.slnx

@@ -0,0 +1,4 @@
+<Solution>
+  <Project Path="src/ILAssembler/ILAssembler.csproj" />
+  <Project Path="tests/ILAssembler.Tests/ILAssembler.Tests.csproj" />
+</Solution>

src/tools/ilasm/src/ILAssembler/BlobBuilderExtensions.cs

@@ -0,0 +1,98 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Reflection.Metadata;
+using System.Reflection.Metadata.Ecma335;
+using System.Text;
+
+namespace ILAssembler
+{
+    internal static class BlobBuilderExtensions
+    {
+        public static BlobBuilder SerializeSequence<T>(this ImmutableArray<T> sequence)
+        {
+            BlobBuilder builder = new BlobBuilder();
+            builder.WriteSerializedSequence(sequence);
+            return builder;
+        }
+
+        public static void WriteSerializedSequence<T>(this BlobBuilder writer, ImmutableArray<T> sequence)
+        {
+            foreach (T value in sequence)
+            {
+                WriteSerializedValue(writer, value);
+            }
+        }
+
+        public static void WriteSerializedValue<T>(this BlobBuilder writer, T value)
+        {
+            if (typeof(T) == typeof(bool))
+            {
+                writer.WriteBoolean((bool)(object)value!);
+            }
+            else if (typeof(T) == typeof(int))
+            {
+                writer.WriteInt32((int)(object)value!);
+            }
+            else if (typeof(T) == typeof(byte))
+            {
+                writer.WriteByte((byte)(object)value!);
+            }
+            else if (typeof(T) == typeof(char))
+            {
+                writer.WriteUInt16((char)(object)value!);
+            }
+            else if (typeof(T) == typeof(double))
+            {
+                writer.WriteDouble((double)(object)value!);
+            }
+            else if (typeof(T) == typeof(short))
+            {
+                writer.WriteInt16((short)(object)value!);
+            }
+            else if (typeof(T) == typeof(long))
+            {
+                writer.WriteInt64((long)(object)value!);
+            }
+            else if (typeof(T) == typeof(sbyte))
+            {
+                writer.WriteSByte((sbyte)(object)value!);
+            }
+            else if (typeof(T) == typeof(float))
+            {
+                writer.WriteSingle((float)(object)value!);
+            }
+            else if (typeof(T) == typeof(ushort))
+            {
+                writer.WriteUInt16((ushort)(object)value!);
+            }
+            else if (typeof(T) == typeof(uint))
+            {
+                writer.WriteUInt32((uint)(object)value!);
+            }
+            else if (typeof(T) == typeof(ulong))
+            {
+                writer.WriteUInt64((ulong)(object)value!);
+            }
+            else if (typeof(T) == typeof(string))
+            {
+                writer.WriteSerializedString((string?)(object?)value);
+            }
+        }
+
+        public static void WriteTypeEntity(this BlobBuilder builder, EntityRegistry.TypeEntity entity)
+        {
+            if (entity is EntityRegistry.FakeTypeEntity fakeEntity)
+            {
+                builder.WriteCompressedInteger(CodedIndex.TypeDefOrRefOrSpec(fakeEntity.TypeSignatureHandle));
+            }
+            else
+            {
+                builder.WriteCompressedInteger(CodedIndex.TypeDefOrRefOrSpec(entity.Handle));
+            }
+        }
+    }
+}