Spock

For more information and tutorials, visit spock.li

Intro

Another Haskell web framework for rapid development: This toolbox provides everything you need to get a quick start into web hacking with haskell:

fast routing (both typesafe and "untyped")
middleware
json
sessions
cookies
database helper
csrf-protection

Benchmarks:

Usage (Simple)

{-# LANGUAGE OverloadedStrings #-}
import Web.Spock.Simple

import qualified Data.Text as T

main =
    runSpock 3000 $ spockT id $
    do get ("echo" <//> ":something") $
        do Just something <- param "something"
           text $ T.concat ["Echo: ", something]
       get ("regex" <//> "{number:^[0-9]+$}") $
        do Just number <- param "number"
           text $ T.concat ["Just a number: ", number]

Usage (Typesafe)

{-# LANGUAGE OverloadedStrings #-}
import Web.Spock.Safe

import qualified Data.Text as T

main =
    runSpock 3000 $ spockT id $
    do get ("echo" <//> var) $ \something ->
        text $ T.concat ["Echo: ", something]

(read more at Type-safe routing in Spock)

Install

Using cabal: cabal install Spock
From Source: git clone https://github.com/agrafix/Spock.git && cd Spock && cabal install

Candy

Extensions

The following Spock extensions exist:

Background workers for Spock: Spock-worker
Digestive functors for Spock: Spock-digestive

Works well with Spock

User management users
Data validation validate-input
Blaze bootstrap helpers blaze-bootstrap
digestive-forms bootstrap helpers digestive-bootstrap

Example Projects

Talks

German: Moderne typsichere Web-Entwicklung mit Haskell (by Alexander Thiemann)
German: reroute-talk (by Tim Baumann)

Companies / Projects using Spock

Notes

Since version 0.7.0.0 Spock supports typesafe routing. If you wish to continue using the untyped version of Spock you can Use Web.Spock.Simple. The implementation of the routing is implemented in a separate haskell package called reroute.

Since version 0.5.0.0 Spock is no longer built on top of scotty. The design and interface is still influenced by scotty, but the internal implementation differs from scotty's.

Thanks to

Tim Baumann Github (lot's of help with typesafe routing)
Tom Nielsen Github (much feedback and small improvements)

Cipherwraith/Spock