lmug-inets

An lmug adapter for the OTP inets web server

Introduction
- EWSAPI
Installation
Documentation
Usage
License

Introduction ↟

Like Clojure's Ring before it, LFE's lmug provides the LFE programmer a means for creating middleware between an HTTP server request and the response that is returned to the client.

In particular, lmug-inets implements an lmug adaptor for use with the Erlang/OTP inets http server, allowing lmug middleware to run on the OTP inets web server by adapting lmug requests, responses, and handlers to the Erlang Web Server API (EWSAPI). For more backgound and some detailed context, be sure to checkout our EWSAPI & lmug notes.

Installation ↟

{deps, [
   {lmug-inets, "0.1.0", {pkg, lmug_inets}}
  ]}.

Documentation ↟

Usage ↟

Define an app with a middleware chain:

lfe> (set app (clj:-> (lmug:app)
                      (lmug-mw-request-id:wrap)
                      (lmug-mw-content-type:wrap)
                      (lmug-mw-status-body:wrap)
                      (lmug-mw-log-request:wrap #m(log-level notice))))

lfe> (set inets-opts `(#(document_root "/tmp")
                       #(server_root "/tmp")
                       #(port 5099)))

lfe> (lmug-inets:start app inets-opts)

This can be tested from another terminal with curl:

curl -v "http://alice:sekr1t@localhost:5099/response.txt"

Which will give something like the following:

*   Trying 127.0.0.1:5099...
* Connected to localhost (127.0.0.1) port 5099 (#0)
> GET /response.txt HTTP/1.1
> Host: localhost:5099
> User-Agent: curl/8.1.2
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Thu, 15 Feb 2024 22:29:34 GMT
< Server: inets/9.1 (unix/darwin) OTP/26
< X-Request-ID: 233220009500597629653337000383468273664
< Content-Type: text/plain
< Content-Length: 3
<
* Connection #0 to host localhost left intact
200

License ↟