Safe Haskell	Safe-Inferred
Language	Haskell2010

Network.HTTP.Client.Conduit

Contents

Conduit-specific interface
Manager helpers
General HTTP client interface
Lower-level conduit functions

Description

A new, experimental API to replace Network.HTTP.Conduit.

For most users, Network.HTTP.Simple is probably a better choice. For more information, see:

https://haskell-lang.org/library/http-client

For more information on using this module, please be sure to read the documentation in the Network.HTTP.Client module.

Synopsis

withResponse :: (MonadUnliftIO m, MonadIO n, MonadReader env m, HasHttpManager env) => Request -> (Response (ConduitM i ByteString n ()) -> m a) -> m a
responseOpen :: (MonadIO m, MonadIO n, MonadReader env m, HasHttpManager env) => Request -> m (Response (ConduitM i ByteString n ()))
responseClose :: MonadIO m => Response body -> m ()
acquireResponse :: (MonadIO n, MonadReader env m, HasHttpManager env) => Request -> m (Acquire (Response (ConduitM i ByteString n ())))
httpSource :: (MonadResource m, MonadIO n, MonadReader env m, HasHttpManager env) => Request -> (Response (ConduitM () ByteString n ()) -> ConduitM () r m ()) -> ConduitM () r m ()
defaultManagerSettings :: ManagerSettings
newManager :: MonadIO m => m Manager
newManagerSettings :: MonadIO m => ManagerSettings -> m Manager
data Proxy = Proxy {
- proxyHost :: ByteString
- proxyPort :: Int
}
data StreamFileStatus = StreamFileStatus {
- fileSize :: Int64
- readSoFar :: Int64
- thisChunkSize :: Int
}
class HasHttpManager a where
- getHttpManager :: a -> Manager
data Manager
data ProxyOverride
data ManagerSettings
data Response body
data ResponseTimeout
data Request
type GivesPopper a = NeedsPopper a -> IO a
type NeedsPopper a = Popper -> IO a
type Popper = IO ByteString
data RequestBody
- = RequestBodyLBS ByteString
- | RequestBodyBS ByteString
- | RequestBodyBuilder Int64 Builder
- | RequestBodyStream Int64 (GivesPopper ())
- | RequestBodyStreamChunked (GivesPopper ())
- | RequestBodyIO (IO RequestBody)
data CookieJar
data Cookie = Cookie {
- cookie_name :: ByteString
- cookie_value :: ByteString
- cookie_expiry_time :: UTCTime
- cookie_domain :: ByteString
- cookie_path :: ByteString
- cookie_creation_time :: UTCTime
- cookie_last_access_time :: UTCTime
- cookie_persistent :: Bool
- cookie_host_only :: Bool
- cookie_secure_only :: Bool
- cookie_http_only :: Bool
}
data HttpExceptionContent
- = StatusCodeException (Response ()) ByteString
- | TooManyRedirects [Response ByteString]
- | OverlongHeaders
- | ResponseTimeout
- | ConnectionTimeout
- | ConnectionFailure SomeException
- | InvalidStatusLine ByteString
- | InvalidHeader ByteString
- | InvalidRequestHeader ByteString
- | InternalException SomeException
- | ProxyConnectException ByteString Int Status
- | NoResponseDataReceived
- | TlsNotSupported
- | WrongRequestBodyStreamSize Word64 Word64
- | ResponseBodyTooShort Word64 Word64
- | InvalidChunkHeaders
- | IncompleteHeaders
- | InvalidDestinationHost ByteString
- | HttpZlibException ZlibException
- | InvalidProxyEnvironmentVariable Text Text
- | ConnectionClosed
- | InvalidProxySettings Text
data HttpException
- = HttpExceptionRequest Request HttpExceptionContent
- | InvalidUrlException String String
data HistoriedResponse body
equalCookie :: Cookie -> Cookie -> Bool
equivCookie :: Cookie -> Cookie -> Bool
compareCookies :: Cookie -> Cookie -> Ordering
equalCookieJar :: CookieJar -> CookieJar -> Bool
equivCookieJar :: CookieJar -> CookieJar -> Bool
makeConnection :: IO ByteString -> (ByteString -> IO ()) -> IO () -> IO Connection
socketConnection :: Socket -> Int -> IO Connection
strippedHostName :: String -> String
brReadSome :: BodyReader -> Int -> IO ByteString
parseUrl :: MonadThrow m => String -> m Request
parseUrlThrow :: MonadThrow m => String -> m Request
throwErrorStatusCodes :: MonadIO m => Request -> Response BodyReader -> m ()
parseRequest :: MonadThrow m => String -> m Request
parseRequest_ :: String -> Request
requestFromURI :: MonadThrow m => URI -> m Request
requestFromURI_ :: URI -> Request
getUri :: Request -> URI
defaultRequest :: Request
applyBasicAuth :: ByteString -> ByteString -> Request -> Request
applyBearerAuth :: ByteString -> Request -> Request
applyBasicProxyAuth :: ByteString -> ByteString -> Request -> Request
urlEncodedBody :: [(ByteString, ByteString)] -> Request -> Request
setRequestIgnoreStatus :: Request -> Request
setRequestCheckStatus :: Request -> Request
setQueryString :: [(ByteString, Maybe ByteString)] -> Request -> Request
setQueryStringPartialEscape :: [(ByteString, [EscapeItem])] -> Request -> Request
streamFile :: FilePath -> IO RequestBody
observedStreamFile :: (StreamFileStatus -> IO ()) -> FilePath -> IO RequestBody
getOriginalRequest :: Response a -> Request
rawConnectionModifySocket :: (Socket -> IO ()) -> IO (Maybe HostAddress -> String -> Int -> IO Connection)
rawConnectionModifySocketSize :: (Socket -> IO ()) -> IO (Int -> Maybe HostAddress -> String -> Int -> IO Connection)
withManager :: ManagerSettings -> (Manager -> IO a) -> IO a
proxyFromRequest :: ProxyOverride
noProxy :: ProxyOverride
useProxy :: Proxy -> ProxyOverride
useProxySecureWithoutConnect :: Proxy -> ProxyOverride
proxyEnvironment :: Maybe Proxy -> ProxyOverride
proxyEnvironmentNamed :: Text -> Maybe Proxy -> ProxyOverride
defaultProxy :: ProxyOverride
isIpAddress :: ByteString -> Bool
domainMatches :: ByteString -> ByteString -> Bool
defaultPath :: Request -> ByteString
pathMatches :: ByteString -> ByteString -> Bool
createCookieJar :: [Cookie] -> CookieJar
destroyCookieJar :: CookieJar -> [Cookie]
removeExistingCookieFromCookieJar :: Cookie -> CookieJar -> (Maybe Cookie, CookieJar)
isPotentiallyTrustworthyOrigin :: Bool -> ByteString -> Bool
evictExpiredCookies :: CookieJar -> UTCTime -> CookieJar
insertCookiesIntoRequest :: Request -> CookieJar -> UTCTime -> (Request, CookieJar)
computeCookieString :: Request -> CookieJar -> UTCTime -> Bool -> (ByteString, CookieJar)
updateCookieJar :: Response a -> Request -> UTCTime -> CookieJar -> (CookieJar, Response a)
receiveSetCookie :: SetCookie -> Request -> UTCTime -> Bool -> CookieJar -> CookieJar
insertCheckedCookie :: Cookie -> CookieJar -> Bool -> CookieJar
generateCookie :: SetCookie -> Request -> UTCTime -> Bool -> Maybe Cookie
withConnection :: Request -> Manager -> (Connection -> IO a) -> IO a
responseOpenHistory :: Request -> Manager -> IO (HistoriedResponse BodyReader)
withResponseHistory :: Request -> Manager -> (HistoriedResponse BodyReader -> IO a) -> IO a
managerSetInsecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings
managerSetSecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings
managerSetProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings
responseTimeoutMicro :: Int -> ResponseTimeout
responseTimeoutNone :: ResponseTimeout
responseTimeoutDefault :: ResponseTimeout
httpLbs :: (MonadIO m, HasHttpManager env, MonadReader env m) => Request -> m (Response ByteString)
httpNoBody :: (MonadIO m, HasHttpManager env, MonadReader env m) => Request -> m (Response ())
requestBodySource :: Int64 -> ConduitM () ByteString IO () -> RequestBody
requestBodySourceChunked :: ConduitM () ByteString IO () -> RequestBody
bodyReaderSource :: MonadIO m => BodyReader -> ConduitM i ByteString m ()

