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. An adapter must handle all errors from the handler, including the handler returning a null response. It should print each error to the console if possible, then act as though the handler returned a 500 response. The adapter may include body data for the 500 response, but this body data must not include information about the error that occurred. This ensures that unexpected errors don't result in exposing internal information in production by default; if the user wants to return detailed error descriptions, they should explicitly include middleware to do so.
Features
- Model for web server middleware that encourages composition and easy reuse
- Shelf handler for serving a packages/ directory
- 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
Project Samples
