@@ -1,9 +1,20 @@
1+{-# LANGUAGE BangPatterns #-}
1{-# LANGUAGE DataKinds #-}
3{-# LANGUAGE DataKinds #-}
4+{-# LANGUAGE DeriveDataTypeable #-}
5+{-# LANGUAGE DeriveGeneric #-}
6+{-# LANGUAGE DeriveLift #-}
7+{-# LANGUAGE FlexibleInstances #-}
8+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
2{-# LANGUAGE LambdaCase #-}
9{-# LANGUAGE LambdaCase #-}
10+{-# LANGUAGE MultiParamTypeClasses #-}
3{-# LANGUAGE OverloadedStrings #-}
11{-# LANGUAGE OverloadedStrings #-}
4{-# LANGUAGE QuasiQuotes #-}
12{-# LANGUAGE QuasiQuotes #-}
13+{-# LANGUAGE RankNTypes #-}
5{-# LANGUAGE RecordWildCards #-}
14{-# LANGUAGE RecordWildCards #-}
6{-# LANGUAGE RoleAnnotations #-}
15{-# LANGUAGE RoleAnnotations #-}
16+{-# LANGUAGE ScopedTypeVariables #-}
17+{-# LANGUAGE StandaloneDeriving #-}
7{-# LANGUAGE TemplateHaskellQuotes #-}
18{-# LANGUAGE TemplateHaskellQuotes #-}
8{-# LANGUAGE TypeFamilies #-}
19{-# LANGUAGE TypeFamilies #-}
9{-# LANGUAGE UndecidableInstances #-}
20{-# LANGUAGE UndecidableInstances #-}
@@ -150,7 +161,6 @@ module Network.HTTP.Req
150 -- *** Headers
161 -- *** Headers
152 attachHeader,
163 attachHeader,
155 -- *** Cookies
165 -- *** Cookies
156 -- $cookies
166 -- $cookies
@@ -197,78 +207,74 @@ module Network.HTTP.Req
198 -- * Other
208 -- * Other
199 HttpException (..),
209 HttpException (..),
200− isStatusCodeException,
201 CanHaveBody (..),
210 CanHaveBody (..),
202 Scheme (..),
211 Scheme (..),
206−import Blaze.ByteString.Builder qualified as BB
215+import qualified Blaze.ByteString.Builder as BB
207import Control.Applicative
216import Control.Applicative
208import Control.Arrow (first, second)
217import Control.Arrow (first, second)
209import Control.Exception hiding (Handler (..), TypeError)
218import Control.Exception hiding (Handler (..), TypeError)
210−import Control.Monad (guard, void, (>=>))
211import Control.Monad.Base
219import Control.Monad.Base
212import Control.Monad.Catch (Handler (..), MonadCatch, MonadMask, MonadThrow)
220import Control.Monad.Catch (Handler (..), MonadCatch, MonadMask, MonadThrow)
213import Control.Monad.IO.Class
221import Control.Monad.IO.Class
214import Control.Monad.IO.Unlift
222import Control.Monad.IO.Unlift
215−import Control.Monad.Reader (ReaderT (ReaderT), ask, lift, runReaderT)
223+import Control.Monad.Reader
216import Control.Monad.Trans.Accum (AccumT)
224import Control.Monad.Trans.Accum (AccumT)
217import Control.Monad.Trans.Cont (ContT)
225import Control.Monad.Trans.Cont (ContT)
218import Control.Monad.Trans.Control
226import Control.Monad.Trans.Control
219import Control.Monad.Trans.Except (ExceptT)
227import Control.Monad.Trans.Except (ExceptT)
220import Control.Monad.Trans.Identity (IdentityT)
228import Control.Monad.Trans.Identity (IdentityT)
221import Control.Monad.Trans.Maybe (MaybeT)
229import Control.Monad.Trans.Maybe (MaybeT)
222−import Control.Monad.Trans.RWS.CPS qualified as RWS.CPS
230+import qualified Control.Monad.Trans.RWS.CPS as RWS.CPS
223−import Control.Monad.Trans.RWS.Lazy qualified as RWS.Lazy
231+import qualified Control.Monad.Trans.RWS.Lazy as RWS.Lazy
224−import Control.Monad.Trans.RWS.Strict qualified as RWS.Strict
232+import qualified Control.Monad.Trans.RWS.Strict as RWS.Strict
225import Control.Monad.Trans.Select (SelectT)
233import Control.Monad.Trans.Select (SelectT)
226−import Control.Monad.Trans.State.Lazy qualified as State.Lazy
234+import qualified Control.Monad.Trans.State.Lazy as State.Lazy
227−import Control.Monad.Trans.State.Strict qualified as State.Strict
235+import qualified Control.Monad.Trans.State.Strict as State.Strict
228−import Control.Monad.Trans.Writer.CPS qualified as Writer.CPS
236+import qualified Control.Monad.Trans.Writer.CPS as Writer.CPS
229−import Control.Monad.Trans.Writer.Lazy qualified as Writer.Lazy
237+import qualified Control.Monad.Trans.Writer.Lazy as Writer.Lazy
230−import Control.Monad.Trans.Writer.Strict qualified as Writer.Strict
238+import qualified Control.Monad.Trans.Writer.Strict as Writer.Strict
231import Control.Retry
239import Control.Retry
232import Data.Aeson (FromJSON (..), ToJSON (..))
240import Data.Aeson (FromJSON (..), ToJSON (..))
233−import Data.Aeson qualified as A
241+import qualified Data.Aeson as A
234import Data.ByteString (ByteString)
242import Data.ByteString (ByteString)
235−import Data.ByteString qualified as B
243+import qualified Data.ByteString as B
236−import Data.ByteString.Lazy qualified as BL
244+import qualified Data.ByteString.Lazy as BL
237−import Data.CaseInsensitive qualified as CI
245+import qualified Data.CaseInsensitive as CI
238import Data.Data (Data)
246import Data.Data (Data)
239−import Data.Default.Class (def)
240import Data.Function (on)
247import Data.Function (on)
241import Data.IORef
248import Data.IORef
242import Data.Kind (Constraint, Type)
249import Data.Kind (Constraint, Type)
243import Data.List (foldl', nubBy)
250import Data.List (foldl', nubBy)
244import Data.List.NonEmpty (NonEmpty (..))
251import Data.List.NonEmpty (NonEmpty (..))
245−import Data.List.NonEmpty qualified as NE
252+import qualified Data.List.NonEmpty as NE
246import Data.Maybe (fromMaybe)
253import Data.Maybe (fromMaybe)
247import Data.Proxy
254import Data.Proxy
248import Data.Semigroup (Endo (..))
255import Data.Semigroup (Endo (..))
249−import Data.Set qualified as S
250import Data.Text (Text)
256import Data.Text (Text)
251−import Data.Text qualified as T
257+import qualified Data.Text as T
252−import Data.Text.Encoding qualified as T
258+import qualified Data.Text.Encoding as T
253import Data.Typeable (Typeable, cast)
259import Data.Typeable (Typeable, cast)
254import GHC.Generics
260import GHC.Generics
255import GHC.TypeLits
261import GHC.TypeLits
256−import Language.Haskell.TH qualified as TH
262+import qualified Language.Haskell.TH as TH
257−import Language.Haskell.TH.Quote qualified as TH
263+import qualified Language.Haskell.TH.Quote as TH
258−import Language.Haskell.TH.Syntax qualified as TH
264+import qualified Language.Haskell.TH.Syntax as TH
259−import Network.Connection qualified as NC
265+import qualified Network.Connection as NC
260−import Network.HTTP.Client qualified as L
266+import qualified Network.HTTP.Client as L
261−import Network.HTTP.Client.Internal qualified as LI
267+import qualified Network.HTTP.Client.Internal as LI
262−import Network.HTTP.Client.MultipartFormData qualified as LM
268+import qualified Network.HTTP.Client.MultipartFormData as LM
263−import Network.HTTP.Client.TLS qualified as L
269+import qualified Network.HTTP.Client.TLS as L
264−import Network.HTTP.Types qualified as Y
270+import qualified Network.HTTP.Types as Y
265import System.IO.Unsafe (unsafePerformIO)
271import System.IO.Unsafe (unsafePerformIO)
266import Text.URI (URI)
272import Text.URI (URI)
267−import Text.URI qualified as URI
273+import qualified Text.URI as URI
268−import Text.URI.QQ qualified as QQ
274+import qualified Text.URI.QQ as QQ
269−import Web.Authenticate.OAuth qualified as OAuth
275+import qualified Web.Authenticate.OAuth as OAuth
270import Web.FormUrlEncoded (FromForm (..), ToForm (..))
276import Web.FormUrlEncoded (FromForm (..), ToForm (..))
271−import Web.FormUrlEncoded qualified as Form
277+import qualified Web.FormUrlEncoded as Form
272import Web.HttpApiData (ToHttpApiData (..))
278import Web.HttpApiData (ToHttpApiData (..))
274----------------------------------------------------------------------------
280----------------------------------------------------------------------------
@@ -489,7 +495,7 @@ reqCb method url body responseProxy options adjustRequest =
490-- @since 3.7.0
496-- @since 3.7.0
491reqHandler ::
497reqHandler ::
492− (MonadHttp m) =>
498+ MonadHttp m =>
493 -- | How to get final result from a 'L.Response'
499 -- | How to get final result from a 'L.Response'
494 (L.Response L.BodyReader -> IO b) ->
500 (L.Response L.BodyReader -> IO b) ->
495 -- | 'L.Request' to perform
501 -- | 'L.Request' to perform
@@ -585,10 +591,10 @@ req' method url body options m = do
585 withReqManager (m request)
591 withReqManager (m request)
587-- | Perform an action using the global implicit 'L.Manager' that the rest
593-- | Perform an action using the global implicit 'L.Manager' that the rest
588−-- of the library uses. This allows us to reuse connections that the
594+-- of the library uses. This allows to reuse connections that the
589-- 'L.Manager' controls.
595-- 'L.Manager' controls.
590−withReqManager :: (MonadIO m) => (L.Manager -> m a) -> m a
596+withReqManager :: MonadIO m => (L.Manager -> m a) -> m a
591−withReqManager m = m globalManager
597+withReqManager m = liftIO (readIORef globalManager) >>= m
593-- | The global 'L.Manager' that 'req' uses. Here we just go with the
599-- | The global 'L.Manager' that 'req' uses. Here we just go with the
594-- default settings, so users don't need to deal with this manager stuff at
600-- default settings, so users don't need to deal with this manager stuff at
@@ -601,16 +607,16 @@ withReqManager m = m globalManager
601-- manager. From that moment on the 'IORef' will be just reused—exactly the
607-- manager. From that moment on the 'IORef' will be just reused—exactly the
602-- behavior we want here in order to maximize connection sharing. GHC could
608-- behavior we want here in order to maximize connection sharing. GHC could
603-- spoil the plan by inlining the definition, hence the @NOINLINE@ pragma.
609-- spoil the plan by inlining the definition, hence the @NOINLINE@ pragma.
604−globalManager :: L.Manager
610+globalManager :: IORef L.Manager
605globalManager = unsafePerformIO $ do
611globalManager = unsafePerformIO $ do
606 context <- NC.initConnectionContext
612 context <- NC.initConnectionContext
607 let settings =
613 let settings =
608 L.mkManagerSettingsContext
614 L.mkManagerSettingsContext
609 (Just context)
615 (Just context)
610− def
616+ (NC.TLSSettingsSimple False False False)
612 manager <- L.newManager settings
618 manager <- L.newManager settings
613− return manager
619+ newIORef manager
614{-# NOINLINE globalManager #-}
620{-# NOINLINE globalManager #-}
616----------------------------------------------------------------------------
622----------------------------------------------------------------------------
@@ -630,7 +636,7 @@ globalManager = unsafePerformIO $ do
630-- | A type class for monads that support performing HTTP requests.
636-- | A type class for monads that support performing HTTP requests.
631-- Typically, you only need to define the 'handleHttpException' method
637-- Typically, you only need to define the 'handleHttpException' method
632-- unless you want to tweak 'HttpConfig'.
638-- unless you want to tweak 'HttpConfig'.
633−class (MonadIO m) => MonadHttp m where
639+class MonadIO m => MonadHttp m where
634 -- | This method describes how to deal with 'HttpException' that was
640 -- | This method describes how to deal with 'HttpException' that was
635 -- caught by the library. One option is to re-throw it if you are OK with
641 -- caught by the library. One option is to re-throw it if you are OK with
636 -- exceptions, but if you prefer working with something like
642 -- exceptions, but if you prefer working with something like
@@ -714,8 +720,9 @@ data HttpConfig = HttpConfig
714 -- | Max length of preview fragment of response body.
720 -- | Max length of preview fragment of response body.
716 -- @since 3.6.0
722 -- @since 3.6.0
717− httpConfigBodyPreviewLength :: forall a. (Num a) => a
723+ httpConfigBodyPreviewLength :: forall a. Num a => a
720-- | The default value of 'HttpConfig'.
727-- | The default value of 'HttpConfig'.
@@ -803,27 +810,27 @@ instance (MonadHttp m, Monoid w) => MonadHttp (AccumT w m) where
803 getHttpConfig = lift getHttpConfig
810 getHttpConfig = lift getHttpConfig
805-- | @since 3.10.0
812-- | @since 3.10.0
806−instance (MonadHttp m) => MonadHttp (ContT r m) where
813+instance MonadHttp m => MonadHttp (ContT r m) where
807 handleHttpException = lift . handleHttpException
814 handleHttpException = lift . handleHttpException
808 getHttpConfig = lift getHttpConfig
815 getHttpConfig = lift getHttpConfig
810-- | @since 3.10.0
817-- | @since 3.10.0
811−instance (MonadHttp m) => MonadHttp (ExceptT e m) where
818+instance MonadHttp m => MonadHttp (ExceptT e m) where
812 handleHttpException = lift . handleHttpException
819 handleHttpException = lift . handleHttpException
813 getHttpConfig = lift getHttpConfig
820 getHttpConfig = lift getHttpConfig
815-- | @since 3.10.0
822-- | @since 3.10.0
816−instance (MonadHttp m) => MonadHttp (IdentityT m) where
823+instance MonadHttp m => MonadHttp (IdentityT m) where
817 handleHttpException = lift . handleHttpException
824 handleHttpException = lift . handleHttpException
818 getHttpConfig = lift getHttpConfig
825 getHttpConfig = lift getHttpConfig
820-- | @since 3.10.0
827-- | @since 3.10.0
821−instance (MonadHttp m) => MonadHttp (MaybeT m) where
828+instance MonadHttp m => MonadHttp (MaybeT m) where
822 handleHttpException = lift . handleHttpException
829 handleHttpException = lift . handleHttpException
823 getHttpConfig = lift getHttpConfig
830 getHttpConfig = lift getHttpConfig
825-- | @since 3.10.0
832-- | @since 3.10.0
826−instance (MonadHttp m) => MonadHttp (ReaderT r m) where
833+instance MonadHttp m => MonadHttp (ReaderT r m) where
827 handleHttpException = lift . handleHttpException
834 handleHttpException = lift . handleHttpException
828 getHttpConfig = lift getHttpConfig
835 getHttpConfig = lift getHttpConfig
@@ -843,17 +850,17 @@ instance (MonadHttp m, Monoid w) => MonadHttp (RWS.Strict.RWST r w s m) where
843 getHttpConfig = lift getHttpConfig
850 getHttpConfig = lift getHttpConfig
845-- | @since 3.10.0
852-- | @since 3.10.0
846−instance (MonadHttp m) => MonadHttp (SelectT r m) where
853+instance MonadHttp m => MonadHttp (SelectT r m) where
847 handleHttpException = lift . handleHttpException
854 handleHttpException = lift . handleHttpException
848 getHttpConfig = lift getHttpConfig
855 getHttpConfig = lift getHttpConfig
850-- | @since 3.10.0
857-- | @since 3.10.0
851−instance (MonadHttp m) => MonadHttp (State.Lazy.StateT s m) where
858+instance MonadHttp m => MonadHttp (State.Lazy.StateT s m) where
852 handleHttpException = lift . handleHttpException
859 handleHttpException = lift . handleHttpException
853 getHttpConfig = lift getHttpConfig
860 getHttpConfig = lift getHttpConfig
855-- | @since 3.10.0
862-- | @since 3.10.0
856−instance (MonadHttp m) => MonadHttp (State.Strict.StateT s m) where
863+instance MonadHttp m => MonadHttp (State.Strict.StateT s m) where
857 handleHttpException = lift . handleHttpException
864 handleHttpException = lift . handleHttpException
858 getHttpConfig = lift getHttpConfig
865 getHttpConfig = lift getHttpConfig
@@ -877,7 +884,7 @@ instance (MonadHttp m, Monoid w) => MonadHttp (Writer.Strict.WriterT w m) where
878-- @since 0.4.0
885-- @since 0.4.0
880− (MonadIO m) =>
887+ MonadIO m =>
881 -- | 'HttpConfig' to use
888 -- | 'HttpConfig' to use
882 HttpConfig ->
889 HttpConfig ->
883 -- | Computation to run
890 -- | Computation to run
@@ -982,7 +989,7 @@ class HttpMethod a where
982 -- | Return name of the method as a 'ByteString'.
989 -- | Return name of the method as a 'ByteString'.
983 httpMethodName :: Proxy a -> ByteString
990 httpMethodName :: Proxy a -> ByteString
985−instance (HttpMethod method) => RequestComponent (Tagged "method" method) where
992+instance HttpMethod method => RequestComponent (Tagged "method" method) where
986 getRequestMod _ = Endo $ \x ->
993 getRequestMod _ = Endo $ \x ->
987 x {L.method = httpMethodName (Proxy :: Proxy method)}
994 x {L.method = httpMethodName (Proxy :: Proxy method)}
@@ -1024,20 +1031,25 @@ instance (HttpMethod method) => RequestComponent (Tagged "method" method) where
1024-- > -- https://%D1%8E%D0%BD%D0%B8%D0%BA%D0%BE%D0%B4.%D1%80%D1%84
1031-- > -- https://%D1%8E%D0%BD%D0%B8%D0%BA%D0%BE%D0%B4.%D1%80%D1%84
1025data Url (scheme :: Scheme) = Url Scheme (NonEmpty Text)
1032data Url (scheme :: Scheme) = Url Scheme (NonEmpty Text)
1026 -- NOTE The second value is the path segments in reversed order.
1033 -- NOTE The second value is the path segments in reversed order.
1027− deriving (Eq, Ord, Show, Data, Generic)
1034+ deriving (Eq, Ord, Show, Data, Typeable, Generic)
1029type role Url nominal
1036type role Url nominal
1031-- With template-haskell >=2.15 and text >=1.2.4 Lift can be derived, however
1038-- With template-haskell >=2.15 and text >=1.2.4 Lift can be derived, however
1032-- the derived lift forgets the type of the scheme.
1039-- the derived lift forgets the type of the scheme.
1033−instance (Typeable scheme) => TH.Lift (Url scheme) where
1040+instance Typeable scheme => TH.Lift (Url scheme) where
1034 lift url =
1041 lift url =
1035 TH.dataToExpQ (fmap liftText . cast) url `TH.sigE` case url of
1042 TH.dataToExpQ (fmap liftText . cast) url `TH.sigE` case url of
1036 Url Http _ -> [t|Url 'Http|]
1043 Url Http _ -> [t|Url 'Http|]
1037 Url Https _ -> [t|Url 'Https|]
1044 Url Https _ -> [t|Url 'Https|]
1039 liftText t = TH.AppE (TH.VarE 'T.pack) <$> TH.lift (T.unpack t)
1046 liftText t = TH.AppE (TH.VarE 'T.pack) <$> TH.lift (T.unpack t)
1048+#if MIN_VERSION_template_haskell(2,17,0)
1040 liftTyped = TH.Code . TH.unsafeTExpCoerce . TH.lift
1049 liftTyped = TH.Code . TH.unsafeTExpCoerce . TH.lift
1050+#elif MIN_VERSION_template_haskell(2,16,0)
1051+ liftTyped = TH.unsafeTExpCoerce . TH.lift
1042-- | Given host name, produce a 'Url' which has “http” as its scheme and
1054-- | Given host name, produce a 'Url' which has “http” as its scheme and
1043-- empty path. This also sets port to @80@.
1055-- empty path. This also sets port to @80@.
@@ -1053,7 +1065,7 @@ https = Url Https . pure
1053-- path segment can be of any type that is an instance of 'ToHttpApiData'.
1065-- path segment can be of any type that is an instance of 'ToHttpApiData'.
1054infixl 5 /~
1066infixl 5 /~
1056−(/~) :: (ToHttpApiData a) => Url scheme -> a -> Url scheme
1068+(/~) :: ToHttpApiData a => Url scheme -> a -> Url scheme
1057Url secure path /~ segment = Url secure (NE.cons (toUrlPiece segment) path)
1069Url secure path /~ segment = Url secure (NE.cons (toUrlPiece segment) path)
1059-- | A type-constrained version of @('/~')@ to remove ambiguity in the cases
1071-- | A type-constrained version of @('/~')@ to remove ambiguity in the cases
@@ -1241,7 +1253,7 @@ instance HttpBody NoReqBody where
1241-- charset=utf-8\"@ value.
1253-- charset=utf-8\"@ value.
1242newtype ReqBodyJson a = ReqBodyJson a
1254newtype ReqBodyJson a = ReqBodyJson a
1244−instance (ToJSON a) => HttpBody (ReqBodyJson a) where
1256+instance ToJSON a => HttpBody (ReqBodyJson a) where
1245 getRequestBody (ReqBodyJson a) = L.RequestBodyLBS (A.encode a)
1257 getRequestBody (ReqBodyJson a) = L.RequestBodyLBS (A.encode a)
1246 getRequestContentType _ = pure "application/json; charset=utf-8"
1258 getRequestContentType _ = pure "application/json; charset=utf-8"
@@ -1340,7 +1352,7 @@ instance HttpBody ReqBodyMultipart where
1340-- | Create 'ReqBodyMultipart' request body from a collection of 'LM.Part's.
1352-- | Create 'ReqBodyMultipart' request body from a collection of 'LM.Part's.
1342-- @since 0.2.0
1354-- @since 0.2.0
1343−reqBodyMultipart :: (MonadIO m) => [LM.Part] -> m ReqBodyMultipart
1355+reqBodyMultipart :: MonadIO m => [LM.Part] -> m ReqBodyMultipart
1344reqBodyMultipart parts = liftIO $ do
1356reqBodyMultipart parts = liftIO $ do
1345 boundary <- LM.webkitBoundary
1357 boundary <- LM.webkitBoundary
1346 body <- LM.renderParts boundary parts
1358 body <- LM.renderParts boundary parts
@@ -1380,7 +1392,7 @@ type family
1380 TypeError
1392 TypeError
1381 ('Text "This HTTP method does not allow attaching a request body.")
1393 ('Text "This HTTP method does not allow attaching a request body.")
1383−instance (HttpBody body) => RequestComponent (Tagged "body" body) where
1395+instance HttpBody body => RequestComponent (Tagged "body" body) where
1384 getRequestMod (Tagged body) = Endo $ \x ->
1396 getRequestMod (Tagged body) = Endo $ \x ->
1386 { L.requestBody = getRequestBody body,
1398 { L.requestBody = getRequestBody body,
@@ -1450,7 +1462,7 @@ instance RequestComponent (Option scheme) where
1451-- | Finalize given 'L.Request' by applying a finalizer from the given
1463-- | Finalize given 'L.Request' by applying a finalizer from the given
1452-- 'Option' (if it has any).
1464-- 'Option' (if it has any).
1453−finalizeRequest :: (MonadIO m) => Option scheme -> L.Request -> m L.Request
1465+finalizeRequest :: MonadIO m => Option scheme -> L.Request -> m L.Request
1454finalizeRequest (Option _ mfinalizer) = liftIO . fromMaybe pure mfinalizer
1466finalizeRequest (Option _ mfinalizer) = liftIO . fromMaybe pure mfinalizer
1456----------------------------------------------------------------------------
1468----------------------------------------------------------------------------
@@ -1483,7 +1495,7 @@ name =: value = queryParam name (pure value)
1483-- This operator is defined in terms of 'queryParam':
1495-- This operator is defined in terms of 'queryParam':
1485-- > queryFlag name = queryParam name (Nothing :: Maybe ())
1497-- > queryFlag name = queryParam name (Nothing :: Maybe ())
1486−queryFlag :: (QueryParam param) => Text -> param
1498+queryFlag :: QueryParam param => Text -> param
1487queryFlag name = queryParam name (Nothing :: Maybe ())
1499queryFlag name = queryParam name (Nothing :: Maybe ())
1489-- | Construct query parameters from a 'ToForm' instance. This function
1501-- | Construct query parameters from a 'ToForm' instance. This function
@@ -1513,7 +1525,7 @@ class QueryParam param where
1513 -- 'Nothing', it won't be included at all (i.e. you create a flag this
1525 -- 'Nothing', it won't be included at all (i.e. you create a flag this
1514 -- way). It's recommended to use @('=:')@ and 'queryFlag' instead of this
1526 -- way). It's recommended to use @('=:')@ and 'queryFlag' instead of this
1515 -- method, because they are easier to read.
1527 -- method, because they are easier to read.
1516− queryParam :: (ToHttpApiData a) => Text -> Maybe a -> param
1528+ queryParam :: ToHttpApiData a => Text -> Maybe a -> param
1518 -- | Get the query parameter names and values set by 'queryParam'.
1530 -- | Get the query parameter names and values set by 'queryParam'.
@@ -1547,14 +1559,6 @@ attachHeader :: ByteString -> ByteString -> L.Request -> L.Request
1547attachHeader name value x =
1559attachHeader name value x =
1548 x {L.requestHeaders = (CI.mk name, value) : L.requestHeaders x}
1560 x {L.requestHeaders = (CI.mk name, value) : L.requestHeaders x}
1550−-- | Same as 'header', but with redacted values on print.
1553−headerRedacted :: ByteString -> ByteString -> Option scheme
1554−headerRedacted name value = withRequest $ \x ->
1555− let y = attachHeader name value x
1556− in y {L.redactHeaders = CI.mk name `S.insert` L.redactHeaders y}
1558----------------------------------------------------------------------------
1562----------------------------------------------------------------------------
1559-- Request—Optional parameters—Cookies
1563-- Request—Optional parameters—Cookies
@@ -1762,7 +1766,7 @@ ignoreResponse = Proxy
1762newtype JsonResponse a = JsonResponse (L.Response a)
1766newtype JsonResponse a = JsonResponse (L.Response a)
1763 deriving (Show)
1767 deriving (Show)
1765−instance (FromJSON a) => HttpResponse (JsonResponse a) where
1769+instance FromJSON a => HttpResponse (JsonResponse a) where
1766 type HttpResponseBody (JsonResponse a) = a
1770 type HttpResponseBody (JsonResponse a) = a
1767 toVanillaResponse (JsonResponse r) = r
1771 toVanillaResponse (JsonResponse r) = r
1768 getHttpResponse r = do
1772 getHttpResponse r = do
@@ -1878,14 +1882,14 @@ brReadN br n = go 0 id id
1879-- | Get the response body.
1883-- | Get the response body.
1880responseBody ::
1884responseBody ::
1881− (HttpResponse response) =>
1885+ HttpResponse response =>
1882 response ->
1886 response ->
1883 HttpResponseBody response
1887 HttpResponseBody response
1884responseBody = L.responseBody . toVanillaResponse
1888responseBody = L.responseBody . toVanillaResponse
1886-- | Get the response status code.
1890-- | Get the response status code.
1887responseStatusCode ::
1891responseStatusCode ::
1888− (HttpResponse response) =>
1892+ HttpResponse response =>
1889 response ->
1893 response ->
1891responseStatusCode =
1895responseStatusCode =
@@ -1893,7 +1897,7 @@ responseStatusCode =
1894-- | Get the response status message.
1898-- | Get the response status message.
1895responseStatusMessage ::
1899responseStatusMessage ::
1896− (HttpResponse response) =>
1900+ HttpResponse response =>
1897 response ->
1901 response ->
1898 ByteString
1902 ByteString
1899responseStatusMessage =
1903responseStatusMessage =
@@ -1901,7 +1905,7 @@ responseStatusMessage =
1902-- | Lookup a particular header from a response.
1906-- | Lookup a particular header from a response.
1903responseHeader ::
1907responseHeader ::
1904− (HttpResponse response) =>
1908+ HttpResponse response =>
1905 -- | Response interpretation
1909 -- | Response interpretation
1906 response ->
1910 response ->
1907 -- | Header to lookup
1911 -- | Header to lookup
@@ -1913,7 +1917,7 @@ responseHeader r h =
1914-- | Get the response 'L.CookieJar'.
1918-- | Get the response 'L.CookieJar'.
1915responseCookieJar ::
1919responseCookieJar ::
1916− (HttpResponse response) =>
1920+ HttpResponse response =>
1917 response ->
1921 response ->
1918 L.CookieJar
1922 L.CookieJar
1919responseCookieJar = L.responseCookieJar . toVanillaResponse
1923responseCookieJar = L.responseCookieJar . toVanillaResponse
@@ -1967,16 +1971,6 @@ class HttpResponse response where
1967 acceptHeader :: Proxy response -> Maybe ByteString
1971 acceptHeader :: Proxy response -> Maybe ByteString
1968 acceptHeader Proxy = Nothing
1972 acceptHeader Proxy = Nothing
1970−-- | This instance has been added to make it easier to inspect 'L.Response'
1971−-- using Req's functions like 'responseStatusCode', 'responseStatusMessage',
1975−instance HttpResponse (L.Response ()) where
1976− type HttpResponseBody (L.Response ()) = ()
1977− toVanillaResponse = id
1978− getHttpResponse = return . void
1980----------------------------------------------------------------------------
1974----------------------------------------------------------------------------
@@ -2011,24 +2005,10 @@ data HttpException
2011 | -- | A wrapper with Aeson-produced 'String' describing why decoding
2005 | -- | A wrapper with Aeson-produced 'String' describing why decoding
2012 -- failed
2006 -- failed
2013 JsonHttpException String
2007 JsonHttpException String
2014− deriving (Show, Generic)
2008+ deriving (Show, Typeable, Generic)
2016instance Exception HttpException
2010instance Exception HttpException
2018−-- | Return 'Just' if the given 'HttpException' is wrapping a http-client's
2019−-- 'L.StatusCodeException'. Otherwise, return 'Nothing'.
2022−isStatusCodeException :: HttpException -> Maybe (L.Response ())
2023−isStatusCodeException
2024− ( VanillaHttpException
2025− ( L.HttpExceptionRequest
2027− (L.StatusCodeException r _)
2030−isStatusCodeException _ = Nothing
2032-- | A simple type isomorphic to 'Bool' that we only have for better error
2012-- | A simple type isomorphic to 'Bool' that we only have for better error
2033-- messages. We use it as a kind and its data constructors as type-level
2013-- messages. We use it as a kind and its data constructors as type-level
@@ -2048,4 +2028,4 @@ data Scheme
2049 | -- | HTTPS
2029 | -- | HTTPS
2051− deriving (Eq, Ord, Show, Data, Generic, TH.Lift)
2031+ deriving (Eq, Ord, Show, Data, Typeable, Generic, TH.Lift)