snap-server: A web server for the Snap Framework

[ bsd3, io-streams, library, snap, web ] [ Propose Tags ] [ Report a vulnerability ]

Snap is a simple and fast web development framework and server written in Haskell. For more information or to download the latest version, you can visit the Snap project website at http://snapframework.com/.

The Snap HTTP server is a high performance 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.

[Skip to Readme]

Modules

[Index] [Quick Jump]

Snap
- Http
  - Snap.Http.Server
    - Snap.Http.Server.Config
    - Snap.Http.Server.Types
- Internal
  - Http
    - Server
      - Snap.Internal.Http.Server.Config
      - Snap.Internal.Http.Server.Types
System
- System.FastLogger

Flags

Manual Flags

Name	Description	Default
openssl	Enable https support using the HsOpenSSL library.	Disabled
build-pong	Build a server that just returns PONG? Normally useful only for benchmarks.	Disabled
build-testserver	Build the blackbox testserver?	Disabled
debug	Enable support for debugging.	Disabled

Automatic Flags

Name	Description	Default
portable	Compile in cross-platform mode. No platform-specific code or optimizations such as C routines will be used.	Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

snap-server-1.1.2.1.tar.gz [browse] (Cabal source package)
Package description (revised from the package)

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

DougBeardsley, GregoryCollins, imalsogreg

For package maintainers and hackage trustees

edit package information

Candidates

No Candidates

Versions [RSS]	0.1.1, 0.1.2, 0.1.3, 0.1.4, 0.2.1, 0.2.2, 0.2.4, 0.2.5, 0.2.6, 0.2.7, 0.2.7.1, 0.2.7.2, 0.2.8, 0.2.8.1, 0.2.9, 0.2.10, 0.2.10.1, 0.2.10.2, 0.2.11, 0.2.12, 0.2.13, 0.2.13.1, 0.2.13.2, 0.2.13.3, 0.2.14, 0.2.14.1, 0.2.15, 0.2.15.1, 0.2.16, 0.2.16.1, 0.2.16.2, 0.3.0, 0.3.1, 0.3.1.1, 0.4.0, 0.4.0.1, 0.4.0.2, 0.4.1, 0.4.2, 0.4.3, 0.5.0, 0.5.1, 0.5.1.1, 0.5.1.2, 0.5.1.3, 0.5.1.4, 0.5.2, 0.5.3, 0.5.3.1, 0.5.4, 0.5.5, 0.6.0, 0.6.0.1, 0.7, 0.7.0.1, 0.8.0, 0.8.0.1, 0.8.1, 0.8.1.1, 0.9.0, 0.9.2, 0.9.2.1, 0.9.2.2, 0.9.2.3, 0.9.2.4, 0.9.3, 0.9.3.1, 0.9.3.3, 0.9.3.4, 0.9.4.0, 0.9.4.1, 0.9.4.2, 0.9.4.3, 0.9.4.4, 0.9.4.5, 0.9.4.6, 0.9.5.0, 0.9.5.1, 1.0.0.0, 1.0.1.0, 1.0.1.1, 1.0.2.0, 1.0.2.1, 1.0.2.2, 1.0.3.0, 1.0.3.1, 1.0.3.2, 1.0.3.3, 1.1.0.0, 1.1.1.0, 1.1.1.1, 1.1.1.2, 1.1.2.0, 1.1.2.1
Dependencies	attoparsec (>=0.12 && <0.15), base (>=4.6 && <5), blaze-builder (>=0.4 && <0.5), bytestring (>=0.9.1 && <0.13), bytestring-builder, case-insensitive (>=1.1 && <1.3), clock (>=0.7.1 && <0.9), containers (>=0.3 && <0.8), directory, filepath (>=1.1 && <2.0), io-streams (>=1.3 && <1.6), io-streams-haproxy (>=1.0 && <1.1), lifted-base (>=0.1 && <0.3), mtl (>=2.0 && <2.4), network (>=2.3 && <4), old-locale (>=1.0 && <1.1), semigroups (>=0.16 && <0.19), snap-core (>=1.0 && <1.1), text (>=0.11 && <2.2), time (>=1.0 && <2), transformers (>=0.3 && <0.7), unix, unix-compat (>=0.2 && <0.8), vector (>=0.7 && <0.14) [details]
Tested with	ghc ==7.6.3, ghc ==7.8.4, ghc ==7.10.3, ghc ==8.0.2, ghc ==8.2.2, ghc ==8.4.4, ghc ==8.6.5, ghc ==8.8.3, ghc ==8.10.1
License	BSD-3-Clause
Author	Snap Framework Authors (see CONTRIBUTORS)
Maintainer	snap@snapframework.com
Revised	Revision 5 made by cydparser at 2024-07-04T07:19:25Z
Category	Web, Snap, IO-Streams
Home page	http://snapframework.com/
Bug tracker	https://github.com/snapframework/snap-server/issues
Source repo	head: git clone git://github.com/snapframework/snap-server.git
Uploaded	by cydparser at 2023-02-13T08:56:43Z
Distributions	Arch:1.1.2.1, Debian:1.1.1.2, Fedora:1.1.2.1, FreeBSD:0.9.5.1, LTSHaskell:1.1.2.1, NixOS:1.1.2.1, Stackage:1.1.2.1
Reverse Dependencies	19 direct, 167 indirect [details]
Executables	snap-test-server, snap-test-pong-server
Downloads	136157 total (468 in the last 30 days)
Rating	2.5 (votes: 3) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs available [build log] Last success reported on 2023-02-13 [all 1 reports]

Readme for snap-server-1.1.2.1

[back to package description]

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 http://www.snapframework.com/.

Building snap-server

Dependencies

To build the Snap HTTP server, you need to cabal install the snap-core library (which should have come with this package).

Optional dependencies

If you would like SSL support, snap-server requires the openssl library.

Building snap-server

The snap-server library is built using Cabal and Hackage. Just run

cabal install

to install snap-server.

If you would like SSL support, pass the openssl flag to cabal install:

cabal install -fopenssl

Building the Haddock Documentation

The haddock documentation can be built using the supplied haddock.sh shell script:

./haddock.sh

The docs get put in dist/doc/html/.

Building the testsuite

The 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 -fopenssl  # for the SSL backend

$ cabal build

From here you can invoke the testsuite by running:

$ ./runTestsAndCoverage.sh

The testsuite generates an hpc test coverage report in test/dist/hpc.