Repository navigation
Explain the .NET / GenHTTP context and document ASP.NET Core hosting - #5
Merged
Merged
Conversation
Readers unfamiliar with GenHTTP could not tell that this is a C# library that plugs into a web server. The readmes and the documentation now introduce the package as a GenHTTP module, show how to set up a project from scratch and describe how to map the handler into an ASP.NET Core application via GenHTTP.Adapters.AspNetCore, including the Kestrel request body limit that otherwise rejects pushes above 30 MB. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Readers who don't know GenHTTP couldn't tell from the readme that this is a C# / .NET library that plugs into a web server. This PR fixes that and documents how to use the module from ASP.NET Core.
dotnet new console+ packages) and a new Using ASP.NET Core section.Kestrel request size
Kestrel rejects request bodies above 30 MB by default, while the module accepts pushes up to 128 MB. A 40 MB push failed with HTTP 413 until
MaxRequestBodySizewas raised, so all ASP.NET Core examples set it and the docs explain why.Verification
Tested against
GenHTTP.Adapters.AspNetCore11.0.5 in a scratch app:app.Map("/repo", ...), including a 40 MB push with the raised Kestrel limitRepositories(...)(/git/nameand/git/name.git, unknown names → not found)BasicAuthenticationconcern on the builder (rejected without credentials, works with them)mkdocs build --strictpasses🤖 Generated with Claude Code