@@ -1,9 +1,20 @@
1+{-# LANGUAGE BangPatterns #-}
2+{-# LANGUAGE CPP #-}
13{-# LANGUAGE DataKinds #-}
4+{-# LANGUAGE DeriveDataTypeable #-}
5+{-# LANGUAGE DeriveGeneric #-}
6+{-# LANGUAGE DeriveLift #-}
7+{-# LANGUAGE FlexibleInstances #-}
8+{-# LANGUAGE GeneralizedNewtypeDeriving #-}
29{-# LANGUAGE LambdaCase #-}
10+{-# LANGUAGE MultiParamTypeClasses #-}
311{-# LANGUAGE OverloadedStrings #-}
412{-# LANGUAGE QuasiQuotes #-}
13+{-# LANGUAGE RankNTypes #-}
514{-# LANGUAGE RecordWildCards #-}
615{-# LANGUAGE RoleAnnotations #-}
16+{-# LANGUAGE ScopedTypeVariables #-}
17+{-# LANGUAGE StandaloneDeriving #-}
718{-# LANGUAGE TemplateHaskellQuotes #-}
819{-# LANGUAGE TypeFamilies #-}
920{-# LANGUAGE UndecidableInstances #-}
@@ -150,7 +161,6 @@ module Network.HTTP.Req
150161 -- *** Headers
151162 header,
152163 attachHeader,
153− headerRedacted,
154164
155165 -- *** Cookies
156166 -- $cookies
@@ -203,7 +213,7 @@ module Network.HTTP.Req
203213 )
204214where
205215
206−import Blaze.ByteString.Builder qualified as BB
216+import qualified Blaze.ByteString.Builder as BB
207217import Control.Applicative
208218import Control.Arrow (first, second)
209219import Control.Exception hiding (Handler (..), TypeError)
@@ -219,56 +229,54 @@ import Control.Monad.Trans.Control
219229import Control.Monad.Trans.Except (ExceptT)
220230import Control.Monad.Trans.Identity (IdentityT)
221231import Control.Monad.Trans.Maybe (MaybeT)
222−import Control.Monad.Trans.RWS.CPS qualified as RWS.CPS
223−import Control.Monad.Trans.RWS.Lazy qualified as RWS.Lazy
224−import Control.Monad.Trans.RWS.Strict qualified as RWS.Strict
232+import qualified Control.Monad.Trans.RWS.CPS as RWS.CPS
233+import qualified Control.Monad.Trans.RWS.Lazy as RWS.Lazy
234+import qualified Control.Monad.Trans.RWS.Strict as RWS.Strict
225235import Control.Monad.Trans.Select (SelectT)
226−import Control.Monad.Trans.State.Lazy qualified as State.Lazy
227−import Control.Monad.Trans.State.Strict qualified as State.Strict
228−import Control.Monad.Trans.Writer.CPS qualified as Writer.CPS
229−import Control.Monad.Trans.Writer.Lazy qualified as Writer.Lazy
230−import Control.Monad.Trans.Writer.Strict qualified as Writer.Strict
236+import qualified Control.Monad.Trans.State.Lazy as State.Lazy
237+import qualified Control.Monad.Trans.State.Strict as State.Strict
238+import qualified Control.Monad.Trans.Writer.CPS as Writer.CPS
239+import qualified Control.Monad.Trans.Writer.Lazy as Writer.Lazy
240+import qualified Control.Monad.Trans.Writer.Strict as Writer.Strict
231241import Control.Retry
232242import Data.Aeson (FromJSON (..), ToJSON (..))
233−import Data.Aeson qualified as A
243+import qualified Data.Aeson as A
234244import Data.ByteString (ByteString)
235−import Data.ByteString qualified as B
236−import Data.ByteString.Lazy qualified as BL
237−import Data.CaseInsensitive qualified as CI
245+import qualified Data.ByteString as B
246+import qualified Data.ByteString.Lazy as BL
247+import qualified Data.CaseInsensitive as CI
238248import Data.Data (Data)
239−import Data.Default.Class (def)
240249import Data.Function (on)
241250import Data.IORef
242251import Data.Kind (Constraint, Type)
243252import Data.List (foldl', nubBy)
244253import Data.List.NonEmpty (NonEmpty (..))
245−import Data.List.NonEmpty qualified as NE
254+import qualified Data.List.NonEmpty as NE
246255import Data.Maybe (fromMaybe)
247256import Data.Proxy
248257import Data.Semigroup (Endo (..))
249−import Data.Set qualified as S
250258import Data.Text (Text)
251−import Data.Text qualified as T
252−import Data.Text.Encoding qualified as T
259+import qualified Data.Text as T
260+import qualified Data.Text.Encoding as T
253261import Data.Typeable (Typeable, cast)
254262import GHC.Generics
255263import GHC.TypeLits
256−import Language.Haskell.TH qualified as TH
257−import Language.Haskell.TH.Quote qualified as TH
258−import Language.Haskell.TH.Syntax qualified as TH
259−import Network.Connection qualified as NC
260−import Network.HTTP.Client qualified as L
261−import Network.HTTP.Client.Internal qualified as LI
262−import Network.HTTP.Client.MultipartFormData qualified as LM
263−import Network.HTTP.Client.TLS qualified as L
264−import Network.HTTP.Types qualified as Y
264+import qualified Language.Haskell.TH as TH
265+import qualified Language.Haskell.TH.Quote as TH
266+import qualified Language.Haskell.TH.Syntax as TH
267+import qualified Network.Connection as NC
268+import qualified Network.HTTP.Client as L
269+import qualified Network.HTTP.Client.Internal as LI
270+import qualified Network.HTTP.Client.MultipartFormData as LM
271+import qualified Network.HTTP.Client.TLS as L
272+import qualified Network.HTTP.Types as Y
265273import System.IO.Unsafe (unsafePerformIO)
266274import Text.URI (URI)
267−import Text.URI qualified as URI
268−import Text.URI.QQ qualified as QQ
269−import Web.Authenticate.OAuth qualified as OAuth
275+import qualified Text.URI as URI
276+import qualified Text.URI.QQ as QQ
277+import qualified Web.Authenticate.OAuth as OAuth
270278import Web.FormUrlEncoded (FromForm (..), ToForm (..))
271−import Web.FormUrlEncoded qualified as Form
279+import qualified Web.FormUrlEncoded as Form
272280import Web.HttpApiData (ToHttpApiData (..))
273281
274282----------------------------------------------------------------------------
@@ -489,7 +497,7 @@ reqCb method url body responseProxy options adjustRequest =
489497--
490498-- @since 3.7.0
491499reqHandler ::
492− (MonadHttp m) =>
500+ MonadHttp m =>
493501 -- | How to get final result from a 'L.Response'
494502 (L.Response L.BodyReader -> IO b) ->
495503 -- | 'L.Request' to perform
@@ -585,10 +593,10 @@ req' method url body options m = do
585593 withReqManager (m request)
586594
587595-- | 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
596+-- of the library uses. This allows to reuse connections that the
589597-- 'L.Manager' controls.
590−withReqManager :: (MonadIO m) => (L.Manager -> m a) -> m a
591−withReqManager m = m globalManager
598+withReqManager :: MonadIO m => (L.Manager -> m a) -> m a
599+withReqManager m = liftIO (readIORef globalManager) >>= m
592600
593601-- | The global 'L.Manager' that 'req' uses. Here we just go with the
594602-- default settings, so users don't need to deal with this manager stuff at
@@ -601,16 +609,16 @@ withReqManager m = m globalManager
601609-- manager. From that moment on the 'IORef' will be just reused—exactly the
602610-- behavior we want here in order to maximize connection sharing. GHC could
603611-- spoil the plan by inlining the definition, hence the @NOINLINE@ pragma.
604−globalManager :: L.Manager
612+globalManager :: IORef L.Manager
605613globalManager = unsafePerformIO $ do
606614 context <- NC.initConnectionContext
607615 let settings =
608616 L.mkManagerSettingsContext
609617 (Just context)
610− def
618+ (NC.TLSSettingsSimple False False False)
611619 Nothing
612620 manager <- L.newManager settings
613− return manager
621+ newIORef manager
614622{-# NOINLINE globalManager #-}
615623
616624----------------------------------------------------------------------------
@@ -630,7 +638,7 @@ globalManager = unsafePerformIO $ do
630638-- | A type class for monads that support performing HTTP requests.
631639-- Typically, you only need to define the 'handleHttpException' method
632640-- unless you want to tweak 'HttpConfig'.
633−class (MonadIO m) => MonadHttp m where
641+class MonadIO m => MonadHttp m where
634642 -- | This method describes how to deal with 'HttpException' that was
635643 -- caught by the library. One option is to re-throw it if you are OK with
636644 -- exceptions, but if you prefer working with something like
@@ -714,8 +722,9 @@ data HttpConfig = HttpConfig
714722 -- | Max length of preview fragment of response body.
715723 --
716724 -- @since 3.6.0
717− httpConfigBodyPreviewLength :: forall a. (Num a) => a
725+ httpConfigBodyPreviewLength :: forall a. Num a => a
718726 }
727+ deriving (Typeable)
719728
720729-- | The default value of 'HttpConfig'.
721730--
@@ -803,27 +812,27 @@ instance (MonadHttp m, Monoid w) => MonadHttp (AccumT w m) where
803812 getHttpConfig = lift getHttpConfig
804813
805814-- | @since 3.10.0
806−instance (MonadHttp m) => MonadHttp (ContT r m) where
815+instance MonadHttp m => MonadHttp (ContT r m) where
807816 handleHttpException = lift . handleHttpException
808817 getHttpConfig = lift getHttpConfig
809818
810819-- | @since 3.10.0
811−instance (MonadHttp m) => MonadHttp (ExceptT e m) where
820+instance MonadHttp m => MonadHttp (ExceptT e m) where
812821 handleHttpException = lift . handleHttpException
813822 getHttpConfig = lift getHttpConfig
814823
815824-- | @since 3.10.0
816−instance (MonadHttp m) => MonadHttp (IdentityT m) where
825+instance MonadHttp m => MonadHttp (IdentityT m) where
817826 handleHttpException = lift . handleHttpException
818827 getHttpConfig = lift getHttpConfig
819828
820829-- | @since 3.10.0
821−instance (MonadHttp m) => MonadHttp (MaybeT m) where
830+instance MonadHttp m => MonadHttp (MaybeT m) where
822831 handleHttpException = lift . handleHttpException
823832 getHttpConfig = lift getHttpConfig
824833
825834-- | @since 3.10.0
826−instance (MonadHttp m) => MonadHttp (ReaderT r m) where
835+instance MonadHttp m => MonadHttp (ReaderT r m) where
827836 handleHttpException = lift . handleHttpException
828837 getHttpConfig = lift getHttpConfig
829838
@@ -843,17 +852,17 @@ instance (MonadHttp m, Monoid w) => MonadHttp (RWS.Strict.RWST r w s m) where
843852 getHttpConfig = lift getHttpConfig
844853
845854-- | @since 3.10.0
846−instance (MonadHttp m) => MonadHttp (SelectT r m) where
855+instance MonadHttp m => MonadHttp (SelectT r m) where
847856 handleHttpException = lift . handleHttpException
848857 getHttpConfig = lift getHttpConfig
849858
850859-- | @since 3.10.0
851−instance (MonadHttp m) => MonadHttp (State.Lazy.StateT s m) where
860+instance MonadHttp m => MonadHttp (State.Lazy.StateT s m) where
852861 handleHttpException = lift . handleHttpException
853862 getHttpConfig = lift getHttpConfig
854863
855864-- | @since 3.10.0
856−instance (MonadHttp m) => MonadHttp (State.Strict.StateT s m) where
865+instance MonadHttp m => MonadHttp (State.Strict.StateT s m) where
857866 handleHttpException = lift . handleHttpException
858867 getHttpConfig = lift getHttpConfig
859868
@@ -877,7 +886,7 @@ instance (MonadHttp m, Monoid w) => MonadHttp (Writer.Strict.WriterT w m) where
877886--
878887-- @since 0.4.0
879888runReq ::
880− (MonadIO m) =>
889+ MonadIO m =>
881890 -- | 'HttpConfig' to use
882891 HttpConfig ->
883892 -- | Computation to run
@@ -982,7 +991,7 @@ class HttpMethod a where
982991 -- | Return name of the method as a 'ByteString'.
983992 httpMethodName :: Proxy a -> ByteString
984993
985−instance (HttpMethod method) => RequestComponent (Tagged "method" method) where
994+instance HttpMethod method => RequestComponent (Tagged "method" method) where
986995 getRequestMod _ = Endo $ \x ->
987996 x {L.method = httpMethodName (Proxy :: Proxy method)}
988997
@@ -1024,20 +1033,25 @@ instance (HttpMethod method) => RequestComponent (Tagged "method" method) where
10241033-- > -- https://%D1%8E%D0%BD%D0%B8%D0%BA%D0%BE%D0%B4.%D1%80%D1%84
10251034data Url (scheme :: Scheme) = Url Scheme (NonEmpty Text)
10261035 -- NOTE The second value is the path segments in reversed order.
1027− deriving (Eq, Ord, Show, Data, Generic)
1036+ deriving (Eq, Ord, Show, Data, Typeable, Generic)
10281037
10291038type role Url nominal
10301039
10311040-- With template-haskell >=2.15 and text >=1.2.4 Lift can be derived, however
10321041-- the derived lift forgets the type of the scheme.
1033−instance (Typeable scheme) => TH.Lift (Url scheme) where
1042+instance Typeable scheme => TH.Lift (Url scheme) where
10341043 lift url =
10351044 TH.dataToExpQ (fmap liftText . cast) url `TH.sigE` case url of
10361045 Url Http _ -> [t|Url 'Http|]
10371046 Url Https _ -> [t|Url 'Https|]
10381047 where
10391048 liftText t = TH.AppE (TH.VarE 'T.pack) <$> TH.lift (T.unpack t)
1049+
1050+#if MIN_VERSION_template_haskell(2,17,0)
10401051 liftTyped = TH.Code . TH.unsafeTExpCoerce . TH.lift
1052+#elif MIN_VERSION_template_haskell(2,16,0)
1053+ liftTyped = TH.unsafeTExpCoerce . TH.lift
1054+#endif
10411055
10421056-- | Given host name, produce a 'Url' which has “http” as its scheme and
10431057-- empty path. This also sets port to @80@.
@@ -1053,7 +1067,7 @@ https = Url Https . pure
10531067-- path segment can be of any type that is an instance of 'ToHttpApiData'.
10541068infixl 5 /~
10551069
1056−(/~) :: (ToHttpApiData a) => Url scheme -> a -> Url scheme
1070+(/~) :: ToHttpApiData a => Url scheme -> a -> Url scheme
10571071Url secure path /~ segment = Url secure (NE.cons (toUrlPiece segment) path)
10581072
10591073-- | A type-constrained version of @('/~')@ to remove ambiguity in the cases
@@ -1241,7 +1255,7 @@ instance HttpBody NoReqBody where
12411255-- charset=utf-8\"@ value.
12421256newtype ReqBodyJson a = ReqBodyJson a
12431257
1244−instance (ToJSON a) => HttpBody (ReqBodyJson a) where
1258+instance ToJSON a => HttpBody (ReqBodyJson a) where
12451259 getRequestBody (ReqBodyJson a) = L.RequestBodyLBS (A.encode a)
12461260 getRequestContentType _ = pure "application/json; charset=utf-8"
12471261
@@ -1340,7 +1354,7 @@ instance HttpBody ReqBodyMultipart where
13401354-- | Create 'ReqBodyMultipart' request body from a collection of 'LM.Part's.
13411355--
13421356-- @since 0.2.0
1343−reqBodyMultipart :: (MonadIO m) => [LM.Part] -> m ReqBodyMultipart
1357+reqBodyMultipart :: MonadIO m => [LM.Part] -> m ReqBodyMultipart
13441358reqBodyMultipart parts = liftIO $ do
13451359 boundary <- LM.webkitBoundary
13461360 body <- LM.renderParts boundary parts
@@ -1380,7 +1394,7 @@ type family
13801394 TypeError
13811395 ('Text "This HTTP method does not allow attaching a request body.")
13821396
1383−instance (HttpBody body) => RequestComponent (Tagged "body" body) where
1397+instance HttpBody body => RequestComponent (Tagged "body" body) where
13841398 getRequestMod (Tagged body) = Endo $ \x ->
13851399 x
13861400 { L.requestBody = getRequestBody body,
@@ -1450,7 +1464,7 @@ instance RequestComponent (Option scheme) where
14501464
14511465-- | Finalize given 'L.Request' by applying a finalizer from the given
14521466-- 'Option' (if it has any).
1453−finalizeRequest :: (MonadIO m) => Option scheme -> L.Request -> m L.Request
1467+finalizeRequest :: MonadIO m => Option scheme -> L.Request -> m L.Request
14541468finalizeRequest (Option _ mfinalizer) = liftIO . fromMaybe pure mfinalizer
14551469
14561470----------------------------------------------------------------------------
@@ -1483,7 +1497,7 @@ name =: value = queryParam name (pure value)
14831497-- This operator is defined in terms of 'queryParam':
14841498--
14851499-- > queryFlag name = queryParam name (Nothing :: Maybe ())
1486−queryFlag :: (QueryParam param) => Text -> param
1500+queryFlag :: QueryParam param => Text -> param
14871501queryFlag name = queryParam name (Nothing :: Maybe ())
14881502
14891503-- | Construct query parameters from a 'ToForm' instance. This function
@@ -1513,7 +1527,7 @@ class QueryParam param where
15131527 -- 'Nothing', it won't be included at all (i.e. you create a flag this
15141528 -- way). It's recommended to use @('=:')@ and 'queryFlag' instead of this
15151529 -- method, because they are easier to read.
1516− queryParam :: (ToHttpApiData a) => Text -> Maybe a -> param
1530+ queryParam :: ToHttpApiData a => Text -> Maybe a -> param
15171531
15181532 -- | Get the query parameter names and values set by 'queryParam'.
15191533 --
@@ -1547,14 +1561,6 @@ attachHeader :: ByteString -> ByteString -> L.Request -> L.Request
15471561attachHeader name value x =
15481562 x {L.requestHeaders = (CI.mk name, value) : L.requestHeaders x}
15491563
1550−-- | Same as 'header', but with redacted values on print.
1551−--
1552−-- @since 3.13.0
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}
1557−
15581564----------------------------------------------------------------------------
15591565-- Request—Optional parameters—Cookies
15601566
@@ -1762,7 +1768,7 @@ ignoreResponse = Proxy
17621768newtype JsonResponse a = JsonResponse (L.Response a)
17631769 deriving (Show)
17641770
1765−instance (FromJSON a) => HttpResponse (JsonResponse a) where
1771+instance FromJSON a => HttpResponse (JsonResponse a) where
17661772 type HttpResponseBody (JsonResponse a) = a
17671773 toVanillaResponse (JsonResponse r) = r
17681774 getHttpResponse r = do
@@ -1878,14 +1884,14 @@ brReadN br n = go 0 id id
18781884
18791885-- | Get the response body.
18801886responseBody ::
1881− (HttpResponse response) =>
1887+ HttpResponse response =>
18821888 response ->
18831889 HttpResponseBody response
18841890responseBody = L.responseBody . toVanillaResponse
18851891
18861892-- | Get the response status code.
18871893responseStatusCode ::
1888− (HttpResponse response) =>
1894+ HttpResponse response =>
18891895 response ->
18901896 Int
18911897responseStatusCode =
@@ -1893,7 +1899,7 @@ responseStatusCode =
18931899
18941900-- | Get the response status message.
18951901responseStatusMessage ::
1896− (HttpResponse response) =>
1902+ HttpResponse response =>
18971903 response ->
18981904 ByteString
18991905responseStatusMessage =
@@ -1901,7 +1907,7 @@ responseStatusMessage =
19011907
19021908-- | Lookup a particular header from a response.
19031909responseHeader ::
1904− (HttpResponse response) =>
1910+ HttpResponse response =>
19051911 -- | Response interpretation
19061912 response ->
19071913 -- | Header to lookup
@@ -1913,7 +1919,7 @@ responseHeader r h =
19131919
19141920-- | Get the response 'L.CookieJar'.
19151921responseCookieJar ::
1916− (HttpResponse response) =>
1922+ HttpResponse response =>
19171923 response ->
19181924 L.CookieJar
19191925responseCookieJar = L.responseCookieJar . toVanillaResponse
@@ -2011,7 +2017,7 @@ data HttpException
20112017 | -- | A wrapper with Aeson-produced 'String' describing why decoding
20122018 -- failed
20132019 JsonHttpException String
2014− deriving (Show, Generic)
2020+ deriving (Show, Typeable, Generic)
20152021
20162022instance Exception HttpException
20172023
@@ -2048,4 +2054,4 @@ data Scheme
20482054 Http
20492055 | -- | HTTPS
20502056 Https
2051− deriving (Eq, Ord, Show, Data, Generic, TH.Lift)
2057+ deriving (Eq, Ord, Show, Data, Typeable, Generic, TH.Lift)