Conduit-specific interface

withResponse :: (MonadUnliftIO m, MonadIO n, MonadReader env m, HasHttpManager env) => Request -> (Response (ConduitM i ByteString n ()) -> m a) -> m a Source #

Conduit powered version of withResponse. Differences are:

Response body is represented as a Producer.
Generalized to any instance of MonadUnliftIO, not just IO.
The Manager is contained by a MonadReader context.

Since 2.1.0

responseOpen :: (MonadIO m, MonadIO n, MonadReader env m, HasHttpManager env) => Request -> m (Response (ConduitM i ByteString n ())) Source #

Conduit-powered version of responseOpen.

See withResponse for the differences with responseOpen.

Since 2.1.0

responseClose :: MonadIO m => Response body -> m () Source #

Generalized version of responseClose.

Since 2.1.0

acquireResponse :: (MonadIO n, MonadReader env m, HasHttpManager env) => Request -> m (Acquire (Response (ConduitM i ByteString n ()))) Source #

An Acquire for getting a Response.

Since 2.1.0

httpSource :: (MonadResource m, MonadIO n, MonadReader env m, HasHttpManager env) => Request -> (Response (ConduitM () ByteString n ()) -> ConduitM () r m ()) -> ConduitM () r m () Source #

Same as httpSource, but uses Manager from Reader environment instead of the global one.

