apiary: Simple and type safe web framework that can be automatically generate API documentation.

Simple and type safe web framework that can be automatically generate API documentation.

{-# LANGUAGE QuasiQuotes #-}
{-# LANGUAGE OverloadedStrings #-}

import Web.Apiary
import Network.Wai.Handler.Warp
import qualified Data.ByteString.Lazy.Char8 as L

main :: IO ()
main = server (run 3000) . runApiary def $ do
  [capture|/:Int|] . ("name" =: pLazyByteString) . method GET . action $ \age name -> do
      guard (age >= 18)
      contentType "text/html"
      mapM_ lazyBytes ["<h1>Hello, ", name, "!</h1>\n"]

$ curl localhost:3000
404 Page Notfound.
$ curl 'localhost:3000/20?name=arice'
<h1>Hello, arice!</h1>
$ curl 'localhost:3000/15?name=bob'
404 Page Notfound.
$ curl -XPOST 'localhost:3000/20?name=arice'
404 Page Notfound.

• High performance(benchmark: https://github.com/philopon/apiary-benchmark/tree/v0.17.0).

• Nestable route handling(Apiary Monad; capture, method and more.).

• Type safe route filter.

• Auto generate API documentation(example: https://github.com/philopon/apiary/blob/v0.17.0/examples/api.hs, https://rawgit.com/philopon/apiary/v0.17.0/examples/api.html).

more examples: https://github.com/philopon/apiary/blob/v0.17.0/examples/

live demo: http://best-haskell.herokuapp.com/ (source code: https://github.com/philopon/best-haskell)

Modules

[Index]

Flags

Automatic Flags

Name	Description	Default
wai3	use wai-3.0	Enabled

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

Downloads

• apiary-0.17.0.tar.gz [browse] (Cabal source package)
• Package description (as included in the package)

Maintainer's Corner

Package maintainers

• HirotomoMoriwaki, winterland

For package maintainers and hackage trustees

• edit package information

Candidates

• No Candidates