README

ocaml-session

ocaml-session is an session manager that handles cookie headers and backend storage for HTTP servers. The library supportsCoHTTP andWebmachine;Async andLwt; and pluggable backing stores based on a functor interface.

Installation

Install the library and its depenencies viaOPAM:

opam install session

Basic Usage

Below is a simplified implementation of session-based user authentication, one of the most common use-cases of sessions. The server will respond with401 Unauthorized for every path until the client visits/authenticate, after which all paths will respond with200 OK.

module Session = struct  module Backend = Session_postgresql_lwt  include Session  include Session_cohttp_lwt.Make(Backend)endlet cookie_key = "__session"let callback conn { Request.headers; uri } body =  Session.of_header backend cookie_key headers  >>= function    | Ok (Some session) when authorized session ->      Server.respond ~status:`OK ()    | _ ->      if Uri.path = "/authenticate" then        let session = Session.generate backend "<user_id>" in        let headers = Header.of_list (Session.to_cookie_hdrs cookie_key session) in        Server.respond ~headers ~status:`OK ()      else        Server.respond ~status:`Unauthorized ()

There are additional examples for both CoHTTP and webmachine in theexamples subdirectory of this project. These examples use a session to count the number of HTTP requests that the server has received from a client. To build them, reconfigure the build to enable examples, an i/o library of our choice (e.g., Async or Lwt), as well as the library you're using to build your server (e.g., CoHTTP or Webmachine):

./configure --enable-examples --enable-async --enable-cohttpmake

Development

To install development versions of the library, pin the package from the root of the repository:

opam pin add .

You can install the latest changes by committing them to the local git repository and running:

opam upgrade session

For building and running the tests during development, you will need to install theoUnit package and reconfigure the build process to enable tests:

opam install oUnit./configure --enable-testsmake && make test

License

BSD3, see LICENSE file for its text.

1. postgresql
2. session>= "0.4.2"
3. dune>= "1.0"
4. ocaml>= "4.07.0"

None

1. session-postgresql-async
2. session-postgresql-lwt

None