httpspec: Specification of HTTP request/response generators and parsers

[ data, library, web ] [ Propose Tags ]

Using httpspec you can write a specification for a HTTP request/response defining the method, headers, url parameters and the body. This specification bidirectionally maps an abstract request/response data type to a concrete realisation as a HTTP request/response. The specification can be used to generate HTTP requests/responses from an abstract description and it can be used to parse a HTTP request/response into such an abstract description. The idea is very similar to the way pickling of XML data is described in HXT. For example, the abstract representation of an authentication request and response could be described as data AuthUserReq = AuthUserReq { authUser_user :: String , authUser_pass :: String } data AuthUserRes = AuthUserOk { authUserOk_sid :: String } | AuthUserFailed Using httpspec you can define a mapping between HTTP and these types: instance HasReqSpec AuthUserReq where reqSpec = rsMeth Http.POST $ rsPath "/authenticate-user" $ rsWrap (uncurry AuthUserReq, (AuthUserReq a b) -> (a,b)) $ rsPair (rsParam "uid") (rsParam "pass") instance HasResSpec AuthUserRes where resSpec = rsSwitch [ rsCase (AuthUserOk,authUserOk_sid) $ rsStatus 200 $ rsContentType "text/plain" $ rsEncodingFixed UTF8 $ rsBody , rsCaseConst AuthUserFailed $ rsStatus 403 ]


Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS] 0.1,
Dependencies base (>=4 && <5), bidispec, bytestring, cgi, containers, encoding (>=0.6), filepath, HTTP, hxt (>8.3), hxthelper, MissingH, mtl, network, pretty, safe [details]
License LicenseRef-LGPL
Author David Leuschner, Stefan Wehr
Maintainer David Leuschner <>
Category Data, Web
Uploaded by StefanWehr at 2010-10-05T14:52:09Z
Reverse Dependencies 2 direct, 0 indirect [details]
Downloads 1835 total (6 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]