pooled-io-0.0.2.2: Run jobs on a limited number of threads and support data dependencies

Safe HaskellNone
LanguageHaskell98

Control.Concurrent.PooledIO.InOrder

Synopsis

Documentation

data T a Source #

Instances
Monad T Source # 
Instance details

Defined in Control.Concurrent.PooledIO.InOrder

Methods

(>>=) :: T a -> (a -> T b) -> T b #

(>>) :: T a -> T b -> T b #

return :: a -> T a #

fail :: String -> T a #

Functor T Source # 
Instance details

Defined in Control.Concurrent.PooledIO.InOrder

Methods

fmap :: (a -> b) -> T a -> T b #

(<$) :: a -> T b -> T a #

Applicative T Source # 
Instance details

Defined in Control.Concurrent.PooledIO.InOrder

Methods

pure :: a -> T a #

(<*>) :: T (a -> b) -> T a -> T b #

liftA2 :: (a -> b -> c) -> T a -> T b -> T c #

(*>) :: T a -> T b -> T b #

(<*) :: T a -> T b -> T a #

run :: T a -> IO a Source #

runLimited with a maximum of numCapabilites threads.

runLimited :: Int -> T a -> IO a Source #

runLimited n runs several actions in a pool with at most n threads.

fork :: NFData a => IO a -> T a Source #

fork runs an IO action in parallel while respecting a maximum number of threads. Evaluating the result of T waits for the termination of the according thread.

Unfortunately, this means that sometimes threads are bored:

foo a b = do
   c <- fork $ f a
   d <- fork $ g c
   e <- fork $ h b

Here the execution of g c reserves a thread but starts with waiting for the evaluation of c. It would be certainly better to execute h b first. You may relax this problem by moving dependent actions away from another as much as possible. It would be optimal to have an OutOfOrder monad, but this is more difficult to implement.

Although we fork all actions in order, the fork itself might re-order the actions. Thus the actions must not rely on a particular order other than the order imposed by data dependencies. We enforce with the NFData constraint that the computation is actually completed when the thread terminates.

Currently the monad does not handle exceptions. It's certainly best to use a package with explicit exception handling like explicit-exception in order to tunnel exception information from the forked action to the main thread.

Although fork has almost the same type signature as liftIO we do not define instance MonadIO InOrder.T since this definition would not satisfy the laws required by the MonadIO class.