HTTP

A library for client-side HTTP

Version on this page:	4000.2.19
LTS Haskell 22.39:	4000.4.1@rev:4
Stackage Nightly 2024-10-29:	4000.4.1@rev:4
Latest on Hackage:	4000.4.1@rev:4

See all snapshots HTTP appears in

BSD-3-Clause licensed by Warrick Gray

Maintained by Ganesh Sittampalam

This version can be pinned in stack with:HTTP-4000.2.19@sha256:b1006886ee479c729e4a6ff691b4572d2f38a5408a1292d151e227d0ba697b84,5384

Module documentation for 4000.2.19

Network
- Network.Browser
- Network.BufferType
- Network.HTTP
  - Network.HTTP.Auth
  - Network.HTTP.Base
  - Network.HTTP.Cookie
  - Network.HTTP.HandleStream
  - Network.HTTP.Headers
  - Network.HTTP.Proxy
  - Network.HTTP.Stream
- Network.Stream
- Network.StreamDebugger
- Network.StreamSocket
- Network.TCP

Depends on 7 packages(full list with versions):

array, base, bytestring, mtl, network, old-time, parsec

Used by 9 packages in lts-0.7(full list with versions):

bake, BlastHTTP, cabal-install, gravatar, HandsomeSoup, haxr, hxt-http, MusicBrainz, pandoc

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))