Authmodule to work with
basic_authmiddleware to protect handlers with a
Basicauthentication method (#238)
Response.of_fileAPI for conveniently creating a response of a file (#244)
Add a package
opium-graphqlto easily create GraphQL server with Opium (#235)
Add a function
App.run_multicorethat uses pre-forking and spawns multiple processes that will handle incoming requests (#239)
Fix reading cookie values when multiple cookies are present in
This release is a complete rewrite of the Opium's internal that switches from Cohttp to Httpaf.
As demonstrated in several benchmarks, Httpaf's latency is much lower than Cohttp's in stress tests, so it is expected that Opium will perform better in these high pressure situations with this change.
The underlying HTTP server implementation is now contained in the
rock package, that provides a Service and Filter implementation, inspired by Finagle's. The architecture is similar to Ruby's Rack library (hence the name), so one can compose complex web applications by combining Rock applications.
rock package offers a very slim API, with very few dependencies, so it should be an attractive option for other Web framework to build on, which would allow the re-usability of middlewares and handlers, independently of the framework used (e.g. one could use Sihl middlewares with Opium, and vice versa).
Apart from the architectural changes, this release comes with a lot of additionnal utilities and middlewares which should make Opium a better candidate for complex web applications, without having to re-write a lot of common Web server functionnalities.
The Request and Response modules now provide:
JSON encoders/decoders with
HTML encoders/decoders with
XML encoders/decoders with
SVG encoders/decoders with
multipart/form encoders/decoders with
urlencoded encoders/decoders with
And the following middlewares are now built-in:
debuggerto display an HTML page with the errors in case of failures
loggerto log requests and responses, with a timer
allow_corsto add CORS headers
staticto serve static content given a custom read function (e.g. read from S3)
static_unixto to serve static content from the local filesystem
content_lengthto add the
Content-Lengthheader to responses
method_overrideto replace the HTTP method with the one found in the
ETagheader to the responses and send an HTTP code
304when the computed ETag matches the one specified in the request.
method_requiredto filter the requests by method and respond with an HTTP code
405if the method is not allowed.
headto add supports for
HEADrequest for handlers that receive
Lastly, this release also adds a package
opium-testing that can be used to test Opium applications with
Alcotest. It provides
Testable modules for every Opium types, and implements helper functions to easily get an
Opium.Response from an
Make examples easier to find and add documentation related to features used in them. (#125, @shonfeder)
Allow overriding 404 handlers (#127, @anuragsoni)
Support cohttp streaming response (#135, #137, #139, @anuragsoni)
Change Deferred.t to Lwt.t in readme (#91, @rymdhund)
cowfrom deps (#92, @anuragsoni)
Switch to dune (#88, @anuragsoni)
Keep the "/" cookie default and expose all cookie directives (#82, @actionshrimp)
Do not assume base 64 encoding of cookies (#74, @malthe)
Add caching capabilities to middleware (#76, @mattjbray)