Command line runner for Wai apps (using Warp) with TLS, CGI, socket activation & graceful shutdown.
Command line runner for Wai apps (using Warp) with support for UNIX domain sockets, TLS (can be turned off with a cabal flag to avoid compiling the TLS library), CGI, socket activation (systemd-compatible, but see https://github.com/unrelentingtech/soad for a more interesting (and not linux-only) thing than what systemd does), and graceful shutdown (on TERM signal).
wai-cli
A command line runner for Wai apps (using Warp) with support for:
--protocol http --port 8000
TCP sockets--protocol unix --socket /var/run/app/sock
UNIX domain sockets--protocol cgi
running as a CGI app (the original serverless lambda functions from the 90s)--protocol fastcgi
running as a FastCGI app (OPTIONAL! You need to build with thefastcgi
cabal flag and you need to havelibfcgi
(e.g.fcgi-devkit
package on FreeBSD) installed)--protocol activate
socket activation (systemd-compatible, but not restricted to systemd in any way. see soad for an interesting use of (de)activation!)--protocol (http+tls|unix+tls|activate+tls) --tlskey key.pem --tlscert cert.pem
TLS (can be turned off with a cabal flag to avoid compiling the TLS library)--graceful (none|serve-normally|serve-503)
graceful shutdown (on TERM signal)--devlogging
development logging (fromwai-extra
)- printing a pretty and colorful run message (e.g.
Running on http port 3000 with 4 CPUs
) (you can replace it with your own, or with nothing)
Extracted from sweetroll and microformats2-parser's demo web app.
Now used in the magicbane framework (which was also extracted from sweetroll).
Usage
Add a dependency on wai-cli
and write something like this:
{-# LANGUAGE OverloadedStrings #-}
import Web.Scotty
import Network.Wai.Cli
import Data.Monoid (mconcat)
app = scottyApp $ do
get "/:word" $ do
beam <- param "word"
html $ mconcat ["<h1>Scotty, ", beam, " me up!</h1>"]
main = defWaiMain =<< app
Want to use command line args for your application-specific settings? Don't. Use environment variables instead. Possibly with dotenv to load some of them from a file. envy is a really awesome way to read them.
License
This is free and unencumbered software released into the public domain.
For more information, please refer to the UNLICENSE
file or unlicense.org.