zeolite-lang-0.9.0.0: src/Module/ProcessMetadata.hs
{- -----------------------------------------------------------------------------
Copyright 2020 Kevin P. Barry
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
----------------------------------------------------------------------------- -}
-- Author: Kevin P. Barry [ta0kira@gmail.com]
module Module.ProcessMetadata (
MetadataMap,
createCachePath,
eraseCachedData,
findSourceFiles,
getCachedPath,
getCacheRelativePath,
getExprMap,
getIncludePathsForDeps,
getLinkFlagsForDeps,
getNamespacesForDeps,
getObjectFilesForDeps,
getObjectFileResolver,
getRealPathsForDeps,
getSourceFilesForDeps,
isPathConfigured,
isPathUpToDate,
loadModuleGlobals,
loadModuleMetadata,
loadPrivateDeps,
loadPublicDeps,
loadRecompile,
loadTestingDeps,
mapMetadata,
resolveCategoryDeps,
resolveObjectDeps,
sortCompiledFiles,
writeCachedFile,
writeMetadata,
writeRecompile,
) where
import Control.Applicative ((<|>))
import Control.Monad (when)
import Data.List (isSuffixOf)
import Data.Maybe (isJust)
import System.Directory
import System.FilePath
import System.IO
import Text.Parsec (SourcePos)
import qualified Data.Map as Map
import qualified Data.Set as Set
import Base.CompileError
import Base.CompileInfo
import Cli.CompileOptions
import Cli.Programs (VersionHash(..))
import Compilation.ProcedureContext (ExprMap)
import CompilerCxx.Category (CxxOutput(..))
import Module.CompileMetadata
import Module.ParseMetadata -- Not safe, due to Text.Regex.TDFA.
import Module.Paths
import Parser.SourceFile
import Types.Pragma
import Types.Procedure (Expression(Literal),ValueLiteral(..))
import Types.TypeCategory
import Types.TypeInstance
cachedDataPath :: FilePath
cachedDataPath = ".zeolite-cache"
moduleFilename :: FilePath
moduleFilename = ".zeolite-module"
metadataFilename :: FilePath
metadataFilename = "compile-metadata"
type MetadataMap = Map.Map FilePath CompileMetadata
mapMetadata :: [CompileMetadata] -> MetadataMap
mapMetadata cs = Map.fromList $ zip (map cmPath cs) cs
loadRecompile :: FilePath -> CompileInfoIO ModuleConfig
loadRecompile p = do
let f = p </> moduleFilename
isFile <- errorFromIO $ doesFileExist p
when isFile $ compileErrorM $ "Path \"" ++ p ++ "\" is not a directory"
isDir <- errorFromIO $ doesDirectoryExist p
when (not isDir) $ compileErrorM $ "Path \"" ++ p ++ "\" does not exist"
filePresent <- errorFromIO $ doesFileExist f
when (not filePresent) $ compileErrorM $ "Module \"" ++ p ++ "\" has not been configured yet"
c <- errorFromIO $ readFile f
(autoReadConfig f c) <!!
("Could not parse metadata from \"" ++ p ++ "\"; please reconfigure")
isPathUpToDate :: VersionHash -> ForceMode -> FilePath -> CompileInfoIO Bool
isPathUpToDate h f p = do
m <- errorFromIO $ toCompileInfo $ loadDepsCommon f h Map.empty Set.empty (\m2 -> cmPublicDeps m2 ++ cmPrivateDeps m2) [p]
return $ not $ isCompileError m
isPathConfigured :: FilePath -> FilePath -> CompileInfoIO Bool
isPathConfigured p d = do
m <- errorFromIO $ toCompileInfo $ loadRecompile (p </> d)
return $ not $ isCompileError m
writeMetadata :: FilePath -> CompileMetadata -> CompileInfoIO ()
writeMetadata p m = do
p' <- errorFromIO $ canonicalizePath p
errorFromIO $ hPutStrLn stderr $ "Writing metadata for \"" ++ p' ++ "\"."
m' <- autoWriteConfig m <?? ("In data for " ++ p)
writeCachedFile p' "" metadataFilename m'
writeRecompile :: FilePath -> ModuleConfig -> CompileInfoIO ()
writeRecompile p m = do
p' <- errorFromIO $ canonicalizePath p
let f = p </> moduleFilename
errorFromIO $ hPutStrLn stderr $ "Updating config for \"" ++ p' ++ "\"."
m' <- autoWriteConfig m <?? ("In data for " ++ p)
errorFromIO $ writeFile f m'
eraseCachedData :: FilePath -> CompileInfoIO ()
eraseCachedData p = do
let d = p </> cachedDataPath
dirExists <- errorFromIO $ doesDirectoryExist d
when dirExists $ errorFromIO $ removeDirectoryRecursive d
createCachePath :: FilePath -> CompileInfoIO ()
createCachePath p = do
let f = p </> cachedDataPath
exists <- errorFromIO $ doesDirectoryExist f
when (not exists) $ errorFromIO $ createDirectoryIfMissing False f
writeCachedFile :: FilePath -> String -> FilePath -> String -> CompileInfoIO ()
writeCachedFile p ns f c = do
createCachePath p
errorFromIO $ createDirectoryIfMissing False $ p </> cachedDataPath </> ns
errorFromIO $ writeFile (getCachedPath p ns f) c
getCachedPath :: FilePath -> String -> FilePath -> FilePath
getCachedPath p ns f = fixPath $ p </> cachedDataPath </> ns </> f
getCacheRelativePath :: FilePath -> FilePath
getCacheRelativePath f = ".." </> f
findSourceFiles :: FilePath -> FilePath -> CompileInfoIO ([FilePath],[FilePath],[FilePath])
findSourceFiles p0 p = do
let absolute = p0 </> p
isFile <- errorFromIO $ doesFileExist absolute
when isFile $ compileErrorM $ "Path \"" ++ absolute ++ "\" is not a directory"
isDir <- errorFromIO $ doesDirectoryExist absolute
when (not isDir) $ compileErrorM $ "Path \"" ++ absolute ++ "\" does not exist"
ds <- errorFromIO $ getDirectoryContents absolute >>= return . map (p </>)
let ps = filter (isSuffixOf ".0rp") ds
let xs = filter (isSuffixOf ".0rx") ds
let ts = filter (isSuffixOf ".0rt") ds
return (ps,xs,ts)
getExprMap :: FilePath -> ModuleConfig -> CompileInfoIO (ExprMap SourcePos)
getExprMap p m = do
path <- errorFromIO $ canonicalizePath (p </> mcRoot m </> mcPath m)
let defaults = [("MODULE_PATH",Literal (StringLiteral [] path))]
return $ Map.fromList $ mcExprMap m ++ defaults
getRealPathsForDeps :: [CompileMetadata] -> [FilePath]
getRealPathsForDeps = map cmPath
getSourceFilesForDeps :: [CompileMetadata] -> [FilePath]
getSourceFilesForDeps = concat . map extract where
extract m = map (cmPath m </>) (cmPublicFiles m)
getNamespacesForDeps :: [CompileMetadata] -> [Namespace]
getNamespacesForDeps = filter (not . isNoNamespace) . map cmPublicNamespace
getIncludePathsForDeps :: [CompileMetadata] -> [FilePath]
getIncludePathsForDeps = concat . map cmPublicSubdirs
getLinkFlagsForDeps :: [CompileMetadata] -> [String]
getLinkFlagsForDeps = concat . map cmLinkFlags
getObjectFilesForDeps :: [CompileMetadata] -> [ObjectFile]
getObjectFilesForDeps = concat . map cmObjectFiles
loadModuleMetadata :: VersionHash -> ForceMode -> MetadataMap -> FilePath ->
CompileInfoIO CompileMetadata
loadModuleMetadata h f ca = fmap head . loadDepsCommon f h ca Set.empty (const []) . (:[])
loadPublicDeps :: VersionHash -> ForceMode -> MetadataMap -> [FilePath] ->
CompileInfoIO [CompileMetadata]
loadPublicDeps h f ca = loadDepsCommon f h ca Set.empty cmPublicDeps
loadTestingDeps :: VersionHash -> ForceMode -> MetadataMap -> CompileMetadata ->
CompileInfoIO [CompileMetadata]
loadTestingDeps h f ca m = loadDepsCommon f h ca (Set.fromList [cmPath m]) cmPublicDeps (cmPublicDeps m ++ cmPrivateDeps m)
loadPrivateDeps :: VersionHash -> ForceMode -> MetadataMap -> [CompileMetadata] ->
CompileInfoIO [CompileMetadata]
loadPrivateDeps h f ca ms = do
new <- loadDepsCommon f h ca pa (\m -> cmPublicDeps m ++ cmPrivateDeps m) paths
return $ ms ++ new where
paths = concat $ map (\m -> cmPublicDeps m ++ cmPrivateDeps m) ms
pa = Set.fromList $ map cmPath ms
loadDepsCommon :: ForceMode -> VersionHash -> MetadataMap -> Set.Set FilePath ->
(CompileMetadata -> [FilePath]) -> [FilePath] -> CompileInfoIO [CompileMetadata]
loadDepsCommon f h ca pa0 getDeps ps = do
(_,processed) <- fixedPaths >>= collect (pa0,[])
let cached = Map.union ca (Map.fromList processed)
mapErrorsM (check cached) processed where
enforce = f /= ForceAll
fixedPaths = mapM (errorFromIO . canonicalizePath) ps
collect xa@(pa,xs) (p:ps2)
| p `Set.member` pa = collect xa ps2
| otherwise = do
let continue m ds = collect (p `Set.insert` pa,xs ++ [(p,m)]) (ps2 ++ ds)
case p `Map.lookup` ca of
Just m2 -> continue m2 []
Nothing -> do
errorFromIO $ hPutStrLn stderr $ "Loading metadata for dependency \"" ++ p ++ "\"."
m2 <- loadMetadata ca p
let ds = getDeps m2
continue m2 ds
collect xa _ = return xa
check cm (p,m)
| p `Map.member` ca = return m
| otherwise = do
p' <- errorFromIO $ canonicalizePath p
when (cmPath m /= p') $
compileErrorM $ "Module \"" ++ p ++ "\" has an invalid cache path and must be recompiled"
fresh <- errorFromIO $ toCompileInfo $ checkModuleFreshness h cm p m <!!
("Module \"" ++ p ++ "\" is out of date and should be recompiled")
if enforce
then fromCompileInfo fresh
else asCompileWarnings fresh
return m
loadMetadata :: MetadataMap -> FilePath -> CompileInfoIO CompileMetadata
loadMetadata ca p = do
path <- errorFromIO $ canonicalizePath p
case path `Map.lookup` ca of
Just cm -> return cm
Nothing -> do
let f = p </> cachedDataPath </> metadataFilename
isFile <- errorFromIO $ doesFileExist p
when isFile $ compileErrorM $ "Path \"" ++ p ++ "\" is not a directory"
isDir <- errorFromIO $ doesDirectoryExist p
when (not isDir) $ compileErrorM $ "Path \"" ++ p ++ "\" does not exist"
filePresent <- errorFromIO $ doesFileExist f
when (not filePresent) $ compileErrorM $ "Module \"" ++ p ++ "\" has not been compiled yet"
c <- errorFromIO $ readFile f
(autoReadConfig f c) <!!
("Could not parse metadata from \"" ++ p ++ "\"; please recompile")
sortCompiledFiles :: [FilePath] -> ([FilePath],[FilePath],[FilePath])
sortCompiledFiles = foldl split ([],[],[]) where
split fs@(hxx,cxx,os) f
| isSuffixOf ".hpp" f = (hxx++[f],cxx,os)
| isSuffixOf ".h" f = (hxx++[f],cxx,os)
| isSuffixOf ".cpp" f = (hxx,cxx++[f],os)
| isSuffixOf ".cc" f = (hxx,cxx++[f],os)
| isSuffixOf ".a" f = (hxx,cxx,os++[f])
| isSuffixOf ".o" f = (hxx,cxx,os++[f])
| otherwise = fs
checkModuleVersionHash :: VersionHash -> CompileMetadata -> Bool
checkModuleVersionHash h m = cmVersionHash m == h
checkModuleFreshness :: VersionHash -> MetadataMap -> FilePath -> CompileMetadata -> CompileInfoIO ()
checkModuleFreshness h ca p m@(CompileMetadata _ p2 _ _ is is2 _ _ _ _ ps xs ts hxx cxx bs _ os) = do
time <- errorFromIO $ getModificationTime $ getCachedPath p "" metadataFilename
(ps2,xs2,ts2) <- findSourceFiles p ""
let rs = Set.toList $ Set.fromList $ concat $ map getRequires os
collectAllM_ $ [
checkHash,
checkInput time (p </> moduleFilename),
checkMissing ps ps2,
checkMissing xs xs2,
checkMissing ts ts2
] ++
(map (checkDep time) $ is ++ is2) ++
(map (checkInput time . (p2 </>)) $ ps ++ xs) ++
(map (checkInput time . getCachedPath p2 "") $ hxx ++ cxx) ++
(map checkOutput bs) ++
(map checkObject os) ++
(map checkRequire rs)
where
checkHash =
when (not $ checkModuleVersionHash h m) $
compileErrorM $ "Module \"" ++ p ++ "\" was compiled with a different compiler setup"
checkInput time f = do
exists <- doesFileOrDirExist f
when (not exists) $ compileErrorM $ "Required path \"" ++ f ++ "\" is missing"
time2 <- errorFromIO $ getModificationTime f
when (time2 > time) $ compileErrorM $ "Required path \"" ++ f ++ "\" is newer than cached data"
checkOutput f = do
exists <- errorFromIO $ doesFileExist f
when (not exists) $ compileErrorM $ "Output file \"" ++ f ++ "\" is missing"
checkDep time dep = do
cm <- loadMetadata ca dep
mapErrorsM_ (checkInput time . (cmPath cm </>)) $ cmPublicFiles cm
checkObject (CategoryObjectFile _ _ fs) = mapErrorsM_ checkOutput fs
checkObject (OtherObjectFile f) = checkOutput f
getRequires (CategoryObjectFile _ rs _) = rs
getRequires _ = []
checkRequire (CategoryIdentifier d c ns) = do
cm <- loadMetadata ca d
when (cmPath cm /= p2 && ns /= cmPublicNamespace cm) $
compileErrorM $ "Required category " ++ show c ++ " is newer than cached data"
checkRequire (UnresolvedCategory c) =
compileErrorM $ "Required category " ++ show c ++ " is unresolved"
checkMissing s0 s1 = do
let missing = Set.toList $ Set.fromList s1 `Set.difference` Set.fromList s0
mapErrorsM_ (\f -> compileErrorM $ "Required path \"" ++ f ++ "\" has not been compiled") missing
doesFileOrDirExist f2 = do
existF <- errorFromIO $ doesFileExist f2
if existF
then return True
else errorFromIO $ doesDirectoryExist f2
getObjectFileResolver :: [ObjectFile] -> [Namespace] -> [CategoryName] -> [FilePath]
getObjectFileResolver os ns ds = resolved ++ nonCategories where
categories = filter isCategoryObjectFile os
nonCategories = map oofFile $ filter (not . isCategoryObjectFile) os
categoryMap = Map.fromList $ map keyByCategory2 categories
keyByCategory2 o = ((ciCategory $ cofCategory o,ciNamespace $ cofCategory o),o)
objectMap = Map.fromList $ map keyBySpec categories
keyBySpec o = (cofCategory o,o)
directDeps = concat $ map resolveDep2 ds
directResolved = map cofCategory directDeps
resolveDep2 d = unwrap $ foldl (<|>) Nothing allChecks <|> Just [] where
allChecks = map (\n -> (d,n) `Map.lookup` categoryMap >>= return . (:[])) (ns ++ [NoNamespace])
unwrap (Just xs) = xs
unwrap _ = []
(_,_,resolved) = collectAll Set.empty Set.empty directResolved
collectAll ca fa [] = (ca,fa,[])
collectAll ca fa (c:cs)
| c `Set.member` ca = collectAll ca fa cs
| otherwise =
case c `Map.lookup` objectMap of
Just (CategoryObjectFile _ ds2 fs) -> (ca',fa'',fs') where
(ca',fa',fs0) = collectAll (c `Set.insert` ca) fa (ds2 ++ cs)
fa'' = fa' `Set.union` (Set.fromList fs)
fs' = (filter (not . flip elem fa') fs) ++ fs0
_ -> collectAll ca fa cs
resolveObjectDeps :: [CompileMetadata] -> FilePath -> FilePath -> [([FilePath],CxxOutput)] -> [ObjectFile]
resolveObjectDeps deps p d os = resolvedCategories ++ nonCategories where
categories = filter (isJust . coCategory . snd) os
publicNamespaces = getNamespacesForDeps deps
nonCategories = map OtherObjectFile $ concat $ map fst $ filter (not . isJust . coCategory . snd) os
resolvedCategories = Map.elems $ Map.fromListWith mergeObjectFiles $ map resolveCategory categories
categoryMap = Map.fromList $ directCategories ++ depCategories
directCategories = map (keyByCategory . cxxToId) $ map snd categories
depCategories = map keyByCategory $ concat (map categoriesToIds deps)
getCats dep = zip (cmPublicCategories dep) (repeat $ cmPublicNamespace dep) ++
-- Allow ModuleOnly when the path is the same. Only needed for tests.
-- TODO: The path comparison here is sloppy.
(if cmPath dep == p then zip (cmPrivateCategories dep) (repeat $ cmPrivateNamespace dep) else [])
categoriesToIds dep = map (uncurry $ CategoryIdentifier $ cmPath dep) $ getCats dep
cxxToId (CxxOutput (Just c) _ ns _ _ _) = CategoryIdentifier d c ns
cxxToId _ = undefined
resolveCategory (fs,ca@(CxxOutput _ _ _ ns2 ds _)) =
(cxxToId ca,CategoryObjectFile (cxxToId ca) (filter (/= cxxToId ca) rs) fs) where
rs = concat $ map (resolveDep categoryMap (ns2 ++ publicNamespaces)) ds
resolveCategoryDeps :: [CategoryName] -> [CompileMetadata] -> [CategoryIdentifier]
resolveCategoryDeps cs deps = resolvedCategories where
publicNamespaces = getNamespacesForDeps deps
resolvedCategories = concat $ map (resolveDep categoryMap publicNamespaces) cs
categoryMap = Map.fromList depCategories
depCategories = map (keyByCategory . cofCategory) $ filter isCategoryObjectFile $ concat $ map cmObjectFiles deps
keyByCategory :: CategoryIdentifier -> ((CategoryName,Namespace),CategoryIdentifier)
keyByCategory c = ((ciCategory c,ciNamespace c),c)
resolveDep :: Map.Map (CategoryName,Namespace) CategoryIdentifier ->
[Namespace] -> CategoryName -> [CategoryIdentifier]
resolveDep cm (n:ns) d =
case (d,n) `Map.lookup` cm of
Just xs -> [xs]
Nothing -> resolveDep cm ns d
resolveDep _ _ d = [UnresolvedCategory d]
loadModuleGlobals :: PathIOHandler r => r -> FilePath -> (Namespace,Namespace) -> [FilePath] ->
Maybe CompileMetadata -> [CompileMetadata] -> [CompileMetadata] ->
CompileInfoIO ([WithVisibility (AnyCategory SourcePos)])
loadModuleGlobals r p (ns0,ns1) fs m deps1 deps2 = do
let public = Set.fromList $ map cmPath deps1
let deps2' = filter (\cm -> not $ cmPath cm `Set.member` public) deps2
cs0 <- fmap concat $ mapErrorsM (processDeps False [FromDependency]) deps1
cs1 <- fmap concat $ mapErrorsM (processDeps False [FromDependency,ModuleOnly]) deps2'
cs2 <- loadAllPublic (ns0,ns1) fs
cs3 <- case m of
Just m2 -> processDeps True [FromDependency] m2
_ -> return []
return (cs0++cs1++cs2++cs3) where
processDeps same ss dep = do
let fs2 = getSourceFilesForDeps [dep]
cs <- loadAllPublic (cmPublicNamespace dep,cmPrivateNamespace dep) fs2
let cs' = if not same
-- Allow ModuleOnly if the dep is the same module being
-- compiled. (Tests load the module being tested as a dep.)
then filter (not . hasCodeVisibility ModuleOnly) cs
else cs
return $ map (updateCodeVisibility (Set.union (Set.fromList ss))) cs'
loadAllPublic (ns2,ns3) fs2 = do
fs2' <- zipWithContents r p fs2
fmap concat $ mapErrorsM loadPublic fs2'
where
loadPublic p3 = do
(pragmas,cs) <- parsePublicSource p3
let tags = Set.fromList $
(if any isTestsOnly pragmas then [TestsOnly] else []) ++
(if any isModuleOnly pragmas then [ModuleOnly] else [])
let cs' = if any isModuleOnly pragmas
then map (setCategoryNamespace ns3) cs
else map (setCategoryNamespace ns2) cs
return $ map (WithVisibility tags) cs'