-- | -- Most of the code is borrowed from -- . -- Therefor, credits go to Paul Johnson and Felix Martini. module Test.QuickCheck.GenT ( GenT (GenT, unGenT), runGenT, MonadGen (liftGen, variant, sized, resize, choose), var, suchThat, suchThatMaybe, listOf, listOf1, vectorOf, oneof, frequency, elements, growingElements, oneofMay, elementsMay, growingElementsMay, ) where import qualified Test.QuickCheck.Gen as QC import qualified Test.QuickCheck.Random as QC import qualified System.Random as Random import Test.QuickCheck.GenT.Private (GenT(..)) import Control.Applicative (Applicative, (<$>)) import Data.Maybe (fromMaybe) runGenT :: GenT m a -> QC.Gen (m a) runGenT (GenT run) = QC.MkGen run class (Applicative g, Monad g) => MonadGen g where liftGen :: QC.Gen a -> g a variant :: Integral n => n -> g a -> g a sized :: (Int -> g a) -> g a resize :: Int -> g a -> g a choose :: Random.Random a => (a, a) -> g a instance (Applicative m, Monad m) => MonadGen (GenT m) where liftGen gen = GenT $ \r n -> return $ QC.unGen gen r n choose rng = GenT $ \r _ -> return $ fst $ Random.randomR rng r variant k (GenT g) = GenT $ \r n -> g (var k r) n sized f = GenT $ \r n -> let GenT g = f n in g r n resize n (GenT g) = GenT $ \r _ -> g r n instance MonadGen QC.Gen where liftGen = id variant k (QC.MkGen g) = QC.MkGen $ \r n -> g (var k r) n sized f = QC.MkGen $ \r n -> let QC.MkGen g = f n in g r n resize n (QC.MkGen g) = QC.MkGen $ \r _ -> g r n choose range = QC.MkGen $ \r _ -> fst $ Random.randomR range r -- | -- Private variant-generating function. Converts an integer into a chain -- of (fst . split) and (snd . split) applications. Every integer (including -- negative ones) will give rise to a different random number generator in -- log2 n steps. var :: Integral n => n -> QC.QCGen -> QC.QCGen var k = (if k == k' then id else var k') . (if even k then fst else snd) . Random.split where k' = k `div` 2 -------------------------------------------------------------------------- -- ** Common generator combinators -- | Generates a value that satisfies a predicate. suchThat :: MonadGen m => m a -> (a -> Bool) -> m a gen `suchThat` p = do mx <- gen `suchThatMaybe` p case mx of Just x -> return x Nothing -> sized (\n -> resize (n+1) (gen `suchThat` p)) -- | Tries to generate a value that satisfies a predicate. suchThatMaybe :: MonadGen m => m a -> (a -> Bool) -> m (Maybe a) gen `suchThatMaybe` p = sized (try 0 . max 1) where try _ 0 = return Nothing try k n = do x <- resize (2*k+n) gen if p x then return (Just x) else try (k+1) (n-1) -- | Generates a list of random length. The maximum length depends on the -- size parameter. listOf :: MonadGen m => m a -> m [a] listOf gen = sized $ \n -> do k <- choose (0,n) vectorOf k gen -- | Generates a non-empty list of random length. The maximum length -- depends on the size parameter. listOf1 :: MonadGen m => m a -> m [a] listOf1 gen = sized $ \n -> do k <- choose (1,1 `max` n) vectorOf k gen -- | Generates a list of the given length. vectorOf :: MonadGen m => Int -> m a -> m [a] vectorOf k gen = sequence [ gen | _ <- [1..k] ] -- * Partial functions ------------------------- -- | Randomly uses one of the given generators. The input list -- must be non-empty. oneof :: MonadGen m => [m a] -> m a oneof = fmap (fromMaybe (error "QuickCheck.GenT.oneof used with empty list")) . oneofMay -- | Chooses one of the given generators, with a weighted random distribution. -- The input list must be non-empty. frequency :: MonadGen m => [(Int, m a)] -> m a frequency [] = error "QuickCheck.GenT.frequency used with empty list" frequency xs0 = choose (1, tot) >>= (`pick` xs0) where tot = sum (map fst xs0) pick n ((k,x):xs) | n <= k = x | otherwise = pick (n-k) xs pick _ _ = error "QuickCheck.GenT.pick used with empty list" -- | Generates one of the given values. The input list must be non-empty. elements :: MonadGen m => [a] -> m a elements = fmap (fromMaybe (error "QuickCheck.GenT.elements used with empty list")) . elementsMay -- | Takes a list of elements of increasing size, and chooses -- among an initial segment of the list. The size of this initial -- segment increases with the size parameter. -- The input list must be non-empty. growingElements :: MonadGen m => [a] -> m a growingElements = fmap (fromMaybe (error "QuickCheck.GenT.growingElements used with empty list")) . growingElementsMay -- * Non-partial functions resulting in Maybe ------------------------- -- | -- Randomly uses one of the given generators. oneofMay :: MonadGen m => [m a] -> m (Maybe a) oneofMay as = case as of [] -> return Nothing l -> fmap Just $ choose (0, length l - 1) >>= (l !!) -- | Generates one of the given values. elementsMay :: MonadGen m => [a] -> m (Maybe a) elementsMay as = case as of [] -> return Nothing l -> Just . (l !!) <$> choose (0, length l - 1) -- | Takes a list of elements of increasing size, and chooses -- among an initial segment of the list. The size of this initial -- segment increases with the size parameter. growingElementsMay :: MonadGen m => [a] -> m (Maybe a) growingElementsMay as = case as of [] -> return Nothing xs -> fmap Just $ sized $ \n -> elements (take (1 `max` size n) xs) where k = length xs mx = 100 log' = round . log . (id :: Double -> Double) . fromIntegral size n = (log' n + 1) * k `div` log' mx