package tiny_httpd

  1. Overview
  2. Docs
Minimal HTTP server using threads

Install 

dune-project
 Dependency

github.com Edit opam file Versions (21)

Authors

  1. C
    c-cube

Maintainers

  1. C
    c-cube

Sources

tiny_httpd-0.21.tbz
sha256=d38cc3962761e85f552171182a540746cbee6840bb9985efc260982e351d54f4
sha512=c658430db112079d3198db16b0b9e34015bc6407ed2cc539c695e9d9b3274b13fb87c6f884ff919d707317ed7b13effd14bb7188bb44ec01170a6f099b244ffa

doc/tiny_httpd.ws/Tiny_httpd_ws/index.html

Module Tiny_httpd_wsSource

Websockets for Tiny_httpd.

This sub-library (tiny_httpd.ws) exports a small implementation for a websocket server. It has no additional dependencies.

Sourcemodule With_lock : sig ... end

Synchronization primitive used to allow both the reader to reply to "ping", and the handler to send messages, without stepping on each other's toes.

Websocket handler

Upgrade a byte stream to the websocket framing protocol.

  • parameter with_lock

    if provided, use this to prevent reader and writer to compete on sending frames. since 0.21.

Sourceexception Close_connection

Exception that can be raised from IOs inside the handler, when the connection is closed from underneath.

Sourceval add_route_handler : ?accept:(unit Tiny_httpd_core.Request.t -> (unit, int * string) result) -> ?accept_ws_protocol:(string -> bool) -> ?accept_origin:(string option -> bool) -> ?middlewares:Tiny_httpd_core.Server.Head_middleware.t list -> ?with_lock:With_lock.builder -> Tiny_httpd_core.Server.t -> (Tiny_httpd_core.Server.upgrade_handler, Tiny_httpd_core.Server.upgrade_handler) Tiny_httpd_core.Route.t -> handler -> unit

Add a route handler for a websocket endpoint.

  • parameter accept_ws_protocol

    decides whether this endpoint accepts the websocket protocol sent by the client. Default accepts everything.

  • parameter accept_origin

    decides whether this endpoint accepts the Origin header sent by the client (None means the header was absent). Default accepts everything. For browser-facing endpoints, provide an allowlist here to prevent Cross-Site WebSocket Hijacking (CSWSH).

  • parameter with_lock

    if provided, use this to synchronize writes between the frame reader (replies "pong" to "ping") and the handler emitting writes. since 0.21.