Sora.Web
0.4.0
dotnet add package Sora.Web --version 0.4.0
NuGet\Install-Package Sora.Web -Version 0.4.0
<PackageReference Include="Sora.Web" Version="0.4.0" />
<PackageVersion Include="Sora.Web" Version="0.4.0" />
<PackageReference Include="Sora.Web" />
paket add Sora.Web --version 0.4.0
#r "nuget: Sora.Web, 0.4.0"
#:package Sora.Web@0.4.0
#addin nuget:?package=Sora.Web&version=0.4.0
#tool nuget:?package=Sora.Web&version=0.4.0
Sylin.Sora.Web
ASP.NET Core integration for Sora: controller-first routing, health endpoints, well-known endpoints, and observability bootstrap.
- Target framework: net9.0
- License: Apache-2.0
Capabilities
- MVC controller-first routing (attribute-routed)
- Health endpoints and OpenAPI wiring (opt-in)
- Transformers for payload shaping (see WEB-0035)
Install (minimal setup)
dotnet add package Sylin.Sora.Web
Usage — quick examples
- Expose REST endpoints via controllers, not inline endpoints:
public sealed class ItemsController : EntityController<Item, Guid>
{
// GET /api/items
[HttpGet("api/items")]
public async Task<IActionResult> GetAll(CancellationToken ct)
=> Ok(await Item.FirstPage(50, ct));
}
- Use transformers for response shaping; see decision WEB-0035.
See TECHNICAL.md for contracts, options, and integration details.
Customization
- Configuration and advanced usage are documented in
TECHNICAL.md
.
References
- Web API conventions:
/docs/api/web-http-api.md
- Decision:
/docs/decisions/WEB-0035-entitycontroller-transformers.md
- Engineering guardrails:
/docs/engineering/index.md
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net9.0
- Microsoft.AspNetCore.Mvc.NewtonsoftJson (>= 9.0.0)
- OpenTelemetry.Extensions.Hosting (>= 1.9.0)
- OpenTelemetry.Instrumentation.AspNetCore (>= 1.8.1)
- OpenTelemetry.Instrumentation.Http (>= 1.8.1)
- Sora.Core (>= 0.4.0)
- Sora.Data.Abstractions (>= 0.4.0)
- Sora.Data.Core (>= 0.4.0)
- Sora.Scheduling (>= 0.4.0)
NuGet packages (7)
Showing the top 5 NuGet packages that depend on Sora.Web:
Package | Downloads |
---|---|
Sora.Web.Transformers
HTTP payload transformers for Sora Web: flexible request/response shaping with auto-discovery. |
|
Sora.Web.Swagger
Swagger/OpenAPI integration for Sora Web: idempotent registration, config-driven enablement, and friendly defaults. |
|
Sora.Web.GraphQl
Sora GraphQL module providing a controller-hosted GraphQL endpoint and schema for IEntity<> types. |
|
Sora.Web.Extensions
Web capability extensions (moderation, soft-delete, audit) for Sora applications. |
|
Sora.Flow.Web
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
See release notes: https://github.com/sylin-labs/sora-framework/releases