< Summary

Information
Class: NexusLabs.Needlr.Hosting.HostSyringe
Assembly: NexusLabs.Needlr.Hosting
File(s): /home/runner/work/needlr/needlr/src/NexusLabs.Needlr.Hosting/HostSyringe.cs
Line coverage
93%
Covered lines: 28
Uncovered lines: 2
Coverable lines: 30
Total lines: 150
Line coverage: 93.3%
Branch coverage
80%
Covered branches: 8
Total branches: 10
Branch coverage: 80%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
get_BaseSyringe()100%11100%
get_OptionsFactory()100%11100%
get_HostFactoryCreator()100%11100%
get_ConfigureCallback()100%11100%
.ctor(...)100%11100%
BuildHost()50%2294.44%
BuildServiceProvider(...)100%210%
GetOrCreateHostFactory(...)75%44100%
GetOrCreateOptions()100%44100%

File(s)

/home/runner/work/needlr/needlr/src/NexusLabs.Needlr.Hosting/HostSyringe.cs

#LineLine coverage
 1using Microsoft.Extensions.Configuration;
 2using Microsoft.Extensions.Hosting;
 3
 4using NexusLabs.Needlr.Injection;
 5
 6namespace NexusLabs.Needlr.Hosting;
 7
 8/// <summary>
 9/// Provides a fluent API for configuring and building host applications using Needlr.
 10/// Wraps a ConfiguredSyringe with additional host functionality.
 11/// </summary>
 12/// <example>
 13/// Creating and configuring a HostSyringe:
 14/// <code>
 15/// // Transition from ConfiguredSyringe
 16/// var hostSyringe = new Syringe()
 17///     .UsingReflection()
 18///     .ForHost();
 19///
 20/// // Build and run the host
 21/// var host = hostSyringe
 22///     .UsingOptions(() => CreateHostOptions.Default.UsingArgs(args))
 23///     .UsingConfigurationCallback((builder, options) =>
 24///     {
 25///         // Configure the HostApplicationBuilder
 26///         builder.Configuration.AddJsonFile("custom-settings.json", optional: true);
 27///         builder.Services.AddSingleton&lt;IMyCustomService, MyCustomService&gt;();
 28///     })
 29///     .BuildHost();
 30///
 31/// await host.RunAsync();
 32/// </code>
 33/// </example>
 34[DoNotAutoRegister]
 35public sealed record HostSyringe
 36{
 10937    internal ConfiguredSyringe BaseSyringe { get; init; }
 1738    internal Func<CreateHostOptions>? OptionsFactory { get; init; }
 1139    internal Func<IServiceProviderBuilder, IServiceCollectionPopulator, IHostFactory>? HostFactoryCreator { get; init; }
 1440    internal Action<HostApplicationBuilder, CreateHostOptions>? ConfigureCallback { get; init; }
 41
 42    /// <summary>
 43    /// Initializes a new instance of the <see cref="HostSyringe"/> class.
 44    /// </summary>
 45    /// <param name="baseSyringe">The configured syringe to wrap.</param>
 46    /// <example>
 47    /// <code>
 48    /// var configuredSyringe = new Syringe().UsingReflection();
 49    ///
 50    /// var hostSyringe = new HostSyringe(configuredSyringe);
 51    /// </code>
 52    /// </example>
 2253    public HostSyringe(ConfiguredSyringe baseSyringe)
 54    {
 2255        ArgumentNullException.ThrowIfNull(baseSyringe);
 2156        BaseSyringe = baseSyringe;
 2157    }
 58
 59    /// <summary>
 60    /// Builds a host with the configured settings.
 61    /// </summary>
 62    /// <returns>The configured <see cref="IHost"/>.</returns>
 63    /// <example>
 64    /// <code>
 65    /// var host = new Syringe()
 66    ///     .UsingReflection()
 67    ///     .UsingScrutorTypeRegistrar()
 68    ///     .ForHost()
 69    ///     .UsingOptions(() => CreateHostOptions.Default
 70    ///         .UsingArgs(args)
 71    ///         .UsingApplicationName("My Worker Service"))
 72    ///     .UsingConfigurationCallback((builder, options) =>
 73    ///     {
 74    ///         // Add custom configuration sources
 75    ///         builder.Configuration.AddJsonFile("appsettings.local.json", optional: true);
 76    ///
 77    ///         // Register additional services
 78    ///         builder.Services.AddSingleton&lt;ICustomService, CustomService&gt;();
 79    ///     })
 80    ///     .BuildHost();
 81    ///
 82    /// await host.RunAsync();
 83    /// </code>
 84    /// </example>
 85    public IHost BuildHost()
 86    {
 1187        var typeRegistrar = BaseSyringe.GetOrCreateTypeRegistrar();
 1188        var typeFilterer = BaseSyringe.GetOrCreateTypeFilterer();
 1189        var pluginFactory = BaseSyringe.GetOrCreatePluginFactory();
 1190        var serviceCollectionPopulator = BaseSyringe.GetOrCreateServiceCollectionPopulator(typeRegistrar, typeFilterer, 
 1191        var assemblyProvider = BaseSyringe.GetOrCreateAssemblyProvider();
 1192        var additionalAssemblies = BaseSyringe.GetAdditionalAssemblies();
 1193        var callbacks = BaseSyringe.GetPostPluginRegistrationCallbacks();
 94
 1195        var serviceProviderBuilder = BaseSyringe.GetOrCreateServiceProviderBuilder(
 1196            serviceCollectionPopulator,
 1197            assemblyProvider,
 1198            additionalAssemblies);
 99
 11100        var hostFactory = GetOrCreateHostFactory(serviceProviderBuilder, serviceCollectionPopulator, pluginFactory);
 11101        var options = GetOrCreateOptions();
 11102        if (callbacks.Count > 0)
 103        {
 0104            options = options.UsingPostPluginRegistrationCallbacks(callbacks);
 105        }
 106
 11107        return hostFactory.Create(
 11108            options,
 11109            ConfigureCallback);
 110    }
 111
 112    /// <summary>
 113    /// Builds a service provider with the configured settings.
 114    /// </summary>
 115    /// <param name="config">The configuration to use for building the service provider.</param>
 116    /// <returns>The configured <see cref="IServiceProvider"/>.</returns>
 117    /// <example>
 118    /// <code>
 119    /// var config = new ConfigurationBuilder()
 120    ///     .AddJsonFile("appsettings.json")
 121    ///     .Build();
 122    ///
 123    /// var serviceProvider = new Syringe()
 124    ///     .UsingReflection()
 125    ///     .UsingScrutorTypeRegistrar()
 126    ///     .ForHost()
 127    ///     .BuildServiceProvider(config);
 128    ///
 129    /// var myService = serviceProvider.GetRequiredService&lt;IMyService&gt;();
 130    /// </code>
 131    /// </example>
 132    public IServiceProvider BuildServiceProvider(IConfiguration config)
 133    {
 0134        return BaseSyringe.BuildServiceProvider(config);
 135    }
 136
 137    private IHostFactory GetOrCreateHostFactory(
 138        IServiceProviderBuilder serviceProviderBuilder,
 139        IServiceCollectionPopulator serviceCollectionPopulator,
 140        IPluginFactory pluginFactory)
 141    {
 11142        return HostFactoryCreator?.Invoke(serviceProviderBuilder, serviceCollectionPopulator)
 11143            ?? new HostFactory(serviceProviderBuilder, serviceCollectionPopulator, pluginFactory);
 144    }
 145
 146    private CreateHostOptions GetOrCreateOptions()
 147    {
 11148        return OptionsFactory?.Invoke() ?? CreateHostOptions.Default;
 149    }
 150}
Generated by: ReportGenerator 5.5.1.0
02/03/2026 - 18:54:42
GitHub | reportgenerator.io

Methods/Properties

get_BaseSyringe()
get_OptionsFactory()
get_HostFactoryCreator()
get_ConfigureCallback()
.ctor(NexusLabs.Needlr.Injection.ConfiguredSyringe)
BuildHost()
BuildServiceProvider(Microsoft.Extensions.Configuration.IConfiguration)
GetOrCreateHostFactory(NexusLabs.Needlr.Injection.IServiceProviderBuilder,NexusLabs.Needlr.Injection.IServiceCollectionPopulator,NexusLabs.Needlr.IPluginFactory)
GetOrCreateOptions()