control-monad-free-0.6.1: Free monads and monad transformers

Safe HaskellSafe
LanguageHaskell98

Control.Monad.Free

Contents

Synopsis

Documentation

Free Monads

class (Functor f, Monad m) => MonadFree f m where Source #

This type class generalizes over encodings of Free Monads.

Minimal complete definition

free, wrap

Methods

free Source #

Arguments

:: m a 
-> m (Either a (f (m a)))

Opens a computation and allows to observe the side effects

wrap Source #

Arguments

:: f (m a) 
-> m a

Wraps a side effect into a monadic computation

Instances
Functor f => MonadFree f (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

free :: Free f a -> Free f (Either a (f (Free f a))) Source #

wrap :: f (Free f a) -> Free f a Source #

(Monad m, Functor f) => MonadFree f (C (FreeT f m)) Source # 
Instance details

Defined in Control.Monad.Free.Improve

Methods

free :: C (FreeT f m) a -> C (FreeT f m) (Either a (f (C (FreeT f m) a))) Source #

wrap :: f (C (FreeT f m) a) -> C (FreeT f m) a Source #

Functor f => MonadFree f (C (Free f)) Source # 
Instance details

Defined in Control.Monad.Free.Improve

Methods

free :: C (Free f) a -> C (Free f) (Either a (f (C (Free f) a))) Source #

wrap :: f (C (Free f) a) -> C (Free f) a Source #

(Functor f, Monad m) => MonadFree f (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

free :: FreeT f m a -> FreeT f m (Either a (f (FreeT f m a))) Source #

wrap :: f (FreeT f m a) -> FreeT f m a Source #

data Free f a Source #

Constructors

Impure (f (Free f a)) 
Pure a 
Instances
Functor f => MonadFree f (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

free :: Free f a -> Free f (Either a (f (Free f a))) Source #

wrap :: f (Free f a) -> Free f a Source #

Functor f => MonadFree f (C (Free f)) Source # 
Instance details

Defined in Control.Monad.Free.Improve

Methods

free :: C (Free f) a -> C (Free f) (Either a (f (C (Free f) a))) Source #

wrap :: f (C (Free f) a) -> C (Free f) a Source #

Functor f => Monad (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

(>>=) :: Free f a -> (a -> Free f b) -> Free f b #

(>>) :: Free f a -> Free f b -> Free f b #

return :: a -> Free f a #

fail :: String -> Free f a #

Functor f => Functor (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

fmap :: (a -> b) -> Free f a -> Free f b #

(<$) :: a -> Free f b -> Free f a #

Functor f => Applicative (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

pure :: a -> Free f a #

(<*>) :: Free f (a -> b) -> Free f a -> Free f b #

liftA2 :: (a -> b -> c) -> Free f a -> Free f b -> Free f c #

(*>) :: Free f a -> Free f b -> Free f b #

(<*) :: Free f a -> Free f b -> Free f a #

(Functor f, Foldable f) => Foldable (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

fold :: Monoid m => Free f m -> m #

foldMap :: Monoid m => (a -> m) -> Free f a -> m #

foldr :: (a -> b -> b) -> b -> Free f a -> b #

foldr' :: (a -> b -> b) -> b -> Free f a -> b #

foldl :: (b -> a -> b) -> b -> Free f a -> b #

foldl' :: (b -> a -> b) -> b -> Free f a -> b #

foldr1 :: (a -> a -> a) -> Free f a -> a #

foldl1 :: (a -> a -> a) -> Free f a -> a #

toList :: Free f a -> [a] #

null :: Free f a -> Bool #

length :: Free f a -> Int #

elem :: Eq a => a -> Free f a -> Bool #

maximum :: Ord a => Free f a -> a #

minimum :: Ord a => Free f a -> a #

sum :: Num a => Free f a -> a #

product :: Num a => Free f a -> a #

Traversable f => Traversable (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

traverse :: Applicative f0 => (a -> f0 b) -> Free f a -> f0 (Free f b) #

sequenceA :: Applicative f0 => Free f (f0 a) -> f0 (Free f a) #

mapM :: Monad m => (a -> m b) -> Free f a -> m (Free f b) #

sequence :: Monad m => Free f (m a) -> m (Free f a) #

Eq1 f => Eq1 (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

(==#) :: Eq a => Free f a -> Free f a -> Bool #

Ord1 f => Ord1 (Free f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

compare1 :: Ord a => Free f a -> Free f a -> Ordering #

(Eq a, Eq1 f) => Eq (Free f a) Source # 
Instance details

Defined in Control.Monad.Free

Methods

(==) :: Free f a -> Free f a -> Bool #

(/=) :: Free f a -> Free f a -> Bool #

(Ord a, Ord1 f) => Ord (Free f a) Source # 
Instance details

Defined in Control.Monad.Free

Methods

compare :: Free f a -> Free f a -> Ordering #

(<) :: Free f a -> Free f a -> Bool #

(<=) :: Free f a -> Free f a -> Bool #

(>) :: Free f a -> Free f a -> Bool #

(>=) :: Free f a -> Free f a -> Bool #

max :: Free f a -> Free f a -> Free f a #

min :: Free f a -> Free f a -> Free f a #

(Show a, Show1 f) => Show (Free f a) Source # 
Instance details

Defined in Control.Monad.Free

Methods

showsPrec :: Int -> Free f a -> ShowS #

show :: Free f a -> String #

showList :: [Free f a] -> ShowS #

Generic (Free f a) Source # 
Instance details

Defined in Control.Monad.Free

Associated Types

type Rep (Free f a) :: * -> * #

Methods

from :: Free f a -> Rep (Free f a) x #

to :: Rep (Free f a) x -> Free f a #

type Rep (Free f a) Source # 
Instance details

Defined in Control.Monad.Free

type Rep (Free f a) = D1 (MetaData "Free" "Control.Monad.Free" "control-monad-free-0.6.1-64fD2vBsrr9nRjiHlGguM" False) (C1 (MetaCons "Impure" PrefixI False) (S1 (MetaSel (Nothing :: Maybe Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 (f (Free f a)))) :+: C1 (MetaCons "Pure" PrefixI False) (S1 (MetaSel (Nothing :: Maybe Symbol) NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 a)))

isPure :: Free f a -> Bool Source #

foldFree :: Functor f => (a -> b) -> (f b -> b) -> Free f a -> b Source #

evalFree :: (a -> b) -> (f (Free f a) -> b) -> Free f a -> b Source #

mapFree :: (Functor f, Functor g) => (f (Free g a) -> g (Free g a)) -> Free f a -> Free g a Source #

mapFreeM :: (Traversable f, Functor g, Monad m) => (f (Free g a) -> m (g (Free g a))) -> Free f a -> m (Free g a) Source #

mapFreeM' :: (Functor f, Traversable g, Monad m) => (forall a. f a -> m (g a)) -> Free f a -> m (Free g a) Source #

Monad Morphisms

foldFreeM :: (Traversable f, Monad m) => (a -> m b) -> (f b -> m b) -> Free f a -> m b Source #

induce :: (Functor f, Monad m) => (forall a. f a -> m a) -> Free f a -> m a Source #

Free Monad Transformers

newtype FreeT f m a Source #

Constructors

FreeT 

Fields

Instances
(Monad m, Functor f) => MonadFree f (C (FreeT f m)) Source # 
Instance details

Defined in Control.Monad.Free.Improve

Methods

free :: C (FreeT f m) a -> C (FreeT f m) (Either a (f (C (FreeT f m) a))) Source #

wrap :: f (C (FreeT f m) a) -> C (FreeT f m) a Source #

(Functor f, Monad m) => MonadFree f (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

free :: FreeT f m a -> FreeT f m (Either a (f (FreeT f m a))) Source #

wrap :: f (FreeT f m a) -> FreeT f m a Source #

Functor f => MonadTrans (FreeT f) Source # 
Instance details

Defined in Control.Monad.Free

Methods

lift :: Monad m => m a -> FreeT f m a #

(Functor f, Monad m) => Monad (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

(>>=) :: FreeT f m a -> (a -> FreeT f m b) -> FreeT f m b #

(>>) :: FreeT f m a -> FreeT f m b -> FreeT f m b #

return :: a -> FreeT f m a #

fail :: String -> FreeT f m a #

(Functor f, Functor m) => Functor (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

fmap :: (a -> b) -> FreeT f m a -> FreeT f m b #

(<$) :: a -> FreeT f m b -> FreeT f m a #

(Functor f, Functor a, Monad a) => Applicative (FreeT f a) Source # 
Instance details

Defined in Control.Monad.Free

Methods

pure :: a0 -> FreeT f a a0 #

(<*>) :: FreeT f a (a0 -> b) -> FreeT f a a0 -> FreeT f a b #

liftA2 :: (a0 -> b -> c) -> FreeT f a a0 -> FreeT f a b -> FreeT f a c #

(*>) :: FreeT f a a0 -> FreeT f a b -> FreeT f a b #

(<*) :: FreeT f a a0 -> FreeT f a b -> FreeT f a a0 #

(Traversable m, Traversable f) => Foldable (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

fold :: Monoid m0 => FreeT f m m0 -> m0 #

foldMap :: Monoid m0 => (a -> m0) -> FreeT f m a -> m0 #

foldr :: (a -> b -> b) -> b -> FreeT f m a -> b #

foldr' :: (a -> b -> b) -> b -> FreeT f m a -> b #

foldl :: (b -> a -> b) -> b -> FreeT f m a -> b #

foldl' :: (b -> a -> b) -> b -> FreeT f m a -> b #

foldr1 :: (a -> a -> a) -> FreeT f m a -> a #

foldl1 :: (a -> a -> a) -> FreeT f m a -> a #

toList :: FreeT f m a -> [a] #

null :: FreeT f m a -> Bool #

length :: FreeT f m a -> Int #

elem :: Eq a => a -> FreeT f m a -> Bool #

maximum :: Ord a => FreeT f m a -> a #

minimum :: Ord a => FreeT f m a -> a #

sum :: Num a => FreeT f m a -> a #

product :: Num a => FreeT f m a -> a #

(Traversable m, Traversable f) => Traversable (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

traverse :: Applicative f0 => (a -> f0 b) -> FreeT f m a -> f0 (FreeT f m b) #

sequenceA :: Applicative f0 => FreeT f m (f0 a) -> f0 (FreeT f m a) #

mapM :: Monad m0 => (a -> m0 b) -> FreeT f m a -> m0 (FreeT f m b) #

sequence :: Monad m0 => FreeT f m (m0 a) -> m0 (FreeT f m a) #

(Functor f, Monad m, MonadIO m) => MonadIO (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

liftIO :: IO a -> FreeT f m a #

(Functor f, Functor m, Monad m, MonadPlus m) => Alternative (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

empty :: FreeT f m a #

(<|>) :: FreeT f m a -> FreeT f m a -> FreeT f m a #

some :: FreeT f m a -> FreeT f m [a] #

many :: FreeT f m a -> FreeT f m [a] #

(Functor f, Monad m, MonadPlus m) => MonadPlus (FreeT f m) Source # 
Instance details

Defined in Control.Monad.Free

Methods

mzero :: FreeT f m a #

mplus :: FreeT f m a -> FreeT f m a -> FreeT f m a #

foldFreeT :: (Traversable f, Monad m) => (a -> m b) -> (f b -> m b) -> FreeT f m a -> m b Source #

foldFreeT' :: (Traversable f, Monad m) => (a -> b) -> (f b -> b) -> FreeT f m a -> m b Source #

mapFreeT :: (Functor f, Functor m) => (forall a. m a -> m' a) -> FreeT f m a -> FreeT f m' a Source #

foldFreeA :: (Traversable f, Applicative m) => (a -> m b) -> m (f b -> b) -> Free f a -> m b Source #

mapFreeA :: (Traversable f, Functor g, Applicative m) => m (f (Free g a) -> g (Free g a)) -> Free f a -> m (Free g a) Source #

Translate between Free monad and Free monad transformer computations

trans :: MonadFree f m => Free f a -> m a Source #

trans' :: (Functor f, Monad m) => m (Free f a) -> FreeT f m a Source #

untrans :: (Traversable f, Monad m) => FreeT f m a -> m (Free f a) Source #

liftFree :: (Functor f, Monad m) => (a -> Free f b) -> a -> FreeT f m b Source #