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 RequestBody
- = RequestBodyLBS ByteString
- | RequestBodyBS ByteString
- | RequestBodyBuilder Int64 Builder
- | RequestBodyStream Int64 (GivesPopper ())
- | RequestBodyStreamChunked (GivesPopper ())
- | RequestBodyIO (IO RequestBody)
data Request
data Response body
data Manager
data ManagerSettings
data ResponseTimeout
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 CookieJar
data HttpException
- = HttpExceptionRequest Request HttpExceptionContent
- | InvalidUrlException String String
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
class HasHttpManager a where
- getHttpManager :: a -> Manager
type GivesPopper a = NeedsPopper a -> IO a
type NeedsPopper a = Popper -> IO a
type Popper = IO ByteString
data ProxyOverride
data StreamFileStatus = StreamFileStatus {
- fileSize :: Int64
- readSoFar :: Int64
- thisChunkSize :: Int
}
data HistoriedResponse body
setQueryString :: [(ByteString, Maybe ByteString)] -> Request -> Request
responseTimeoutMicro :: Int -> ResponseTimeout
responseTimeoutNone :: ResponseTimeout
responseTimeoutDefault :: ResponseTimeout
createCookieJar :: [Cookie] -> CookieJar
destroyCookieJar :: CookieJar -> [Cookie]
parseUrl :: MonadThrow m => String -> m Request
parseUrlThrow :: MonadThrow m => String -> m Request
parseRequest :: MonadThrow m => String -> m Request
parseRequest_ :: String -> Request
defaultRequest :: Request
applyBasicAuth :: ByteString -> ByteString -> Request -> Request
urlEncodedBody :: [(ByteString, ByteString)] -> Request -> Request
setRequestIgnoreStatus :: Request -> Request
setRequestCheckStatus :: Request -> Request
brReadSome :: BodyReader -> Int -> IO ByteString
makeConnection :: IO ByteString -> (ByteString -> IO ()) -> IO () -> IO Connection
socketConnection :: Socket -> Int -> IO Connection
strippedHostName :: String -> String
computeCookieString :: Request -> CookieJar -> UTCTime -> Bool -> (ByteString, CookieJar)
defaultPath :: Request -> ByteString
domainMatches :: ByteString -> ByteString -> Bool
evictExpiredCookies :: CookieJar -> UTCTime -> CookieJar
generateCookie :: SetCookie -> Request -> UTCTime -> Bool -> Maybe Cookie
insertCheckedCookie :: Cookie -> CookieJar -> Bool -> CookieJar
insertCookiesIntoRequest :: Request -> CookieJar -> UTCTime -> (Request, CookieJar)
isIpAddress :: ByteString -> Bool
isPotentiallyTrustworthyOrigin :: Bool -> ByteString -> Bool
pathMatches :: ByteString -> ByteString -> Bool
receiveSetCookie :: SetCookie -> Request -> UTCTime -> Bool -> CookieJar -> CookieJar
removeExistingCookieFromCookieJar :: Cookie -> CookieJar -> (Maybe Cookie, CookieJar)
updateCookieJar :: Response a -> Request -> UTCTime -> CookieJar -> (CookieJar, Response a)
withConnection :: Request -> Manager -> (Connection -> IO a) -> IO a
defaultProxy :: ProxyOverride
noProxy :: ProxyOverride
proxyEnvironment :: Maybe Proxy -> ProxyOverride
proxyEnvironmentNamed :: Text -> Maybe Proxy -> ProxyOverride
proxyFromRequest :: ProxyOverride
rawConnectionModifySocket :: (Socket -> IO ()) -> IO (Maybe HostAddress -> String -> Int -> IO Connection)
rawConnectionModifySocketSize :: (Socket -> IO ()) -> IO (Int -> Maybe HostAddress -> String -> Int -> IO Connection)
useProxy :: Proxy -> ProxyOverride
useProxySecureWithoutConnect :: Proxy -> ProxyOverride
withManager :: ManagerSettings -> (Manager -> IO a) -> IO a
applyBasicProxyAuth :: ByteString -> ByteString -> Request -> Request
applyBearerAuth :: ByteString -> Request -> Request
getUri :: Request -> URI
observedStreamFile :: (StreamFileStatus -> IO ()) -> FilePath -> IO RequestBody
requestFromURI :: MonadThrow m => URI -> m Request
requestFromURI_ :: URI -> Request
setQueryStringPartialEscape :: [(ByteString, [EscapeItem])] -> Request -> Request
streamFile :: FilePath -> IO RequestBody
throwErrorStatusCodes :: MonadIO m => Request -> Response BodyReader -> m ()
getOriginalRequest :: Response a -> Request
compareCookies :: Cookie -> Cookie -> Ordering
equalCookie :: Cookie -> Cookie -> Bool
equalCookieJar :: CookieJar -> CookieJar -> Bool
equivCookie :: Cookie -> Cookie -> Bool
equivCookieJar :: CookieJar -> CookieJar -> Bool
managerSetInsecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings
managerSetProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings
managerSetSecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings
responseOpenHistory :: Request -> Manager -> IO (HistoriedResponse BodyReader)
withResponseHistory :: Request -> Manager -> (HistoriedResponse BodyReader -> IO a) -> IO a
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 readList :: ReadS [Proxy] readPrec :: ReadPrec Proxy readListPrec :: ReadPrec [Proxy]
Show Proxy
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> Proxy -> ShowS show :: Proxy -> String showList :: [Proxy] -> ShowS
Eq Proxy
Instance details Defined in Network.HTTP.Client.Types Methods (==) :: Proxy -> Proxy -> Bool (/=) :: Proxy -> Proxy -> Bool
Ord Proxy
Instance details Defined in Network.HTTP.Client.Types Methods compare :: Proxy -> Proxy -> Ordering (<) :: Proxy -> Proxy -> Bool (<=) :: Proxy -> Proxy -> Bool (>) :: Proxy -> Proxy -> Bool (>=) :: Proxy -> Proxy -> Bool max :: Proxy -> Proxy -> Proxy min :: Proxy -> Proxy -> Proxy

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
Monoid RequestBody
Instance details Defined in Network.HTTP.Client.Types Methods mempty :: RequestBody mappend :: RequestBody -> RequestBody -> RequestBody mconcat :: [RequestBody] -> RequestBody
Semigroup RequestBody
Instance details Defined in Network.HTTP.Client.Types Methods (<>) :: RequestBody -> RequestBody -> RequestBody sconcat :: NonEmpty RequestBody -> RequestBody stimes :: Integral b => b -> RequestBody -> RequestBody

