tock-mirror/pass/Pass.hs

208 lines
7.1 KiB
Haskell

{-
Tock: a compiler for parallel languages
Copyright (C) 2007 University of Kent
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program. If not, see <http://www.gnu.org/licenses/>.
-}
-- | Common definitions for passes over the AST.
module Pass where
import Control.Monad.Error
import Control.Monad.Reader
import Control.Monad.State
import Control.Monad.Writer
import Data.Generics
import Data.List
import qualified Data.Set as Set
import System.IO
import qualified AST as A
import CompState
import Errors
import Metadata
import PrettyShow
import TreeUtils
import Utils
-- | The monad in which AST-mangling passes operate.
-- The old monad stacks:
--type PassM = ErrorT ErrorReport (StateT CompState (WriterT [WarningReport] IO))
--type PassMR = ErrorT ErrorReport (ReaderT CompState (WriterT [WarningReport] IO))
newtype PassM a = PassMInternal { runPassM :: CompState -> IO (Either ErrorReport (a, CompState, [WarningReport])) }
newtype PassMR a = PassMRInternal { runPassMR :: CompState -> IO (Either ErrorReport (a, [WarningReport])) }
instance Monad PassM where
return x = PassMInternal $ \cs -> return (Right (x, cs, []))
m >>= b = PassMInternal $ \cs ->
do mresult <- runPassM m cs
case mresult of
Left err -> return $ Left err
Right (x, cs', w') ->
do bresult <- runPassM (b x) cs'
case bresult of
Left err -> return $ Left err
Right (x', cs'', w'') -> return $ Right (x', cs'', w' ++ w'')
instance Monad PassMR where
return x = PassMRInternal $ \cs -> return (Right (x, []))
m >>= b = PassMRInternal $ \cs ->
do mresult <- runPassMR m cs
case mresult of
Left err -> return $ Left err
Right (x, w') ->
do bresult <- runPassMR (b x) cs
case bresult of
Left err -> return $ Left err
Right (x', w'') -> return $ Right (x', w' ++ w'')
instance Die PassM where
dieReport err = PassMInternal $ const $ return $ Left err
instance Die PassMR where
dieReport err = PassMRInternal $ const $ return $ Left err
instance Warn PassM where
warnReport w = PassMInternal $ \cs -> return (Right ((), cs, [w]))
instance Warn PassMR where
warnReport w = PassMRInternal $ \cs -> return (Right ((), [w]))
instance MonadIO PassM where
liftIO a = PassMInternal $ \cs -> do a' <- a
return $ Right (a', cs, [])
instance MonadIO PassMR where
liftIO a = PassMRInternal $ const $ do a' <- a
return $ Right (a', [])
instance CSMR PassM where
getCompState = PassMInternal $ \cs -> return (Right (cs, cs, []))
instance CSMR PassMR where
getCompState = PassMRInternal $ \cs -> return (Right (cs, []))
instance MonadState CompState PassM where
get = getCompState
put cs = PassMInternal $ const $ return (Right ((), cs, []))
-- | The type of an AST-mangling pass.
data Monad m => Pass_ m = Pass {
passCode :: A.AST -> m A.AST
,passName :: String
,passPre :: Set.Set Property
,passPost :: Set.Set Property
,passEnabled :: CompState -> Bool
}
instance Monad m => Eq (Pass_ m) where
x == y = passName x == passName y
instance Monad m => Ord (Pass_ m) where
compare x y = compare (passName x) (passName y)
type Pass = Pass_ PassM
type PassR = Pass_ PassMR
data Property = Property {
propName :: String
,propCheck :: A.AST -> PassMR ()
}
instance Eq Property where
x == y = propName x == propName y
instance Ord Property where
compare x y = compare (propName x) (propName y)
runPassR :: (A.AST -> PassMR A.AST) -> (A.AST -> PassM A.AST)
runPassR p t = PassMInternal $ \cs -> do result <- runPassMR (p t) cs
case result of
Left err -> return $ Left err
Right (t', w) -> return $ Right (t', cs, w)
makePassesDep :: [(String, A.AST -> PassM A.AST, [Property], [Property])] -> [Pass]
makePassesDep = map (\(s, p, pre, post) -> Pass p s (Set.fromList pre) (Set.fromList post) (const True))
makePassesDep' :: (CompState -> Bool) -> [(String, A.AST -> PassM A.AST, [Property], [Property])] -> [Pass]
makePassesDep' f = map (\(s, p, pre, post) -> Pass p s (Set.fromList pre) (Set.fromList post) f)
-- | Compose a list of passes into a single pass by running them in the order given.
runPasses :: [Pass] -> (A.AST -> PassM A.AST)
runPasses [] ast = return ast
runPasses (p:ps) ast
= do debug $ "{{{ " ++ passName p
progress $ "- " ++ passName p
ast' <- passCode p ast
debugAST ast'
debug $ "}}}"
runPasses ps ast'
-- | Print a message if above the given verbosity level.
verboseMessage :: (CSM m, MonadIO m) => Int -> String -> m ()
verboseMessage n s
= do ps <- get
when (csVerboseLevel ps >= n) $
liftIO $ hPutStrLn stderr s
-- | Print a progress message.
progress :: (CSM m, MonadIO m) => String -> m ()
progress = verboseMessage 1
-- | Print a debugging message.
debug :: (CSM m, MonadIO m) => String -> m ()
debug = verboseMessage 2
-- | Print a really verbose debugging message.
veryDebug :: (CSM m, MonadIO m) => String -> m ()
veryDebug = verboseMessage 3
-- | Dump the AST and parse state.
debugAST :: (CSM m, MonadIO m, Data t) => t -> m ()
debugAST p
= do veryDebug $ "{{{ AST"
veryDebug $ pshow p
veryDebug $ "}}}"
veryDebug $ "{{{ State"
ps <- get
veryDebug $ pshow ps
veryDebug $ "}}}"
applyToOnly :: (Monad m, Data a) => (a -> m a) -> A.Structured a -> m (A.Structured a)
applyToOnly f (A.Rep m r s) = applyToOnly f s >>* A.Rep m r
applyToOnly f (A.Spec m sp s) = applyToOnly f s >>* A.Spec m sp
applyToOnly f (A.ProcThen m p s) = applyToOnly f s >>* A.ProcThen m p
applyToOnly f (A.Several m ss) = mapM (applyToOnly f) ss >>* A.Several m
applyToOnly f (A.Only m o) = f o >>* A.Only m
-- | Make a generic rule for a pass.
makeGeneric :: forall m t. (Data t, Monad m) => (forall s. Data s => s -> m s) -> t -> m t
makeGeneric top
= (gmapM top)
`extM` (return :: String -> m String)
`extM` (return :: Meta -> m Meta)
excludeConstr :: (Data a, CSMR m) => [Constr] -> a -> m a
excludeConstr cons x
= if null items then return x else dieInternal (Nothing, "Excluded item still remains in source tree: " ++ (show $ head items) ++ " tree is: " ++ pshow x)
where
items = checkTreeForConstr cons x
mk1M :: (Monad m, Data a, Typeable1 t) => (forall d . Data d => t d -> m (t d)) -> a -> m a
mk1M = ext1M return