HTTP

Grammar to parse a cookie header to a series of keys and values.

(cookies nextmw)

Parses cookies into the table under :cookies key

(logger nextmw)

Creates a logging middleware. The logger middleware prints URL route, return status, and elapsed request time.

(middleware x)

Coerce any type to http middleware

Grammar that parses a query string (sans url path and ? character) and returns a table.

(read-body req)

Given a request, read the HTTP body from the connection. Returns the body as a buffer. If the request has no body, returns nil.

(read-request conn buf &opt no-query)

Read an HTTP request header from a connection. Returns a table with the following keys:

• :headers - table mapping header names to header values. Header names are lowercase.
• :connection - the connection stream for the header.
• :buffer - the buffer instance that may contain extra bytes.
• :head-size - the number of bytes used by the header.
• :method - the HTTP method used.
• :path - the path of the resource requested.

The following keys are also present, but omitted if the user passes a truthy parameter to no-query.

• :route - path of the resource requested without query string.
• :query-string - segment of HTTP path after first ? character.
• :query - the query string parsed into a table. Supports a single string value for every string key, and any query parameters that aren't given a value are mapped to true.

Note that data is read in chunks and any data after the header terminator is stored in :buffer.

(read-response conn buf)

Read an HTTP response header from a connection. Returns a table with the following keys:

• :headers - table mapping header names to header values. Header names are lowercase.
• :connection - the connection stream for the header.
• :buffer - the buffer instance that may contain extra bytes.
• :head-size - the number of bytes used by the header.
• :status - the HTTP status code.
• :message - the HTTP status message.

Note that data is read in chunks and any data after the header terminator is stored in :buffer.

(request method url &keys {:body body :headers headers})

Make an HTTP request to a server. Returns a table containing response information.

• :head-size - number of bytes in the http header
• :headers - table mapping header names to header values. Header names are lowercase.
• :connection - the connection stream for the header.
• :buffer - the buffer instance that may contain extra bytes.
• :status - HTTP status code as an integer.
• :message - HTTP status message.
• :body - Bytes of the response body.

PEG for parsing HTTP requests

PEG for parsing HTTP responses

(router routes)

Creates a router middleware. A router will dispatch to different routes based on the URL path.

(send-response conn response &opt buf)

Send an HTTP response over a connection. Will automatically use chunked encoding if body is not a byte sequence. response should be a table with the following keys:

• :headers - optional headers to write
• :status - integer status code to write
• :body - optional byte sequence or iterable (for chunked body) for returning contents. The iterable can be lazy, i.e. for streaming data.

(server handler &opt host port)

Makes a simple http server. By default it binds to 0.0.0.0:8000, returns a new server stream. Simply wraps http/server-handler with a net/server.

(server-handler conn handler)

A simple connection handler for an HTTP server. When a connection is accepted. Call this with a handler function to handle the connect. The handler will be called with one argument, the request table, which will contain the following keys:

• :head-size - number of bytes in the http header.
• :headers - table mapping header names to header values.
• :connection - the connection stream for the header.
• :buffer - the buffer instance that may contain extra bytes.
• :path - HTTP path.
• :method - HTTP method, as a string.

Mapping of HTTP status codes to their status message.

Grammar to parse a URL into domain, port, and path triplet. Only supports the http:// protocol.