Skip to content

NexusLabs.Needlr

NexusLabs.Needlr

NexusLabs.Needlr Namespace

Classes
ContainerVerificationException Exception thrown when Needlr container verification detects one or more registered issues that are configured to fail-fast at startup.
DecoratorForAttribute<TService> Marks a class as a decorator for the specified service type. When discovered by Needlr (via source generation or reflection), the decorator will be automatically wired using AddDecorator<TService,TDecorator>(this IServiceCollection).
DeferToContainerAttribute Specifies constructor parameter types for a partial class whose constructor will be generated by another source generator.
DoNotAutoRegisterAttribute Prevents a class or interface from being automatically registered by Needlr's dependency injection discovery pipeline.
DoNotInjectAttribute Prevents a class or interface from being injected as a dependency by Needlr. Types decorated with this attribute are discovered but excluded from service collection registration.
DumpExtensions Extension methods for dumping service registration information for debugging.
DumpOptions Options for customizing the output of Dump(this IServiceCollection, DumpOptions).
InterceptAttribute Applies an interceptor to a class or method. When discovered by Needlr's source generator, a proxy class is generated that routes method calls through the specified interceptor(s).
InterceptAttribute<TInterceptor> Applies an interceptor to a class or method. Generic version that provides compile-time type safety for the interceptor type.
KeyedAttribute Marks a class for keyed service registration. The type will be registered with the specified service key in addition to its normal registration.
LifetimeMismatch Represents a lifetime mismatch where a longer-lived service depends on a shorter-lived service. This is also known as a "captive dependency" and can lead to unexpected behavior.
LifetimeMismatchExtensions Extension methods for detecting lifetime mismatches (captive dependencies) in service registrations.
MethodInvocation Default implementation of IMethodInvocation used by generated interceptor proxy classes.
PluginOrderAttribute Specifies the execution order for a plugin. Lower values execute first. Plugins without this attribute default to Order = 0.
PostBuildServiceCollectionPluginOptions Options provided to IPostBuildServiceCollectionPlugin implementations during configuration. Contains the built service provider, configuration, discovered assemblies, and plugin factory.
RegisterAsAttribute<TInterface> Specifies that the decorated class should only be registered as the specified interface type, rather than all interfaces it implements.
ScopedAttribute Specifies that the decorated class should be registered with \<b>Scoped\</b> lifetime. Scoped services are created once per scope — for example, once per HTTP request in ASP.NET Core.
ServiceCollectionExtensions Extension methods for Microsoft.Extensions.DependencyInjection.IServiceCollection that add decorator wiring, service inspection, and registration-check utilities to the standard Microsoft DI container.
ServiceCollectionPluginOptions Options provided to IServiceCollectionPlugin implementations during configuration. Contains the service collection, configuration, discovered assemblies, and plugin factory.
ServiceCollectionVerificationExtensions Extension methods for verifying service collection configuration.
ServiceProviderExtensions Extension methods for System.IServiceProvider to provide type inspection functionality.
SingletonAttribute Specifies that the decorated class should be registered with \<b>Singleton\</b> lifetime. Singleton services are created once for the lifetime of the application and reused for every request.
SourceGenRegistry Static registry for source-generated registrations.
TransientAttribute Specifies that the decorated class should be registered with \<b>Transient\</b> lifetime. Transient services are created fresh every time they are resolved from the container.
TypeExtensions Extension methods for System.Type to provide additional type inspection capabilities.
VerificationIssue Represents a verification issue detected during container analysis.
VerificationOptions Options for controlling container verification behavior.
VerificationOptionsBuilder Builder for creating VerificationOptions with a fluent API.
VerificationResult Result of container verification containing all detected issues.
Structs
ServiceRegistrationInfo
Interfaces
IMethodInterceptor Intercepts method invocations on a service. Implement this interface to create reusable cross-cutting concerns like logging, caching, or timing.
IMethodInvocation Represents a method invocation that is being intercepted. Provides access to the target instance, method metadata, and arguments.
IPluginFactory Defines a factory for discovering and creating plugin instances from assemblies.
IPostBuildServiceCollectionPlugin Defines a plugin that executes after the service provider has been built. Implement this interface to perform configuration that requires access to the fully built service provider.
IServiceCollectionPlugin Defines a plugin that participates in Needlr's Microsoft.Extensions.DependencyInjection.IServiceCollection configuration pipeline. Implement this interface to encapsulate a cohesive block of service registrations that can be discovered and applied automatically during startup.
Enums
VerificationBehavior Specifies the behavior when a verification issue is detected.
VerificationIssueType The type of verification issue detected.