Skip to content

AUS-1016: embedded-host docs bundle and samples/EmbeddedHost #175

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Astn merged 1 commit into from
Sep 28, 2026
Merged

AUS-1016: embedded-host docs bundle and samples/EmbeddedHost #175

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/workflows/pages.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ on:
- "AustinHarris.JsonRpc.Newtonsoft/README.md"
- "AustinHarris.JsonRpc.SystemTextJson/README.md"
- "samples/WasmHost/README.md"
- "samples/EmbeddedHost/README.md"
- "benchmarks/Micro/README.md"
- "benchmarks/charts/**"
- ".github/workflows/pages.yml"
Expand Down
5 changes: 4 additions & 1 deletion AustinHarris.JsonRpc.AspNetCore/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,10 @@ builder.WebHost.ConfigureKestrel(k =>

Clients write JSON documents back to back (whitespace or newlines between them are fine) and read the responses
in the same order, also back to back with no newline or `Content-Length` prefix, so the client must parse one
complete JSON value at a time. Notifications produce nothing. The `ConnectionContext` is the RPC context.
complete JSON value at a time. A client that expects newline-delimited or `Content-Length`-framed replies (an LSP
or MCP stdio client) is not served by this handler; a host that adds the framing over any `Stream` is in
[samples/EmbeddedHost](../samples/EmbeddedHost). Notifications produce nothing. The `ConnectionContext` is the RPC
context.

The framer accepts strict JSON only, even with the Json.NET serializer or a lenient `JsmnSerializer` selected.
A document larger than `MaxRequestBytes` aborts the connection. Documents on one connection are processed one at
Expand Down
23 changes: 23 additions & 0 deletions AustinHarris.JsonRpc.sln
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "samples", "samples", "{5D20
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WasmHost", "samples\WasmHost\WasmHost.csproj", "{293EB57E-ED38-4127-879C-34FD73820127}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EmbeddedHost", "samples\EmbeddedHost\EmbeddedHost.csproj", "{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Expand Down Expand Up @@ -175,12 +177,33 @@ Global
{293EB57E-ED38-4127-879C-34FD73820127}.Release|x86.Build.0 = Release|Any CPU
{293EB57E-ED38-4127-879C-34FD73820127}.Release|x64.ActiveCfg = Release|Any CPU
{293EB57E-ED38-4127-879C-34FD73820127}.Release|x64.Build.0 = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|Any CPU.Build.0 = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|ARM.ActiveCfg = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|ARM.Build.0 = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|x86.ActiveCfg = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|x86.Build.0 = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|x64.ActiveCfg = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Debug|x64.Build.0 = Debug|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|Any CPU.ActiveCfg = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|Any CPU.Build.0 = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|ARM.ActiveCfg = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|ARM.Build.0 = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|Mixed Platforms.Build.0 = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|x86.ActiveCfg = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|x86.Build.0 = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|x64.ActiveCfg = Release|Any CPU
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11}.Release|x64.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(NestedProjects) = preSolution
{293EB57E-ED38-4127-879C-34FD73820127} = {5D20AA90-6969-D8BD-9DCD-8634F4692FDA}
{7A4C1E52-9B3D-4F61-8E2A-5C0D7B9F3A11} = {5D20AA90-6969-D8BD-9DCD-8634F4692FDA}
EndGlobalSection
GlobalSection(TestCaseManagementSettings) = postSolution
CategoryFile = AustinHarris.JsonRpc.vsmdi
Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ behaviour: a breaking change to either means a new major version.
- `AddJsonRpcService<T>(ServiceLifetime, sessionId)` and the matching `AddJsonRpcServicesFromAssembly` overload: scoped and transient services are resolved per call from `HttpContext.RequestServices`, or from a scope the raw connection handler opens per document and publishes as `IServiceProvidersFeature`; a batch shares one scope. `JsonRpcOptions.ServiceProviderSelector` locates the provider from a custom context. A lifetime that conflicts with the container's registration, a non-singleton `JsonRpcService` subclass, and a `ContextFactory` without a selector are refused at registration or startup.
- `protected JsonRpcService(bool autoBind)`: a subclass constructed with `base(false)` binds itself nowhere, for services that a host or an explicit `BindService` call binds.
- `SECURITY.md` (private vulnerability reporting) and this changelog.
- [samples/EmbeddedHost](samples/EmbeddedHost): the core hosted without ASP.NET Core, through `HttpListener`, over a named pipe with newline-delimited documents, and on a thread that owns the state; its `check` mode runs all three against a client.
- `TestServer_Console --scale` is the release gate for the `ProcessAsync` path. It measures the inline rows at 1, 2 and N workers in three paired runs, takes the medians and fails when N/1 is below the threshold. `--kestrel [seconds] async` runs the host with `EnableAsyncMethods = true`. The README adds `--async` rows for `ProcessAsync` at 1 and 16 workers. The 1.x string overloads' thread-pool benchmark is now the `t` menu entry and no longer the default.
- `--scale` prints per-serializer and yielding-row diagnostics after the gate; the Kestrel `EnableAsyncMethods = true` row with methods that suspend once is a release-required regression row: re-measured before each release against the previous release's figure, with no absolute floor.

Expand Down
Loading
Loading