package uwt

Uwt

Uwt provides OCaml bindings for libuv - on top of lwt.

• Requests are translated to lwt-threads.
• Callbacks that are called continually are most of the time not translated to the usual lwt semantic.
• naming conventions mirror the conventions of libuv, so you can easily consult the official libuv manual. Only the differences are explained inside uwt.mli
• Uwt is not compatible with lwt.unix. It's not a further Lwt_engine in addition to select and libev. However, the findlib package uwt.ext provides alternatives to the higher level modules of lwt.unix with a nearly identic interface (Uwt_io, Uwt_process, Uwt_log). You can also open the module Uwt_compat (package uwt.compat) that provides aliases with module names as found in lwt (e.g. Lwt_main instead of Uwt.Main). This is necessary, if you want to use the camlp4 syntax extension of lwt.
• Uwt is not thread safe. All uwt functions should be called from your main thread.

Installation

Quick install guide

$ opam install uwt
# or for the latest development version
$ opam pin add uwt --dev-repo

Manual install

Dependencies:

• OCaml 4.02.1 or later
• lwt 2.6.0 or later
• libuv 1.8 or later

Build dependencies:

• pkg-config / pkgconf
• findlib
• omake
• cppo
• ppx_deriving (test only)
• ppx_import (test only)
• ounit (test only)
• autoconf (repo pinning only)

$ omake all
$ omake install

libuv will be compiled locally, if is not already installed on your system. You can also explicity enforce one option:

$ omake all BUILD_LIBUV=true
# or
$ omake all BUILD_LIBUV=false