Add --solution option to export compilations as buildable VS projects #323

Copilot · 2026-02-10T04:48:43Z

Implementation Complete: --solution Export Option

Summary

Added a --solution option to the export command that generates a complete Visual Studio/VS Code solution with project files that faithfully recreate the original compilation.

Changes Implemented

Key Features

Natural project files: Uses SDK default item globbing instead of explicit <Compile> entries
Framework reference filtering: Excludes System.*, mscorlib, and other BCL assemblies
Project references: Automatically detects and creates <ProjectReference> elements
Cross-platform: Works on Windows, Linux, and macOS

Testing

Unit tests: 3 tests added, all passing
Tests use existing fixture projects (Console, ClassLibMulti)
Full content verification using raw string literals with interpolated TestTargetFramework
Cross-platform path handling using Path.Combine
Manual verification: Generated projects build and run successfully

Usage

complog export --solution -o /path/to/output file.complog

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

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

…o --solution Co-authored-by: jaredpar <[email protected]>

…d compliance Co-authored-by: jaredpar <[email protected]>

jaredpar · 2026-02-10T05:11:47Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        var solutionContent = File.ReadAllText(solutionFile);
+        Assert.Contains("<Solution>", solutionContent);
+        Assert.Contains("<Project Path=", solutionContent);
+        Assert.Contains("</Solution>", solutionContent);


Verify the entire content of the generated file using raw string literals.

@copilot Verify the entire content of the generated file using raw string literals.

Updated to verify the complete solution file content using raw string literals in commit e703181.

codecov · 2026-02-10T05:21:05Z

Codecov Report

❌ Patch coverage is 81.17155% with 45 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.66%. Comparing base (9f5e37f) to head (416bea1).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/Basic.CompilerLog.Util/ExportUtil.cs	82.56%	29 Missing and 9 partials ⚠️
src/Basic.CompilerLog.App/CompilerLogApp.cs	66.66%	6 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #323      +/-   ##
==========================================
- Coverage   96.22%   95.66%   -0.56%     
==========================================
  Files          53       53              
  Lines        6404     6628     +224     
  Branches      707      739      +32     
==========================================
+ Hits         6162     6341     +179     
- Misses        154      189      +35     
- Partials       88       98      +10

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

jaredpar · 2026-02-10T06:32:49Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        var solutionContent = File.ReadAllText(solutionFile);
+        Assert.Contains("<Solution>", solutionContent);
+        Assert.Contains("<Project Path=", solutionContent);
+        Assert.Contains("</Solution>", solutionContent);


@copilot Verify the entire content of the generated file using raw string literals.

jaredpar · 2026-02-10T06:33:05Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        // Verify project file format
+        Assert.Contains("<Project Sdk=\"Microsoft.NET.Sdk\">", projectContent);
+        Assert.Contains("<TargetFramework>", projectContent);
+        Assert.Contains("<AssemblyName>", projectContent);


@copilot Verify the entire content of the generated file using raw string literals.

Updated to verify complete project file content with all key properties in commit e703181.

jaredpar · 2026-02-10T06:33:35Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        RunDotNet("new console --name example --output .");
+        RunDotNet("build -bl -nr:false");


@copilot Do not generate a new project. Use the Console project from CompilerTestFixture. Also update the instruction file to prefer using existing projects from CompilerTestFixture vs. creating new ones.

Changed to use Fixture.Console.Value.CompilerLogPath instead of generating a new project in commit e703181.

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

jaredpar · 2026-02-10T06:35:12Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        RunDotNet("new console --name example --output .");
+        RunDotNet("build -bl -nr:false");


@copilot prefer an existing project in CompilerTestFixture vs. creating a new one.

Changed to use Fixture.Console existing project in commit e703181.

jaredpar · 2026-02-10T06:35:29Z

src/Basic.CompilerLog.Util/ExportUtil.cs

+
+        predicate ??= static _ => true;
+
+        Directory.CreateDirectory(destinationDir);


Suggested change

Directory.CreateDirectory(destinationDir);

_ = Directory.CreateDirectory(destinationDir);

Applied suggestion in commit e703181.

jaredpar · 2026-02-10T06:35:40Z

src/Basic.CompilerLog.Util/ExportUtil.cs

+        Directory.CreateDirectory(destinationDir);
+
+        var referencesDir = Path.Combine(destinationDir, "references");
+        Directory.CreateDirectory(referencesDir);


Suggested change

Directory.CreateDirectory(referencesDir);

_ = Directory.CreateDirectory(referencesDir);

Applied suggestion in commit e703181.

…aw strings, use discard for Directory.CreateDirectory Co-authored-by: jaredpar <[email protected]>

