The HTTP package

[Tags:bsd3, library, test]

The HTTP package supports client-side web programming in Haskell. It lets you set up HTTP connections, transmitting requests and processing the responses coming back, all from within the comforts of Haskell. It's dependent on the network package to operate, but other than that, the implementation is all written in Haskell.

A basic API for issuing single HTTP requests + receiving responses is provided. On top of that, a session-level abstraction is also on offer (the BrowserAction monad); it taking care of handling the management of persistent connections, proxies, state (cookies) and authentication credentials required to handle multi-step interactions with a web server.

The representation of the bytes flowing across is extensible via the use of a type class, letting you pick the representation of requests and responses that best fits your use. Some pre-packaged, common instances are provided for you (ByteString, String.)

Here's an example use:

    do
      rsp <- Network.HTTP.simpleHTTP (getRequest "http://www.haskell.org/")
              -- fetch document and return it (as a 'String'.)
      fmap (take 100) (getResponseBody rsp)

    do
      (_, rsp)
         <- Network.Browser.browse $ do
               setAllowRedirects True -- handle HTTP redirects
               request $ getRequest "http://www.haskell.org/"
      return (take 100 (rspBody rsp))

Properties

Versions 3000.0.0, 3001.0.0, 3001.0.1, 3001.0.2, 3001.0.3, 3001.0.4, 3001.1.3, 3001.1.4, 3001.1.5, 4000.0.0, 4000.0.1, 4000.0.2, 4000.0.3, 4000.0.4, 4000.0.5, 4000.0.6, 4000.0.7, 4000.0.8, 4000.0.9, 4000.0.10, 4000.1.0, 4000.1.1, 4000.1.2, 4000.2.0, 4000.2.1, 4000.2.2, 4000.2.3, 4000.2.4, 4000.2.5, 4000.2.6, 4000.2.7, 4000.2.8, 4000.2.9, 4000.2.10, 4000.2.11, 4000.2.12, 4000.2.13, 4000.2.14, 4000.2.15, 4000.2.16, 4000.2.16.1, 4000.2.17, 4000.2.18, 4000.2.19, 4000.2.20, 4000.2.21, 4000.2.22, 4000.2.23, 4000.3.0, 4000.3.1, 4000.3.2, 4000.3.3
Change log CHANGES
Dependencies array, base (>=2 && <4.7), bytestring, mtl (==1.1.* || >=2.0 && <2.2), network (<2.4), old-time, parsec, Win32 [details]
License BSD3
Author Warrick Gray <warrick.gray@hotmail.com>
Maintainer Ganesh Sittampalam <http@projects.haskell.org>
Stability Unknown
Category Network
Home page https://github.com/haskell/HTTP
Source repository head: git clone https://github.com/haskell/HTTP.git
Uploaded Fri Aug 31 07:04:13 UTC 2012 by GaneshSittampalam
Updated Sun Jun 8 12:43:54 UTC 2014 by DuncanCoutts to revision 1
Distributions Arch:4000.3.3, Debian:4000.2.23, Fedora:4000.3.3, FreeBSD:4000.2.20, LTSHaskell:4000.3.3, NixOS:4000.3.3, Stackage:4000.3.3, Tumbleweed:4000.3.3
Downloads 134914 total (292 in the last 30 days)
Votes
0 []
Status Docs uploaded by user
Build status unknown [no reports yet]

Modules

[Index]

Flags

NameDescriptionDefaultType
old-baseOld, monolithic baseDisabledAutomatic
mtl1Use the old mtl version 1.DisabledAutomatic
warn-as-errorBuild with warnings-as-errorsDisabledAutomatic

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

Downloads

Maintainer's Corner

For package maintainers and hackage trustees