Unravel.Startup 0.1.36-alpha

This is a prerelease version of Unravel.Startup.
dotnet add package Unravel.Startup --version 0.1.36-alpha                
NuGet\Install-Package Unravel.Startup -Version 0.1.36-alpha                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Unravel.Startup" Version="0.1.36-alpha" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Unravel.Startup --version 0.1.36-alpha                
#r "nuget: Unravel.Startup, 0.1.36-alpha"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Unravel.Startup as a Cake Addin
#addin nuget:?package=Unravel.Startup&version=0.1.36-alpha&prerelease

// Install Unravel.Startup as a Cake Tool
#tool nuget:?package=Unravel.Startup&version=0.1.36-alpha&prerelease                

Unravel.Startup

Unravel provides a fully configurable ASP.NET Core IWebHost on top of System.Web via OWIN, with forward-compatible dependency injection, configuration and logging.

  • Unravel.Application
    • Inherits from System.Web.HttpApplication
    • Provides OWIN Startup
    • Provides ASP.NET Core Startup, including ConfigureServices(IServiceCollection)
    • Builds an ASP.NET Core IWebHost, including an IServiceProvider
      • Static Unravel.Application.Services service locator
      • Scoped per HttpContext
      • With GetRequestServices() extension methods
  • OwinHost.CreateDefaultBuilder(), equivalent to WebHost.CreateDefaultBuilder().
    • Microsoft.Extensions.Configuration
      • ConfigurationManagerConfigurationProvider inspired by @benfoster
      • appsettings.json and appsettings.{env}.json
      • User Secrets (Development only)
      • Environment Variables
    • Microsoft.Extensions.DependencyInjection
    • Microsoft.Extensions.Logging
      • Configured from IConfiguration
      • Debug Logger

Setup

  1. Install Unravel.Startup in your Web Application project

  2. Search the project for an existing OWIN Startup Class:

    • There may be an OwinStartup attribute, e.g.

      [assembly: OwinStartup(typeof(UnravelExamples.Web.OwinStartup))]
      
    • Web.config may contain owin:appStartup, e.g.

      <appSettings>
        <add key="owin:appStartup" value="UnravelExamples.Web.OwinStartup" />
      </appSettings>
      

    In the instructions that follow, use that class name instead of Startup (or rename it to Startup).

  3. Open Global.asax.cs:

    • Rename the class to Startup
    • Make the class partial
    • Inherit from Unravel.Application
    -public class MvcApplication : System.Web.HttpApplication
    +public partial class Startup : Unravel.Application
    

    Make sure the Inherits in Global.asax updated, too

    -<%@ Application CodeBehind="Global.asax.cs" Inherits="UnravelExamples.Web.MvcApplication" Language="C#" %>
    +<%@ Application CodeBehind="Global.asax.cs" Inherits="UnravelExamples.Web.Startup" Language="C#" %>
    
  4. If you already have a Startup.cs:

    1. Make it partial
    2. Replace void Configuration(IAppBuilder app) with override void ConfigureOwin(IAppBuilder app)

    If you don't, create one.

    Then you can override ConfigureServices(), too.

    // Startup.cs
    public partial class Startup
    {
        public override void ConfigureServices(IServiceCollection services)
        {
        }
    
        public override void ConfigureOwin(IAppBuilder app)
        {
        }
    }
    
Product Compatible and additional computed target framework versions.
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Unravel.Startup:

Package Downloads
Unravel.AspNet.WebApi

Package Description

Unravel.AspNet.Mvc

Package Description

Unravel.AspNet.Identity

Package Description

Unravel.AspNetCore.Mvc

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.1.36-alpha 1,357 5/26/2024
0.1.30-alpha 653 3/6/2024
0.1.26-alpha 61 3/4/2024
0.1.20-alpha 274 7/10/2023
0.1.13-alpha 88 7/10/2023
0.1.11-alpha 89 7/9/2023