data Request #

Instances

Instances details

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

data Response body #

Instances

Instances details

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

data Manager #

Instances

Instances details

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

data ManagerSettings #

data ResponseTimeout #

Instances

Instances details

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

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

Instances

Instances details

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

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 fromException :: SomeException -> Maybe HttpException displayException :: HttpException -> String
Show HttpException
Instance details Defined in Network.HTTP.Client.Types Methods showsPrec :: Int -> HttpException -> ShowS show :: HttpException -> String showList :: [HttpException] -> ShowS

data HttpExceptionContent #

Constructors

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

Instances

Instances details

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

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 #

type GivesPopper a = NeedsPopper a -> IO a #

type NeedsPopper a = Popper -> IO a #

type Popper = IO ByteString #

data ProxyOverride #

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 show :: StreamFileStatus -> String showList :: [StreamFileStatus] -> ShowS
Eq StreamFileStatus
Instance details Defined in Network.HTTP.Client.Types Methods (==) :: StreamFileStatus -> StreamFileStatus -> Bool (/=) :: StreamFileStatus -> StreamFileStatus -> Bool
Ord StreamFileStatus
Instance details Defined in Network.HTTP.Client.Types Methods compare :: StreamFileStatus -> StreamFileStatus -> Ordering (<) :: StreamFileStatus -> StreamFileStatus -> Bool (<=) :: StreamFileStatus -> StreamFileStatus -> Bool (>) :: StreamFileStatus -> StreamFileStatus -> Bool (>=) :: StreamFileStatus -> StreamFileStatus -> Bool max :: StreamFileStatus -> StreamFileStatus -> StreamFileStatus min :: StreamFileStatus -> StreamFileStatus -> StreamFileStatus

data HistoriedResponse body #

Instances

Instances details

