{-# LANGUAGE DeriveFunctor         #-}
{-# LANGUAGE FlexibleInstances     #-}
{-# LANGUAGE MultiParamTypeClasses #-}
{-# LANGUAGE TypeFamilies          #-}
{-# LANGUAGE UndecidableInstances  #-}
module Servant.Server.Internal.RouteResult where

import           Control.Monad
                 (ap, liftM)
import           Control.Monad.Base
                 (MonadBase (..))
import           Control.Monad.Catch
                 (MonadThrow (..))
import           Control.Monad.Trans
                 (MonadIO (..), MonadTrans (..))
import           Control.Monad.Trans.Control
                 (ComposeSt, MonadBaseControl (..), MonadTransControl (..),
                 defaultLiftBaseWith, defaultRestoreM)

import           Servant.Server.Internal.ServerError

-- | The result of matching against a path in the route tree.
data RouteResult a =
    Fail ServerError           -- ^ Keep trying other paths.
                               --   The 'ServantError' should only be 404, 405 or 406.
  | FailFatal !ServerError     -- ^ Don't try other paths.
  | Route !a
  deriving (RouteResult a -> RouteResult a -> Bool
(RouteResult a -> RouteResult a -> Bool)
-> (RouteResult a -> RouteResult a -> Bool) -> Eq (RouteResult a)
forall a. Eq a => RouteResult a -> RouteResult a -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
$c== :: forall a. Eq a => RouteResult a -> RouteResult a -> Bool
== :: RouteResult a -> RouteResult a -> Bool
$c/= :: forall a. Eq a => RouteResult a -> RouteResult a -> Bool
/= :: RouteResult a -> RouteResult a -> Bool
Eq, Int -> RouteResult a -> ShowS
[RouteResult a] -> ShowS
RouteResult a -> String
(Int -> RouteResult a -> ShowS)
-> (RouteResult a -> String)
-> ([RouteResult a] -> ShowS)
-> Show (RouteResult a)
forall a. Show a => Int -> RouteResult a -> ShowS
forall a. Show a => [RouteResult a] -> ShowS
forall a. Show a => RouteResult a -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
$cshowsPrec :: forall a. Show a => Int -> RouteResult a -> ShowS
showsPrec :: Int -> RouteResult a -> ShowS
$cshow :: forall a. Show a => RouteResult a -> String
show :: RouteResult a -> String
$cshowList :: forall a. Show a => [RouteResult a] -> ShowS
showList :: [RouteResult a] -> ShowS
Show, ReadPrec [RouteResult a]
ReadPrec (RouteResult a)
Int -> ReadS (RouteResult a)
ReadS [RouteResult a]
(Int -> ReadS (RouteResult a))
-> ReadS [RouteResult a]
-> ReadPrec (RouteResult a)
-> ReadPrec [RouteResult a]
-> Read (RouteResult a)
forall a. Read a => ReadPrec [RouteResult a]
forall a. Read a => ReadPrec (RouteResult a)
forall a. Read a => Int -> ReadS (RouteResult a)
forall a. Read a => ReadS [RouteResult a]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
$creadsPrec :: forall a. Read a => Int -> ReadS (RouteResult a)
readsPrec :: Int -> ReadS (RouteResult a)
$creadList :: forall a. Read a => ReadS [RouteResult a]
readList :: ReadS [RouteResult a]
$creadPrec :: forall a. Read a => ReadPrec (RouteResult a)
readPrec :: ReadPrec (RouteResult a)
$creadListPrec :: forall a. Read a => ReadPrec [RouteResult a]
readListPrec :: ReadPrec [RouteResult a]
Read, (forall a b. (a -> b) -> RouteResult a -> RouteResult b)
-> (forall a b. a -> RouteResult b -> RouteResult a)
-> Functor RouteResult
forall a b. a -> RouteResult b -> RouteResult a
forall a b. (a -> b) -> RouteResult a -> RouteResult b
forall (f :: * -> *).
(forall a b. (a -> b) -> f a -> f b)
-> (forall a b. a -> f b -> f a) -> Functor f
$cfmap :: forall a b. (a -> b) -> RouteResult a -> RouteResult b
fmap :: forall a b. (a -> b) -> RouteResult a -> RouteResult b
$c<$ :: forall a b. a -> RouteResult b -> RouteResult a
<$ :: forall a b. a -> RouteResult b -> RouteResult a
Functor)

instance Applicative RouteResult where
    pure :: forall a. a -> RouteResult a
pure = a -> RouteResult a
forall a. a -> RouteResult a
forall (m :: * -> *) a. Monad m => a -> m a
return
    <*> :: forall a b. RouteResult (a -> b) -> RouteResult a -> RouteResult b
(<*>) = RouteResult (a -> b) -> RouteResult a -> RouteResult b
forall (m :: * -> *) a b. Monad m => m (a -> b) -> m a -> m b
ap

instance Monad RouteResult where
    return :: forall a. a -> RouteResult a
return = a -> RouteResult a
forall a. a -> RouteResult a
Route
    Route a
a     >>= :: forall a b. RouteResult a -> (a -> RouteResult b) -> RouteResult b
>>= a -> RouteResult b
f = a -> RouteResult b
f a
a
    Fail ServerError
e      >>= a -> RouteResult b
_ = ServerError -> RouteResult b
forall a. ServerError -> RouteResult a
Fail ServerError
e
    FailFatal ServerError
e >>= a -> RouteResult b
_ = ServerError -> RouteResult b
forall a. ServerError -> RouteResult a
FailFatal ServerError
e

newtype RouteResultT m a = RouteResultT { forall (m :: * -> *) a. RouteResultT m a -> m (RouteResult a)
runRouteResultT :: m (RouteResult a) }
  deriving ((forall a b. (a -> b) -> RouteResultT m a -> RouteResultT m b)
-> (forall a b. a -> RouteResultT m b -> RouteResultT m a)
-> Functor (RouteResultT m)
forall a b. a -> RouteResultT m b -> RouteResultT m a
forall a b. (a -> b) -> RouteResultT m a -> RouteResultT m b
forall (m :: * -> *) a b.
Functor m =>
a -> RouteResultT m b -> RouteResultT m a
forall (m :: * -> *) a b.
Functor m =>
(a -> b) -> RouteResultT m a -> RouteResultT m b
forall (f :: * -> *).
(forall a b. (a -> b) -> f a -> f b)
-> (forall a b. a -> f b -> f a) -> Functor f
$cfmap :: forall (m :: * -> *) a b.
Functor m =>
(a -> b) -> RouteResultT m a -> RouteResultT m b
fmap :: forall a b. (a -> b) -> RouteResultT m a -> RouteResultT m b
$c<$ :: forall (m :: * -> *) a b.
Functor m =>
a -> RouteResultT m b -> RouteResultT m a
<$ :: forall a b. a -> RouteResultT m b -> RouteResultT m a
Functor)

instance MonadTrans RouteResultT where
    lift :: forall (m :: * -> *) a. Monad m => m a -> RouteResultT m a
lift = m (RouteResult a) -> RouteResultT m a
forall (m :: * -> *) a. m (RouteResult a) -> RouteResultT m a
RouteResultT (m (RouteResult a) -> RouteResultT m a)
-> (m a -> m (RouteResult a)) -> m a -> RouteResultT m a
forall b c a. (b -> c) -> (a -> b) -> a -> c
. (a -> RouteResult a) -> m a -> m (RouteResult a)
forall (m :: * -> *) a1 r. Monad m => (a1 -> r) -> m a1 -> m r
liftM a -> RouteResult a
forall a. a -> RouteResult a
Route

instance (Functor m, Monad m) => Applicative (RouteResultT m) where
    pure :: forall a. a -> RouteResultT m a
pure  = a -> RouteResultT m a
forall a. a -> RouteResultT m a
forall (m :: * -> *) a. Monad m => a -> m a
return
    <*> :: forall a b.
RouteResultT m (a -> b) -> RouteResultT m a -> RouteResultT m b
(<*>) = RouteResultT m (a -> b) -> RouteResultT m a -> RouteResultT m b
forall (m :: * -> *) a b. Monad m => m (a -> b) -> m a -> m b
ap

instance Monad m => Monad (RouteResultT m) where
    return :: forall a. a -> RouteResultT m a
return = m (RouteResult a) -> RouteResultT m a
forall (m :: * -> *) a. m (RouteResult a) -> RouteResultT m a
RouteResultT (m (RouteResult a) -> RouteResultT m a)
-> (a -> m (RouteResult a)) -> a -> RouteResultT m a
forall b c a. (b -> c) -> (a -> b) -> a -> c
. RouteResult a -> m (RouteResult a)
forall a. a -> m a
forall (m :: * -> *) a. Monad m => a -> m a
return (RouteResult a -> m (RouteResult a))
-> (a -> RouteResult a) -> a -> m (RouteResult a)
forall b c a. (b -> c) -> (a -> b) -> a -> c
. a -> RouteResult a
forall a. a -> RouteResult a
Route
    RouteResultT m a
m >>= :: forall a b.
RouteResultT m a -> (a -> RouteResultT m b) -> RouteResultT m b
>>= a -> RouteResultT m b
k = m (RouteResult b) -> RouteResultT m b
forall (m :: * -> *) a. m (RouteResult a) -> RouteResultT m a
RouteResultT (m (RouteResult b) -> RouteResultT m b)
-> m (RouteResult b) -> RouteResultT m b
forall a b. (a -> b) -> a -> b
$ do
        RouteResult a
a <- RouteResultT m a -> m (RouteResult a)
forall (m :: * -> *) a. RouteResultT m a -> m (RouteResult a)
runRouteResultT RouteResultT m a
m
        case RouteResult a
a of
            Fail ServerError
e      -> RouteResult b -> m (RouteResult b)
forall a. a -> m a
forall (m :: * -> *) a. Monad m => a -> m a
return (RouteResult b -> m (RouteResult b))
-> RouteResult b -> m (RouteResult b)
forall a b. (a -> b) -> a -> b
$ ServerError -> RouteResult b
forall a. ServerError -> RouteResult a
Fail ServerError
e
            FailFatal ServerError
e -> RouteResult b -> m (RouteResult b)
forall a. a -> m a
forall (m :: * -> *) a. Monad m => a -> m a
return (RouteResult b -> m (RouteResult b))
-> RouteResult b -> m (RouteResult b)
forall a b. (a -> b) -> a -> b
$ ServerError -> RouteResult b
forall a. ServerError -> RouteResult a
FailFatal ServerError
e
            Route a
b     -> RouteResultT m b -> m (RouteResult b)
forall (m :: * -> *) a. RouteResultT m a -> m (RouteResult a)
runRouteResultT (a -> RouteResultT m b
k a
b)

instance MonadIO m => MonadIO (RouteResultT m) where
    liftIO :: forall a. IO a -> RouteResultT m a
liftIO = m a -> RouteResultT m a
forall (m :: * -> *) a. Monad m => m a -> RouteResultT m a
forall (t :: (* -> *) -> * -> *) (m :: * -> *) a.
(MonadTrans t, Monad m) =>
m a -> t m a
lift (m a -> RouteResultT m a)
-> (IO a -> m a) -> IO a -> RouteResultT m a
forall b c a. (b -> c) -> (a -> b) -> a -> c
. IO a -> m a
forall a. IO a -> m a
forall (m :: * -> *) a. MonadIO m => IO a -> m a
liftIO

instance MonadBase b m => MonadBase b (RouteResultT m) where
    liftBase :: forall α. b α -> RouteResultT m α
liftBase = m α -> RouteResultT m α
forall (m :: * -> *) a. Monad m => m a -> RouteResultT m a
forall (t :: (* -> *) -> * -> *) (m :: * -> *) a.
(MonadTrans t, Monad m) =>
m a -> t m a
lift (m α -> RouteResultT m α)
-> (b α -> m α) -> b α -> RouteResultT m α
forall b c a. (b -> c) -> (a -> b) -> a -> c
. b α -> m α
forall α. b α -> m α
forall (b :: * -> *) (m :: * -> *) α. MonadBase b m => b α -> m α
liftBase

instance MonadBaseControl b m => MonadBaseControl b (RouteResultT m) where
    type StM (RouteResultT m) a = ComposeSt RouteResultT m a
    liftBaseWith :: forall a. (RunInBase (RouteResultT m) b -> b a) -> RouteResultT m a
liftBaseWith = (RunInBaseDefault RouteResultT m b -> b a) -> RouteResultT m a
(RunInBase (RouteResultT m) b -> b a) -> RouteResultT m a
forall (t :: (* -> *) -> * -> *) (b :: * -> *) (m :: * -> *) a.
(MonadTransControl t, MonadBaseControl b m) =>
(RunInBaseDefault t m b -> b a) -> t m a
defaultLiftBaseWith
    restoreM :: forall a. StM (RouteResultT m) a -> RouteResultT m a
restoreM     = ComposeSt RouteResultT m a -> RouteResultT m a
StM (RouteResultT m) a -> RouteResultT m a
forall (t :: (* -> *) -> * -> *) (b :: * -> *) (m :: * -> *) a.
(MonadTransControl t, MonadBaseControl b m) =>
ComposeSt t m a -> t m a
defaultRestoreM

instance MonadTransControl RouteResultT where
    type StT RouteResultT a = RouteResult a
    liftWith :: forall (m :: * -> *) a.
Monad m =>
(Run RouteResultT -> m a) -> RouteResultT m a
liftWith Run RouteResultT -> m a
f = m (RouteResult a) -> RouteResultT m a
forall (m :: * -> *) a. m (RouteResult a) -> RouteResultT m a
RouteResultT (m (RouteResult a) -> RouteResultT m a)
-> m (RouteResult a) -> RouteResultT m a
forall a b. (a -> b) -> a -> b
$ (a -> RouteResult a) -> m a -> m (RouteResult a)
forall (m :: * -> *) a1 r. Monad m => (a1 -> r) -> m a1 -> m r
liftM a -> RouteResult a
forall a. a -> RouteResult a
forall (m :: * -> *) a. Monad m => a -> m a
return (m a -> m (RouteResult a)) -> m a -> m (RouteResult a)
forall a b. (a -> b) -> a -> b
$ Run RouteResultT -> m a
f RouteResultT n b -> n (StT RouteResultT b)
RouteResultT n b -> n (RouteResult b)
Run RouteResultT
forall (m :: * -> *) a. RouteResultT m a -> m (RouteResult a)
runRouteResultT
    restoreT :: forall (m :: * -> *) a.
Monad m =>
m (StT RouteResultT a) -> RouteResultT m a
restoreT = m (StT RouteResultT a) -> RouteResultT m a
m (RouteResult a) -> RouteResultT m a
forall (m :: * -> *) a. m (RouteResult a) -> RouteResultT m a
RouteResultT

instance MonadThrow m => MonadThrow (RouteResultT m) where
    throwM :: forall e a. (HasCallStack, Exception e) => e -> RouteResultT m a
throwM = m a -> RouteResultT m a
forall (m :: * -> *) a. Monad m => m a -> RouteResultT m a
forall (t :: (* -> *) -> * -> *) (m :: * -> *) a.
(MonadTrans t, Monad m) =>
m a -> t m a
lift (m a -> RouteResultT m a) -> (e -> m a) -> e -> RouteResultT m a
forall b c a. (b -> c) -> (a -> b) -> a -> c
. e -> m a
forall e a. (HasCallStack, Exception e) => e -> m a
forall (m :: * -> *) e a.
(MonadThrow m, HasCallStack, Exception e) =>
e -> m a
throwM