add ApiListWriterOptions.WriterOptions.WriteReferencedAssemblies

Author: smdn

src/Smdn.Reflection.ReverseGenerating.ListApi.Core/Smdn.Reflection.ReverseGenerating.ListApi.Core.csproj

@@ -10,6 +10,7 @@ SPDX-License-Identifier: MIT
     <VersionSuffix></VersionSuffix>
     <PackageValidationBaselineVersion>1.0.0</PackageValidationBaselineVersion>
     <Nullable>enable</Nullable>
+    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
   </PropertyGroup>
 
   <Import Project="..\Sdk.net7.0-preview.props" />

src/Smdn.Reflection.ReverseGenerating.ListApi.Core/Smdn.Reflection.ReverseGenerating.ListApi/ApiListWriter.cs

@@ -5,6 +5,7 @@
 using System.IO;
 using System.Linq;
 using System.Reflection;
+using System.Reflection.Metadata;
 using System.Runtime.CompilerServices;
 using System.Runtime.Versioning;
 using System.Text;
@@ -33,6 +34,9 @@ public void WriteAssemblyInfoHeader()
     BaseWriter.WriteLine($"//   TargetFramework: {assembly.GetAssemblyMetadataAttributeValue<TargetFrameworkAttribute, string>()}");
     BaseWriter.WriteLine($"//   Configuration: {assembly.GetAssemblyMetadataAttributeValue<AssemblyConfigurationAttribute, string>()}");
 
+    if (options.Writer.WriteReferencedAssemblies)
+      WriteReferencedAssemblies();
+
     var manifestResourceNames = assembly.GetManifestResourceNames();
 
     if (options.Writer.WriteEmbeddedResources && 0 < manifestResourceNames.Length) {
@@ -52,6 +56,37 @@ public void WriteAssemblyInfoHeader()
     }
   }
 
+  private unsafe void WriteReferencedAssemblies()
+  {
+    if (!assembly.TryGetRawMetadata(out var blobPtr, out var blobLength))
+      return;
+
+    BaseWriter.WriteLine("//   Referenced assemblies:");
+
+    var reader = new MetadataReader(blobPtr, blobLength);
+    var assemblyReferences = reader
+      .AssemblyReferences
+      .Select(handle => reader.GetAssemblyReference(handle))
+      .ToDictionary(
+        assmRef => reader.GetString(assmRef.Name),
+        assmRef => assmRef
+      );
+
+    foreach (var (name, assmRef) in assemblyReferences.OrderBy(static pair => pair.Key, StringComparer.Ordinal)) {
+      var culture = reader.GetString(assmRef.Culture);
+
+      if (string.IsNullOrEmpty(culture))
+        culture = "neutral";
+
+      var publicKeyOrToken = reader.GetBlobBytes(assmRef.PublicKeyOrToken);
+      var publicKeyOrTokenString = publicKeyOrToken is null || publicKeyOrToken.Length == 0
+        ? string.Empty
+        : $", PublicKeyToken={string.Concat(publicKeyOrToken.Select(static b => b.ToString("x2", provider: null)))}";
+
+      BaseWriter.WriteLine($"//     {name}, Version={assmRef.Version}, Culture={culture}{publicKeyOrTokenString}");
+    }
+  }
+
   public void WriteExportedTypes()
   {
     var types = assembly.GetExportedTypes()

src/Smdn.Reflection.ReverseGenerating.ListApi.Core/Smdn.Reflection.ReverseGenerating.ListApi/ApiListWriterOptions.cs

@@ -9,5 +9,6 @@ public class WriterOptions {
     public bool OrderStaticMembersFirst { get; set; } = false;
     public bool WriteNullableAnnotationDirective { get; set; } = true;
     public bool WriteEmbeddedResources { get; set; } = true;
+    public bool WriteReferencedAssemblies { get; set; } = true;
   }
 }