Microsoft.Extensions.DependencyInjection.Specification.Tests

About

Provides a suite of xUnit.net tests designed to ensure compatibility with the Microsoft.Extensions.DependencyInjection framework.

This package is intended for developers implementing their own Dependency Injection (DI) containers, allowing them to verify that their implementations conform to the expected behavior of the Microsoft Dependency Injection framework.

Key Features

• Comprehensive suite of tests to validate DI container compatibility with the Microsoft Dependency Injection framework.
• Includes fakes and mocks (Microsoft.Extensions.DependencyInjection.Specification.Fakes) for testing common scenarios.

How to Use

To utilize the Microsoft.Extensions.DependencyInjection.Specification.Tests in a custom DI container implementation, create a test project and include this package as a dependency. Then, run the specification tests against the DI container to validate its compatibility with the Microsoft.Extensions.DependencyInjection framework.

1. Start by creating a test project to run the specification tests.

2. Add the following NuGet packages to the test project:

   • Microsoft.Extensions.DependencyInjection.Specification.Tests
   • xunit

3. Add the custom DI container package (e.g., MyCustomDI)

4. In the test project, create a class that inherits from DependencyInjectionSpecificationTests provided by the Microsoft.Extensions.DependencyInjection.Specification.Tests package.

   Override the CreateServiceProvider method to return an instance of the DI container's service provider.

    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.DependencyInjection.Specification.Tests;
    using Xunit;
    using MyCustomDI;
   
    public class MyCustomDIContainerTests : DependencyInjectionSpecificationTests
    {
        protected override IServiceProvider CreateServiceProvider(IServiceCollection serviceCollection)
        {
            // Create an instance of your custom DI container and build the service provider
            return MyCustomDIContainer.BuildServiceProvider(serviceCollection);
        }
    }
   

5. Run the tests to validate that the custom DI container behaves according to the Microsoft Dependency Injection specifications.

Main Types

The main types provided by this library are:

• Microsoft.Extensions.DependencyInjection.Specification.DependencyInjectionSpecificationTests
• Microsoft.Extensions.DependencyInjection.Specification.KeyedDependencyInjectionSpecificationTests

Feedback & Contributing

Microsoft.Extensions.DependencyInjection.Specification.Tests is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.