Snap Framework HTTP Server Library
This is the Snap Framework HTTP Server library. For more information about
Snap, read the
README.SNAP.md or visit the Snap project website at
The Snap HTTP server is a high performance, epoll-enabled, iteratee-based web
server library written in Haskell. Together with the
snap-core library upon
which it depends, it provides a clean and efficient Haskell programming
interface to the HTTP protocol. Higher-level facilities for building web
applications (like user/session management, component interfaces, data
modeling, etc.) are not yet implemented, so this release will mostly be of
interest for those who:
- need a fast and minimal HTTP API at roughly the same level of abstraction as Java servlets,
- are interested in contributing to the Snap Framework project.
To build the Snap HTTP server, you need to
cabal install the
library (which should have come with this package).
snap-server library can optionally use the
libev for high-speed, O(1)
scalable socket event processing.
If you would like SSL support,
snap-server requires the
to get the "stock" version of Snap. If you would like to try the optional
libev backend, pass the
libev flag to
cabal install -flibev
And if you would like SSL support, pass the
gnutls flag to
cabal install -fgnutls
Note that the "
-flibev" and "
-fgnutls" flags are not mutually-exclusive,
and if you would like you can use them together.
Building the Haddock Documentation
The haddock documentation can be built using the supplied
The docs get put in
Building the testsuite
snap-server has a fairly comprehensive test suite. To build and run it,
cd into the
test/ directory and run
$ cabal configure # for the stock backend, or.. $ cabal configure -flibev # for the libev backend, and/or.. $ cabal configure -fgnutls # for the SSL backend $ cabal build
From here you can invoke the testsuite by running:
The testsuite generates an
hpc test coverage report in