DependencyModules.Runtime 1.0.0-RC9044

This is a prerelease version of DependencyModules.Runtime.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package DependencyModules.Runtime --version 1.0.0-RC9044
                    
NuGet\Install-Package DependencyModules.Runtime -Version 1.0.0-RC9044
                    
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.Runtime" Version="1.0.0-RC9044" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DependencyModules.Runtime" Version="1.0.0-RC9044" />
                    
Directory.Packages.props
<PackageReference Include="DependencyModules.Runtime" />
                    
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.Runtime --version 1.0.0-RC9044
                    
#r "nuget: DependencyModules.Runtime, 1.0.0-RC9044"
                    
#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.
#:package DependencyModules.Runtime@1.0.0-RC9044
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DependencyModules.Runtime&version=1.0.0-RC9044&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=DependencyModules.Runtime&version=1.0.0-RC9044&prerelease
                    
Install 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.Testing
> dotnet add package DependencyModules.Testing.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 (13)

Showing the top 5 NuGet packages that depend on DependencyModules.Runtime:

Package Downloads
DependencyModules.xUnit

Package Description

DependencyModules.xUnit.NSubstitute

Package Description

SimpleRequest.Runtime

Package Description

SimpleRequest.Web.AspNetHost

Package Description

SimpleRequest.Functions.Runtime

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-RC9148 71 5/10/2025
1.0.0-RC9145 49 5/10/2025
1.0.0-RC9141 138 4/24/2025
1.0.0-RC9138 161 4/22/2025
1.0.0-RC9137 165 4/17/2025
1.0.0-RC9136 171 4/13/2025
1.0.0-RC9135 154 4/13/2025
1.0.0-RC9133 62 4/12/2025
1.0.0-RC9131 72 4/11/2025
1.0.0-RC9130 144 3/31/2025
1.0.0-RC9128 128 3/31/2025
1.0.0-RC9127 131 3/31/2025
1.0.0-RC9126 119 3/30/2025
1.0.0-RC9125 83 3/29/2025
1.0.0-RC9124 113 3/28/2025
1.0.0-RC9123 105 3/28/2025
1.0.0-RC9122 104 3/28/2025
1.0.0-RC9121 255 3/23/2025
1.0.0-RC9120 187 3/23/2025
1.0.0-RC9119 141 3/22/2025
1.0.0-RC9118 144 3/22/2025
1.0.0-RC9117 134 3/22/2025
1.0.0-RC9116 133 3/22/2025
1.0.0-RC9115 137 3/22/2025
1.0.0-RC9112 129 3/19/2025
1.0.0-RC9111 103 3/14/2025
1.0.0-RC9110 62 3/14/2025
1.0.0-RC9109 67 3/14/2025
1.0.0-RC9108 84 3/14/2025
1.0.0-RC9107 153 3/13/2025
1.0.0-RC9106 139 3/13/2025
1.0.0-RC9105 126 3/13/2025
1.0.0-RC9104 176 3/11/2025
1.0.0-RC9103 141 3/9/2025
1.0.0-RC9102 120 3/9/2025
1.0.0-RC9100 184 3/6/2025
1.0.0-RC9099 202 3/5/2025
1.0.0-RC9098 179 3/5/2025
1.0.0-RC9096 85 2/26/2025
1.0.0-RC9094 60 2/25/2025
1.0.0-RC9092 72 2/24/2025
1.0.0-RC9091 71 2/23/2025
1.0.0-RC9090 79 2/23/2025
1.0.0-RC9086 97 2/22/2025
1.0.0-RC9083 72 2/22/2025
1.0.0-RC9082 65 2/22/2025
1.0.0-RC9078 73 2/17/2025
1.0.0-RC9077 74 2/17/2025
1.0.0-RC9076 145 2/16/2025
1.0.0-RC9075 85 2/16/2025
1.0.0-RC9074 69 2/16/2025
1.0.0-RC9072 147 2/14/2025
1.0.0-RC9071 73 2/14/2025
1.0.0-RC9070 91 2/13/2025
1.0.0-RC9069 73 2/13/2025
1.0.0-RC9068 94 2/13/2025
1.0.0-RC9066 71 2/8/2025
1.0.0-RC9059 126 2/6/2025
1.0.0-RC9058 74 2/6/2025
1.0.0-RC9048 237 2/2/2025
1.0.0-RC9047 80 2/2/2025
1.0.0-RC9045 71 2/2/2025
1.0.0-RC9044 60 2/2/2025
1.0.0-RC9042 78 2/1/2025
1.0.0-RC9040 69 2/1/2025
1.0.0-RC9024 66 1/31/2025
1.0.0-RC9022 72 1/31/2025
1.0.0-RC9021 71 1/26/2025
1.0.0-RC9015 76 1/5/2025
1.0.0-RC9013 67 1/5/2025
1.0.0-RC9012 62 1/5/2025
1.0.0-RC9011 85 1/5/2025
1.0.0-RC9009 70 1/5/2025
1.0.0-RC9006 80 1/4/2025
1.0.0-RC9003 76 1/4/2025
1.0.0-RC9000 78 1/4/2025
1.0.0-RC8 76 1/4/2025
1.0.0-RC3 90 1/4/2025
1.0.0-RC2 93 1/4/2025
1.0.0-RC1 103 1/3/2025