Skip to content

feat: HttpMock.Aspire.Hosting — first-class Aspire 13 resource for HttpMock stub servers #130

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hibri merged 16 commits into from
Apr 22, 2026
Merged

feat: HttpMock.Aspire.Hosting — first-class Aspire 13 resource for HttpMock stub servers #130

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
487fc6d
feat: add HttpMock.Aspire.Hosting package with HttpMockResource, even…
Copilot Apr 17, 2026
4a1a6aa
fix: address code review comments — document FindFreePort race, add M…
Copilot Apr 17, 2026
6291d8b
chore: plan FindFreePort consolidation
Copilot Apr 17, 2026
023f089
refactor: consolidate FindFreePort into HttpMockRepository.FindFreePo…
Copilot Apr 17, 2026
e98a9d9
docs: update README with HttpMock.Aspire.Hosting API, FindFreePort, a…
Copilot Apr 17, 2026
0ad00be
Potential fix for pull request finding
hibri Apr 17, 2026
c5e270d
Potential fix for pull request finding
hibri Apr 17, 2026
d7b4765
fix: add explicit using HttpMock; and replace hard-coded port with Fi…
Copilot Apr 17, 2026
661bcb1
refactor: remove PortHelper, replace usages with HttpMockRepository.F…
Copilot Apr 21, 2026
99adc47
remove NuGet.exe
hibri Apr 21, 2026
a317671
Merge remote-tracking branch 'origin/copilot/evaluate-httpmock-net-as…
hibri Apr 21, 2026
a2b4853
delete
hibri Apr 21, 2026
b313e9d
delete
hibri Apr 21, 2026
81b984c
remove solution folder
hibri Apr 21, 2026
d4974e2
fix test project naming
hibri Apr 22, 2026
b5653cc
fix test project naming
hibri Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/workflows/publish.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ jobs:
run: |
dotnet pack src/HttpMock/HttpMock.csproj --configuration Release --no-build -p:PackageVersion=${{ steps.version.outputs.VERSION }} --output ./nupkgs
dotnet pack src/HttpMock.Verify.NUnit/HttpMock.Verify.NUnit.csproj --configuration Release --no-build -p:PackageVersion=${{ steps.version.outputs.VERSION }} --output ./nupkgs
dotnet pack src/HttpMock.Aspire.Hosting/HttpMock.Aspire.Hosting.csproj --configuration Release --no-build -p:PackageVersion=${{ steps.version.outputs.VERSION }} --output ./nupkgs