Since 2.3.6

Manager helpers

defaultManagerSettings :: ManagerSettings Source #

TLS-powered manager settings.

Since 2.1.0

newManager :: MonadIO m => m Manager Source #

Get a new manager using defaultManagerSettings.

Since 2.1.0

newManagerSettings :: MonadIO m => ManagerSettings -> m Manager Source #

Get a new manager using the given settings.

Since 2.1.0

General HTTP client interface

data Proxy #

Constructors

Proxy
Fields proxyHost :: ByteString proxyPort :: Int

Instances

Instances details

Read Proxy
Instance details Defined in Network.HTTP.Client.Types Methods readsPrec :: Int -> ReadS Proxy Source # readList :: ReadS [Proxy] Source # readPrec :: ReadPrec Proxy Source # readListPrec :: ReadPrec [Proxy] Source #
Show Proxy
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> Proxy -> ShowS Source # show :: Proxy -> String Source # showList :: [Proxy] -> ShowS Source #
Eq Proxy
Instance details Defined in Network.HTTP.Client.Types Methods (==) :: Proxy -> Proxy -> Bool Source # (/=) :: Proxy -> Proxy -> Bool Source #
Ord Proxy
Instance details Defined in Network.HTTP.Client.Types Methods compare :: Proxy -> Proxy -> Ordering Source # (<) :: Proxy -> Proxy -> Bool Source # (<=) :: Proxy -> Proxy -> Bool Source # (>) :: Proxy -> Proxy -> Bool Source # (>=) :: Proxy -> Proxy -> Bool Source # max :: Proxy -> Proxy -> Proxy Source # min :: Proxy -> Proxy -> Proxy Source #

data StreamFileStatus #

Constructors

StreamFileStatus
Fields fileSize :: Int64 readSoFar :: Int64 thisChunkSize :: Int

Instances

Instances details

