MVP POC

This is a working prototype.

Author: A9G-Data-Droid

MermaidGraph.NET.md

@@ -0,0 +1,8 @@
+```mermaid
+graph TD
+    MermaidGraph.NET --> mermaid-graph
+    mermaid-graph -->|NuGet| Microsoft.Build
+    mermaid-graph -->|NuGet| Microsoft.Build.Locator
+    mermaid-graph -->|NuGet| Microsoft.Build.Utilities.Core
+    mermaid-graph -->|NuGet| System.CommandLine.DragonFruit
+```

README.md

@@ -1,2 +1,7 @@
 # MermaidGraph.NET
  Create a mermaid graph of the dependency diagram for a project, or whole solution.
+
+## Example
+{!MermaidGraph.NET.md!}
+
+[MermaidGraph.NET.md](MermaidGraph.NET.md)

mermaid-graph/Commands.cs

@@ -0,0 +1,78 @@
+using System.Text;
+using Microsoft.Build.Construction;
+using Microsoft.Build.Evaluation;
+
+namespace MermaidGraph;
+
+/// <summary>
+/// The commands that can be run by `mermaid-graph`
+/// </summary>
+public static class Commands
+{
+    private static readonly StringBuilder Graph = new();
+
+    private const string Fence = "```";
+
+    static Commands()
+    {
+        Graph.AppendLine(Fence + "mermaid");
+        Graph.AppendLine("graph TD");
+    }
+
+    /// <summary>
+    /// Generate the dependency graph of a Visual Studio Project.
+    /// </summary>
+    /// <param name="path">Full path to `.csproj` file.</param>
+    public static void Project(string path)
+    {
+        GraphProject(path);
+        Graph.AppendLine(Fence);
+        Console.WriteLine(Graph.ToString());
+    }
+
+    private static void GraphProject(string path)
+    {
+        // Load project
+        var project = new Project(path);
+        var projectName = Path.GetFileNameWithoutExtension(path);
+
+        foreach (var item in project.GetItems("ProjectReference"))
+        {
+            string refPath = item.EvaluatedInclude;
+            string refName = Path.GetFileNameWithoutExtension(refPath);
+            Graph.AppendLine($"    {projectName} --> {refName}");
+        }
+
+        foreach (var item in project.GetItems("PackageReference"))
+        {
+            string packageName = item.EvaluatedInclude;
+            Graph.AppendLine($"    {projectName} -->|NuGet| {packageName}");
+        }
+    }
+
+    /// <summary>
+    /// Generate the dependency graph of a Visual Studio Solution.
+    /// </summary>
+    /// <param name="path">Full path to `.sln` file.</param>
+    public static void Solution(string path)
+    {
+        var solutionFile = SolutionFile.Parse(path);
+        var solutionName = Path.GetFileNameWithoutExtension(path);
+        foreach (var project in solutionFile.ProjectsInOrder)
+        {
+            if (project.ProjectType == SolutionProjectType.KnownToBeMSBuildFormat)
+            {
+                var projectPath = project.AbsolutePath;
+                var projectName = Path.GetFileNameWithoutExtension(projectPath);
+                Graph.AppendLine($"    {solutionName} --> {projectName}");
+                if (File.Exists(projectPath))
+                {
+                    GraphProject(projectPath);
+                }
+            }
+        }
+
+        Graph.AppendLine(Fence);
+        Console.WriteLine(Graph.ToString());
+    }
+}

mermaid-graph/Program.cs

@@ -1,81 +1,55 @@
-using System.Text;
-using Microsoft.Build.Evaluation;
-using Microsoft.Build.Locator;
+using Microsoft.Build.Locator;
 
-namespace mermaid_graph;
+namespace MermaidGraph;
 
