Skip to content

Add integration testing guide for Wolverine.HTTP with Alba#2423

Merged
jeremydmiller merged 1 commit intomainfrom
2408-integration-testing-guide
Apr 3, 2026
Merged

Add integration testing guide for Wolverine.HTTP with Alba#2423
jeremydmiller merged 1 commit intomainfrom
2408-integration-testing-guide

Conversation

@jeremydmiller
Copy link
Copy Markdown
Member

Summary

Closes #2408

Adds a new guide document at /guide/http/integration-testing covering integration testing of Wolverine.HTTP endpoints using Alba and Wolverine's tracked sessions.

  • Test harness setup: AppFixture + IntegrationContext base class pattern with ICollectionFixture
  • TrackedHttpCall helper: How to combine Alba's Host.Scenario() with Wolverine's ExecuteAndWaitAsync() to track all message activity triggered by an HTTP request
  • Real examples from the codebase: Publishing messages, cascading messages via tuple/OutgoingMessages, resource creation with Location headers, EF Core persistence verification
  • ITrackedSession API reference: All RecordCollection properties (Sent, Received, Executed, etc.) and query methods (SingleMessage<T>(), MessagesOf<T>(), FindSingleTrackedMessageOfType<T>())
  • TrackActivity() fluent configuration: Timeout(), DoNotAssertOnExceptionsDetected(), IncludeExternalTransports(), IgnoreMessageType<T>(), AlsoTrack(), WaitForMessageToBeReceivedAt<T>()
  • Marten-specific helpers: ResetAllMartenDataFirst(), PauseThenCatchUpOnMartenDaemonActivity(), WaitForNonStaleDaemonDataAfterExecution()
  • Testing mode helpers: RunWolverineInSoloMode() and DisableAllExternalWolverineTransports()
  • Links to Alba docs and the existing Wolverine tracked sessions guide
  • Added sidebar entry under HTTP guide section

Test plan

  • Verify the new page renders in VitePress
  • Verify sidebar navigation includes the new entry
  • Review code samples for accuracy against current API
  • Check all internal and external links resolve

🤖 Generated with Claude Code

Closes #2408. Documents how to combine Alba's in-memory HTTP testing
with Wolverine's tracked sessions to write reliable integration tests
for HTTP endpoints that publish messages or trigger cascading work.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jeremydmiller jeremydmiller merged commit 61945af into main Apr 3, 2026
34 of 38 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation for integration testing HTTP endpoints with Alba and TrackActivity

1 participant