https://github.com/engineering87/webquark
WebQuark is a lightweight, modular .NET library that streamlines web requests, session handling, and routing across both .NET Framework and .NET Core environments
https://github.com/engineering87/webquark
aspnet aspnet-core dotnet framework utilities web web-development
Last synced: 8 months ago
JSON representation
WebQuark is a lightweight, modular .NET library that streamlines web requests, session handling, and routing across both .NET Framework and .NET Core environments
- Host: GitHub
- URL: https://github.com/engineering87/webquark
- Owner: engineering87
- License: mit
- Created: 2025-07-21T23:32:02.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-07-28T22:04:22.000Z (8 months ago)
- Last Synced: 2025-07-28T22:06:23.194Z (8 months ago)
- Topics: aspnet, aspnet-core, dotnet, framework, utilities, web, web-development
- Language: JavaScript
- Homepage:
- Size: 2.3 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WebQuark
[](https://opensource.org/licenses/MIT)
[](https://www.nuget.org/packages/WebQuark.Core)
[](https://github.com/engineering87/WebQuark/issues)
[](https://github.com/engineering87/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.
## 📦 Packages
WebQuark is split into small, focused projects:
| Project | Description | NuGet Stable |
|----------------------------|-----------------------------------------------------------------------------|--------------|
| `WebQuark.Core` | Core interfaces and shared abstractions used across other modules | [](https://www.nuget.org/packages/WebQuark.Core) |
| `WebQuark.HttpRequest` | Unified request handling and query utilities for Framework and Core | [](https://www.nuget.org/packages/WebQuark.HttpRequest) |
| `WebQuark.HttpResponse` | Response helpers: headers, status codes, content writing, and redirection | [](https://www.nuget.org/packages/WebQuark.HttpResponse) |
| `WebQuark.Session` | Cross-platform session manager with support for encrypted object storage | [](https://www.nuget.org/packages/WebQuark.Session) |
| `WebQuark.QueryString` | Strongly-typed query string parser and encoder utilities | [](https://www.nuget.org/packages/WebQuark.QueryString) |
| `WebQuark.Extensions` | Extension methods to simplify integration and enhance core WebQuark modules | [](https://www.nuget.org/packages/WebQuark.Extensions) |
## 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`
```csharp
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();
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:
```csharp
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:
```csharp
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](https://docs.github.com/en/get-started/getting-started-with-git/set-up-git)
* [Fork the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)
* [Open an issue](https://github.com/engineering87/WebQuark/issues) if you encounter a bug or have a suggestion for improvements/features
### Licensee
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.