implementation of 'gcperfsim-functional' command

src/benchmarks/gc/GC.Infrastructure/Configurations/GCPerfSim/GCPerfSimFunctionalRun.yaml

@@ -0,0 +1,18 @@
+output_path: C:\Outputs\GCPerfsimFunctionalTest
+gcperfsim_path: C:\performance\artifacts\bin\GCPerfSim\release\net7.0\GCPerfSim.dll
+
+coreruns:
+  segments: 
+    path: C:\runtime_rc2\artifacts\tests\coreclr\windows.x64.Release\Tests\Core_Root\corerun.exe
+    environment_variables:
+        COMPlus_GCName: clrgc.dll
+  regions:
+    path: C:\runtime_ga\artifacts\tests\coreclr\windows.x64.Release\Tests\Core_Root\corerun.exe
+    environment_variables:
+        COMPlus_GCName: clrgc.dll
+
+environment:
+  environment_variables:
+    COMPlus_GCName: clrgc.dll 
+
+trace_configuration_type: gc # Choose between: none, gc, verbose, cpu, cpu_managed, threadtime, join.

src/benchmarks/gc/GC.Infrastructure/GC.Infrastructure.Core/Configurations/GCPerfSimFunctional.Configuration.cs

@@ -0,0 +1,64 @@
+using GC.Infrastructure.Core.Configurations.GCPerfSim;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace GC.Infrastructure.Core.Configurations
+{
+    public sealed class GCPerfSimFunctionalConfiguration
+    {
+        public string output_path { get; set; }
+        public string gcperfsim_path { get; set; }
+        public Dictionary<string, CoreRunInfo> coreruns { get; set; }
+        public Environment Environment { get; set; } = new();
+        public string trace_configuration_type { get; set; } = "gc";
+    }
+    public class Environment
+    {
+        public Dictionary<string, string> environment_variables { get; set; } = new();
+    }
+
+    public static class GCPerfSimFunctionalConfigurationParser
+    {
+        public static GCPerfSimFunctionalConfiguration Parse(string path)
+        {
+            string serializedConfiguration = File.ReadAllText(path);
+
+            GCPerfSimFunctionalConfiguration? configuration = null;
+
+            try
+            {
+                configuration = Common.Deserializer.Deserialize<GCPerfSimFunctionalConfiguration>(serializedConfiguration);
+            }
+            catch (Exception ex)
+            {
+                throw new ArgumentException($"{nameof(GCPerfSimFunctionalConfigurationParser)}: Unable to parse the yaml file because of an error in the syntax. Please use the configurations under: Configuration/GCPerfSim/*.yaml in as example to ensure the file is formatted correctly. Exception: {ex.Message} \n Call Stack: {ex.StackTrace}");
+            }
+
+            // Preconditions.
+            if (configuration.coreruns == null)
+            {
+                throw new ArgumentException($"{nameof(GCPerfSimFunctionalConfigurationParser)}: Provide a set of coreruns use for the analysis.");
+            }
+
+            if (string.IsNullOrEmpty(configuration.output_path))
+            {
+                throw new ArgumentException($"{nameof(GCPerfSimFunctionalConfigurationParser)}: Provide an output path.");
+            }
+
+            if (string.IsNullOrEmpty(configuration.gcperfsim_path) || !File.Exists(configuration.gcperfsim_path))
+            {
+                throw new ArgumentException($"{nameof(GCPerfSimFunctionalConfigurationParser)}: A path to the gcperfsim dll must be provided or exist.");
+            }
+
+            if (configuration.trace_configuration_type == null || string.IsNullOrEmpty(configuration?.trace_configuration_type))
+            {
+                throw new ArgumentException($"{nameof(GCPerfSimFunctionalConfigurationParser)}: Please provide the trace_configuration type");
+            }
+
+            return configuration;
+        }
+    }
+}

src/benchmarks/gc/GC.Infrastructure/GC.Infrastructure.Core/Presentation/MarkdownReportBuilder.cs

@@ -81,6 +81,24 @@ public static void AddIncompleteTestsSection(this StreamWriter sw, Dictionary<st
             }
         }
 
+        public static void AddIncompleteTestsSectionWithYamlFileName(this StreamWriter sw, string yamlFileName, Dictionary<string, ProcessExecutionDetails> executionDetails)
+        {
+            sw.WriteLine($"# Incomplete Tests: {yamlFileName}.yaml");
+
+            foreach (var p in executionDetails)
+            {
+                if (p.Value.HasFailed)
+                {
+                    sw.WriteLine($"### {p.Key}");
+                    sw.WriteLine($"Standard Error: {p.Value.StandardError}\n");
+                    sw.WriteLine();
+                    sw.WriteLine($"Standard Out: {p.Value.StandardOut}\n");
+                    sw.WriteLine();
+                    sw.WriteLine($"Repro: \n ```{p.Value.CommandlineArgs}```\n");
+                }
+            }
+        }
+
         public static void AddReproSection(this StreamWriter sw, Dictionary<string, ProcessExecutionDetails> executionDetails)
         {
             sw.WriteLine("## Repro Steps");