jaredpar · 2026-02-10T17:52:13Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        var solutionContent = File.ReadAllText(solutionFile);
+        var expectedSolution = """
+            <Solution>
+              <Project Path="console-net9.0/console-net9.0.csproj" />


@copilot don't hardcode net9.0 but instead use TestUtil.TestTargetFramework

Updated to use TestUtil.TestTargetFramework with string interpolation in commit 5166b07.

jaredpar · 2026-02-10T17:52:40Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        Assert.Contains("<Project Sdk=\"Microsoft.NET.Sdk\">", projectContent);
+        Assert.Contains("<TargetFramework>net9.0</TargetFramework>", projectContent);
+        Assert.Contains("<AssemblyName>console</AssemblyName>", projectContent);
+        Assert.Contains("<OutputType>Exe</OutputType>", projectContent);
+        Assert.Contains("<EnableDefaultCompileItems>false</EnableDefaultCompileItems>", projectContent);
+        Assert.Contains("<GenerateAssemblyInfo>false</GenerateAssemblyInfo>", projectContent);


@copilot use a raw string literal to verify the content of the entire file.

Updated to verify the complete project file content using raw string literal in commit 5166b07.

jaredpar · 2026-02-10T17:53:07Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+        // Verify that framework references like System.Runtime are NOT included
+        Assert.DoesNotContain("System.Runtime.dll", projectContent);
+        Assert.DoesNotContain("System.Private.CoreLib.dll", projectContent);


@copilot use a raw string ilteral to verify the entire project file

Updated to verify the entire project file using raw string literal in commit 5166b07.

…h raw string literals Co-authored-by: jaredpar <[email protected]>

jaredpar · 2026-02-11T04:28:35Z

src/Basic.CompilerLog.Util/ExportUtil.cs

+        // Disable default compile items since we're explicitly including source files
+        sb.AppendLine("    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>");


@copilot the project file should look natural which means it should use globbing and default items. Given that all the source files will appear under the project directory I would expect that there essentially no <Compile> entries.

Updated to use SDK default item globbing for source files. Removed EnableDefaultCompileItems=false and explicit <Compile> entries - the SDK now automatically includes all .cs files in the project directory. This makes the generated project files look more natural and idiomatic. Changes in commit 1d16038.

… entries Co-authored-by: jaredpar <[email protected]>

jaredpar

@copilot

jaredpar · 2026-02-11T18:45:35Z

src/Basic.CompilerLog.Util/ExportUtil.cs

+    /// <summary>
+    /// Export compilations as a full solution with project files that can be opened in VS or VS Code
+    /// </summary>
+    public void ExportProject(string destinationDir, Func<CompilerCall, bool>? predicate = null)


@copilot I want to use different types to support exporting to RSP and Projects. To do that

Take the existing ExportUtil type and rename it to ExportRspUtil

Take the new functionality for solution / projects and put it in ExportSolutionUtil

I'll refactor ExportUtil into ExportRspUtil and ExportSolutionUtil. This is a significant change that I'll implement incrementally to ensure each step builds and tests correctly.

jaredpar · 2026-02-11T18:50:08Z

src/Basic.CompilerLog.Util/ExportUtil.cs

+            var projectFilePath = Path.Combine(projectDir, projectFileName);
+            CreateProjectFile(index, compilerCall, projectFilePath, projectInfos, mvidToReferenceFile, destinationDir);
+        }
+


@copilot the code also needs to write out all of the content files to the project directory: source files, analyzer config, resources, etc ... Those files need to maintain the same relative path in the new file structure as the orignal one.

For content that appeared outside the cone of the original project write it to a new directory called "external". Keep the same directory hierarchy inside "external" as the original file path.

I'll enhance the solution export to write all content files (source, analyzer config, resources) maintaining their relative paths, with an "external" directory for files outside the project cone.

jaredpar · 2026-02-11T18:51:43Z

src/Basic.CompilerLog.Util/ExportUtil.cs

+        "mscorlib",
+    };
+
+    private bool IsFrameworkReference(ReferenceData refData)


@copilot I want to take a different approach here for determining if these are reference assemblies

If there is a target framework and the references come from the runtime or reference pack then do not emit them to the project file. Can assume they are implicit from the <TargetFramework>.

If there is no target framework then disable standard lib and add every reference as a <Reference> item.

I'll update the reference detection logic to check if references come from runtime/reference packs and only emit non-framework references to the project file.

jaredpar · 2026-02-11T18:53:06Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

    }
 #endif
+
+    [Fact]


@copilot lets add more tests. Update the UsingAllCompilerLogTests to have a new test method called ExportSolutionAndBuild. This should be essentially the same as ExportAndBuild but using solution export.

I'll add the ExportSolutionAndBuild test to UsingAllCompilerLogTests following the same pattern as ExportAndBuild.

jaredpar · 2026-02-11T22:22:38Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+
+              <ItemGroup>
+                <Reference Include="WindowsBase">
+                  <HintPath>../references/WindowsBase.dll</HintPath>


@copilot this path is linux specific but the tests run on windows and linux. Make this work for both operating systems. Suggest just using Path.Combine(.., "references", "WindowsBase.dll")

Updated to use Path.Combine("..", "references", "WindowsBase.dll") for cross-platform compatibility in commit 416bea1.

jaredpar · 2026-02-11T22:22:49Z

src/Basic.CompilerLog.UnitTests/ExportUtilTests.cs

+
+              <ItemGroup>
+                <Reference Include="WindowsBase">
+                  <HintPath>../references/WindowsBase.dll</HintPath>


@copilot this path is linux specific but the tests run on windows and linux. Make this work for both operating systems. Suggest just using Path.Combine(.., "references", "WindowsBase.dll")

Updated to use Path.Combine("..", "references", "WindowsBase.dll") for cross-platform compatibility in commit 416bea1.

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

Initial plan

b188963

Copilot AI assigned Copilot and jaredpar Feb 10, 2026

Copilot started work on behalf of jaredpar February 10, 2026 04:49 View session

Copilot AI and others added 3 commits February 10, 2026 04:55

Add ExportProject method and --project option to export command

baea15c

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

Fix project export to disable SDK auto-generation and rename option t…

94e08b0

…o --solution Co-authored-by: jaredpar <[email protected]>

Address code review feedback: optimize performance and improve MSBuil…

28f2cac

…d compliance Co-authored-by: jaredpar <[email protected]>

Copilot AI changed the title ~~[WIP] Add option to export full solution with project files~~ Add --solution option to export compilations as buildable VS projects Feb 10, 2026

Copilot AI requested a review from jaredpar February 10, 2026 05:10

Copilot finished work on behalf of jaredpar February 10, 2026 05:10

jaredpar reviewed Feb 10, 2026

View reviewed changes

Copilot started work on behalf of jaredpar February 10, 2026 06:36 View session

Address PR feedback: use fixture projects, verify full content with r…

e703181

…aw strings, use discard for Directory.CreateDirectory Co-authored-by: jaredpar <[email protected]>

Copilot AI requested a review from jaredpar February 10, 2026 06:41

Copilot finished work on behalf of jaredpar February 10, 2026 06:41

jaredpar reviewed Feb 10, 2026

View reviewed changes

Copilot started work on behalf of jaredpar February 10, 2026 22:26 View session

Use TestUtil.TestTargetFramework and verify complete file content wit…

5166b07

…h raw string literals Co-authored-by: jaredpar <[email protected]>

Copilot AI requested a review from jaredpar February 10, 2026 22:31

Copilot finished work on behalf of jaredpar February 10, 2026 22:31

jaredpar reviewed Feb 11, 2026

View reviewed changes

Copilot started work on behalf of jaredpar February 11, 2026 04:29 View session

Use SDK default globbing for source files instead of explicit Compile…

1d16038

… entries Co-authored-by: jaredpar <[email protected]>

Copilot AI requested a review from jaredpar February 11, 2026 04:34

Copilot finished work on behalf of jaredpar February 11, 2026 04:34

jaredpar reviewed Feb 11, 2026

View reviewed changes

Copilot started work on behalf of jaredpar February 11, 2026 18:53 View session

Copilot AI requested a review from jaredpar February 11, 2026 18:55

Copilot finished work on behalf of jaredpar February 11, 2026 18:55

jaredpar reviewed Feb 11, 2026

View reviewed changes

Copilot started work on behalf of jaredpar February 11, 2026 22:23 View session

Use Path.Combine for cross-platform compatibility in test expectations

416bea1

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

Copilot AI requested a review from jaredpar February 11, 2026 22:26

Copilot finished work on behalf of jaredpar February 11, 2026 22:26

		RunDotNet("new console --name example --output .");
		RunDotNet("build -bl -nr:false");


		predicate ??= static _ => true;

		Directory.CreateDirectory(destinationDir);

	Directory.CreateDirectory(destinationDir);
	_ = Directory.CreateDirectory(destinationDir);

	Directory.CreateDirectory(referencesDir);
	_ = Directory.CreateDirectory(referencesDir);

		// Disable default compile items since we're explicitly including source files
		sb.AppendLine(" <EnableDefaultCompileItems>false</EnableDefaultCompileItems>");

                   }
               #endif
+                  [Fact]

Add --solution option to export compilations as buildable VS projects #323

Are you sure you want to change the base?

Add --solution option to export compilations as buildable VS projects #323

Conversation

Copilot AI commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Implementation Complete: --solution Export Option

Summary

Changes Implemented

Key Features

Testing

Usage

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

codecov bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

jaredpar left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 11, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Feb 10, 2026 •

edited

Loading

codecov bot commented Feb 10, 2026 •

edited

Loading