- name: Push to NuGet.org
run: dotnet nuget push ./nupkgs/*.nupkg --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json --skip-duplicate
6 changes: 0 additions & 6 deletions .nuget/NuGet.Config
View file
Open in desktop

This file was deleted.

Binary file removed .nuget/NuGet.exe
View file
Open in desktop
Binary file not shown.
136 changes: 0 additions & 136 deletions .nuget/NuGet.targets
View file
Open in desktop

This file was deleted.

Binary file removed .nuget/nuget.exe
View file
Open in desktop
Binary file not shown.
51 changes: 51 additions & 0 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Contributing to HttpMock

Thank you for taking the time to contribute! Please read the guidelines below before opening a pull request.

## Building

```bash
dotnet build HttpMock.sln
```

## Running the tests

```bash
dotnet test HttpMock.sln
```

## Project structure

| Folder | Purpose |
|--------|---------|
| `src/HttpMock` | Core library |
| `src/HttpMock.Aspire.Hosting` | .NET Aspire hosting integration |
| `src/HttpMock.Verify.NUnit` | NUnit verification helpers |
| `examples/` | Runnable example applications |

## Test project naming conventions

Test projects must follow this naming scheme:

| Test type | Suffix | Example |
|-----------|--------|---------|
| Unit tests | `*.Unit.Tests` | `HttpMock.Unit.Tests` |
| Integration tests | `*.Integration.Tests` | `HttpMock.Integration.Tests` |

Both suffixes apply to any feature area. For example, tests for the Aspire hosting package should be named:

- `HttpMock.Aspire.Hosting.Unit.Tests`
- `HttpMock.Aspire.Hosting.Integration.Tests`

### Rationale

The consistent suffixes make it easy to:

- Filter test runs by type (`--filter FullyQualifiedName~Integration.Tests`).
- Identify the scope of a project at a glance.
- Apply CI policies (e.g. run unit tests on every push, integration tests only on PRs).

## Reporting issues

When reporting a bug, please provide a failing test that demonstrates the problem.

83 changes: 76 additions & 7 deletions HttpMock.sln
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,54 +9,123 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Integration.Tests"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Unit.Tests", "src\HttpMock.Unit.Tests\HttpMock.Unit.Tests.csproj", "{92735A21-16E8-46BC-859D-AB96F137C457}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".nuget", ".nuget", "{BF7536BA-5DEE-48E0-BD16-45E3C36B1979}"
ProjectSection(SolutionItems) = preProject
.nuget\NuGet.Config = .nuget\NuGet.Config
.nuget\NuGet.exe = .nuget\NuGet.exe
.nuget\NuGet.targets = .nuget\NuGet.targets
EndProjectSection
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Verify.NUnit", "src\HttpMock.Verify.NUnit\HttpMock.Verify.NUnit.csproj", "{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Aspire.Hosting", "src\HttpMock.Aspire.Hosting\HttpMock.Aspire.Hosting.csproj", "{263B28F3-85D5-4357-9043-11210B1799A1}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Aspire.Hosting.Unit.Tests", "src\HttpMock.Aspire.Hosting.Unit.Tests\HttpMock.Aspire.Hosting.Unit.Tests.csproj", "{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Aspire.Hosting.Integration.Tests.AppHost", "src\HttpMock.Aspire.Hosting.Integration.Tests.AppHost\HttpMock.Aspire.Hosting.Integration.Tests.AppHost.csproj", "{35191166-4086-4A21-840B-D6894E24D9FF}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "HttpMock.Aspire.Hosting.Integration.Tests", "src\HttpMock.Aspire.Hosting.Integration.Tests\HttpMock.Aspire.Hosting.Integration.Tests.csproj", "{5A9E205D-8837-4AB6-B449-15B14E13E6E0}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Debug|x86 = Debug|x86
Debug|x64 = Debug|x64
Release|Any CPU = Release|Any CPU
Release|x86 = Release|x86
Release|x64 = Release|x64
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Debug|Any CPU.Build.0 = Debug|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Debug|x86.ActiveCfg = Debug|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Debug|x64.ActiveCfg = Debug|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Debug|x64.Build.0 = Debug|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Release|Any CPU.ActiveCfg = Release|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Release|Any CPU.Build.0 = Release|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Release|x86.ActiveCfg = Release|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Release|x86.Build.0 = Release|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Release|x64.ActiveCfg = Release|Any CPU
{7D7A1C68-6D1C-4AD5-BD2E-CA2D7B76AE1C}.Release|x64.Build.0 = Release|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Debug|Any CPU.Build.0 = Debug|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Debug|x86.ActiveCfg = Debug|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Debug|x64.ActiveCfg = Debug|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Debug|x64.Build.0 = Debug|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Release|Any CPU.ActiveCfg = Release|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Release|Any CPU.Build.0 = Release|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Release|x86.ActiveCfg = Release|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Release|x86.Build.0 = Release|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Release|x64.ActiveCfg = Release|Any CPU
{3E61549A-1FAC-416B-BA50-7265E6FC1D03}.Release|x64.Build.0 = Release|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Debug|Any CPU.Build.0 = Debug|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Debug|x86.ActiveCfg = Debug|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Debug|x64.ActiveCfg = Debug|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Debug|x64.Build.0 = Debug|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Release|Any CPU.ActiveCfg = Release|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Release|Any CPU.Build.0 = Release|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Release|x86.ActiveCfg = Release|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Release|x86.Build.0 = Release|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Release|x64.ActiveCfg = Release|Any CPU
{92735A21-16E8-46BC-859D-AB96F137C457}.Release|x64.Build.0 = Release|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Debug|Any CPU.Build.0 = Debug|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Debug|x86.ActiveCfg = Debug|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Debug|x86.Build.0 = Debug|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Debug|x64.ActiveCfg = Debug|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Debug|x64.Build.0 = Debug|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Release|Any CPU.ActiveCfg = Release|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Release|Any CPU.Build.0 = Release|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Release|x86.ActiveCfg = Release|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Release|x86.Build.0 = Release|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Release|x64.ActiveCfg = Release|Any CPU
{1B61C8E3-7A43-479B-B7FE-D374DFEAA5E7}.Release|x64.Build.0 = Release|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Debug|Any CPU.Build.0 = Debug|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Debug|x86.ActiveCfg = Debug|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Debug|x86.Build.0 = Debug|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Debug|x64.ActiveCfg = Debug|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Debug|x64.Build.0 = Debug|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Release|Any CPU.ActiveCfg = Release|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Release|Any CPU.Build.0 = Release|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Release|x86.ActiveCfg = Release|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Release|x86.Build.0 = Release|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Release|x64.ActiveCfg = Release|Any CPU
{263B28F3-85D5-4357-9043-11210B1799A1}.Release|x64.Build.0 = Release|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Debug|Any CPU.Build.0 = Debug|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Debug|x86.ActiveCfg = Debug|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Debug|x86.Build.0 = Debug|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Debug|x64.ActiveCfg = Debug|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Debug|x64.Build.0 = Debug|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Release|Any CPU.ActiveCfg = Release|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Release|Any CPU.Build.0 = Release|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Release|x86.ActiveCfg = Release|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Release|x86.Build.0 = Release|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Release|x64.ActiveCfg = Release|Any CPU
{9B2EB8C3-7C3C-4BBC-8058-A9B2BA4A2E09}.Release|x64.Build.0 = Release|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Debug|Any CPU.Build.0 = Debug|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Debug|x86.ActiveCfg = Debug|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Debug|x86.Build.0 = Debug|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Debug|x64.ActiveCfg = Debug|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Debug|x64.Build.0 = Debug|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Release|Any CPU.ActiveCfg = Release|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Release|Any CPU.Build.0 = Release|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Release|x86.ActiveCfg = Release|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Release|x86.Build.0 = Release|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Release|x64.ActiveCfg = Release|Any CPU
{35191166-4086-4A21-840B-D6894E24D9FF}.Release|x64.Build.0 = Release|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Debug|Any CPU.Build.0 = Debug|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Debug|x86.ActiveCfg = Debug|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Debug|x86.Build.0 = Debug|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Debug|x64.ActiveCfg = Debug|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Debug|x64.Build.0 = Debug|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Release|Any CPU.ActiveCfg = Release|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Release|Any CPU.Build.0 = Release|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Release|x86.ActiveCfg = Release|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Release|x86.Build.0 = Release|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Release|x64.ActiveCfg = Release|Any CPU
{5A9E205D-8837-4AB6-B449-15B14E13E6E0}.Release|x64.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(NestedProjects) = preSolution
EndGlobalSection
EndGlobal
Empty file added Integration.Tests
View file
Open in desktop
Empty file.
Empty file added Integration.Tests.AppHost
View file
Open in desktop
Empty file.
Loading
Loading