Google Git
Sign in
dart/shelf/a6693a97d980efff06821173186776e2442027b2
commit
a6693a97d980efff06821173186776e2442027b2
[log]
author
Kevin Moore <kevmoo@users.noreply.github.com>
Wed Apr 22 23:15:09 2026 -0700
committer
GitHub <noreply@github.com>
Wed Apr 22 23:15:09 2026 -0700
tree
728ebe2a258ce31c45dbb6c40e924a510501a7a1
parent
c4b94d3879e627c0b1fe95d9e1ce5f93ebf122d3 [diff]
feat: Add HTTP/1.1 compliance testing package and baseline for shelf (#518)

- Created `pkgs/_shelf_compliance` package to run HTTP/1.1 compliance tests.
- Vendored the `Http11Probe` tool as a git submodule in `vendor/Http11Probe`.
- Implemented a generic test harness in `test/compliance_test.dart` that runs the probe by category and verifies against goldens.
- Created `bin/update_goldens.dart` to easily regenerate golden baseline JSON and markdown files.
- Created `tool/generate_summary.dart` to post-process JSON reports into a clean, deduplicated markdown summary file (`shelf_summary.md`).
- Added `mono_pkg.yaml` and configured a separate `compliance` workflow in `.github/workflows/compliance.yml`.
- Added `tool/run_tests_with_dotnet.sh` to pre-install the .NET 10 SDK on CI runners before running tests.
30 files changed
tree: 728ebe2a258ce31c45dbb6c40e924a510501a7a1
  1. .github/
  2. pkgs/
  3. tool/
  4. vendor/
  5. .gitignore
  6. .gitmodules
  7. CONTRIBUTING.md
  8. LICENSE
  9. mono_repo.yaml
  10. README.md
README.md

Build Status

About Shelf

Shelf makes it easy to create and compose web servers and parts of web servers. How?

  • Expose a small set of simple types.
  • Map server logic into a simple function: a single argument for the request, the response is the return value.
  • Trivially mix and match synchronous and asynchronous processing.
  • Flexibility to return a simple string or a byte stream with the same model.

It was inspired by Connect for NodeJS and Rack for Ruby.

See the package:shelf readme for more information.

Packages

PackageDescriptionIssuesVersion
shelfA model for web server middleware that encourages composition and easy reuse.issuespub package
shelf_packages_handlerA shelf handler for serving a packages/ directory.issuespub package
shelf_proxyA shelf handler for proxying HTTP requests to another server.issuespub package
shelf_routerA convenient request router for the shelf web-framework, with support for URL-parameters, nested routers and routers generated from source annotations.issuespub package
shelf_router_generatorA package:build-compatible builder for generating request routers for the shelf web-framework based on source annotations.issuespub package
shelf_staticStatic file server support for the shelf package and ecosystem.issuespub package
shelf_test_handlerA Shelf handler that makes it easy to test HTTP interactions.issuespub package
shelf_web_socketA shelf handler that wires up a listener for every connection.issuespub package
_shelf_complianceHTTP/1.1 compliance and hardening tests.issues(not published)

Publishing automation

For information about our publishing automation and release process, see https://github.com/dart-lang/ecosystem/wiki/Publishing-automation.