Edwin BradySome tiny updatesb0d640f6 years agoHistory
292 lines · 11.5 KB · Text
RawDownload
module Text.Parser.Core import Data.Listimport public Control.Delayed %default total -- TODO: Add some primitives for helping with error messages.-- e.g. perhaps set a string to state what we're currently trying to-- parse, or to say what the next expected token is in words ||| Description of a language's grammar. The `tok` parameter is the type||| of tokens, and the `consumes` flag is True if the language is guaranteed||| to be non-empty - that is, successfully parsing the language is guaranteed||| to consume some input.exportdata Grammar : (tok : Type) -> (consumes : Bool) -> Type -> Type where     Empty : (val : ty) -> Grammar tok False ty     Terminal : String -> (tok -> Maybe a) -> Grammar tok True a     NextIs : String -> (tok -> Bool) -> Grammar tok False tok     EOF : Grammar tok False ()      Fail : {c : Bool} -> Bool -> String -> Grammar tok c ty     Commit : Grammar tok False ()     MustWork : Grammar tok c a -> Grammar tok c a      SeqEat : {c2 : Bool} ->              Grammar tok True a -> Inf (a -> Grammar tok c2 b) ->              Grammar tok True b     SeqEmpty : {c1, c2 : Bool} ->                Grammar tok c1 a -> (a -> Grammar tok c2 b) ->                Grammar tok (c1 || c2) b     Alt : {c1, c2 : Bool} ->           Grammar tok c1 ty -> Lazy (Grammar tok c2 ty) ->           Grammar tok (c1 && c2) ty ||| Sequence two grammars. If either consumes some input, the sequence is||| guaranteed to consume some input. If the first one consumes input, the||| second is allowed to be recursive (because it means some input has been||| consumed and therefore the input is smaller)export %inline(>>=) : {c1, c2 : Bool} ->        Grammar tok c1 a ->        inf c1 (a -> Grammar tok c2 b) ->        Grammar tok (c1 || c2) b(>>=) {c1 = False} = SeqEmpty(>>=) {c1 = True}  = SeqEat ||| Sequence two grammars. If either consumes some input, the sequence is||| guaranteed to consume input. This is an explicitly non-infinite version||| of `>>=`.exportseq : {c1,c2 : Bool} ->      Grammar tok c1 a ->      (a -> Grammar tok c2 b) ->      Grammar tok (c1 || c2) bseq = SeqEmpty ||| Sequence a grammar followed by the grammar it returns.exportjoin : {c1,c2 : Bool} ->       Grammar tok c1 (Grammar tok c2 a) ->       Grammar tok (c1 || c2) ajoin {c1 = False} p = SeqEmpty p idjoin {c1 = True} p = SeqEat p id ||| Give two alternative grammars. If both consume, the combination is||| guaranteed to consume.export(<|>) : {c1,c2 : Bool} ->         Grammar tok c1 ty ->        Lazy (Grammar tok c2 ty) ->        Grammar tok (c1 && c2) ty(<|>) = Alt ||| Allows the result of a grammar to be mapped to a different value.exportFunctor (Grammar tok c) where  map f (Empty val)  = Empty (f val)  map f (Fail fatal msg) = Fail fatal msg  map f (MustWork g) = MustWork (map f g)  map f (Terminal msg g) = Terminal msg (\t => map f (g t))  map f (Alt x y)    = Alt (map f x) (map f y)  map f (SeqEat act next)      = SeqEat act (\val => map f (next val))  map f (SeqEmpty act next)      = SeqEmpty act (\val => map f (next val))  -- The remaining constructors (NextIs, EOF, Commit) have a fixed type,  -- so a sequence must be used.  map {c = False} f p = SeqEmpty p (Empty . f) ||| Sequence a grammar with value type `a -> b` and a grammar||| with value type `a`. If both succeed, apply the function||| from the first grammar to the value from the second grammar.||| Guaranteed to consume if either grammar consumes.export(<*>) : {c1, c2 : Bool} ->        Grammar tok c1 (a -> b) ->        Grammar tok c2 a ->        Grammar tok (c1 || c2) b(<*>) x y = SeqEmpty x (\f => map f y) ||| Sequence two grammars. If both succeed, use the value of the first one.||| Guaranteed to consume if either grammar consumes.export(<*) : {c1,c2 : Bool} ->       Grammar tok c1 a ->       Grammar tok c2 b ->       Grammar tok (c1 || c2) a(<*) x y = map const x <*> y ||| Sequence two grammars. If both succeed, use the value of the second one.||| Guaranteed to consume if either grammar consumes.export(*>) : {c1,c2 : Bool} ->       Grammar tok c1 a ->       Grammar tok c2 b ->       Grammar tok (c1 || c2) b(*>) x y = map (const id) x <*> y ||| Produce a grammar that can parse a different type of token by providing a||| function converting the new token type into the original one.exportmapToken : {c : Bool} -> (a -> b) -> Grammar b c ty -> Grammar a c tymapToken f (Empty val) = Empty valmapToken f (Terminal msg g) = Terminal msg (g . f)mapToken f (NextIs msg g) = SeqEmpty (NextIs msg (g . f)) (Empty . f)mapToken f EOF = EOFmapToken f (Fail fatal msg) = Fail fatal msgmapToken f (MustWork g) = MustWork (mapToken f g)mapToken f Commit = CommitmapToken f (SeqEat act next) = SeqEat (mapToken f act) (\x => mapToken f (next x))mapToken f (SeqEmpty act next) = SeqEmpty (mapToken f act) (\x => mapToken f (next x))mapToken f (Alt x y) = Alt (mapToken f x) (mapToken f y) ||| Always succeed with the given value.exportpure : (val : ty) -> Grammar tok False typure = Empty ||| Check whether the next token satisfies a predicateexportnextIs : String -> (tok -> Bool) -> Grammar tok False toknextIs = NextIs ||| Look at the next token in the inputexportpeek : Grammar tok False tokpeek = nextIs "Unrecognised token" (const True) ||| Succeeds if running the predicate on the next token returns Just x,||| returning x. Otherwise fails.exportterminal : String -> (tok -> Maybe a) -> Grammar tok True aterminal = Terminal ||| Always fail with a messageexportfail : {c : Bool} -> String -> Grammar tok c tyfail = Fail False exportfatalError : {c : Bool} -> String -> Grammar tok c tyfatalError = Fail True ||| Succeed if the input is emptyexporteof : Grammar tok False ()eof = EOF ||| Commit to an alternative; if the current branch of an alternative||| fails to parse, no more branches will be triedexportcommit : Grammar tok False ()commit = Commit ||| If the parser fails, treat it as a fatal errorexportmustWork : {c : Bool} -> Grammar tok c ty -> Grammar tok c tymustWork = MustWork data ParseResult : List tok -> (consumes : Bool) -> Type -> Type where     Failure : {c : Bool} -> {xs : List tok} ->               (committed : Bool) -> (fatal : Bool) ->               (err : String) -> (rest : List tok) -> ParseResult xs c ty     EmptyRes : (committed : Bool) ->                (val : ty) -> (more : List tok) -> ParseResult more False ty     NonEmptyRes : {c : Bool} -> {xs : List tok} ->                   (committed : Bool) ->                   (val : ty) -> (more : List tok) ->                   ParseResult (x :: xs ++ more) c ty -- Take the result of an alternative branch, reset the commit flag to-- the commit flag from the outer alternative, and weaken the 'consumes'-- flag to take both alternatives into accountweakenRes : {whatever, c : Bool} -> {xs : List tok} ->            (com' : Bool) ->						ParseResult xs c ty -> ParseResult xs (whatever && c) tyweakenRes com' (Failure com fatal msg ts) = Failure com' fatal msg tsweakenRes {whatever=True} com' (EmptyRes com val xs) = EmptyRes com' val xsweakenRes {whatever=False} com' (EmptyRes com val xs) = EmptyRes com' val xsweakenRes com' (NonEmptyRes com val more) = NonEmptyRes com' val more shorter : (more : List tok) -> (ys : List tok) ->          LTE (S (length more)) (S (length (ys ++ more)))shorter more [] = lteReflshorter more (x :: xs) = LTESucc (lteSuccLeft (shorter more xs)) doParse : {c : Bool} ->          (commit : Bool) -> (xs : List tok) -> (act : Grammar tok c ty) ->          ParseResult xs c ty-- doParse com xs act with (sizeAccessible xs)doParse com xs (Empty val) = EmptyRes com val xsdoParse com [] (Fail fatal str) = Failure com fatal str []doParse com (x :: xs) (Fail fatal str) = Failure com fatal str (x :: xs)doParse com xs Commit = EmptyRes True () xsdoParse com xs (MustWork g) =  let p' = doParse com xs g in      case p' of           Failure com' _ msg ts => Failure com' True msg ts           res => resdoParse com [] (Terminal err f) = Failure com False "End of input" []doParse com (x :: xs) (Terminal err f)      = maybe           (Failure com False err (x :: xs))           (\a => NonEmptyRes com {xs=[]} a xs)           (f x)doParse com [] EOF = EmptyRes com () []doParse com (x :: xs) EOF      = Failure com False "Expected end of input" (x :: xs)doParse com [] (NextIs err f) = Failure com False "End of input" []doParse com (x :: xs) (NextIs err f)      = if f x           then EmptyRes com x (x :: xs)           else Failure com False err (x :: xs)doParse com xs (Alt x y)    = let p' = doParse False xs x in          case p' of               Failure com' fatal msg ts                  => if com' || fatal                            -- If the alternative had committed, don't try the                            -- other branch (and reset commit flag)                       then Failure com fatal msg ts                       else weakenRes com (doParse False xs y)  -- Successfully parsed the first option, so use the outer commit flag               EmptyRes _ val xs => EmptyRes com val xs               NonEmptyRes _ val more => NonEmptyRes com val moredoParse com xs (SeqEmpty act next)        = let p' = assert_total (doParse com xs act) in              case p' of               Failure com fatal msg ts => Failure com fatal msg ts               EmptyRes com val xs =>                     case assert_total (doParse com xs (next val)) of                          Failure com' fatal msg ts => Failure com' fatal msg ts                          EmptyRes com' val xs => EmptyRes com' val xs                          NonEmptyRes com' val more => NonEmptyRes com' val more               NonEmptyRes {x} {xs=ys} com val more =>                     case (assert_total (doParse com more (next val))) of                          Failure com' fatal msg ts => Failure com' fatal msg ts                          EmptyRes com' val _ => NonEmptyRes com' val more                          NonEmptyRes {x=x1} {xs=xs1} com' val more' =>                               rewrite appendAssociative (x :: ys) (x1 :: xs1) more' in                                       NonEmptyRes com' val more'doParse com xs (SeqEat act next) with (doParse com xs act)  doParse com xs (SeqEat act next) | Failure com' fatal msg ts       = Failure com' fatal msg ts  doParse com (x :: (ys ++ more)) (SeqEat act next) | (NonEmptyRes com' val more)       = let p' = assert_total (doParse com' more (next val)) in             case p' of              Failure com' fatal msg ts => Failure com' fatal msg ts              EmptyRes com' val _ => NonEmptyRes com' val more              NonEmptyRes {x=x1} {xs=xs1} com' val more' =>                   rewrite appendAssociative (x :: ys) (x1 :: xs1) more' in                           NonEmptyRes com' val more'-- This next line is not strictly necessary, but it stops the coverage-- checker taking a really long time and eating lots of memory...-- doParse _ _ _ | sml = Failure True "Help the coverage checker!" [] public exportdata ParseError tok = Error String (List tok) ||| Parse a list of tokens according to the given grammar. If successful,||| returns a pair of the parse result and the unparsed tokens (the remaining||| input).exportparse : {c : Bool} -> (act : Grammar tok c ty) -> (xs : List tok) ->        Either (ParseError tok) (ty, List tok)parse act xs    = case doParse False xs act of           Failure _ _ msg ts => Left (Error msg ts)           EmptyRes _ val rest => pure (val, rest)           NonEmptyRes _ val rest => pure (val, rest)

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t