Show StreamFileStatus
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> StreamFileStatus -> ShowS Source # show :: StreamFileStatus -> String Source # showList :: [StreamFileStatus] -> ShowS Source #
Eq StreamFileStatus
Instance details Defined in Network.HTTP.Client.Types Methods (==) :: StreamFileStatus -> StreamFileStatus -> Bool Source # (/=) :: StreamFileStatus -> StreamFileStatus -> Bool Source #
Ord StreamFileStatus
Instance details Defined in Network.HTTP.Client.Types Methods compare :: StreamFileStatus -> StreamFileStatus -> Ordering Source # (<) :: StreamFileStatus -> StreamFileStatus -> Bool Source # (<=) :: StreamFileStatus -> StreamFileStatus -> Bool Source # (>) :: StreamFileStatus -> StreamFileStatus -> Bool Source # (>=) :: StreamFileStatus -> StreamFileStatus -> Bool Source # max :: StreamFileStatus -> StreamFileStatus -> StreamFileStatus Source # min :: StreamFileStatus -> StreamFileStatus -> StreamFileStatus Source #

class HasHttpManager a where #

Methods

getHttpManager :: a -> Manager #

Instances

Instances details

HasHttpManager Manager
Instance details Defined in Network.HTTP.Client.Types Methods getHttpManager :: Manager -> Manager #

data Manager #

Instances

Instances details

HasHttpManager Manager
Instance details Defined in Network.HTTP.Client.Types Methods getHttpManager :: Manager -> Manager #

data ProxyOverride #

data ManagerSettings #

data Response body #

Instances

Instances details

Foldable Response
Instance details Defined in Network.HTTP.Client.Types Methods fold :: Monoid m => Response m -> m Source # foldMap :: Monoid m => (a -> m) -> Response a -> m Source # foldMap' :: Monoid m => (a -> m) -> Response a -> m Source # foldr :: (a -> b -> b) -> b -> Response a -> b Source # foldr' :: (a -> b -> b) -> b -> Response a -> b Source # foldl :: (b -> a -> b) -> b -> Response a -> b Source # foldl' :: (b -> a -> b) -> b -> Response a -> b Source # foldr1 :: (a -> a -> a) -> Response a -> a Source # foldl1 :: (a -> a -> a) -> Response a -> a Source # toList :: Response a -> [a] Source # null :: Response a -> Bool Source # length :: Response a -> Int Source # elem :: Eq a => a -> Response a -> Bool Source # maximum :: Ord a => Response a -> a Source # minimum :: Ord a => Response a -> a Source # sum :: Num a => Response a -> a Source # product :: Num a => Response a -> a Source #
Traversable Response
Instance details Defined in Network.HTTP.Client.Types Methods traverse :: Applicative f => (a -> f b) -> Response a -> f (Response b) Source # sequenceA :: Applicative f => Response (f a) -> f (Response a) Source # mapM :: Monad m => (a -> m b) -> Response a -> m (Response b) Source # sequence :: Monad m => Response (m a) -> m (Response a) Source #
Functor Response
Instance details Defined in Network.HTTP.Client.Types Methods fmap :: (a -> b) -> Response a -> Response b Source # (<$) :: a -> Response b -> Response a Source #
Show body => Show (Response body)
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> Response body -> ShowS Source # show :: Response body -> String Source # showList :: [Response body] -> ShowS Source #

data ResponseTimeout #

Instances

Instances details

Show ResponseTimeout
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> ResponseTimeout -> ShowS Source # show :: ResponseTimeout -> String Source # showList :: [ResponseTimeout] -> ShowS Source #
Eq ResponseTimeout
Instance details Defined in Network.HTTP.Client.Types Methods (==) :: ResponseTimeout -> ResponseTimeout -> Bool Source # (/=) :: ResponseTimeout -> ResponseTimeout -> Bool Source #

data Request #

Instances

Instances details

Show Request
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> Request -> ShowS Source # show :: Request -> String Source # showList :: [Request] -> ShowS Source #

type GivesPopper a = NeedsPopper a -> IO a #

type NeedsPopper a = Popper -> IO a #

type Popper = IO ByteString #

data RequestBody #

Constructors

RequestBodyLBS ByteString
RequestBodyBS ByteString
RequestBodyBuilder Int64 Builder
RequestBodyStream Int64 (GivesPopper ())
RequestBodyStreamChunked (GivesPopper ())
RequestBodyIO (IO RequestBody)

Instances

Instances details

