1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200
|
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE ScopedTypeVariables #-}
{-# LANGUAGE GADTs #-}
{-# LANGUAGE CPP #-}
{-# LANGUAGE FlexibleContexts #-}
{-# LANGUAGE TupleSections #-}
-- |
-- Module: Utils
-- Copyright: Copyright © 2014 AlephCloud Systems, Inc.
-- License: BSD3
-- Maintainer: Lars Kuhtz <lars@alephcloud.com>
-- Stability: experimental
--
-- Utils for Tests for Haskell AWS bindints
--
module Utils
(
-- * Parameters
testDataPrefix
-- * General Utils
, sshow
, mustFail
, tryT
, retryT
, retryT_
, testData
, evalTestT
, evalTestTM
, eitherTOnceTest0
, eitherTOnceTest1
, eitherTOnceTest2
-- * Generic Tests
, test_jsonRoundtrip
, prop_jsonRoundtrip
) where
import Control.Concurrent (threadDelay)
import qualified Control.Exception.Lifted as LE
import Control.Error hiding (syncIO)
import Control.Monad
import Control.Monad.Identity
import Control.Monad.IO.Class
import Control.Monad.Base
import Control.Monad.Trans.Control
import Control.Applicative
import Data.Monoid
import Prelude
import Data.Aeson (FromJSON, ToJSON, encode, eitherDecode)
import Data.Dynamic (Dynamic)
import Data.Proxy
import Data.String
import qualified Data.Text as T
import qualified Data.Text.IO as T
import Data.Typeable
import Test.QuickCheck.Property
import Test.QuickCheck.Monadic
import Test.Tasty
import Test.Tasty.QuickCheck
import System.Exit (ExitCode)
import System.IO (stderr)
import Data.Time.Clock.POSIX (getPOSIXTime)
-- -------------------------------------------------------------------------- --
-- Static Test parameters
--
-- | This prefix is used for the IDs and names of all entities that are
-- created in the AWS account.
--
testDataPrefix :: IsString a => MonadBase IO m => m a
testDataPrefix = do
t <- liftBase $ getPOSIXTime
let t' :: Int
t' = floor (t * 1000)
return . fromString $ "__TEST_AWSHASKELLBINDINGS__" ++ show t'
-- -------------------------------------------------------------------------- --
-- General Utils
-- | Catches all exceptions except for asynchronous exceptions found in base.
--
tryT :: MonadBaseControl IO m => m a -> ExceptT T.Text m a
tryT = fmapLT (T.pack . show) . syncIO
-- | Lifted Version of 'syncIO' form "Control.Error.Util".
--
syncIO :: MonadBaseControl IO m => m a -> ExceptT LE.SomeException m a
syncIO a = ExceptT $ LE.catches (Right <$> a)
[ LE.Handler $ \e -> LE.throw (e :: LE.ArithException)
, LE.Handler $ \e -> LE.throw (e :: LE.ArrayException)
, LE.Handler $ \e -> LE.throw (e :: LE.AssertionFailed)
, LE.Handler $ \e -> LE.throw (e :: LE.AsyncException)
, LE.Handler $ \e -> LE.throw (e :: LE.BlockedIndefinitelyOnMVar)
, LE.Handler $ \e -> LE.throw (e :: LE.BlockedIndefinitelyOnSTM)
, LE.Handler $ \e -> LE.throw (e :: LE.Deadlock)
, LE.Handler $ \e -> LE.throw (e :: Dynamic)
, LE.Handler $ \e -> LE.throw (e :: LE.ErrorCall)
, LE.Handler $ \e -> LE.throw (e :: ExitCode)
, LE.Handler $ \e -> LE.throw (e :: LE.NestedAtomically)
, LE.Handler $ \e -> LE.throw (e :: LE.NoMethodError)
, LE.Handler $ \e -> LE.throw (e :: LE.NonTermination)
, LE.Handler $ \e -> LE.throw (e :: LE.PatternMatchFail)
, LE.Handler $ \e -> LE.throw (e :: LE.RecConError)
, LE.Handler $ \e -> LE.throw (e :: LE.RecSelError)
, LE.Handler $ \e -> LE.throw (e :: LE.RecUpdError)
, LE.Handler $ return . Left
]
testData :: (IsString a, Monoid a, MonadBaseControl IO m) => a -> m a
testData a = fmap (<> a) testDataPrefix
retryT :: (Functor m, MonadIO m) => Int -> ExceptT T.Text m a -> ExceptT T.Text m a
retryT n f = snd <$> retryT_ n f
retryT_ :: (Functor m, MonadIO m) => Int -> ExceptT T.Text m a -> ExceptT T.Text m (Int, a)
retryT_ n f = go 1
where
go x
| x >= n = fmapLT (\e -> "error after " <> sshow x <> " retries: " <> e) ((x,) <$> f)
| otherwise = ((x,) <$> f) `catchE` \e -> do
liftIO $ T.hPutStrLn stderr $ "Retrying after error: " <> e
liftIO $ threadDelay (1000000 * min 60 (2^(x-1)))
go (succ x)
sshow :: (Show a, IsString b) => a -> b
sshow = fromString . show
mustFail :: Monad m => ExceptT e m a -> ExceptT T.Text m ()
mustFail = ExceptT . exceptT
(const . return $ Right ())
(const . return $ Left "operation succeeded when a failure was expected")
evalTestTM
:: Functor f
=> String -- ^ test name
-> f (ExceptT T.Text IO a) -- ^ test
-> f (PropertyM IO Bool)
evalTestTM name = fmap $
(liftIO . runExceptT) >=> \r -> case r of
Left e ->
fail $ "failed to run test \"" <> name <> "\": " <> show e
Right _ -> return True
evalTestT
:: String -- ^ test name
-> ExceptT T.Text IO a -- ^ test
-> PropertyM IO Bool
evalTestT name = runIdentity . evalTestTM name . Identity
eitherTOnceTest0
:: String -- ^ test name
-> ExceptT T.Text IO a -- ^ test
-> TestTree
eitherTOnceTest0 name test = testProperty name . once . monadicIO
$ evalTestT name test
eitherTOnceTest1
:: (Arbitrary a, Show a)
=> String -- ^ test name
-> (a -> ExceptT T.Text IO b)
-> TestTree
eitherTOnceTest1 name test = testProperty name . once $ monadicIO
. evalTestTM name test
eitherTOnceTest2
:: (Arbitrary a, Show a, Arbitrary b, Show b)
=> String -- ^ test name
-> (a -> b -> ExceptT T.Text IO c)
-> TestTree
eitherTOnceTest2 name test = testProperty name . once $ \a b -> monadicIO
$ (evalTestTM name $ uncurry test) (a, b)
-- -------------------------------------------------------------------------- --
-- Generic Tests
test_jsonRoundtrip
:: forall a . (Eq a, Show a, FromJSON a, ToJSON a, Typeable a, Arbitrary a)
=> Proxy a
-> TestTree
test_jsonRoundtrip proxy = testProperty msg (prop_jsonRoundtrip :: a -> Property)
where
msg = "JSON roundtrip for " <> show typ
#if MIN_VERSION_base(4,7,0)
typ = typeRep proxy
#else
typ = typeOf (undefined :: a)
#endif
prop_jsonRoundtrip :: forall a . (Eq a, Show a, FromJSON a, ToJSON a) => a -> Property
prop_jsonRoundtrip a = either (const $ property False) (\(b :: [a]) -> [a] === b) $
eitherDecode $ encode [a]
|