package dream

  1. Overview
  2. Docs
Tidy, feature-complete Web framework

Install 

dune-project
 Dependency

github.com Edit opam file Versions (8)

Authors

  1. Anton Bachin

Maintainers

  1. Anton Bachin

Sources

dream-1.0.0-alpha4.tar.gz
sha256=a143b3694d67c0089ea16ce4585971d6333f05001abcadcede6696b06ca6af10
md5=20aaa93b13c210324e9dcceeba3c3b21

Description

Dream is a feature-complete Web framework with a simple programming model and no boilerplate. It provides only two data types, request and response.

Almost everything else is either a built-in OCaml type, or an abbreviation for a bare function. For example, a Web app, known in Dream as a handler, is just an ordinary function from requests to responses. And a middleware is then just a function from handlers to handlers.

Within this model, Dream adds:

  • Session management with pluggable back ends.
  • A fully composable router.
  • Support for HTTP/1.1, HTTP/2, and HTTPS.
  • WebSockets.
  • GraphQL, including subscriptions and a built-in GraphiQL editor.
  • SQL connection pool helpers.
  • Server-side HTML templates.
  • Automatic secure handling of cookies and forms.
  • Unified, internationalization-friendly error handling.
  • A neat log, and OCaml runtime configuration.
  • Helpers for Web formats, such as Base64url, and a modern cipher.

Because of the simple programming model, everything is optional and composable. It is trivailly possible to strip Dream down to just a bare driver of the various HTTP protocols.

Dream is presented as a single module, whose API is documented on one page. In addition, Dream comes with a large number of examples. Security topics are introduced throughout, wherever they are applicable.

Tags

http web framework websocket graphql server http2 tls

Published: 08 Mar 2022

Dependencies (28)

  1. yojson
  2. uri >= "4.2.0"
  3. ssl >= "0.5.8"
  4. ptime >= "0.8.1"
  5. ocaml >= "4.08.0"
  6. multipart_form-lwt
  7. multipart_form >= "0.4.0"
  8. mirage-crypto-rng >= "0.8.0" & < "0.11.0"
  9. mirage-crypto >= "0.8.1" & < "1.0.0"
  10. mirage-clock >= "3.0.0"
  11. magic-mime
  12. logs >= "0.5.0"
  13. lwt_ssl
  14. lwt_ppx >= "1.2.2"
  15. lwt
  16. graphql-lwt
  17. graphql_parser
  18. fmt >= "0.8.7"
  19. dune >= "2.7.0"
  20. dream-pure >= "1.0.0~alpha2"
  21. dream-httpaf < "1.0.0~alpha2"
  22. cstruct >= "6.0.0"
  23. conf-libev os != "win32"
  24. caqti-lwt
  25. caqti >= "1.6.0" & < "2.0.0~"
  26. camlp-streams
  27. bigarray-compat
  28. base-unix

Dev Dependencies (12)

  1. tyxml-ppx with-test & >= "4.5.0"
  2. tyxml-jsx with-test & >= "4.5.0"
  3. tyxml with-test & >= "4.5.0"
  4. reason with-test
  5. ppx_yojson_conv with-test
  6. ppx_expect with-test
  7. lambdasoup with-test
  8. crunch with-test
  9. caqti-driver-sqlite3 with-test
  10. caqti-driver-postgresql with-test
  11. bisect_ppx with-test & >= "2.5.0"
  12. alcotest with-test

Conflicts

None