@@ -8,7 +8,6 @@
8{-# LANGUAGE MultiParamTypeClasses #-}
8{-# LANGUAGE MultiParamTypeClasses #-}
9{-# LANGUAGE OverloadedStrings #-}
9{-# LANGUAGE OverloadedStrings #-}
10{-# LANGUAGE PolyKinds #-}
10{-# LANGUAGE PolyKinds #-}
11−{-# LANGUAGE Rank2Types #-}
12{-# LANGUAGE ScopedTypeVariables #-}
11{-# LANGUAGE ScopedTypeVariables #-}
13{-# LANGUAGE TupleSections #-}
12{-# LANGUAGE TupleSections #-}
14{-# LANGUAGE TypeFamilies #-}
13{-# LANGUAGE TypeFamilies #-}
@@ -26,9 +25,7 @@
26module Servant.Reflex
25module Servant.Reflex
28 , clientWithOpts
27 , clientWithOpts
29− , clientWithOptsAndResultHandler
30 , clientWithRoute
28 , clientWithRoute
31− , clientWithRouteAndResultHandler
32 , BuildHeaderKeysTo(..)
29 , BuildHeaderKeysTo(..)
33 , toHeaders
30 , toHeaders
34 , HasClient
31 , HasClient
@@ -39,41 +36,39 @@ module Servant.Reflex
40------------------------------------------------------------------------------
37------------------------------------------------------------------------------
41import Control.Applicative
38import Control.Applicative
42−import qualified Data.CaseInsensitive as CI
43−import Data.Functor.Identity
44−import qualified Data.Map as Map
45import Data.Monoid ((<>))
39import Data.Monoid ((<>))
46−import Data.Proxy (Proxy (..))
47import qualified Data.Set as Set
40import qualified Data.Set as Set
41+import qualified Data.Text.Encoding as E
42+import Data.CaseInsensitive (mk)
43+import Data.Functor.Identity
44+import Data.Proxy (Proxy (..))
45+import qualified Data.Map as Map
48import Data.Text (Text)
46import Data.Text (Text)
49import qualified Data.Text as T
47import qualified Data.Text as T
50−import qualified Data.Text.Encoding as E
51import GHC.Exts (Constraint)
48import GHC.Exts (Constraint)
52import GHC.TypeLits (KnownSymbol, symbolVal)
49import GHC.TypeLits (KnownSymbol, symbolVal)
53−import Servant.API ((:<|>) (..), (:>), BasicAuth,
50+import Servant.API ((:<|>)(..),(:>), BasicAuth,
54− BasicAuthData, BuildHeadersTo (..),
51+ BasicAuthData, BuildHeadersTo(..),
55− Capture, Header, Headers (..),
52+ Capture, contentType, Header,
56− HttpVersion, IsSecure,
53+ Headers(..), HttpVersion, IsSecure,
57− MimeRender (..), MimeUnrender,
54+ MimeRender(..),
58 NoContent, QueryFlag, QueryParam,
55 NoContent, QueryFlag, QueryParam,
59− QueryParams, Raw, ReflectMethod (..),
56+ QueryParams, Raw, ReflectMethod(..),
60 RemoteHost, ReqBody,
57 RemoteHost, ReqBody,
61− ToHttpApiData (..), Vault, Verb,
58+ ToHttpApiData(..), Vault, Verb)
63−import Servant.API.Description (Summary)
64import qualified Servant.Auth as Auth
59import qualified Servant.Auth as Auth
66import Reflex.Dom.Core (Dynamic, Event, Reflex,
61import Reflex.Dom.Core (Dynamic, Event, Reflex,
67− XhrRequest (..), XhrResponse (..),
62+ XhrRequest(..),
68− XhrResponseHeaders (..),
63+ XhrResponseHeaders(..),
69− attachPromptlyDynWith, constDyn, ffor,
64+ XhrResponse(..), attachPromptlyDynWith, constDyn, ffor, fmapMaybe,
71− performRequestsAsync)
65+ leftmost, performRequestsAsync,
72------------------------------------------------------------------------------
67------------------------------------------------------------------------------
73import Servant.Common.BaseUrl (BaseUrl(..), Scheme(..), baseUrlWidget,
68import Servant.Common.BaseUrl (BaseUrl(..), Scheme(..), baseUrlWidget,
74 showBaseUrl,
69 showBaseUrl,
75 SupportsServantReflex)
70 SupportsServantReflex)
76−import Servant.Common.Req (ClientOptions(..),
71+import Servant.Common.Req (ClientOptions(..), MimeUnrender(..),
77 defaultClientOptions,
72 defaultClientOptions,
78 Req, ReqResult(..), QParam(..),
73 Req, ReqResult(..), QParam(..),
79 QueryPart(..), addHeader, authData,
74 QueryPart(..), addHeader, authData,
@@ -89,6 +84,8 @@ import Servant.Common.Req (ClientOptions(..),
91 qParams, withCredentials)
86 qParams, withCredentials)
87+import Servant.Checked.Exceptions.Internal.Envelope (Envelope)
88+import Servant.Checked.Exceptions.Internal.Servant.API (NoThrow, Throws, Throwing, ThrowingNonterminal)
94-- * Accessing APIs as a Client
91-- * Accessing APIs as a Client
@@ -103,7 +100,7 @@ import Servant.Common.Req (ClientOptions(..),
104-- > getAllBooks :: Event t l -> m (Event t (l, ReqResult [Book]))
101-- > getAllBooks :: Event t l -> m (Event t (l, ReqResult [Book]))
105-- > postNewBook :: Dynamic t (Maybe Book) -> Event t l
102-- > postNewBook :: Dynamic t (Maybe Book) -> Event t l
106−-- > -> m (Event t (l, ReqResult Book)))
103+-- -> m (Event t (l, ReqResult Book)))
107-- > (getAllBooks :<|> postNewBook) = client myApi host
104-- > (getAllBooks :<|> postNewBook) = client myApi host
108-- > where host = constDyn $ BaseUrl Http "localhost" 8080
105-- > where host = constDyn $ BaseUrl Http "localhost" 8080
@@ -125,53 +122,21 @@ clientWithOpts
125 -> Client t m layout tag
122 -> Client t m layout tag
126clientWithOpts p q t baseurl = clientWithRoute p q t defReq baseurl
123clientWithOpts p q t baseurl = clientWithRoute p q t defReq baseurl
128−-- | Like 'clientWithOpts' but allows passing a function which will process the
129−-- result event in some way. This can be used to handle errors in a uniform way
130−-- across call sites.
131−clientWithOptsAndResultHandler
132− :: (HasClient t m layout tag)
136− -> Dynamic t BaseUrl
138− -> (forall a. Event t (ReqResult tag a) -> m (Event t (ReqResult tag a)))
139− -> Client t m layout tag
140−clientWithOptsAndResultHandler p q t = clientWithRouteAndResultHandler p q t defReq
143-- | This class lets us define how each API combinator
126-- | This class lets us define how each API combinator
144-- influences the creation of an HTTP request. It's mostly
127-- influences the creation of an HTTP request. It's mostly
145-- an internal class, you can just use 'client'.
128-- an internal class, you can just use 'client'.
146−class Monad m => HasClient t m layout (tag :: *) where
129+class HasClient t m layout (tag :: *) where
147 type Client t m layout tag :: *
130 type Client t m layout tag :: *
148− clientWithRoute
131+ clientWithRoute :: Proxy layout -> Proxy m -> Proxy tag -> Req t -> Dynamic t BaseUrl -> ClientOptions -> Client t m layout tag
153− -> Dynamic t BaseUrl
155− -> Client t m layout tag
156− clientWithRoute l m t r b o = clientWithRouteAndResultHandler l m t r b o return
158− clientWithRouteAndResultHandler
163− -> Dynamic t BaseUrl
165− -> (forall a. Event t (ReqResult tag a) -> m (Event t (ReqResult tag a)))
166− -> Client t m layout tag
169instance (HasClient t m a tag, HasClient t m b tag) => HasClient t m (a :<|> b) tag where
134instance (HasClient t m a tag, HasClient t m b tag) => HasClient t m (a :<|> b) tag where
170 type Client t m (a :<|> b) tag = Client t m a tag :<|> Client t m b tag
135 type Client t m (a :<|> b) tag = Client t m a tag :<|> Client t m b tag
172− clientWithRouteAndResultHandler Proxy q pTag req baseurl opts wrap =
137+ clientWithRoute Proxy q pTag req baseurl opts =
173− clientWithRouteAndResultHandler (Proxy :: Proxy a) q pTag req baseurl opts wrap :<|>
138+ clientWithRoute (Proxy :: Proxy a) q pTag req baseurl opts :<|>
174− clientWithRouteAndResultHandler (Proxy :: Proxy b) q pTag req baseurl opts wrap
139+ clientWithRoute (Proxy :: Proxy b) q pTag req baseurl opts
177-- Capture. Example:
142-- Capture. Example:
@@ -192,9 +157,11 @@ instance (SupportsServantReflex t m, ToHttpApiData a, HasClient t m sublayout ta
192 type Client t m (Capture capture a :> sublayout) tag =
157 type Client t m (Capture capture a :> sublayout) tag =
193 Dynamic t (Either Text a) -> Client t m sublayout tag
158 Dynamic t (Either Text a) -> Client t m sublayout tag
195− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap val =
160+ clientWithRoute Proxy q t req baseurl opts val =
196− clientWithRouteAndResultHandler
161+ clientWithRoute (Proxy :: Proxy sublayout)
197− (Proxy :: Proxy sublayout) q t (prependToPathParts p req) baseurl opts wrap
163+ (prependToPathParts p req)
198 where p = (fmap . fmap) (toUrlPiece) val
165 where p = (fmap . fmap) (toUrlPiece) val
@@ -207,8 +174,8 @@ instance {-# OVERLAPPABLE #-}
207 Event t tag -> m (Event t (ReqResult tag a))
174 Event t tag -> m (Event t (ReqResult tag a))
208 -- TODO how to access input types here?
175 -- TODO how to access input types here?
209 -- ExceptT ServantError IO a
176 -- ExceptT ServantError IO a
210− clientWithRouteAndResultHandler Proxy _ _ req baseurl opts wrap trigs =
177+ clientWithRoute Proxy _ _ req baseurl opts trigs =
211− wrap =<< fmap runIdentity <$> performRequestsCT (Proxy :: Proxy ct) method (constDyn $ Identity $ req') baseurl opts trigs
178+ fmap runIdentity <$> performRequestsCT (Proxy :: Proxy ct) method (constDyn $ Identity $ req') baseurl opts trigs
212 where method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
179 where method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
213 req' = req { reqMethod = method }
180 req' = req { reqMethod = method }
@@ -221,33 +188,29 @@ instance {-# OVERLAPPING #-}
221 Event t tag -> m (Event t (ReqResult tag NoContent))
188 Event t tag -> m (Event t (ReqResult tag NoContent))
222 -- TODO: how to access input types here?
189 -- TODO: how to access input types here?
223 -- ExceptT ServantError IO NoContent
190 -- ExceptT ServantError IO NoContent
224− clientWithRouteAndResultHandler Proxy _ _ req baseurl opts wrap trigs =
191+ clientWithRoute Proxy _ _ req baseurl opts =
225− wrap =<< fmap runIdentity <$> performRequestsNoBody method (constDyn $ Identity req) baseurl opts trigs
192+ (fmap . fmap) runIdentity . performRequestsNoBody method (constDyn $ Identity req) baseurl opts
226 where method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
193 where method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
229toHeaders :: BuildHeadersTo ls => ReqResult tag a -> ReqResult tag (Headers ls a)
196toHeaders :: BuildHeadersTo ls => ReqResult tag a -> ReqResult tag (Headers ls a)
230toHeaders r =
197toHeaders r =
198+ let toBS = E.encodeUtf8
231− let hdrs = maybe []
199+ hdrs = maybe []
232− (\xhr -> fmap (\(h,v) -> (CI.map E.encodeUtf8 h, E.encodeUtf8 v))
200+ (\xhr -> fmap (\(h,v) -> (mk (toBS h), toBS v))
233 (Map.toList $ _xhrResponse_headers xhr))
201 (Map.toList $ _xhrResponse_headers xhr))
234 (response r)
202 (response r)
235 in ffor r $ \a -> Headers {getResponse = a ,getHeadersHList = buildHeadersTo hdrs}
203 in ffor r $ \a -> Headers {getResponse = a ,getHeadersHList = buildHeadersTo hdrs}
238class BuildHeaderKeysTo hs where
205class BuildHeaderKeysTo hs where
239− buildHeaderKeysTo :: Proxy hs -> [CI.CI T.Text]
206+ buildHeaderKeysTo :: Proxy hs -> [T.Text]
241instance {-# OVERLAPPABLE #-} BuildHeaderKeysTo '[]
208instance {-# OVERLAPPABLE #-} BuildHeaderKeysTo '[]
242 where buildHeaderKeysTo _ = []
209 where buildHeaderKeysTo _ = []
244instance {-# OVERLAPPABLE #-} (BuildHeaderKeysTo xs, KnownSymbol h)
211instance {-# OVERLAPPABLE #-} (BuildHeaderKeysTo xs, KnownSymbol h)
245 => BuildHeaderKeysTo ((Header h v) ': xs) where
212 => BuildHeaderKeysTo ((Header h v) ': xs) where
246− buildHeaderKeysTo _ =
248− thisKey = CI.mk $ T.pack (symbolVal (Proxy :: Proxy h))
249− in thisKey : buildHeaderKeysTo (Proxy :: Proxy xs)
213+ buildHeaderKeysTo _ = T.pack (symbolVal (Proxy :: Proxy h)) : buildHeaderKeysTo (Proxy :: Proxy xs)
252-- HEADERS Verb (Content) --
215-- HEADERS Verb (Content) --
253-- Headers combinator not treated in fully general case,
216-- Headers combinator not treated in fully general case,
@@ -262,10 +225,10 @@ instance {-# OVERLAPPABLE #-}
262 ) => HasClient t m (Verb method status cts' (Headers ls a)) tag where
225 ) => HasClient t m (Verb method status cts' (Headers ls a)) tag where
263 type Client t m (Verb method status cts' (Headers ls a)) tag =
226 type Client t m (Verb method status cts' (Headers ls a)) tag =
264 Event t tag -> m (Event t (ReqResult tag (Headers ls a)))
227 Event t tag -> m (Event t (ReqResult tag (Headers ls a)))
265− clientWithRouteAndResultHandler Proxy _ _ req baseurl opts wrap trigs = do
228+ clientWithRoute Proxy _ _ req baseurl opts trigs = do
266 let method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
229 let method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
267 resp <- fmap runIdentity <$> performRequestsCT (Proxy :: Proxy ct) method (constDyn $ Identity req') baseurl opts trigs
230 resp <- fmap runIdentity <$> performRequestsCT (Proxy :: Proxy ct) method (constDyn $ Identity req') baseurl opts trigs
268− wrap $ toHeaders <$> resp
231+ return $ toHeaders <$> resp
269 where req' = req { respHeaders =
232 where req' = req { respHeaders =
270 OnlyHeaders (Set.fromList (buildHeaderKeysTo (Proxy :: Proxy ls)))
233 OnlyHeaders (Set.fromList (buildHeaderKeysTo (Proxy :: Proxy ls)))
@@ -278,10 +241,10 @@ instance {-# OVERLAPPABLE #-}
278 ) => HasClient t m (Verb method status cts (Headers ls NoContent)) tag where
241 ) => HasClient t m (Verb method status cts (Headers ls NoContent)) tag where
279 type Client t m (Verb method status cts (Headers ls NoContent)) tag
242 type Client t m (Verb method status cts (Headers ls NoContent)) tag
280 = Event t tag -> m (Event t (ReqResult tag (Headers ls NoContent)))
243 = Event t tag -> m (Event t (ReqResult tag (Headers ls NoContent)))
281− clientWithRouteAndResultHandler Proxy _ _ req baseurl opts wrap trigs = do
244+ clientWithRoute Proxy _ _ req baseurl opts trigs = do
282 let method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
245 let method = E.decodeUtf8 $ reflectMethod (Proxy :: Proxy method)
283 resp <- fmap runIdentity <$> performRequestsNoBody method (constDyn $ Identity req') baseurl opts trigs
246 resp <- fmap runIdentity <$> performRequestsNoBody method (constDyn $ Identity req') baseurl opts trigs
284− wrap $ toHeaders <$> resp
247+ return $ toHeaders <$> resp
285 where req' = req {respHeaders =
248 where req' = req {respHeaders =
286 OnlyHeaders (Set.fromList (buildHeaderKeysTo (Proxy :: Proxy ls)))
249 OnlyHeaders (Set.fromList (buildHeaderKeysTo (Proxy :: Proxy ls)))
@@ -308,11 +271,11 @@ instance (KnownSymbol sym, ToHttpApiData a,
308 type Client t m (Header sym a :> sublayout) tag =
271 type Client t m (Header sym a :> sublayout) tag =
309 Dynamic t (Either Text a) -> Client t m sublayout tag
272 Dynamic t (Either Text a) -> Client t m sublayout tag
311− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap eVal =
274+ clientWithRoute Proxy q t req baseurl opts eVal =
312− clientWithRouteAndResultHandler
313− (Proxy :: Proxy sublayout) q t
275+ clientWithRoute (Proxy :: Proxy sublayout)
314− (Servant.Common.Req.addHeader hname eVal req)
277+ (Servant.Common.Req.addHeader hname eVal req)
315− baseurl opts wrap
278+ baseurl opts
316 where hname = T.pack $ symbolVal (Proxy :: Proxy sym)
279 where hname = T.pack $ symbolVal (Proxy :: Proxy sym)
@@ -326,21 +289,8 @@ instance HasClient t m sublayout tag
326 type Client t m (HttpVersion :> sublayout) tag =
289 type Client t m (HttpVersion :> sublayout) tag =
327 Client t m sublayout tag
290 Client t m sublayout tag
329− clientWithRouteAndResultHandler Proxy =
292+ clientWithRoute Proxy q t =
330− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout)
293+ clientWithRoute (Proxy :: Proxy sublayout) q t
332−-- | Using a 'Summary' combinator in your API doesn't affect the client
334−instance (HasClient t m sublayout tag, KnownSymbol sym)
335− => HasClient t m (Summary sym :> sublayout) tag where
337− type Client t m (Summary sym :> sublayout) tag =
338− Client t m sublayout tag
340− clientWithRouteAndResultHandler Proxy =
341− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout)
346-- | If you use a 'QueryParam' in one of your endpoints in your API,
296-- | If you use a 'QueryParam' in one of your endpoints in your API,
@@ -376,9 +326,9 @@ instance (KnownSymbol sym, ToHttpApiData a, HasClient t m sublayout tag, Reflex
376 Dynamic t (QParam a) -> Client t m sublayout tag
326 Dynamic t (QParam a) -> Client t m sublayout tag
378 -- if mparam = Nothing, we don't add it to the query string
328 -- if mparam = Nothing, we don't add it to the query string
379− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap mparam =
329+ clientWithRoute Proxy q t req baseurl opts mparam =
380− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout) q t
330+ clientWithRoute (Proxy :: Proxy sublayout) q t
381− (req {qParams = paramPair : qParams req}) baseurl opts wrap
331+ (req {qParams = paramPair : qParams req}) baseurl opts
383 where pname = symbolVal (Proxy :: Proxy sym)
333 where pname = symbolVal (Proxy :: Proxy sym)
384 --p prm = QueryPartParam $ (fmap . fmap) (toQueryParam) prm
334 --p prm = QueryPartParam $ (fmap . fmap) (toQueryParam) prm
@@ -422,8 +372,8 @@ instance (KnownSymbol sym, ToHttpApiData a, HasClient t m sublayout tag, Reflex
422 type Client t m (QueryParams sym a :> sublayout) tag =
372 type Client t m (QueryParams sym a :> sublayout) tag =
423 Dynamic t [a] -> Client t m sublayout tag
373 Dynamic t [a] -> Client t m sublayout tag
425− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap paramlist =
375+ clientWithRoute Proxy q t req baseurl opts paramlist =
426− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout) q t req' baseurl opts wrap
376+ clientWithRoute (Proxy :: Proxy sublayout) q t req' baseurl opts
428 where req' = req { qParams = (T.pack pname, params') : qParams req }
378 where req' = req { qParams = (T.pack pname, params') : qParams req }
429 pname = symbolVal (Proxy :: Proxy sym)
379 pname = symbolVal (Proxy :: Proxy sym)
@@ -462,8 +412,8 @@ instance (KnownSymbol sym, HasClient t m sublayout tag, Reflex t)
462 type Client t m (QueryFlag sym :> sublayout) tag =
412 type Client t m (QueryFlag sym :> sublayout) tag =
463 Dynamic t Bool -> Client t m sublayout tag
413 Dynamic t Bool -> Client t m sublayout tag
465− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap flag =
415+ clientWithRoute Proxy q t req baseurl opts flag =
466− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout) q t req' baseurl opts wrap
416+ clientWithRoute (Proxy :: Proxy sublayout) q t req' baseurl opts
468 where req' = req { qParams = thisPair : qParams req }
418 where req' = req { qParams = thisPair : qParams req }
469 thisPair = (T.pack pName, QueryPartFlag flag) :: (Text, QueryPart t)
419 thisPair = (T.pack pName, QueryPartFlag flag) :: (Text, QueryPart t)
@@ -477,7 +427,7 @@ instance SupportsServantReflex t m => HasClient t m Raw tag where
477 -> Event t tag
427 -> Event t tag
478 -> m (Event t (ReqResult tag ()))
428 -> m (Event t (ReqResult tag ()))
480− clientWithRouteAndResultHandler _ _ _ _ baseurl _ wrap xhrs triggers = do
430+ clientWithRoute _ _ _ _ baseurl _ xhrs triggers = do
482 let xhrs' = liftA2 (\x path -> case x of
432 let xhrs' = liftA2 (\x path -> case x of
483 Left e -> Left e
433 Left e -> Left e
@@ -488,7 +438,7 @@ instance SupportsServantReflex t m => HasClient t m Raw tag where
488 okReq = fmapMaybe (\(t,x) -> either (const Nothing) (Just . (t,)) x) xhrs'' :: Event t (tag, XhrRequest ())
438 okReq = fmapMaybe (\(t,x) -> either (const Nothing) (Just . (t,)) x) xhrs'' :: Event t (tag, XhrRequest ())
490 resps <- performRequestsAsync okReq
440 resps <- performRequestsAsync okReq
491− wrap $ leftmost [ uncurry RequestFailure <$> badReq
441+ return $ leftmost [ uncurry RequestFailure <$> badReq
492 , evalResponse (const $ Right ()) <$> resps
442 , evalResponse (const $ Right ()) <$> resps
@@ -519,8 +469,8 @@ instance (MimeRender ct a, HasClient t m sublayout tag, Reflex t)
519 type Client t m (ReqBody (ct ': cts) a :> sublayout) tag =
469 type Client t m (ReqBody (ct ': cts) a :> sublayout) tag =
520 Dynamic t (Either Text a) -> Client t m sublayout tag
470 Dynamic t (Either Text a) -> Client t m sublayout tag
522− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap body =
472+ clientWithRoute Proxy q t req baseurl opts body =
523− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout) q t req' baseurl opts wrap
473+ clientWithRoute (Proxy :: Proxy sublayout) q t req' baseurl opts
524 where req' = req { reqBody = bodyBytesCT }
474 where req' = req { reqBody = bodyBytesCT }
525 ctProxy = Proxy :: Proxy ct
475 ctProxy = Proxy :: Proxy ct
526 ctString = T.pack $ show $ contentType ctProxy
476 ctString = T.pack $ show $ contentType ctProxy
@@ -534,9 +484,9 @@ instance (MimeRender ct a, HasClient t m sublayout tag, Reflex t)
534instance (KnownSymbol path, HasClient t m sublayout tag, Reflex t) => HasClient t m (path :> sublayout) tag where
484instance (KnownSymbol path, HasClient t m sublayout tag, Reflex t) => HasClient t m (path :> sublayout) tag where
535 type Client t m (path :> sublayout) tag = Client t m sublayout tag
485 type Client t m (path :> sublayout) tag = Client t m sublayout tag
537− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap =
487+ clientWithRoute Proxy q t req baseurl opts =
538− clientWithRouteAndResultHandler (Proxy :: Proxy sublayout) q t
488+ clientWithRoute (Proxy :: Proxy sublayout) q t
539− (prependToPathParts (pure (Right $ T.pack p)) req) baseurl opts wrap
489+ (prependToPathParts (pure (Right $ T.pack p)) req) baseurl opts
541 where p = symbolVal (Proxy :: Proxy path)
491 where p = symbolVal (Proxy :: Proxy path)
@@ -544,23 +494,23 @@ instance (KnownSymbol path, HasClient t m sublayout tag, Reflex t) => HasClient
544instance HasClient t m api tag => HasClient t m (Vault :> api) tag where
494instance HasClient t m api tag => HasClient t m (Vault :> api) tag where
545 type Client t m (Vault :> api) tag = Client t m api tag
495 type Client t m (Vault :> api) tag = Client t m api tag
547− clientWithRouteAndResultHandler Proxy =
497+ clientWithRoute Proxy q t req baseurl =
548− clientWithRouteAndResultHandler (Proxy :: Proxy api)
498+ clientWithRoute (Proxy :: Proxy api) q t req baseurl
551instance HasClient t m api tag => HasClient t m (RemoteHost :> api) tag where
501instance HasClient t m api tag => HasClient t m (RemoteHost :> api) tag where
552 type Client t m (RemoteHost :> api) tag = Client t m api tag
502 type Client t m (RemoteHost :> api) tag = Client t m api tag
554− clientWithRouteAndResultHandler Proxy =
504+ clientWithRoute Proxy q t req baseurl =
555− clientWithRouteAndResultHandler (Proxy :: Proxy api)
505+ clientWithRoute (Proxy :: Proxy api) q t req baseurl
559instance HasClient t m api tag => HasClient t m (IsSecure :> api) tag where
509instance HasClient t m api tag => HasClient t m (IsSecure :> api) tag where
560 type Client t m (IsSecure :> api) tag = Client t m api tag
510 type Client t m (IsSecure :> api) tag = Client t m api tag
562− clientWithRouteAndResultHandler Proxy =
512+ clientWithRoute Proxy q t req baseurl =
563− clientWithRouteAndResultHandler (Proxy :: Proxy api)
513+ clientWithRoute (Proxy :: Proxy api) q t req baseurl
566instance (HasClient t m api tag, Reflex t)
516instance (HasClient t m api tag, Reflex t)
@@ -569,8 +519,8 @@ instance (HasClient t m api tag, Reflex t)
569 type Client t m (BasicAuth realm usr :> api) tag = Dynamic t (Maybe BasicAuthData)
519 type Client t m (BasicAuth realm usr :> api) tag = Dynamic t (Maybe BasicAuthData)
570 -> Client t m api tag
520 -> Client t m api tag
572− clientWithRouteAndResultHandler Proxy q t req baseurl opts wrap authdata =
522+ clientWithRoute Proxy q t req baseurl opts authdata =
573− clientWithRouteAndResultHandler (Proxy :: Proxy api) q t req' baseurl opts wrap
523+ clientWithRoute (Proxy :: Proxy api) q t req' baseurl opts
575 req' = req { authData = Just authdata }
525 req' = req { authData = Just authdata }
@@ -613,7 +563,7 @@ for empty and one for non-empty lists).
613instance (HasCookieAuth auths, HasClient t m api tag) => HasClient t m (Auth.Auth auths a :> api) tag where
563instance (HasCookieAuth auths, HasClient t m api tag) => HasClient t m (Auth.Auth auths a :> api) tag where
615 type Client t m (Auth.Auth auths a :> api) tag = Client t m api tag
565 type Client t m (Auth.Auth auths a :> api) tag = Client t m api tag
616− clientWithRouteAndResultHandler Proxy = clientWithRouteAndResultHandler (Proxy :: Proxy api)
566+ clientWithRoute Proxy = clientWithRoute (Proxy :: Proxy api)
619type family HasCookieAuth xs :: Constraint where
569type family HasCookieAuth xs :: Constraint where
@@ -623,3 +573,136 @@ type family HasCookieAuth xs :: Constraint where
624class CookieAuthNotEnabled
574class CookieAuthNotEnabled
576+{- servant-checked-exceptions
577+~~~~~~~~~~~~~~~~~~~~~
580+-- | Change a 'Throws' into 'Throwing'.
581+instance (HasClient t m (Throwing '[e] :> api) tag) => HasClient t m (Throws e :> api) tag where
582+ type Client t m (Throws e :> api) tag = Client t m (Throwing '[e] :> api) tag
585+ :: Proxy (Throws e :> api)
589+ -> Dynamic t BaseUrl
591+ -> Client t m (Throwing '[e] :> api) tag
592+ clientWithRoute _ = clientWithRoute (Proxy :: Proxy (Throwing '[e] :> api))
594+-- | When @'Throwing' es@ comes before a 'Verb', change it into the same 'Verb'
595+-- but returning an @'Envelope' es@.
596+instance (HasClient t m (Verb method status ctypes (Envelope es a)) tag) =>
597+ HasClient t m (Throwing es :> Verb method status ctypes a) tag where
599+ type Client t m (Throwing es :> Verb method status ctypes a) tag =
600+ Client t m (Verb method status ctypes (Envelope es a)) tag
603+ :: Proxy (Throwing es :> Verb method status ctypes a)
607+ -> Dynamic t BaseUrl
609+ -> Client t m (Verb method status ctypes (Envelope es a)) tag
610+ clientWithRoute Proxy =
611+ clientWithRoute (Proxy :: Proxy (Verb method status ctypes (Envelope es a)))
613+-- | When 'NoThrow' comes before a 'Verb', change it into the same 'Verb'
614+-- but returning an @'Envelope' \'[]@.
615+instance (HasClient t m (Verb method status ctypes (Envelope '[] a)) tag) =>
616+ HasClient t m (NoThrow :> Verb method status ctypes a) tag where
618+ type Client t m (NoThrow :> Verb method status ctypes a) tag =
619+ Client t m (Verb method status ctypes (Envelope '[] a)) tag
622+ :: Proxy (NoThrow :> Verb method status ctypes a)
626+ -> Dynamic t BaseUrl
628+ -> Client t m (Verb method status ctypes (Envelope '[] a)) tag
629+ clientWithRoute Proxy =
630+ clientWithRoute (Proxy :: Proxy (Verb method status ctypes (Envelope '[] a)))
632+-- | When @'Throwing' es@ comes before ':<|>', push @'Throwing' es@ into each
633+-- branch of the API.
634+instance HasClient t m ((Throwing es :> api1) :<|> (Throwing es :> api2)) tag =>
635+ HasClient t m (Throwing es :> (api1 :<|> api2)) tag where
637+ type Client t m (Throwing es :> (api1 :<|> api2)) tag =
638+ Client t m ((Throwing es :> api1) :<|> (Throwing es :> api2)) tag
641+ :: Proxy (Throwing es :> (api1 :<|> api2))
645+ -> Dynamic t BaseUrl
647+ -> Client t m ((Throwing es :> api1) :<|> (Throwing es :> api2)) tag
649+ clientWithRoute (Proxy :: Proxy ((Throwing es :> api1) :<|> (Throwing es :> api2)))
651+-- | When 'NoThrow' comes before ':<|>', push 'NoThrow' into each branch of the
653+instance HasClient t m ((NoThrow :> api1) :<|> (NoThrow :> api2)) tag =>
654+ HasClient t m (NoThrow :> (api1 :<|> api2)) tag where
656+ type Client t m (NoThrow :> (api1 :<|> api2)) tag =
657+ Client t m ((NoThrow :> api1) :<|> (NoThrow :> api2)) tag
660+ :: Proxy (NoThrow :> (api1 :<|> api2))
664+ -> Dynamic t BaseUrl
666+ -> Client t m ((NoThrow :> api1) :<|> (NoThrow :> api2)) tag
668+ clientWithRoute (Proxy :: Proxy ((NoThrow :> api1) :<|> (NoThrow :> api2)))
670+-- | When a @'Throws' e@ comes immediately after a @'Throwing' es@, 'Snoc' the
671+-- @e@ onto the @es@. Otherwise, if @'Throws' e@ comes before any other
672+-- combinator, push it down so it is closer to the 'Verb'.
673+instance HasClient t m (ThrowingNonterminal (Throwing es :> api :> apis)) tag =>
674+ HasClient t m (Throwing es :> api :> apis) tag where
676+ type Client t m (Throwing es :> api :> apis) tag =
677+ Client t m (ThrowingNonterminal (Throwing es :> api :> apis)) tag
680+ :: Proxy (Throwing es :> api :> apis)
684+ -> Dynamic t BaseUrl
686+ -> Client t m (ThrowingNonterminal (Throwing es :> api :> apis)) tag
688+ clientWithRoute (Proxy :: Proxy (ThrowingNonterminal (Throwing es :> api :> apis)))
690+-- | When 'NoThrow' comes before any other combinator, push it down so it is
691+-- closer to the 'Verb'.
692+instance HasClient t m (api :> NoThrow :> apis) tag =>
693+ HasClient t m (NoThrow :> api :> apis) tag where
695+ type Client t m (NoThrow :> api :> apis) tag =
696+ Client t m (api :> NoThrow :> apis) tag
699+ :: Proxy (NoThrow :> api :> apis)
703+ -> Dynamic t BaseUrl
705+ -> Client t m (api :> NoThrow :> apis) tag
707+ clientWithRoute (Proxy :: Proxy (api :> NoThrow :> apis))