-internal class Program
+// ReSharper disable UnusedMember.Global
+
+/// <summary>
+/// mermaid-graph.exe
+/// </summary>
+internal sealed class Program
 {
     /// <summary>
     /// Outputs a mermaid graph of the dependency diagram for a project, or whole solution.
     /// </summary>
     /// <param name="path">Full path to the solution (*.sln) or project (*.csproj) file that will be mapped.</param>
     /// <returns>HResult</returns>
-    static int Main(string path)
+    internal static int Main(string path)
     {
-        if (!File.Exists(path))
+        var file = new FileInfo(path);
+        if (!file.Exists)
         {
             Console.WriteLine($"Error: File not found - {path}");
             return 1;
         }
 
-        // Register the MSBuild instance (needed for Microsoft.Build.Evaluation)
-        MSBuildLocator.RegisterDefaults();
-
-        if (path.EndsWith(".csproj"))
+        try
         {
-            return Commands.Project(path);
+            // Ensure MSBuild is registered
+            if (!MSBuildLocator.IsRegistered)
+            {
+                MSBuildLocator.RegisterDefaults();
+            }
+
+            if (path.EndsWith(".csproj"))
+            {
+                Commands.Project(file.FullName);
+                return 0;
+            }
+
+            if (path.EndsWith(".sln"))
+            {
+                Commands.Solution(file.FullName);
+                return 0;
+            }
         }
-
-        if (path.EndsWith(".sln"))
+        catch (Exception ex)
         {
-            return Commands.Solution(path);
+            Console.WriteLine(ex);
+            return ex.HResult;
         }
 
         Console.WriteLine($"Error: Unsupported file type - {path}");
         return 2;
     }
-}
-
-public static class Commands
-{
-    /// <summary>
-    /// Generate
-    /// </summary>
-    
-    public static int Project(string path)
-    {
-        // Load project
-        var project = new Project(path);
-
-        var sb = new StringBuilder("```");
-        sb.AppendLine("graph TD;");
-
-        string projectName = Path.GetFileNameWithoutExtension(path);
-
-        // Add ProjectReferences
-        foreach (var item in project.GetItems("ProjectReference"))
-        {
-            string refPath = item.EvaluatedInclude;
-            string refName = Path.GetFileNameWithoutExtension(refPath);
-            sb.AppendLine($"    {projectName} --> {refName}");
-        }
-
-        // Add PackageReferences
-        foreach (var item in project.GetItems("PackageReference"))
-        {
-            string packageName = item.EvaluatedInclude;
-            sb.AppendLine($"    {projectName} -->|NuGet| {packageName}");
-        }
-
-        // Output Mermaid.js graph
-        Console.WriteLine(sb.ToString());
-
-        return 0;
-    }
-
-    internal static int Solution(string path)
-    {
-        throw new NotImplementedException();
-    }
 }

mermaid-graph/Properties/launchSettings.json

@@ -2,7 +2,7 @@
   "profiles": {
     "mermaid-graph": {
       "commandName": "Project",
-      "commandLineArgs": "--path \"..\\..\\..\\mermaid-graph.csproj\""
+      "commandLineArgs": "--path \"..\\..\\..\\..\\MermaidGraph.NET.sln\""
     }
   }
 }

mermaid-graph/mermaid-graph.csproj

@@ -3,18 +3,24 @@
   <PropertyGroup>
     <OutputType>Exe</OutputType>
     <TargetFramework>net9.0</TargetFramework>
-    <RootNamespace>mermaid_graph</RootNamespace>
+    <RootNamespace>MermaidGraph</RootNamespace>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <InvariantGlobalization>true</InvariantGlobalization>
+    <EnforceCodeStyleInBuild>True</EnforceCodeStyleInBuild>
+    <AnalysisLevel>latest-recommended</AnalysisLevel>
+    <PackAsTool>True</PackAsTool>
+    <StartupObject>MermaidGraph.Program</StartupObject>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
     <WarningLevel>8</WarningLevel>
+    <CheckForOverflowUnderflow>True</CheckForOverflowUnderflow>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
     <WarningLevel>8</WarningLevel>
+    <CheckForOverflowUnderflow>True</CheckForOverflowUnderflow>
   </PropertyGroup>
 
   <ItemGroup>