-{- Notes about the syntax of interface files
+{- Notes about the syntax of interface files -*-haskell-*-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The header
~~~~~~~~~~
{
-module ParseIface ( parseIface, IfaceStuff(..) ) where
+module ParseIface ( parseIface, parseType, parseRules, parseIdInfo ) where
#include "HsVersions.h"
import RdrHsSyn -- oodles of synonyms
import HsTypes ( mkHsForAllTy, mkHsTupCon )
import HsCore
-import Demand ( mkStrictnessInfo )
import Literal ( Literal(..), mkMachInt, mkMachInt64, mkMachWord, mkMachWord64 )
-import BasicTypes ( Fixity(..), FixityDirection(..),
- NewOrData(..), Version, initialVersion, Boxity(..)
+import BasicTypes ( Fixity(..), FixityDirection(..), StrictnessMark(..),
+ NewOrData(..), Version, initialVersion, Boxity(..),
+ Activation(..), IPName(..)
)
import CostCentre ( CostCentre(..), IsCafCC(..), IsDupdCC(..) )
-import CallConv ( cCallConv )
-import Type ( Kind, mkArrowKind, boxedTypeKind, openTypeKind, usageTypeKind )
-import IdInfo ( exactArity, InlinePragInfo(..) )
-import PrimOp ( CCall(..), CCallTarget(..) )
+import Type ( Kind, mkArrowKind, liftedTypeKind, openTypeKind, usageTypeKind )
+import ForeignCall ( ForeignCall(..), CCallConv(..), CCallSpec(..), CCallTarget(..) )
import Lex
import RnMonad ( ParsedIface(..), ExportItem, IfaceDeprecs )
RdrAvailInfo )
import RdrName ( RdrName, mkRdrUnqual, mkIfaceOrig )
+import TyCon ( DataConDetails(..) )
import Name ( OccName )
import OccName ( mkSysOccFS,
- tcName, varName, ipName, dataName, clsName, tvName,
+ tcName, varName, dataName, clsName, tvName,
EncodedFS
)
-import Module ( ModuleName, PackageName, mkSysModuleNameFS, mkModule )
+import Module ( ModuleName, PackageName, mkSysModuleNameFS )
import SrcLoc ( SrcLoc )
import CmdLineOpts ( opt_InPackage, opt_IgnoreIfacePragmas )
import Outputable
import FastString ( tailFS )
}
-%name parseIface
+%name parseIface iface
+%name parseType type
+%name parseIdInfo id_info
+%name parseRules rules_and_deprecs
+
%tokentype { Token }
%monad { P }{ thenP }{ returnP }
%lexer { lexer } { ITeof }
'case' { ITcase } -- Haskell keywords
'class' { ITclass }
'data' { ITdata }
- 'default' { ITdefault }
- 'deriving' { ITderiving }
- 'do' { ITdo }
- 'else' { ITelse }
'hiding' { IThiding }
- 'if' { ITif }
'import' { ITimport }
'in' { ITin }
'infix' { ITinfix }
'infixr' { ITinfixr }
'instance' { ITinstance }
'let' { ITlet }
- 'module' { ITmodule }
'newtype' { ITnewtype }
'of' { ITof }
'qualified' { ITqualified }
- 'then' { ITthen }
'type' { ITtype }
'where' { ITwhere }
'__interface' { ITinterface } -- interface keywords
'__export' { IT__export }
- '__depends' { ITdepends }
'__forall' { IT__forall }
'__letrec' { ITletrec }
'__coerce' { ITcoerce }
'__inline_me' { ITinlineMe }
'__inline_call'{ ITinlineCall }
'__DEFAULT' { ITdefaultbranch }
- '__bot' { ITbottom }
- '__integer' { ITinteger_lit }
'__float' { ITfloat_lit }
'__word' { ITword_lit }
'__int64' { ITint64_lit }
'__word64' { ITword64_lit }
- '__rational' { ITrational_lit }
'__addr' { ITaddr_lit }
'__label' { ITlabel_lit }
'__litlit' { ITlit_lit }
- '__string' { ITstring_lit }
'__ccall' { ITccall $$ }
'__scc' { ITscc }
'__sccC' { ITsccAllCafs }
'__A' { ITarity }
'__P' { ITspecialise }
'__C' { ITnocaf }
- '__U' { ITunfold $$ }
+ '__U' { ITunfold }
'__S' { ITstrict $$ }
'__R' { ITrules }
- '__M' { ITcprinfo }
'__D' { ITdeprecated }
- '..' { ITdotdot } -- reserved symbols
'::' { ITdcolon }
'=' { ITequal }
'\\' { ITlam }
'|' { ITvbar }
- '<-' { ITlarrow }
'->' { ITrarrow }
'@' { ITat }
+ '~' { ITtilde }
'=>' { ITdarrow }
'-' { ITminus }
'!' { ITbang }
+ '*' { ITstar }
'{' { ITocurly } -- special symbols
'}' { ITccurly }
- '{|' { ITocurlybar } -- special symbols
- '|}' { ITccurlybar } -- special symbols
'[' { ITobrack }
']' { ITcbrack }
+ '[:' { ITopabrack }
+ ':]' { ITcpabrack }
'(' { IToparen }
')' { ITcparen }
'(#' { IToubxparen }
VARID { ITvarid $$ } -- identifiers
CONID { ITconid $$ }
VARSYM { ITvarsym $$ }
- CONSYM { ITconsym $$ }
QVARID { ITqvarid $$ }
QCONID { ITqconid $$ }
- QVARSYM { ITqvarsym $$ }
- QCONSYM { ITqconsym $$ }
- IPVARID { ITipvarid $$ } -- GHC extension
+ IPDUPVARID { ITdupipvarid $$ } -- GHC extension
+ IPSPLITVARID { ITsplitipvarid $$ } -- GHC extension
PRAGMA { ITpragma $$ }
INTEGER { ITinteger $$ }
RATIONAL { ITrational $$ }
CLITLIT { ITlitlit $$ }
-
- UNKNOWN { ITunknown $$ }
%%
--- iface_stuff is the main production.
--- It recognises (a) a whole interface file
--- (b) a type (so that type sigs can be parsed lazily)
--- (c) the IdInfo part of a signature (same reason)
-
-iface_stuff :: { IfaceStuff }
-iface_stuff : iface { PIface $1 }
- | type { PType $1 }
- | id_info { PIdInfo $1 }
- | rules_and_deprecs { PRulesAndDeprecs $1 }
-
iface :: { ParsedIface }
iface : '__interface' package mod_name
version sub_versions
instance_decl_part
decls_part
rules_and_deprecs_part
- { ParsedIface {
- pi_mod = mkModule $3 $2, -- Module itself
+ { let (rules,deprecs) = $14 () in
+ ParsedIface {
+ pi_mod = $3, -- Module name
+ pi_pkg = $2, -- Package name
pi_vers = $4, -- Module version
pi_orphan = $6,
pi_exports = (fst $5, $9), -- Exports
pi_fixity = $11, -- Fixies
pi_insts = $12, -- Local instances
pi_decls = $13, -- Decls
- pi_rules = (snd $5,fst $14), -- Rules
- pi_deprecs = snd $14 -- Deprecations
+ pi_rules = (snd $5,rules), -- Rules
+ pi_deprecs = deprecs -- Deprecations
} }
-- Versions for exports and rules (optional)
whats_imported : { NothingAtAll }
| '::' version { Everything $2 }
| '::' version version version name_version_pairs { Specifically $2 (Just $3) $5 $4 }
+ | '::' version version name_version_pairs { Specifically $2 Nothing $4 $3 }
name_version_pairs :: { [(OccName, Version)] }
name_version_pairs : { [] }
{ IfaceSig $2 $4 ($5 $2) $1 }
| src_loc 'type' qtc_name tv_bndrs '=' type
{ TySynonym $3 $4 $6 $1 }
- | src_loc 'data' opt_decl_context qtc_name tv_bndrs constrs
- { mkTyData DataType $3 $4 $5 $6 (length $6) Nothing $1 }
- | src_loc 'newtype' opt_decl_context qtc_name tv_bndrs newtype_constr
- { mkTyData NewType $3 $4 $5 $6 1 Nothing $1 }
- | src_loc 'class' opt_decl_context qtc_name tv_bndrs fds csigs
- { mkClassDecl $3 $4 $5 $6 $7 Nothing $1 }
+ | src_loc 'foreign' 'type' qtc_name
+ { ForeignType $4 Nothing DNType $1 }
+ | src_loc 'data' tycl_hdr constrs
+ { mkTyData DataType $3 $4 Nothing $1 }
+ | src_loc 'newtype' tycl_hdr newtype_constr
+ { mkTyData NewType $3 (DataCons [$4]) Nothing $1 }
+ | src_loc 'class' tycl_hdr fds csigs
+ { mkClassDecl $3 $4 $5 Nothing $1 }
+
+tycl_hdr :: { (RdrNameContext, RdrName, [RdrNameHsTyVar]) }
+ : context '=>' qtc_name tv_bndrs { ($1, $3, $4) }
+ | qtc_name tv_bndrs { ([], $1, $2) }
maybe_idinfo :: { RdrName -> [HsIdInfo RdrName] }
maybe_idinfo : {- empty -} { \_ -> [] }
| pragma { \x -> if opt_IgnoreIfacePragmas then []
else case $1 of
- POk _ (PIdInfo id_info) -> id_info
- PFailed err -> pprPanic "IdInfo parse failed"
+ Just (POk _ id_info) -> id_info
+ Just (PFailed err) -> pprPanic "IdInfo parse failed"
(vcat [ppr x, err])
}
{-
dates from a time where we picked up a .hi file first if it existed.]
-}
-pragma :: { ParseResult IfaceStuff }
-pragma : src_loc PRAGMA { parseIface $2 PState{ bol = 0#, atbol = 1#,
- context = [],
- glasgow_exts = 1#,
- loc = $1 }
+pragma :: { Maybe (ParseResult [HsIdInfo RdrName]) }
+pragma : src_loc PRAGMA { let exts = ExtFlags {glasgowExtsEF = True,
+ parrEF = True}
+ in
+ Just (parseIdInfo $2 (mkPState $1 exts))
}
-----------------------------------------------------------------------------
-rules_and_deprecs_part :: { ([RdrNameRuleDecl], IfaceDeprecs) }
-rules_and_deprecs_part : {- empty -} { ([], Nothing) }
- | pragma { case $1 of
- POk _ (PRulesAndDeprecs rds) -> rds
- PFailed err -> pprPanic "Rules/Deprecations parse failed" err
- }
+-- This production is lifted so that it doesn't get eagerly parsed when we
+-- use happy --strict.
+rules_and_deprecs_part :: { () -> ([RdrNameRuleDecl], IfaceDeprecs) }
+rules_and_deprecs_part
+ : {- empty -} { \_ -> ([], Nothing) }
+ | src_loc PRAGMA { \_ -> let exts = ExtFlags {glasgowExtsEF = True,
+ parrEF = True}
+ in case parseRules $2 (mkPState $1 exts) of
+ POk _ rds -> rds
+ PFailed err -> pprPanic "Rules/Deprecations parse failed" err
+ }
rules_and_deprecs :: { ([RdrNameRuleDecl], IfaceDeprecs) }
rules_and_deprecs : rule_prag deprec_prag { ($1, $2) }
-
+
-----------------------------------------------------------------------------
rule_prag :: { [RdrNameRuleDecl] }
| rule ';' rules { $1:$3 }
rule :: { RdrNameRuleDecl }
-rule : src_loc STRING rule_forall qvar_name
- core_args '=' core_expr { IfaceRule $2 $3 $4 $5 $7 $1 }
+rule : src_loc STRING activation rule_forall qvar_name
+ core_args '=' core_expr { IfaceRule $2 $3 $4 $5 $6 $8 $1 }
+
+activation :: { Activation }
+activation : {- empty -} { AlwaysActive }
+ | '[' INTEGER ']' { ActiveAfter (fromInteger $2) }
+ | '[' '~' INTEGER ']' { ActiveBefore (fromInteger $3) }
rule_forall :: { [UfBinder RdrName] }
rule_forall : '__forall' '{' core_bndrs '}' { $3 }
opt_version : version { $1 }
| {- empty -} { initialVersion }
-opt_decl_context :: { RdrNameContext }
-opt_decl_context : { [] }
- | context '=>' { $1 }
----------------------------------------------------------------------------
-constrs :: { [RdrNameConDecl] {- empty for handwritten abstract -} }
- : { [] }
- | '=' constrs1 { $2 }
+constrs :: { DataConDetails RdrNameConDecl }
+ : { Unknown }
+ | '=' { DataCons [] }
+ | '=' constrs1 { DataCons $2 }
constrs1 :: { [RdrNameConDecl] }
constrs1 : constr { [$1] }
| src_loc ex_stuff qdata_name '{' fields1 '}' { mk_con_decl $3 $2 (RecCon $5) $1 }
-- We use "data_fs" so as to include ()
-newtype_constr :: { [RdrNameConDecl] {- Not allowed to be empty -} }
-newtype_constr : src_loc '=' ex_stuff qdata_name atype { [mk_con_decl $4 $3 (VanillaCon [Unbanged $5]) $1] }
+newtype_constr :: { RdrNameConDecl }
+newtype_constr : src_loc '=' ex_stuff qdata_name atype { mk_con_decl $4 $3 (VanillaCon [unbangedType $5]) $1 }
| src_loc '=' ex_stuff qdata_name '{' qvar_name '::' atype '}'
- { [mk_con_decl $4 $3 (RecCon [([$6], Unbanged $8)]) $1] }
+ { mk_con_decl $4 $3 (RecCon [([$6], unbangedType $8)]) $1 }
ex_stuff :: { ([HsTyVarBndr RdrName], RdrNameContext) }
ex_stuff : { ([],[]) }
| batype batypes { $1 : $2 }
batype :: { RdrNameBangType }
-batype : tatype { Unbanged $1 }
- | '!' tatype { Banged $2 }
- | '!' '!' tatype { Unpacked $3 }
+batype : tatype { unbangedType $1 }
+ | '!' tatype { BangType MarkedStrict $2 }
+ | '!' '!' tatype { BangType MarkedUnboxed $3 }
fields1 :: { [([RdrName], RdrNameBangType)] }
fields1 : field { [$1] }
| field ',' fields1 { $1 : $3 }
field :: { ([RdrName], RdrNameBangType) }
-field : qvar_names1 '::' ttype { ($1, Unbanged $3) }
- | qvar_names1 '::' '!' ttype { ($1, Banged $4) }
- | qvar_names1 '::' '!' '!' ttype { ($1, Unpacked $5) }
+field : qvar_names1 '::' ttype { ($1, unbangedType $3) }
+ | qvar_names1 '::' '!' ttype { ($1, BangType MarkedStrict $4) }
+ | qvar_names1 '::' '!' '!' ttype { ($1, BangType MarkedUnboxed $5) }
--------------------------------------------------------------------------
| class ',' context_list1 { $1 : $3 }
class :: { HsPred RdrName }
-class : qcls_name atypes { (HsPClass $1 $2) }
- | ipvar_name '::' type { (HsPIParam $1 $3) }
+class : qcls_name atypes { (HsClassP $1 $2) }
+ | ipvar_name '::' type { (HsIParam $1 $3) }
types0 :: { [RdrNameHsType] {- Zero or more -} }
types0 : {- empty -} { [ ] }
btype :: { RdrNameHsType }
btype : atype { $1 }
| btype atype { HsAppTy $1 $2 }
- | '__u' atype atype { HsUsageTy $2 $3 }
atype :: { RdrNameHsType }
atype : qtc_name { HsTyVar $1 }
| '(' types2 ')' { HsTupleTy (mkHsTupCon tcName Boxed $2) $2 }
| '(#' types0 '#)' { HsTupleTy (mkHsTupCon tcName Unboxed $2) $2 }
| '[' type ']' { HsListTy $2 }
+ | '[:' type ':]' { HsPArrTy $2 }
| '{' qcls_name atypes '}' { mkHsDictTy $2 $3 }
| '{' ipvar_name '::' type '}' { mkHsIParamTy $2 $4 }
| '(' type ')' { $2 }
tbtype :: { RdrNameHsType }
tbtype : tatype { $1 }
| tbtype atype { HsAppTy $1 $2 }
- | '__u' atype atype { HsUsageTy $2 $3 }
tatype :: { RdrNameHsType }
tatype : qtc_name { HsTyVar $1 }
| '(' types2 ')' { HsTupleTy (mkHsTupCon tcName Boxed $2) $2 }
| '(#' types0 '#)' { HsTupleTy (mkHsTupCon tcName Unboxed $2) $2 }
| '[' type ']' { HsListTy $2 }
+ | '[:' type ':]' { HsPArrTy $2 }
| '{' qcls_name atypes '}' { mkHsDictTy $2 $3 }
| '{' ipvar_name '::' type '}' { mkHsIParamTy $2 $4 }
| '(' type ')' { $2 }
package :: { PackageName }
: STRING { $1 }
- | {- empty -} { opt_InPackage } -- Useful for .hi-boot files,
- -- which can omit the package Id
- -- Module loops are always within a package
+ | {- empty -} { opt_InPackage }
+ -- Useful for .hi-boot files,
+ -- which can omit the package Id
+ -- Module loops are always within a package
mod_name :: { ModuleName }
: CONID { mkSysModuleNameFS $1 }
---------------------------------------------------
-var_fs :: { EncodedFS }
+var_fs :: { EncodedFS }
: VARID { $1 }
- | '!' { SLIT("!") }
| 'as' { SLIT("as") }
| 'qualified' { SLIT("qualified") }
| 'hiding' { SLIT("hiding") }
| 'ccall' { SLIT("ccall") }
| 'stdcall' { SLIT("stdcall") }
-qvar_fs :: { (EncodedFS, EncodedFS) }
- : QVARID { $1 }
- | QVARSYM { $1 }
-
var_occ :: { OccName }
: var_fs { mkSysOccFS varName $1 }
qvar_name :: { RdrName }
qvar_name : var_name { $1 }
- | qvar_fs { mkIfaceOrig varName $1 }
+ | QVARID { mkIfaceOrig varName $1 }
-ipvar_name :: { RdrName }
- : IPVARID { mkRdrUnqual (mkSysOccFS ipName (tailFS $1)) }
+ipvar_name :: { IPName RdrName }
+ : IPDUPVARID { Dupable (mkRdrUnqual (mkSysOccFS varName $1)) }
+ | IPSPLITVARID { Linear (mkRdrUnqual (mkSysOccFS varName $1)) }
qvar_names1 :: { [RdrName] }
qvar_names1 : qvar_name { [$1] }
| qvar_name qvar_names1 { $1 : $2 }
-var_names :: { [RdrName] }
-var_names : { [] }
- | var_name var_names { $1 : $2 }
-
-var_names1 :: { [RdrName] }
-var_names1 : var_name var_names { $1 : $2 }
-
---------------------------------------------------
--- For some bizarre reason,
--- (,,,) is dealt with by the parser
--- Foo.(,,,) is dealt with by the lexer
--- Sigh
-
-data_fs :: { EncodedFS }
- : CONID { $1 }
- | CONSYM { $1 }
-
-qdata_fs :: { (EncodedFS, EncodedFS) }
- : QCONID { $1 }
- | QCONSYM { $1 }
data_occ :: { OccName }
- : data_fs { mkSysOccFS dataName $1 }
-
-data_name :: { RdrName }
- : data_occ { mkRdrUnqual $1 }
+ : CONID { mkSysOccFS dataName $1 }
qdata_name :: { RdrName }
-qdata_name : data_name { $1 }
- | qdata_fs { mkIfaceOrig dataName $1 }
+ : data_occ { mkRdrUnqual $1 }
+ | QCONID { mkIfaceOrig dataName $1 }
var_or_data_name :: { RdrName }
- : qvar_name { $1 }
- | qdata_name { $1 }
+ : qvar_name { $1 }
+ | qdata_name { $1 }
---------------------------------------------------
tc_occ :: { OccName }
- : data_fs { mkSysOccFS tcName $1 }
-
-tc_name :: { RdrName }
- : tc_occ { mkRdrUnqual $1 }
+ : CONID { mkSysOccFS tcName $1 }
qtc_name :: { RdrName }
- : tc_name { $1 }
- | qdata_fs { mkIfaceOrig tcName $1 }
+ : tc_occ { mkRdrUnqual $1 }
+ | QCONID { mkIfaceOrig tcName $1 }
---------------------------------------------------
-cls_name :: { RdrName }
- : data_fs { mkRdrUnqual (mkSysOccFS clsName $1) }
-
qcls_name :: { RdrName }
- : cls_name { $1 }
- | qdata_fs { mkIfaceOrig clsName $1 }
+ : CONID { mkRdrUnqual (mkSysOccFS clsName $1) }
+ | QCONID { mkIfaceOrig clsName $1 }
---------------------------------------------------
tv_name :: { RdrName }
- : VARID { mkRdrUnqual (mkSysOccFS tvName $1) }
+ : var_fs { mkRdrUnqual (mkSysOccFS tvName $1) }
tv_bndr :: { HsTyVarBndr RdrName }
: tv_name '::' akind { IfaceTyVar $1 $3 }
- | tv_name { IfaceTyVar $1 boxedTypeKind }
+ | tv_name { IfaceTyVar $1 liftedTypeKind }
tv_bndrs :: { [HsTyVarBndr RdrName] }
: tv_bndrs1 { $1 }
| akind '->' kind { mkArrowKind $1 $3 }
akind :: { Kind }
- : VARSYM { if $1 == SLIT("*") then
- boxedTypeKind
- else if $1 == SLIT("?") then
+ : '*' { liftedTypeKind }
+ | VARSYM { if $1 == SLIT("?") then
openTypeKind
else if $1 == SLIT("\36") then
usageTypeKind -- dollar
| id_info_item id_info { $1 : $2 }
id_info_item :: { HsIdInfo RdrName }
- : '__A' INTEGER { HsArity (exactArity (fromInteger $2)) }
- | '__U' inline_prag core_expr { HsUnfold $2 $3 }
- | '__M' { HsCprInfo }
- | '__S' { HsStrictness (mkStrictnessInfo $1) }
+ : '__A' INTEGER { HsArity (fromInteger $2) }
+ | '__U' activation core_expr { HsUnfold $2 $3 }
+ | '__S' { HsStrictness $1 }
| '__C' { HsNoCafRefs }
- | '__P' qvar_name { HsWorker $2 }
-
-inline_prag :: { InlinePragInfo }
- : {- empty -} { NoInlinePragInfo }
- | '[' from_prag phase ']' { IMustNotBeINLINEd $2 $3 }
-
-from_prag :: { Bool }
- : {- empty -} { True }
- | '!' { False }
-
-phase :: { Maybe Int }
- : {- empty -} { Nothing }
- | INTEGER { Just (fromInteger $1) }
+ | '__P' qvar_name INTEGER { HsWorker $2 (fromInteger $3) }
-------------------------------------------------------
core_expr :: { UfExpr RdrName }
{ let
(is_dyn, is_casm, may_gc) = $2
- target | is_dyn = DynamicTarget (error "CCall dyn target bogus unique")
+ target | is_dyn = DynamicTarget
+ | is_casm = CasmTarget $3
| otherwise = StaticTarget $3
- ccall = CCall target is_casm may_gc cCallConv
+ ccall = CCallSpec target CCallConv may_gc
in
- UfCCall ccall $4
+ UfFCall (CCall ccall) $4
}
core_tv_bndr :: { UfBinder RdrName }
core_tv_bndr : '@' tv_name '::' akind { UfTyBinder $2 $4 }
- | '@' tv_name { UfTyBinder $2 boxedTypeKind }
+ | '@' tv_name { UfTyBinder $2 liftedTypeKind }
ccall_string :: { FAST_STRING }
: STRING { $1 }
happyError :: P a
happyError buf PState{ loc = loc } = PFailed (ifaceParseErr buf loc)
-data IfaceStuff = PIface ParsedIface
- | PIdInfo [HsIdInfo RdrName]
- | PType RdrNameHsType
- | PRulesAndDeprecs ([RdrNameRuleDecl], IfaceDeprecs)
-
mk_con_decl name (ex_tvs, ex_ctxt) details loc = mkConDecl name ex_tvs ex_ctxt details loc
}