Hackage.Security.Client.Repository.HttpLib.HTTP

Implementation of HttpClient using the HTTP package

Documentation

withClient :: (Browser -> HttpLib -> IO a) -> IO a

Initialize the client

TODO: This currently uses the lazy bytestring API offered by the HTTP library. Unfortunately this provides no way of closing the connection when the callback decides it doens't require any further input. It seems impossible however to implement a proper streaming API. See https://github.com/haskell/HTTP/issues/86.

Additional operations

setOutHandler :: Browser -> (String -> IO ()) -> IO ()

setErrHandler :: Browser -> (String -> IO ()) -> IO ()

setProxy :: Browser -> ProxyConfig String -> IO ()

request :: Throws IOException => Browser -> Request ByteString -> IO (Response ByteString)

Execute a single request

Low-level API

data Browser

withBrowser :: forall a. Browser -> BrowserAction LazyStream a -> IO a

Run a browser action

IMPLEMENTATION NOTE: the browse action doesn't itself create any connections, they are created on demand; we just need to make sure to carry this state from one invocation of browse to another.

Exception types

data UnexpectedResponse

Constructors

UnexpectedResponse URI (Int, Int, Int)

Instances

Show UnexpectedResponse

Exception UnexpectedResponse

Pretty UnexpectedResponse

data InvalidProxy

Constructors

InvalidProxy String

Instances

Show InvalidProxy

Exception InvalidProxy

Pretty InvalidProxy