Rebus.UnitOfWork 7.0.1

dotnet add package Rebus.UnitOfWork --version 7.0.1                
NuGet\Install-Package Rebus.UnitOfWork -Version 7.0.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Rebus.UnitOfWork" Version="7.0.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Rebus.UnitOfWork --version 7.0.1                
#r "nuget: Rebus.UnitOfWork, 7.0.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Rebus.UnitOfWork as a Cake Addin
#addin nuget:?package=Rebus.UnitOfWork&version=7.0.1

// Install Rebus.UnitOfWork as a Cake Tool
#tool nuget:?package=Rebus.UnitOfWork&version=7.0.1                

Rebus.UnitOfWork

install from nuget

Provides a unit of work helper for Rebus.

alternate text is missing from this package README image


The unit of work helper works with C# generics and lets you represent your unit of work as anything that makes sense to you.

You configure it like this:

Configure.With(activator)
    .Transport(t => t.Use(...))
    .Options(o => o.EnableUnitOfWork(...))
    .Start();

for the synchronous version, or

Configure.With(activator)
    .Transport(t => t.Use(...))
    .Options(o => o.EnableAsyncUnitOfWork(...))
    .Start();

if you want a unit of work that supports asynchronous creation, completion, etc.

An example could be an Entity Framework database context, MyDbContext, which you then manage like this:

Configure.With(activator)
    .Transport(t => t.Use(...))
    .Options(o => o.EnableAsyncUnitOfWork(
        create: async context => new MyDbContext(),
        commit: async (context, uow) => await uow.SaveChangesAsync(),
        dispose: async (context, uow) => uow.Dispose()
    ))
    .Start();

By the power of C# generics, uow passed to the commit and dispose functions above will have the save type as the one returned from the create method.

context will be the current IMessageContext, which is also statically accessible via MessageContext.Current, this way enabling injection of your unit of work by using the message context to share it:

Configure.With(activator)
    .Transport(t => t.Use(...))
    .Options(o => o.EnableAsyncUnitOfWork(
        create: async context =>
        {
            var uow = new MyDbContext();
            context.TransactionContext.Items["current-uow"] = uow;
            return uow;
        },
        commit: async (context, uow) => await uow.SaveChangesAsync(),
        dispose: async (context, uow) => uow.Dispose()
    ))
    .Start();

and then you can configure your IoC container to be able to inject MyDbContext - e.g. with Microsoft Extensions Dependency Injection like this:

services.AddScoped(p =>
{
    var context = p.GetService<IMessageContext>() 
                    ?? throw new InvalidOperationException("Cannot resolve db context outside of Rebus handler, sorry");

    return context.TransactionContext.Items.TryGetValue("current-uow", out var result)
        ? (MyDbContext)result
        : throw new ArgumentException("Didn't find db context under 'current-uow' key in current context");

});

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Rebus.UnitOfWork:

Package Downloads
Revo.Rebus

Event Sourcing, CQRS and DDD framework for modern C#/.NET applications. Rebus (service bus) messaging integration package.

Vedaantees.Framework.Providers

Providers implementation for the framework.

Dbosoft.Rebus.SimpleInjector

A extension to Rebus to configure transports and other settings via dependency injection.

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Rebus.UnitOfWork:

Repository Stars
revoframework/Revo
Event Sourcing, CQRS and DDD framework for C#/.NET Core.
rebus-org/RebusSamples
Small sample projects
Version Downloads Last updated
7.0.1 2,072 11/15/2023
7.0.0 164 11/15/2023
6.0.0 544,700 4/28/2020
4.0.0 143,613 8/15/2017
4.0.0-b02 819 5/18/2017
4.0.0-b01 765 5/1/2017
3.0.0 1,572 1/5/2017
2.0.0 1,446 9/20/2016
2.0.0-b01 783 9/9/2016
0.99.74 1,232 8/29/2016
0.99.73 998 8/12/2016
0.99.72 955 8/4/2016
0.99.71 1,260 8/3/2016
0.99.70 1,087 7/29/2016
0.99.68 972 7/18/2016
0.99.67 951 7/1/2016
0.99.66 982 6/28/2016
0.99.65 949 6/23/2016
0.99.64 937 6/22/2016
0.99.63 973 6/21/2016
0.99.62 998 6/17/2016
0.99.61 937 6/17/2016
0.99.60 1,088 6/15/2016
0.99.59 1,010 6/3/2016
0.99.58 1,022 5/24/2016
0.99.57 1,007 5/22/2016
0.99.56 1,018 5/22/2016
0.99.55 1,007 5/16/2016
0.99.54 976 5/12/2016
0.99.53 951 5/12/2016
0.99.52 961 5/11/2016
0.99.51 957 5/9/2016
0.99.50 989 4/13/2016
0.99.48 1,011 4/6/2016
0.99.47 985 3/31/2016
0.99.46 983 3/30/2016
0.99.45 976 3/29/2016
0.99.44 974 3/26/2016
0.99.43 988 3/26/2016
0.99.42 984 3/22/2016
0.99.41 945 3/17/2016
0.99.40 1,023 3/15/2016
0.99.39 968 3/14/2016
0.99.38 962 3/9/2016
0.99.37 994 3/9/2016
0.99.36 951 3/3/2016
0.99.35 1,001 2/22/2016
0.99.34 979 2/19/2016
0.99.33 1,092 2/12/2016
0.99.32 987 2/10/2016
0.99.31 1,006 2/8/2016
0.99.30 988 2/5/2016
0.99.29 979 2/2/2016
0.99.27 1,036 1/28/2016
0.99.26 958 1/27/2016
0.99.25 1,007 1/22/2016