WebQuark

WebQuark is a lightweight, modular .NET utility library that streamlines web request, session handling, and routing across both legacy .NET Framework and modern .NET / ASP.NET Core environments.

📑 Table of Contents

• Packages
• Integrating WebQuark in Your Project
  • .NET Core Integration
  • Legacy .NET Framework Integration
• Contributing
• License
• Contact

📦 Packages

WebQuark is split into small, focused projects:

Project	Description	NuGet Stable
WebQuark.Core	Core interfaces and shared abstractions used across other modules
WebQuark.HttpRequest	Unified request handling and query utilities for Framework and Core
WebQuark.HttpResponse	Response helpers: headers, status codes, content writing, and redirection
WebQuark.Session	Cross-platform session manager with support for encrypted object storage
WebQuark.QueryString	Strongly-typed query string parser and encoder utilities
WebQuark.Extensions	Extension methods to simplify integration and enhance core WebQuark modules
WebQuark.Cors	CORS helpers with secure defaults, prebuilt policies, ASP.NET Core & OWIN

Integrating WebQuark in Your Project

This guide shows how to integrate the WebQuark library for unified abstraction across different .NET platforms, including .NET Core and legacy .NET Framework.

.NET Core Integration

For .NET Core applications, WebQuark provides extension methods to register all core services using the built-in dependency injection (DI) container.

Register WebQuark Services in Program.cs or Startup.cs

using WebQuark.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Add required services
builder.Services.AddRazorPages();
builder.Services.AddSession();
builder.Services.AddHttpContextAccessor(); // Register IHttpContextAccessor
builder.Services.AddWebQuark();             // Register all WebQuark services

var app = builder.Build();

// Configure WebQuark's QueryStringHandler with IHttpContextAccessor
var accessor = app.Services.GetRequiredService<IHttpContextAccessor>();
WebQuark.QueryString.QueryStringHandler.ConfigureHttpContextAccessor(accessor);

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseSession();
app.UseRouting();
app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages().WithStaticAssets();

app.Run();

You can also register services individually if needed:

builder.Services.AddWebQuarkHttpRequestInspector();
builder.Services.AddWebQuarkHttpResponseHandler();
builder.Services.AddWebQuarkRequestQueryHandler();
builder.Services.AddWebQuarkSessionHandler();

Legacy .NET Framework Integration

For legacy ASP.NET Framework projects (e.g., targeting .NET Framework 4.7.2), WebQuark services can be used directly by instantiating their classes:

var responseHandler = new HttpResponseHandler();
var queryHandler = new QueryStringHandler();
var sessionHandler = new SessionHandler();
var requestInspector = new HttpRequestInspector();

Contributing

Thank you for considering to help out with the source code! If you'd like to contribute, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base.

• Setting up Git
• Fork the repository
• Open an issue if you encounter a bug or have a suggestion for improvements/features

License

WebQuark source code is available under MIT License, see license in the source.

Contact

Please contact at francesco.delre[at]protonmail.com for any details.