Foldable HistoriedResponse
Instance details Defined in Network.HTTP.Client Methods fold :: Monoid m => HistoriedResponse m -> m foldMap :: Monoid m => (a -> m) -> HistoriedResponse a -> m foldMap' :: Monoid m => (a -> m) -> HistoriedResponse a -> m foldr :: (a -> b -> b) -> b -> HistoriedResponse a -> b foldr' :: (a -> b -> b) -> b -> HistoriedResponse a -> b foldl :: (b -> a -> b) -> b -> HistoriedResponse a -> b foldl' :: (b -> a -> b) -> b -> HistoriedResponse a -> b foldr1 :: (a -> a -> a) -> HistoriedResponse a -> a foldl1 :: (a -> a -> a) -> HistoriedResponse a -> a toList :: HistoriedResponse a -> [a] null :: HistoriedResponse a -> Bool length :: HistoriedResponse a -> Int elem :: Eq a => a -> HistoriedResponse a -> Bool maximum :: Ord a => HistoriedResponse a -> a minimum :: Ord a => HistoriedResponse a -> a sum :: Num a => HistoriedResponse a -> a product :: Num a => HistoriedResponse a -> a
Traversable HistoriedResponse
Instance details Defined in Network.HTTP.Client Methods traverse :: Applicative f => (a -> f b) -> HistoriedResponse a -> f (HistoriedResponse b) sequenceA :: Applicative f => HistoriedResponse (f a) -> f (HistoriedResponse a) mapM :: Monad m => (a -> m b) -> HistoriedResponse a -> m (HistoriedResponse b) sequence :: Monad m => HistoriedResponse (m a) -> m (HistoriedResponse a)
Functor HistoriedResponse
Instance details Defined in Network.HTTP.Client Methods fmap :: (a -> b) -> HistoriedResponse a -> HistoriedResponse b (<$) :: a -> HistoriedResponse b -> HistoriedResponse a
Generic (HistoriedResponse body)
Instance details Defined in Network.HTTP.Client Associated Types type Rep (HistoriedResponse body) :: Type -> Type Methods from :: HistoriedResponse body -> Rep (HistoriedResponse body) x to :: Rep (HistoriedResponse body) x -> HistoriedResponse body
Show body => Show (HistoriedResponse body)
Instance details Defined in Network.HTTP.Client Methods showsPrec :: Int -> HistoriedResponse body -> ShowS show :: HistoriedResponse body -> String showList :: [HistoriedResponse body] -> ShowS
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.13.1-KhEiSot1RXjF3uZgUYTk2d" '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)))))

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

responseTimeoutMicro :: Int -> ResponseTimeout #

responseTimeoutNone :: ResponseTimeout #

responseTimeoutDefault :: ResponseTimeout #

createCookieJar :: [Cookie] -> CookieJar #

destroyCookieJar :: CookieJar -> [Cookie] #

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

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

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

parseRequest_ :: String -> Request #

defaultRequest :: Request #

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

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

setRequestIgnoreStatus :: Request -> Request #

setRequestCheckStatus :: Request -> Request #

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

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

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

strippedHostName :: String -> String #

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

defaultPath :: Request -> ByteString #

domainMatches :: ByteString -> ByteString -> Bool #

evictExpiredCookies :: CookieJar -> UTCTime -> CookieJar #

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

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

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

isIpAddress :: ByteString -> Bool #

isPotentiallyTrustworthyOrigin :: Bool -> ByteString -> Bool #

pathMatches :: ByteString -> ByteString -> Bool #

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

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

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

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

defaultProxy :: ProxyOverride #

noProxy :: ProxyOverride #

proxyEnvironment :: Maybe Proxy -> ProxyOverride #

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

proxyFromRequest :: ProxyOverride #

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

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

useProxy :: Proxy -> ProxyOverride #

useProxySecureWithoutConnect :: Proxy -> ProxyOverride #

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

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

applyBearerAuth :: ByteString -> Request -> Request #

getUri :: Request -> URI #

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

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

requestFromURI_ :: URI -> Request #

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

streamFile :: FilePath -> IO RequestBody #

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

getOriginalRequest :: Response a -> Request #

compareCookies :: Cookie -> Cookie -> Ordering #

equalCookie :: Cookie -> Cookie -> Bool #

equalCookieJar :: CookieJar -> CookieJar -> Bool #

equivCookie :: Cookie -> Cookie -> Bool #

equivCookieJar :: CookieJar -> CookieJar -> Bool #

managerSetInsecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings #

managerSetProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings #

managerSetSecureProxy :: ProxyOverride -> ManagerSettings -> ManagerSettings #

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

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

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 #