SharpServiceCollection 0.0.4

Branch	Status
main

Installation

To install, run dotnet add package SharpServiceCollection or from Nuget

Introduction

SharpServiceCollection is a lightweight C# library that wraps the `IServiceCollection interface to streamline dependency injection through attribute-based assembly scanning.

Usage

• SharpServiceCollection scans an assembly to automatically register services in the IServiceCollection container.

• Use one of the extension methods of IServiceCollection to perform assembly scanning.

  • AddServicesFromCurrentAssembly()
  • AddServicesFromAssembly(Assembly assembly)
  • AddServicesFromAssemblyContaining<T>()
  • AddServicesFromAssemblyContaining(Type type)

• InstanceLifetime is an Enum with the values Singleton Scoped Transient

• IServiceCollection comes with Add* and TryAdd* methods. SharpServiceCollection offers the same functionality.

• SharpServiceCollection will perform lexicographical sort on the class name to register dependency when duplicates occur. For example, Foo Bar Baz will be sorted as Bar Baz Foo, If three of them are resolved by IDemoInterface, Non Try* based attributes will register the last one, which is Foo, Try* based attributes will register the first one, which is Bar

• In general, it is better to use Try* based attributes.

using SharpServiceCollection.Attributes;
using SharpServiceCollection.Enums;

// The class will be resolvable by the interface specified in the generic argument
[TryResolveBy<IScopedDemoService>(InstanceLifetime.Scoped)]
[ResolveBy<IScopedDemoService>(InstanceLifetime.Scoped)]
public class ScopedDemoType : IScopedDemoService, IKeyedScopedDemoService
{
}

// The class will be resolvable by the interface specified in the generic argument and the key
[KeyedTryResolveBy<IKeyedScopedDemoService>(InstanceLifetime.Scoped, "keyed")]
[KeyedResolveBy<IKeyedScopedDemoService>(InstanceLifetime.Scoped, "keyed")]
public class ScopedDemoType : IScopedDemoService, IKeyedScopedDemoService
{
}

// The class will be resolvable by itself
[TryResolveBySelf(InstanceLifetime.Scoped)]
[ResolveBySelf(InstanceLifetime.Scoped)]
public class ScopedDependency : IScopedDependency
{
}

// This will work by convention
// The class must have to implement an interface that has the same name of the class prefixed with I
[TryResolveByMatchingInterface(InstanceLifetime.Scoped)]
[ResolveByMatchingInterface(InstanceLifetime.Scoped)]
public class ScopedDependency : IScopedDependency
{
}

// The class will be resolvable by any of the implementeed interface
[TryResolveByImplementedInterface(InstanceLifetime.Scoped)]
[ResolveByImplementedInterface(InstanceLifetime.Scoped)]
public class FooBarBaz : IFoo, IBar, IBaz
{
}

Example

public interface IDemoService
{
    string Greet();
}

using SharpServiceCollection.Attributes;
using SharpServiceCollection.Enums;

[TryResolveByImplementedInterface(InstanceLifetime.Scoped)]
public class DemoService : IDemoService
{
    public string Greet()
    {
        return "Hello World!";
    }
}

using SharpServiceCollection.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Current assembly will be scanned by Assembly.GetCallingAssembly()
builder.Services.AddServicesFromCurrentAssembly();

var app = builder.Build();

app.MapGet("/", (IDemoService demoService) => demoService.Greet());

app.Run();