Indiko.Hosting.Abstractions 2.1.1

Indiko.Hosting.Abstractions

Core hosting abstractions providing a foundation for building .NET applications with standardized bootstrapping and startup patterns.

Overview

This package provides base classes, interfaces, and utilities for application hosting, configuration, logging setup, and lifecycle management. It integrates with the Indiko Blocks system for modular application composition.

Features

• Base Host Bootstrapper: Abstract base class for host initialization with logging and configuration
• Startup Abstractions: Interfaces for defining application startup configuration (IHostingStartup)
• Configuration Utilities: Helper methods for configuration initialization
• Logging Utilities: Standardized logger creation and setup
• Block Integration: Seamless integration with Indiko Blocks management system
• Request Metadata: Interface for accessing HTTP request metadata
• Host Builder Extensions: Extensions for configuring host builders

Installation

dotnet add package Indiko.Hosting.Abstractions

Key Components

BaseHostBootstraper<T, TBaseStartup>

Base class for bootstrapping a host with automatic configuration and logging setup.

public class MyHostBootstrapper : BaseHostBootstraper<MyHostBootstrapper, IMyStartup>
{
    protected override IHostBuilder CreateHostBuilder<TStartup>(string[] args)
    {
        var builder = base.CreateHostBuilder<TStartup>(args);
        // Add custom configuration
        return builder;
    }
}

IHostingStartup

Interface marker for startup classes.

public interface IHostingStartup
{
    void ConfigureServices(IServiceCollection services);
    void Configure(IApplicationBuilder app, IServiceProvider services, IHostEnvironment environment);
}

Configuration and Logging Utilities

// Create configuration
var configuration = ConfigurationUtil.CreateConfiguration();

// Create logger
var logger = LogUtil.CreateLogger<MyClass>(configuration);

Usage Example

Creating a Custom Host

using Indiko.Hosting.Abstractions;
using Indiko.Hosting.Abstractions.Interfaces;

// Define your startup
public class MyStartup : IHostingStartup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddLogging();
        services.AddHttpClient();
        // Configure services
    }

    public void Configure(IApplicationBuilder app, IServiceProvider services, IHostEnvironment env)
    {
        // Configure middleware
    }
}

// Create bootstrapper
public class MyBootstrapper : BaseHostBootstraper<MyBootstrapper, IHostingStartup>
{
    // Optionally override methods for custom behavior
}

// Run application
class Program
{
    static async Task<int> Main(string[] args)
    {
        return await MyBootstrapper.Instance.RunAsync<MyStartup>(args);
    }
}

Integration with Blocks

The bootstrapper automatically integrates with the Indiko Blocks system:

// Blocks are automatically configured during host building
// 1. ConfigureBuilder is called for all registered blocks
// 2. ConfigureServices is called during service configuration
// 3. Configure is called during application configuration
// 4. PreRunAsync is called before the host runs

Architecture

Lifecycle

1. Configuration Initialization: Load configuration from appsettings.json and environment
2. Logger Creation: Create logger based on configuration
3. Host Builder Creation: Create and configure IHostBuilder
4. Block Configuration: Apply all registered blocks to the builder
5. Host Building: Build the IHost instance
6. Pre-Run Blocks: Execute pre-run logic for all blocks
7. Host Run: Start the application

Block Integration Points

• ConfigureBuilder(IHostBuilder): Configure the host builder
• ConfigureServices(IServiceCollection): Register services
• Configure(IApplicationBuilder, IServiceProvider, IHostEnvironment): Configure middleware
• PreRunAsync(IServiceProvider): Execute logic before host runs

Target Framework

• .NET 10

Dependencies

• Indiko.Common.Runtime.Abstractions
• Indiko.Blocks.Common.Abstractions
• Indiko.Blocks.Common.Management
• Microsoft.Extensions.Hosting
• Microsoft.Extensions.Logging

License

See LICENSE file in the repository root.

Related Packages

• Indiko.Hosting.Web - Web API hosting implementation
• Indiko.Hosting.Mvc - MVC hosting implementation
• Indiko.Hosting.BlazorServer - Blazor Server hosting implementation
• Indiko.Hosting.Gateway - API Gateway hosting implementation
• Indiko.Blocks.Common.Management - Block management system