HyperDev.Web 1.2.2

HyperDev.Web

ASP.NET Core application infrastructure, part of the HyperDev Fatum framework. WebApplicationFactory builds a WebApplication with the framework services and middleware already wired, driven by configuration and extensible through modules.

• WebApplicationFactory: Razor Pages, authentication schemes from Web:Authentications, default authorization policy, database connections (Database), query tracing, app settings, storages, scheduler, database logging (Logging:Database), bundling and minification
• Extension points: ConfigureBuilder, ConfigureApplication, ConfigureBundles, overridable On.../Add.../Use... methods, modules (IWebApplicationModule, [assembly: WebApplicationModule], AddAssembly)
• HTTP request tracing to a database (Web:Trace, UseHttpTracing)
• Live objects: server objects rendered in Razor views (LiveObject) and invoked from the browser ([LiveObject], [LiveProperty], [LiveMethod])
• Files of storage volumes served at $Volume/{name}/{path}
• Embedded file providers (AddEmbeddedPath), /Diagnostics endpoint, unhandled exception middleware
• Helpers for session (GetSession, SetSession, ...), authorization (IsAuthenticated, IsInAnyRole, IsAuthorized) and URLs

Installation

dotnet add package HyperDev.Web

Quick start

using HyperDev.Web.Builder;

var factory = new WebApplicationFactory();

factory.ConfigureBuilder(builder => builder.Services.AddControllersWithViews());

factory.ConfigureBundles(bundles =>
    bundles.Pipeline.AddCssBundle("/bundles/site.css", "css/*.css"));

factory.ConfigureApplication(app => app.MapGet("/ping", () => "pong"));

var builder = factory.CreateBuilder(args);

var app = factory.Build(builder);

app.Run();

CreateBuilder registers the framework services, Build adds the middleware pipeline (static files, tracing, routing, authentication, authorization, Razor Pages and the default controller route). Derive from WebApplicationFactory to replace a single step, for example protected override void AddScheduler(WebApplicationBuilder builder).

Target frameworks

.NET 8.0, .NET 10.0

License

MIT, © Ivan Senatore, Wemake Informatica srl. Third-party dependencies keep their own licenses (LigerShark.WebOptimizer.Core: Apache-2.0, Microsoft.EntityFrameworkCore: MIT, System.IdentityModel.Tokens.Jwt: MIT, Newtonsoft.Json: MIT, Newtonsoft.Json.Schema: commercial or AGPL-3.0, Antlr4.Runtime: BSD-3-Clause).