DependencyModules.xUnit.NSubstitute 1.0.0-RC9045

This is a prerelease version of DependencyModules.xUnit.NSubstitute.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package DependencyModules.xUnit.NSubstitute --version 1.0.0-RC9045
                    
NuGet\Install-Package DependencyModules.xUnit.NSubstitute -Version 1.0.0-RC9045
                    
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="DependencyModules.xUnit.NSubstitute" Version="1.0.0-RC9045" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DependencyModules.xUnit.NSubstitute" Version="1.0.0-RC9045" />
                    
Directory.Packages.props
<PackageReference Include="DependencyModules.xUnit.NSubstitute" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DependencyModules.xUnit.NSubstitute --version 1.0.0-RC9045
                    
#r "nuget: DependencyModules.xUnit.NSubstitute, 1.0.0-RC9045"
                    
#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.
#addin nuget:?package=DependencyModules.xUnit.NSubstitute&version=1.0.0-RC9045&prerelease
                    
Install DependencyModules.xUnit.NSubstitute as a Cake Addin
#tool nuget:?package=DependencyModules.xUnit.NSubstitute&version=1.0.0-RC9045&prerelease
                    
Install DependencyModules.xUnit.NSubstitute as a Cake Tool

DependencyModules

DependencyModules is a C# source generator package that uses attributes to create dependency injection registration modules. These packages can then be used to populate an IServiceCollection instance.

Installation

dotnet add package DependencyModules.Runtime
dotnet add package DependencyModules.SourceGenerator

Service Attributes

  • [DependencyModule] - used to attribute class that will become dependency module (must be partial)
  • [SingletonService] - registers service as AddSingleton
  • [ScopedService] - registers service as AdddScoped
  • [TransientService] - registers service as AddTransient
// Registration example
[DependencyModule]
public partial class MyDeps { }

[SingletonService(ServiceType = typeof(ISomeService)]
public class SomeClass : ISomeService 
{
  public string SomeProp => "SomeString";
}

[TransientService]
public class OtherService
{
  public OtherService(ISomeService service)
  { 
    SomeProp = service.SomeProp;
  }
  public string SomeProp { get; }
}

Container Instantiation

AddModule - method adds modules to service collection

var serviceCollection = new ServiceCollection();

serviceCollection.AddModule<MyDeps>();

var provider = serviceCollection.BuildServiceProvider();

var service = provider.GetService<OtherService>();

Module Re-use

DependencyModules creates a ModuleAttribute class that can be used to apply sub dependencies.

// Modules can be re-used with the generated attributes
[DependencyModule]
[MyDeps.Module]
public partial class AnotherModule { }

Parameters

Sometimes you want to provide extra registration for your module. This can be achieved by adding a constructor to your module or optional properties. Note these parameters and properties will be correspondingly implemented in the module attribute.

[DependencyModule]
public partial class SomeProject : IServiceCollectionConfiguration 
{
  private bool _someFlag;
  public SomeProject(bool someFlag = false)
  {
    _someFlag = someFlag;
  }
  
  public string OptionalString { get; set; } = "";
  
  public void ConfigureServices(IServiceCollection services) 
  {
    if (_someFlag) 
    {
      // custom registration
    } 
  }
}

[DependencyModule]
[SomeProject.Module(true, OptionalString = "otherString")]
public partial class SomeOtherModule 
{

}

Realm

By default, all dependencies are registered in all modules within the same assembly. The realm allows the developer to scope down the registration within a given module.

// register only dependencies specifically marked for this realm
[DependencyModule(OnlyRealm = true)]
public partial class AnotherModule { }

[SingletonService(ServiceType = typeof(ISomeInterface), 
  Realm = typeof(AnotherModule))]
public class SomeDep : ISomeInterface { }

Unit testing & Mocking

DependencyModules provides an xUnit extension to make testing much easier. It handles the population and construction of a service provider using specified modules.

> dotnet add package DependencyModules.xUnit
> dotnet add package DependencyModules.xUnit.NSubstitute

// applies module & nsubstitute support to all tests.
// test attributes can be applied at the assembly, class, and test method level
[assemlby: MyDeps.Module]
[assembly: NSubstituteSupport]

public class OtherServiceTests 
{
  [ModuleTest]
  public void SomeTest(OtherService test, [Mock]ISomeService service)
  {
     service.SomeProp.Returns("some mock value");
     Assert.Equals("some mock value", test.SomeProp);
  }
}
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0-RC9148 42 5/10/2025
1.0.0-RC9145 35 5/10/2025
1.0.0-RC9141 130 4/24/2025
1.0.0-RC9138 127 4/22/2025
1.0.0-RC9137 145 4/17/2025
1.0.0-RC9136 138 4/13/2025
1.0.0-RC9135 135 4/13/2025
1.0.0-RC9133 53 4/12/2025
1.0.0-RC9131 59 4/11/2025
1.0.0-RC9130 121 3/31/2025
1.0.0-RC9128 113 3/31/2025
1.0.0-RC9127 114 3/31/2025
1.0.0-RC9126 102 3/30/2025
1.0.0-RC9125 55 3/29/2025
1.0.0-RC9124 91 3/28/2025
1.0.0-RC9123 90 3/28/2025
1.0.0-RC9122 92 3/28/2025
1.0.0-RC9121 243 3/23/2025
1.0.0-RC9120 130 3/23/2025
1.0.0-RC9119 121 3/22/2025
1.0.0-RC9118 127 3/22/2025
1.0.0-RC9117 130 3/22/2025
1.0.0-RC9116 116 3/22/2025
1.0.0-RC9115 123 3/22/2025
1.0.0-RC9112 116 3/19/2025
1.0.0-RC9111 69 3/14/2025
1.0.0-RC9110 50 3/14/2025
1.0.0-RC9109 61 3/14/2025
1.0.0-RC9108 67 3/14/2025
1.0.0-RC9107 114 3/13/2025
1.0.0-RC9106 116 3/13/2025
1.0.0-RC9105 112 3/13/2025
1.0.0-RC9104 148 3/11/2025
1.0.0-RC9103 127 3/9/2025
1.0.0-RC9102 86 3/9/2025
1.0.0-RC9100 171 3/6/2025
1.0.0-RC9099 168 3/5/2025
1.0.0-RC9098 162 3/5/2025
1.0.0-RC9096 59 2/26/2025
1.0.0-RC9094 55 2/25/2025
1.0.0-RC9092 62 2/24/2025
1.0.0-RC9091 59 2/23/2025
1.0.0-RC9090 53 2/23/2025
1.0.0-RC9086 62 2/22/2025
1.0.0-RC9083 51 2/22/2025
1.0.0-RC9082 57 2/22/2025
1.0.0-RC9078 62 2/17/2025
1.0.0-RC9077 56 2/17/2025
1.0.0-RC9076 80 2/16/2025
1.0.0-RC9075 63 2/16/2025
1.0.0-RC9074 48 2/16/2025
1.0.0-RC9072 71 2/14/2025
1.0.0-RC9071 54 2/14/2025
1.0.0-RC9070 65 2/13/2025
1.0.0-RC9069 57 2/13/2025
1.0.0-RC9068 53 2/13/2025
1.0.0-RC9066 53 2/8/2025
1.0.0-RC9059 74 2/6/2025
1.0.0-RC9058 50 2/6/2025
1.0.0-RC9048 61 2/2/2025
1.0.0-RC9047 50 2/2/2025
1.0.0-RC9045 55 2/2/2025