snap: Top-level package for the Snap Web Framework

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

This is the top-level package for the official Snap Framework libraries. It includes:

The Snaplets API
Snaplets for sessions, authentication, and templates

To get started, issue the following sequence of commands:

$ cabal install snap snap-templates
$ mkdir myproject
$ cd myproject
$ snap init

If you have trouble or any questions, see our FAQ page (http://snapframework.com/faq) or the documentation (http://snapframework.com/docs).

Note: since version 1.0, the "snap" executable program for generating starter projects is provided by the snap-templates package.

[Skip to Readme]

Properties

Versions	0.3.0, 0.3.0.1, 0.3.1, 0.4, 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.2, 0.5.3, 0.5.3.1, 0.5.4, 0.5.5, 0.5.5.1, 0.6.0, 0.6.0.1, 0.6.0.2, 0.7, 0.8.0, 0.8.0.1, 0.8.0.2, 0.8.1, 0.9.0, 0.9.0.1, 0.9.1, 0.9.1.1, 0.9.2, 0.9.2.1, 0.9.2.2, 0.10.0, 0.10.0.1, 0.11.0, 0.11.1, 0.11.2, 0.11.2.1, 0.11.2.2, 0.11.3, 0.11.3.1, 0.12.0, 0.12.1, 0.13.0, 0.13.0.1, 0.13.0.2, 0.13.0.3, 0.13.0.4, 0.13.1, 0.13.1.1, 0.13.1.2, 0.13.2.0, 0.13.2.1, 0.13.2.2, 0.13.2.3, 0.13.2.4, 0.13.2.5, 0.13.2.6, 0.13.2.7, 0.13.2.8, 0.13.2.9, 0.13.3, 0.13.3.1, 0.13.3.2, 0.14.0, 0.14.0.1, 0.14.0.2, 0.14.0.3, 0.14.0.4, 0.14.0.5, 0.14.0.6, 0.14.0.7, 1.0.0.0, 1.0.0.1, 1.0.0.2, 1.1.0.0, 1.1.0.0, 1.1.1.0, 1.1.2.0, 1.1.3.0, 1.1.3.1
Change log	None available
Dependencies	aeson (>=0.6 && <1.3), attoparsec (>=0.10 && <0.14), base (>=4 && <4.11), bytestring (>=0.9.1 && <0.11), cereal (>=0.3 && <0.6), clientsession (>=0.8 && <0.10), configurator (>=0.1 && <0.4), containers (>=0.2 && <0.6), directory (>=1.1 && <1.4), directory-tree (>=0.10 && <0.13), dlist (>=0.5 && <0.9), filepath (>=1.3 && <1.5), hashable (>=1.2.0.6 && <1.3), heist (>=1.0 && <1.1), lens (>=3.7.6 && <4.16), lifted-base (>=0.2 && <0.3), map-syntax (>=0.2 && <0.3), monad-control (>=0.3 && <1.1), mtl (>=2.0 && <2.3), mwc-random (>=0.8 && <0.14), pwstore-fast (>=2.2 && <2.5), snap-core (>=1.0 && <1.1), snap-server (>=1.0 && <1.1), stm (>=2.2 && <2.5), text (>=0.11 && <1.3), time (>=1.1 && <1.9), transformers (>=0.2 && <0.6), transformers-base (>=0.4 && <0.5), unordered-containers (>=0.1.4 && <0.3), xmlhtml (>=0.1 && <0.3) [details]
License	BSD-3-Clause
Author	Ozgun Ataman, Doug Beardsley, Gregory Collins, Carl Howells, Chris Smith
Maintainer	snap@snapframework.com
Category	Web, Snap
Home page	http://snapframework.com/
Bug tracker	https://github.com/snapframework/snap/issues
Source repo	head: git clone https://github.com/snapframework/snap.git
Uploaded	by DougBeardsley at 2018-01-09T15:46:37Z

Modules

[Index]

Snap
- Snap.Snaplet

Downloads

snap-1.1.0.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

DougBeardsley, GregoryCollins, imalsogreg, cydparser

For package maintainers and hackage trustees

edit package information

Readme for snap-1.1.0.0

[back to package description]

Snap Framework

Snap is a simple and fast web development framework and server written in Haskell. For more information about Snap, read the README.SNAP.md or visit the Snap project website at http://www.snapframework.com/.

Library contents

This is top-level project for the Snap Framework, which contains:

a library allowing Snap applications to recompile actions on the fly in development mode, with no performance loss in production mode.
a "snaplet" API allowing web applications to be build from composable pieces.

The command-line utility snap for creating initial Snap applications used to be a part of this package. As of version 1.0, the snap command-line utility is no longer provided by this package. It is now provided by the package snap-templates.

Building snap

After you clone the repository, change to the newly created snap directory and run

git submodule update --init --recursive
./init-sandbox.sh
cabal install

(You may want to look at pull.sh or pullLatestMaster.sh.) This updates all the Snap Framework dependencies to the correct version, creates a sandbox, and installs everything. The snap library is built using Cabal and Hackage.

Building the Haddock Documentation

The haddock documentation can be built using 'cabal haddock'.

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

Building the testsuite

To build the test suite, run

$ cabal clean
$ cabal configure --enable-tests --enable-library-coverage
$ cabal build
$ cabal install --enable-tests

From here you can invoke the testsuite by running:

$ ./runTestsAndCoverage.sh

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

Roadmap to Understanding Snaplets

Read Tutorial.lhs which is in the project_template/tutorial/src directory of the snap-templates package.
Generate and read the haddock docs.
The test code has the nice property that it actually functions as a pretty good example app and covers a lot of the use cases.
If you're interested in the implementation, read design.md.