1-----------------------------------------------------------------------------
3-- Module : Language.PureScript.ModuleDependencies
4-- Copyright : (c) 2013-15 Phil Freeman, (c) 2014-15 Gary Burgess
5-- License : MIT (http://opensource.org/licenses/MIT)
7-- Maintainer : Phil Freeman <paf31@cantab.net>
8-- Stability : experimental
11-- | Provides the ability to sort modules based on module dependencies
13-----------------------------------------------------------------------------
15{-# LANGUAGE FlexibleContexts #-}
17module Language.PureScript.ModuleDependencies (
22import Control.Monad.Error.Class (MonadError(..))
26import Data.Maybe (fromMaybe, mapMaybe)
28import Language.PureScript.Crash
29import Language.PureScript.AST
30import Language.PureScript.Names
31import Language.PureScript.Types
32import Language.PureScript.Errors
34-- | A list of modules with their transitive dependencies
35type ModuleGraph = [(ModuleName, [ModuleName])]
37-- | Sort a collection of modules based on module dependencies.
39-- Reports an error if the module graph contains a cycle.
41sortModules :: (MonadError MultipleErrors m) => [Module] -> m ([Module], ModuleGraph)
43 let verts = map (\m@(Module _ _ _ ds _) -> (m, getModuleName m, nub (concatMap usedModules ds))) ms
44 ms' <- mapM toModule $ stronglyConnComp verts
45 let (graph, fromVertex, toVertex) = graphFromEdges verts
46 moduleGraph = do (_, mn, _) <- verts
47 let v = fromMaybe (internalError "sortModules: vertex not found") (toVertex mn)
48 deps = reachable graph v
49 toKey i = case fromVertex i of (_, key, _) -> key
50 return (mn, filter (/= mn) (map toKey deps))
51 return (ms', moduleGraph)
54-- Calculate a list of used modules based on explicit imports and qualified names
56usedModules :: Declaration -> [ModuleName]
57usedModules = let (f, _, _, _, _) = everythingOnValues (++) forDecls forValues (const []) (const []) (const []) in nub . f
59 forDecls :: Declaration -> [ModuleName]
60 forDecls (ImportDeclaration mn _ _ _) = [mn]
63 forValues :: Expr -> [ModuleName]
64 forValues (Var (Qualified (Just mn) _)) = [mn]
65 forValues (Constructor (Qualified (Just mn) _)) = [mn]
66 forValues (TypedValue _ _ ty) = forTypes ty
69 forTypes :: Type -> [ModuleName]
70 forTypes (TypeConstructor (Qualified (Just mn) _)) = [mn]
71 forTypes (ConstrainedType cs _) = mapMaybe (\(Qualified mn _, _) -> mn) cs
75-- Convert a strongly connected component of the module graph to a module
77toModule :: (MonadError MultipleErrors m) => SCC Module -> m Module
78toModule (AcyclicSCC m) = return m
79toModule (CyclicSCC [m]) = return m
80toModule (CyclicSCC ms) = throwError . errorMessage $ CycleInModules (map getModuleName ms)
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list