SimonG96 / LightweightIocContainer

A lightweight IOC Container that is powerful enough to do all the things you need it to do.
MIT License
4 stars 2 forks source link
csharp dotnet dotnet-core lightweightioccontainer

Lightweight IOC Container

A lightweight IOC Container that is powerful enough to do all the things you need it to do.

GitHub Actions

Nuget Nuget Nuget (with prereleases)

Nuget Nuget Nuget (with prereleases)

Get started with the Lightweight IOC Container

How to install

The easiest way to install the Lightweight IOC Container is by using NuGet through the .NET CLI:

> dotnet add package LightweightIocContainer --version 4.3.0

Example usage

  1. Instantiate IocContainer:

      IocContainer container = new();
  2. Install IIocInstallers for the container:

      container.Install(new Installer());
  3. Resolve one instance from the container:

      IFooFactory fooFactory = container.Resolve<IFooFactory>();
  4. Use this instance to create what your application needs:

      IFoo foo = fooFactory.Create();
  5. When your application is finished, don't forget to dispose your IocContainer:

      container.Dispose();

Validation

There is the option to install the LightweightIocContainer.Validation package:

> dotnet add package LightweightIocContainer.Validaton --version 4.3.0

With this you can validate your IocContainer setup by using the IocValidator in a unit test:

[TestFixture]
public class IocValidationTest
{
    [Test]
    public void ValidateIocContainerSetup()
    {
        IocContainer container = new();
        container.Install(new Installer());

        IocValidator validator = new(container);
        validator.Validate();
    }
}

If this test is successful, everything is correctly installed and can be resolved by the IocContainer. By going through the thrown exceptions in case of a failed test you will see what is not working correctly with your current setup.

Demo Project

There is a demo project available where you can check out how different functions of the Lightweight IOC Container can be used.