Safe Haskell	Safe-Inferred
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 doesn'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

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

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