Safe Haskell	None
Language	Haskell2010

Hackage.Security.Client.Repository.HttpLib.HTTP

Contents

Additional operations
Low-level API
Exception types

Description

Implementation of HttpClient using the HTTP package

Synopsis

withClient :: (Browser -> HttpLib -> IO a) -> IO a
setOutHandler :: Browser -> (String -> IO ()) -> IO ()
setErrHandler :: Browser -> (String -> IO ()) -> IO ()
setProxy :: Browser -> ProxyConfig String -> IO ()
request :: Throws IOException => Browser -> Request ByteString -> IO (Response ByteString)
data Browser
withBrowser :: forall a. Browser -> BrowserAction LazyStream a -> IO a
data UnexpectedResponse = UnexpectedResponse URI (Int, Int, Int)
data InvalidProxy = InvalidProxy String

Documentation

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

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 () Source #

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

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

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

Execute a single request

Low-level API

data Browser Source #

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

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 Source #

Constructors

UnexpectedResponse URI (Int, Int, Int)

Instances

Instances details

Show UnexpectedResponse Source #
Instance details Defined in Hackage.Security.Client.Repository.HttpLib.HTTP Methods showsPrec :: Int -> UnexpectedResponse -> ShowS # show :: UnexpectedResponse -> String # showList :: [UnexpectedResponse] -> ShowS #
Exception UnexpectedResponse Source #
Instance details Defined in Hackage.Security.Client.Repository.HttpLib.HTTP Methods toException :: UnexpectedResponse -> SomeException # fromException :: SomeException -> Maybe UnexpectedResponse # displayException :: UnexpectedResponse -> String #
Pretty UnexpectedResponse Source #
Instance details Defined in Hackage.Security.Client.Repository.HttpLib.HTTP Methods pretty :: UnexpectedResponse -> String #

data InvalidProxy Source #

Constructors

InvalidProxy String

Instances

Instances details

Show InvalidProxy Source #
Instance details Defined in Hackage.Security.Client.Repository.HttpLib.HTTP Methods showsPrec :: Int -> InvalidProxy -> ShowS # show :: InvalidProxy -> String # showList :: [InvalidProxy] -> ShowS #
Exception InvalidProxy Source #
Instance details Defined in Hackage.Security.Client.Repository.HttpLib.HTTP Methods toException :: InvalidProxy -> SomeException # fromException :: SomeException -> Maybe InvalidProxy # displayException :: InvalidProxy -> String #
Pretty InvalidProxy Source #
Instance details Defined in Hackage.Security.Client.Repository.HttpLib.HTTP Methods pretty :: InvalidProxy -> String #