The HTTP package

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain]

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

Note: This package does not support HTTPS connections. If you need HTTPS, take a look at the following packages:

Properties

Versions3000.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, 4000.3.4, 4000.3.5, 4000.3.6, 4000.3.7, 4000.3.7
Change logCHANGES
Dependenciesarray (>=0.3.0.2 && <0.6), base (>=4.3.0.0 && <4.11), bytestring (>=0.9.1.5 && <0.11), mtl (>=1.1.1.0 && <1.2 || >=2.0 && <2.3), network (>=2.2.1.8 && <2.7), network-uri (==2.6.*), parsec (>=2.0 && <3.2), time (>=1.1.2.3 && <1.9), Win32 (>=2.2.0.0 && <2.6) [details]
LicenseBSD3
AuthorWarrick Gray <warrick.gray@hotmail.com>
MaintainerGanesh Sittampalam <ganesh@earth.li>
CategoryNetwork
Home pagehttps://github.com/haskell/HTTP
Source repositoryhead: git clone https://github.com/haskell/HTTP.git
UploadedThu May 18 05:11:50 UTC 2017 by GaneshSittampalam

Modules

[Index]

Flags

NameDescriptionDefaultType
mtl1

Use the old mtl version 1.

DisabledAutomatic
warn-as-error

Build with warnings-as-errors

DisabledManual
network23

Use version 2.3.x or below of the network package

DisabledAutomatic
conduit10

Use version 1.0.x or below of the conduit package (for the test suite)

DisabledAutomatic
warp-tests

Test against warp

EnabledManual
network-uri

Get Network.URI from the network-uri package

EnabledAutomatic

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

Downloads

Maintainers' corner

For package maintainers and hackage trustees