2 -- The above warning supression flag is a temporary kludge.
3 -- While working on this module you are encouraged to remove it and fix
4 -- any warnings in the module. See
5 -- http://hackage.haskell.org/trac/ghc/wiki/Commentary/CodingStyle#Warnings
8 -----------------------------------------------------------------------------
10 -- Parsing the top of a Haskell source file to get its module name,
11 -- imports and options.
13 -- (c) Simon Marlow 2005
16 -----------------------------------------------------------------------------
18 module HeaderInfo ( getImports
19 , getOptionsFromFile, getOptions
20 , optionsErrorMsgs ) where
22 #include "HsVersions.h"
24 import Parser ( parseHeader )
27 import HsSyn ( ImportDecl(..), HsModule(..) )
28 import Module ( ModuleName, moduleName )
29 import PrelNames ( gHC_PRIM, mAIN_NAME )
30 import StringBuffer ( StringBuffer(..), hGetStringBuffer, hGetStringBufferBlock
31 , appendStringBuffers )
41 import Bag ( emptyBag, listToBag )
43 import Control.Exception
49 #if __GLASGOW_HASKELL__ >= 601
50 import System.IO ( openBinaryFile )
52 import IOExts ( openFileEx, IOModeEx(..) )
55 #if __GLASGOW_HASKELL__ < 601
56 openBinaryFile fp mode = openFileEx fp (BinaryMode mode)
59 getImports :: DynFlags -> StringBuffer -> FilePath -> FilePath
60 -> IO ([Located ModuleName], [Located ModuleName], Located ModuleName)
61 getImports dflags buf filename source_filename = do
62 let loc = mkSrcLoc (mkFastString filename) 1 0
63 case unP parseHeader (mkPState buf loc dflags) of
64 PFailed span err -> parseError span err
65 POk pst rdr_module -> do
66 let ms = getMessages pst
67 printErrorsAndWarnings dflags ms
68 when (errorsFound dflags ms) $ exitWith (ExitFailure 1)
70 L _ (HsModule mb_mod _ imps _ _ _ _) ->
72 main_loc = mkSrcLoc (mkFastString source_filename) 1 0
73 mod = mb_mod `orElse` L (srcLocSpan main_loc) mAIN_NAME
74 (src_idecls, ord_idecls) = partition isSourceIdecl (map unLoc imps)
75 source_imps = map getImpMod src_idecls
76 ordinary_imps = filter ((/= moduleName gHC_PRIM) . unLoc)
77 (map getImpMod ord_idecls)
78 -- GHC.Prim doesn't exist physically, so don't go looking for it.
80 return (source_imps, ordinary_imps, mod)
82 parseError span err = throwDyn $ mkPlainErrMsg span err
84 isSourceIdecl (ImportDecl _ s _ _ _) = s
86 getImpMod (ImportDecl located_mod _ _ _ _) = located_mod
88 --------------------------------------------------------------
90 --------------------------------------------------------------
93 getOptionsFromFile :: FilePath -- input file
94 -> IO [Located String] -- options, if any
95 getOptionsFromFile filename
96 = Control.Exception.bracket
97 (openBinaryFile filename ReadMode)
100 do buf <- hGetStringBufferBlock handle blockSize
102 where blockSize = 1024
104 | len buf == 0 = return []
106 = case getOptions' buf filename of
107 (Nothing, opts) -> return opts
108 (Just buf', opts) -> do nextBlock <- hGetStringBufferBlock handle blockSize
109 newBuf <- appendStringBuffers buf' nextBlock
110 if len newBuf == len buf
112 else do opts' <- loop handle newBuf
115 getOptions :: StringBuffer -> FilePath -> [Located String]
116 getOptions buf filename
117 = case getOptions' buf filename of
120 -- The token parser is written manually because Happy can't
121 -- return a partial result when it encounters a lexer error.
122 -- We want to extract options before the buffer is passed through
123 -- CPP, so we can't use the same trick as 'getImports'.
124 getOptions' :: StringBuffer -- Input buffer
125 -> FilePath -- Source file. Used for msgs only.
126 -> ( Maybe StringBuffer -- Just => we can use more input
127 , [Located String] -- Options.
129 getOptions' buf filename
130 = parseToks (lexAll (pragState buf loc))
131 where loc = mkSrcLoc (mkFastString filename) 1 0
133 getToken (buf,L _loc tok) = tok
134 getLoc (buf,L loc _tok) = loc
135 getBuf (buf,_tok) = buf
136 combine opts (flag, opts') = (flag, opts++opts')
137 add opt (flag, opts) = (flag, opt:opts)
139 parseToks (open:close:xs)
140 | IToptions_prag str <- getToken open
141 , ITclose_prag <- getToken close
142 = map (L (getLoc open)) (words str) `combine`
144 parseToks (open:close:xs)
145 | ITinclude_prag str <- getToken open
146 , ITclose_prag <- getToken close
147 = map (L (getLoc open)) ["-#include",removeSpaces str] `combine`
149 parseToks (open:close:xs)
150 | ITdocOptions str <- getToken open
151 , ITclose_prag <- getToken close
152 = map (L (getLoc open)) ["-haddock-opts", removeSpaces str]
153 `combine` parseToks xs
155 | ITdocOptionsOld str <- getToken open
156 = map (L (getLoc open)) ["-haddock-opts", removeSpaces str]
157 `combine` parseToks xs
159 | ITlanguage_prag <- getToken open
161 -- The last token before EOF could have been truncated.
162 -- We ignore it to be on the safe side.
164 | ITeof <- getToken eof
165 = (Just (getBuf tok),[])
167 | ITeof <- getToken eof
168 = (Just (getBuf eof),[])
169 parseToks _ = (Nothing,[])
170 parseLanguage ((_buf,L loc (ITconid fs)):rest)
171 = checkExtension (L loc fs) `add`
173 (_,L loc ITcomma):more -> parseLanguage more
174 (_,L loc ITclose_prag):more -> parseToks more
175 (_,L loc _):_ -> languagePragParseError loc
176 parseLanguage (tok:_)
177 = languagePragParseError (getLoc tok)
178 lexToken t = return t
179 lexAll state = case unP (lexer lexToken) state of
180 POk state' t@(L _ ITeof) -> [(buffer state,t)]
181 POk state' t -> (buffer state,t):lexAll state'
182 _ -> [(buffer state,L (last_loc state) ITeof)]
184 checkExtension :: Located FastString -> Located String
185 checkExtension (L l ext)
186 -- Checks if a given extension is valid, and if so returns
187 -- its corresponding flag. Otherwise it throws an exception.
188 = let ext' = unpackFS ext in
189 if ext' `elem` supportedLanguages
190 || ext' `elem` (map ("No"++) supportedLanguages)
191 then L l ("-X"++ext')
192 else unsupportedExtnError l ext'
194 languagePragParseError loc =
195 pgmError (showSDoc (mkLocMessage loc (
196 text "cannot parse LANGUAGE pragma")))
198 unsupportedExtnError loc unsup =
199 pgmError (showSDoc (mkLocMessage loc (
200 text "unsupported extension: " <>
204 optionsErrorMsgs :: [String] -> [Located String] -> FilePath -> Messages
205 optionsErrorMsgs unhandled_flags flags_lines filename
206 = (emptyBag, listToBag (map mkMsg unhandled_flags_lines))
207 where unhandled_flags_lines = [ L l f | f <- unhandled_flags,
208 L l f' <- flags_lines, f == f' ]
209 mkMsg (L flagSpan flag) =
210 ErrUtils.mkPlainErrMsg flagSpan $
211 text "unknown flag in {-# OPTIONS #-} pragma:" <+> text flag