IsString RequestBody
Instance details Defined in Network.HTTP.Client.Types Methods fromString :: String -> RequestBody Source #
Monoid RequestBody
Instance details Defined in Network.HTTP.Client.Types Methods mempty :: RequestBody Source # mappend :: RequestBody -> RequestBody -> RequestBody Source # mconcat :: [RequestBody] -> RequestBody Source #
Semigroup RequestBody
Instance details Defined in Network.HTTP.Client.Types Methods (<>) :: RequestBody -> RequestBody -> RequestBody Source # sconcat :: NonEmpty RequestBody -> RequestBody Source # stimes :: Integral b => b -> RequestBody -> RequestBody Source #

data CookieJar #

Instances

Instances details

Monoid CookieJar
Instance details Defined in Network.HTTP.Client.Types Methods mempty :: CookieJar Source # mappend :: CookieJar -> CookieJar -> CookieJar Source # mconcat :: [CookieJar] -> CookieJar Source #
Semigroup CookieJar
Instance details Defined in Network.HTTP.Client.Types Methods (<>) :: CookieJar -> CookieJar -> CookieJar Source # sconcat :: NonEmpty CookieJar -> CookieJar Source # stimes :: Integral b => b -> CookieJar -> CookieJar Source #
Read CookieJar
Instance details Defined in Network.HTTP.Client.Types Methods readsPrec :: Int -> ReadS CookieJar Source # readList :: ReadS [CookieJar] Source # readPrec :: ReadPrec CookieJar Source # readListPrec :: ReadPrec [CookieJar] Source #
Show CookieJar
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> CookieJar -> ShowS Source # show :: CookieJar -> String Source # showList :: [CookieJar] -> ShowS Source #

data Cookie #

Constructors

Cookie
Fields cookie_name :: ByteString cookie_value :: ByteString cookie_expiry_time :: UTCTime cookie_domain :: ByteString cookie_path :: ByteString cookie_creation_time :: UTCTime cookie_last_access_time :: UTCTime cookie_persistent :: Bool cookie_host_only :: Bool cookie_secure_only :: Bool cookie_http_only :: Bool

Instances

data HttpExceptionContent #

Instances

Instances details

Show HttpExceptionContent
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> HttpExceptionContent -> ShowS Source # show :: HttpExceptionContent -> String Source # showList :: [HttpExceptionContent] -> ShowS Source #

data HttpException #

Constructors

HttpExceptionRequest Request HttpExceptionContent
InvalidUrlException String String

Instances

Instances details

Exception HttpException
Instance details Defined in Network.HTTP.Client.Types Methods toException :: HttpException -> SomeException Source # fromException :: SomeException -> Maybe HttpException Source # displayException :: HttpException -> String Source #
Show HttpException
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> HttpException -> ShowS Source # show :: HttpException -> String Source # showList :: [HttpException] -> ShowS Source #

data HistoriedResponse body #

Instances

Instances details

