Added samples to the API - #40930
Merged
Craig Loewen (craigloewen-msft) merged 5 commits intoJul 7, 2026
Merged
Added samples to the API#40930
Conversation
Copilot started reviewing on behalf of
Craig Loewen (craigloewen-msft)
June 26, 2026 21:36
View session
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a set of standalone samples under doc/samples/ demonstrating how to use the WSL Container API (Microsoft.WSL.Containers) from C, C++/WinRT, and C#—intended to be referenced from WSL documentation.
Changes:
- Adds three runnable “pull/run” samples: C (HelloWorld), C++/WinRT (Neofetch), and C# (Nextcloud).
- Adds a C# sample that demonstrates building and running a custom container image via the SDK’s
<WslcImage>MSBuild integration. - Adds a samples index README plus a samples-local
.gitignoreto support keeping these hand-authored project files in-repo.
Reviewed changes
Copilot reviewed 21 out of 21 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| doc/samples/WSLC-NextCloud/WSLCNextCloud.csproj | New .NET 8 console project referencing Microsoft.WSL.Containers. |
| doc/samples/WSLC-NextCloud/README.md | Build/run/storage instructions for the Nextcloud sample. |
| doc/samples/WSLC-NextCloud/Program.cs | C# sample that pulls nextcloud and runs it with port + volume mapping. |
| doc/samples/WSLC-Neofetch/WSLCNeofetch.vcxproj.filters | VS filters file for the Neofetch sample project. |
| doc/samples/WSLC-Neofetch/WSLCNeofetch.vcxproj | C++/WinRT sample project wiring NuGet packages + build settings. |
| doc/samples/WSLC-Neofetch/WSLCNeofetch.sln | VS solution for building the Neofetch sample. |
| doc/samples/WSLC-Neofetch/README.md | Build/run instructions for the Neofetch sample. |
| doc/samples/WSLC-Neofetch/packages.config | NuGet dependencies for the C++/WinRT Neofetch sample. |
| doc/samples/WSLC-Neofetch/neofetch.cpp | C++/WinRT sample that runs neofetch in a container and streams output. |
| doc/samples/WSLC-HelloWorld/WSLCHelloWorld.vcxproj | C sample project wiring the WSLC SDK package. |
| doc/samples/WSLC-HelloWorld/WSLCHelloWorld.sln | VS solution for building the HelloWorld C sample. |
| doc/samples/WSLC-HelloWorld/README.md | Build/run instructions for the HelloWorld sample. |
| doc/samples/WSLC-HelloWorld/packages.config | NuGet dependency for the HelloWorld sample. |
| doc/samples/WSLC-HelloWorld/helloworld.c | Minimal C sample using the flat wslcsdk.h API to run echo. |
| doc/samples/WSLC-CustomContainer/WSLCCustomContainer.csproj | C# project that auto-builds a custom image via <WslcImage>. |
| doc/samples/WSLC-CustomContainer/README.md | Explains the <WslcImage> auto-build flow and how to run the sample. |
| doc/samples/WSLC-CustomContainer/Program.cs | C# sample that loads a locally-built image tar and runs a Python tool inside. |
| doc/samples/WSLC-CustomContainer/Container/qr.py | Python tool that prints an ASCII/Unicode QR code in the container. |
| doc/samples/WSLC-CustomContainer/Container/Containerfile | Containerfile that installs qrcode and copies qr.py. |
| doc/samples/README.md | Top-level index describing all four samples. |
| doc/samples/.gitignore | Samples-local ignore rules + re-includes for project files normally ignored at repo root. |
![github-code-quality[bot]](https://cdn.statically.io/img/avatars.githubusercontent.com/u/9919?s=60&v=4){kind=small}
Blue (OneBlue)
left a comment
Blue (OneBlue)
left a comment
Collaborator
There was a problem hiding this comment.
Change looks good overall, couple minor comments
I also recommend add a pipeline to validate that all of these actually build (we can use a GH pipeline to make this easy, and only trigger it when doc/samples is edited
Copilot started reviewing on behalf of
Craig Loewen (craigloewen-msft)
July 6, 2026 15:18
View session
…icrosoft/wsl into user/crloewen/wslc-api-samples
Member
Author
|
Fixed up requests - should be good to merge now I think! |
Craig Loewen (craigloewen-msft)
enabled auto-merge (squash)
July 6, 2026 17:03
Blue (OneBlue)
approved these changes
Jul 7, 2026
Blue (OneBlue)
left a comment
Blue (OneBlue)
left a comment
Collaborator
There was a problem hiding this comment.
LGTM. I think it would be a good idea to have a github action pipeline to build the sample, just to make sure that they don't get broken in future changes, but this can be done in a future change
Craig Loewen (craigloewen-msft)
deleted the
user/crloewen/wslc-api-samples
branch
July 7, 2026 23:33
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Added 4 basic samples for the WSLC API that will be referenced in the WSL docs.