Wolverine is a Next Generation .NET Mediator and Message Bus. Check out the documentation website at https://wolverine.netlify.app.
To work with the code, just open the wolverine.sln
file in the root of the repository and go. If you want to run
integration tests though, you'll want Docker installed locally
and to start the matching testing services with:
docker compose up -d
There's a separate README in the Azure Service Bus tests as those require an actual cloud set up (sorry, but blame Microsoft for not having a local Docker based emulator ala Localstack).
For contributors, there's a light naming style Jeremy refuses to let go of that he's used for gulp 20+ years:
- All public or internal members should be Pascal cased
- All private or protected members should be Camel cased
- Use
_
as a prefix for private fields
The build is scripted out with Bullseye in the /build
folder. To run the
build file locally, use build
with Windows or ./build.sh
on OSX or Linux.
All the documentation content is in the /docs
folder. The documentation is built and published
with Vitepress and
uses Markdown Snippets for code samples. To run the documentation
locally, you'll need a recent version of Node.js installed. To start the documentation website, first run:
npm install
Then start the actual website with:
npm run docs
To update the code sample snippets, use:
npm run mdsnippets
This is a little sad, but Wolverine started as a project named "Jasper" way, way back in 2015 as an intended reboot of an even older project named FubuMVC / FubuTransportation that was a combination web api framework and asynchronous message bus. What is now Wolverine was meant to build upon what we thought was the positive aspects of fubu's programming model but do so with a much more efficient runtime. Wolverine was largely rebooted, revamped, and renamed in 2022 with the intention of being combined with Marten into the "critter stack" for highly productive and highly performant server side development in .NET.