Foldable HistoriedResponse
Instance details Defined in Network.HTTP.Client Methods fold :: Monoid m => HistoriedResponse m -> m Source # foldMap :: Monoid m => (a -> m) -> HistoriedResponse a -> m Source # foldMap' :: Monoid m => (a -> m) -> HistoriedResponse a -> m Source # foldr :: (a -> b -> b) -> b -> HistoriedResponse a -> b Source # foldr' :: (a -> b -> b) -> b -> HistoriedResponse a -> b Source # foldl :: (b -> a -> b) -> b -> HistoriedResponse a -> b Source # foldl' :: (b -> a -> b) -> b -> HistoriedResponse a -> b Source # foldr1 :: (a -> a -> a) -> HistoriedResponse a -> a Source # foldl1 :: (a -> a -> a) -> HistoriedResponse a -> a Source # toList :: HistoriedResponse a -> [a] Source # null :: HistoriedResponse a -> Bool Source # length :: HistoriedResponse a -> Int Source # elem :: Eq a => a -> HistoriedResponse a -> Bool Source # maximum :: Ord a => HistoriedResponse a -> a Source # minimum :: Ord a => HistoriedResponse a -> a Source # sum :: Num a => HistoriedResponse a -> a Source # product :: Num a => HistoriedResponse a -> a Source #
Traversable HistoriedResponse
Instance details Defined in Network.HTTP.Client Methods traverse :: Applicative f => (a -> f b) -> HistoriedResponse a -> f (HistoriedResponse b) Source # sequenceA :: Applicative f => HistoriedResponse (f a) -> f (HistoriedResponse a) Source # mapM :: Monad m => (a -> m b) -> HistoriedResponse a -> m (HistoriedResponse b) Source # sequence :: Monad m => HistoriedResponse (m a) -> m (HistoriedResponse a) Source #
Functor HistoriedResponse
Instance details Defined in Network.HTTP.Client Methods fmap :: (a -> b) -> HistoriedResponse a -> HistoriedResponse b Source # (<$) :: a -> HistoriedResponse b -> HistoriedResponse a Source #
Generic (HistoriedResponse body)
Instance details Defined in Network.HTTP.Client Associated Types type Rep (HistoriedResponse body) :: Type -> Type Source # Methods from :: HistoriedResponse body -> Rep (HistoriedResponse body) x Source # to :: Rep (HistoriedResponse body) x -> HistoriedResponse body Source #
Show body => Show (HistoriedResponse body)
Instance details Defined in Network.HTTP.Client Methods showsPrec :: Int -> HistoriedResponse body -> ShowS Source # show :: HistoriedResponse body -> String Source # showList :: [HistoriedResponse body] -> ShowS Source #
type Rep (HistoriedResponse body)
Instance details Defined in Network.HTTP.Client type Rep (HistoriedResponse body) = D1 ('MetaData "HistoriedResponse" "Network.HTTP.Client" "http-client-0.7.14-CSLgFyXjfrG1g6JsBLkVLh" 'False) (C1 ('MetaCons "HistoriedResponse" 'PrefixI 'True) (S1 ('MetaSel ('Just "hrRedirects") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 [(Request, Response ByteString)]) :: (S1 ('MetaSel ('Just "hrFinalRequest") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Request) :: S1 ('MetaSel ('Just "hrFinalResponse") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Response body)))))

equalCookie :: Cookie -> Cookie -> Bool #

equivCookie :: Cookie -> Cookie -> Bool #

compareCookies :: Cookie -> Cookie -> Ordering #

equalCookieJar :: CookieJar -> CookieJar -> Bool #

equivCookieJar :: CookieJar -> CookieJar -> Bool #

makeConnection :: IO ByteString -> (ByteString -> IO ()) -> IO () -> IO Connection #

socketConnection :: Socket -> Int -> IO Connection #

strippedHostName :: String -> String #

brReadSome :: BodyReader -> Int -> IO ByteString #

parseUrl :: MonadThrow m => String -> m Request #

parseUrlThrow :: MonadThrow m => String -> m Request #

throwErrorStatusCodes :: MonadIO m => Request -> Response BodyReader -> m () #

parseRequest :: MonadThrow m => String -> m Request #

parseRequest_ :: String -> Request #

requestFromURI :: MonadThrow m => URI -> m Request #

requestFromURI_ :: URI -> Request #

getUri :: Request -> URI #

defaultRequest :: Request #

applyBasicAuth :: ByteString -> ByteString -> Request -> Request #

applyBearerAuth :: ByteString -> Request -> Request #

applyBasicProxyAuth :: ByteString -> ByteString -> Request -> Request #

urlEncodedBody :: [(ByteString, ByteString)] -> Request -> Request #

setRequestIgnoreStatus :: Request -> Request #

setRequestCheckStatus :: Request -> Request #

setQueryString :: [(ByteString, Maybe ByteString)] -> Request -> Request #

setQueryStringPartialEscape :: [(ByteString, [EscapeItem])] -> Request -> Request #

streamFile :: FilePath -> IO RequestBody #

observedStreamFile :: (StreamFileStatus -> IO ()) -> FilePath -> IO RequestBody #

getOriginalRequest :: Response a -> Request #

rawConnectionModifySocket :: (Socket -> IO ()) -> IO (Maybe HostAddress -> String -> Int -> IO Connection) #

rawConnectionModifySocketSize :: (Socket -> IO ()) -> IO (Int -> Maybe HostAddress -> String -> Int -> IO Connection) #

withManager :: ManagerSettings -> (Manager -> IO a) -> IO a #

proxyFromRequest :: ProxyOverride #

noProxy :: ProxyOverride #

useProxy :: Proxy -> ProxyOverride #

useProxySecureWithoutConnect :: Proxy -> ProxyOverride #

proxyEnvironment :: Maybe Proxy -> ProxyOverride #

proxyEnvironmentNamed :: Text -> Maybe Proxy -> ProxyOverride #

defaultProxy :: ProxyOverride #

isIpAddress :: ByteString -> Bool #

domainMatches :: ByteString -> ByteString -> Bool #

defaultPath :: Request -> ByteString #

pathMatches :: ByteString -> ByteString -> Bool #

createCookieJar :: [Cookie] -> CookieJar #

destroyCookieJar :: CookieJar -> [Cookie] #

removeExistingCookieFromCookieJar :: Cookie -> CookieJar -> (Maybe Cookie, CookieJar) #

isPotentiallyTrustworthyOrigin :: Bool -> ByteString -> Bool #

evictExpiredCookies :: CookieJar -> UTCTime -> CookieJar #

insertCookiesIntoRequest :: Request -> CookieJar -> UTCTime -> (Request, CookieJar) #

computeCookieString :: Request -> CookieJar -> UTCTime -> Bool -> (ByteString, CookieJar) #

updateCookieJar :: Response a -> Request -> UTCTime -> CookieJar -> (CookieJar, Response a) #

receiveSetCookie :: SetCookie -> Request -> UTCTime -> Bool -> CookieJar -> CookieJar #

insertCheckedCookie :: Cookie -> CookieJar -> Bool -> CookieJar #

generateCookie :: SetCookie -> Request -> UTCTime -> Bool -> Maybe Cookie #

withConnection :: Request -> Manager -> (Connection -> IO a) -> IO a #

responseOpenHistory :: Request -> Manager -> IO (HistoriedResponse BodyReader) #

withResponseHistory :: Request -> Manager -> (HistoriedResponse BodyReader -> IO a) -> IO a #

managerSetInsecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings #

managerSetSecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings #

managerSetProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings #

responseTimeoutMicro :: Int -> ResponseTimeout #

responseTimeoutNone :: ResponseTimeout #

responseTimeoutDefault :: ResponseTimeout #

httpLbs :: (MonadIO m, HasHttpManager env, MonadReader env m) => Request -> m (Response ByteString) Source #

Same as httpLbs, except it uses the Manager in the reader environment.

Since 2.1.1

httpNoBody :: (MonadIO m, HasHttpManager env, MonadReader env m) => Request -> m (Response ()) Source #

Same as httpNoBody, except it uses the Manager in the reader environment.

This can be more convenient that using withManager as it avoids the need to specify the base monad for the response body.

Since 2.1.2

Lower-level conduit functions

requestBodySource :: Int64 -> ConduitM () ByteString IO () -> RequestBody Source #

requestBodySourceChunked :: ConduitM () ByteString IO () -> RequestBody Source #

bodyReaderSource :: MonadIO m => BodyReader -> ConduitM i ByteString m () Source #

StatusCodeException (Response ()) ByteString
TooManyRedirects [Response ByteString]
OverlongHeaders
ResponseTimeout
ConnectionTimeout
ConnectionFailure SomeException
InvalidStatusLine ByteString
InvalidHeader ByteString
InvalidRequestHeader ByteString
InternalException SomeException
ProxyConnectException ByteString Int Status
NoResponseDataReceived
TlsNotSupported
WrongRequestBodyStreamSize Word64 Word64
ResponseBodyTooShort Word64 Word64
InvalidChunkHeaders
IncompleteHeaders
InvalidDestinationHost ByteString
HttpZlibException ZlibException
InvalidProxyEnvironmentVariable Text Text
ConnectionClosed
InvalidProxySettings Text