Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Very lightweight HTTP server using Lwt or Async
OCaml JavaScript Other

This branch is even with mirage:master

Failed to load latest commit information.
async Limited read buffer size in Async backend to 32K.
bin remove debug output from `cohttp-curl-async`
examples/async Add async client example s3_cp
js Fix type in post_form
lib bump to 0.17.2
lib_test make test_net_async actually the non-ssl and ssl tests rather than ju…
lwt Use Lwt.return_{true|false}
scripts Remove unnecessary test in generate.ml
.gitignore Test the Link header support and adopt alcotest
.merlin Test the Link header support and adopt alcotest
.ocp-indent ocp-indent config file for lwt
.travis-ci.sh Travis: simplify and just test on OPAM 1.2 now
.travis.yml test async_ssl as well
CHANGES bump to 0.17.2
DESIGN.md Add a very skeletal `DESIGN.md` document to explain the library struc…
LICENSE Replace LICENSE with the ISC, which has been true of the individual
Makefile Remove netttests as it's not used
README.md tweak gitter icon position
TODO.md remove Async SSL todo
_oasis bump to 0.17.2
_opam Add several fields and versions constraints in _oasis
_tags regenerate oasis
cohttp.install Actually installs binaries fixing regression in bd626e for #252
myocamlbuild.ml regenerate oasis
opam bump to 0.17.2
setup.ml bump to 0.17.2

README.md

Join the chat at https://gitter.im/mirage/ocaml-cohttp

CoHTTP is an OCaml library for creating HTTP daemons. It has a portable HTTP parser, and implementations using various asynchronous programming libraries:

  • Cohttp_lwt_unix uses the Lwt library, and specifically the UNIX bindings.
  • Cohttp_async uses the Async library.
  • Cohttp_lwt exposes an OS-independent Lwt interface, which is used by the the Mirage interface to generate standalone microkernels (see the mirage-http repository).
  • Cohttp_lwt_xhr compiles to a JavaScript module that maps the Cohttp calls to XMLHTTPRequests. This is used to compile OCaml libraries like the GitHub bindings to JavaScript and still run efficiently.

You can implement other targets using the parser very easily. Look at the lib/IO.mli signature and implement that in the desired backend.

You can activate some runtime debugging by setting COHTTP_DEBUG to any value, and all requests and responses will be written to stderr. Further debugging of the connection layer can be obtained by setting CONDUIT_DEBUG to any value.

Installation

Latest stable version should be obtained from opam. Make sure to install the specific backends you want as well. E.g.

$ opam install cohttp lwt js_of_ocaml

You can also obtain the development release:

$ opam pin add cohttp --dev-repo

Simple HTTP server

If you install the Async dependency, then a cohttp-server-async binary will also be built and installed that acts in a similar fashion to the Python SimpleHTTPServer. Just run cohttp-server-async in a directory and it will open up a local port and serve the files over HTTP.

There is also an Lwt version of the SimpleHTTPServer installed as the cohttp-server-lwt binary. The source code for both is in the bin/ subdirectory and is a good starting point for how to write servers using the library.

Something went wrong with that request. Please try again.