trifecta-1.6: A modern parser combinator library with convenient diagnostics

Copyright(c) Edward Kmett 2011-2015
LicenseBSD3
Maintainerekmett@gmail.com
Stabilityexperimental
Portabilitynon-portable
Safe HaskellNone
LanguageHaskell2010

Text.Trifecta.Combinators

Description

 

Synopsis

Documentation

class (MonadPlus m, TokenParsing m) => DeltaParsing m where Source #

This class provides parsers with easy access to:

1) the current line contents. 2) the current position as a Delta. 3) the ability to use sliced on any parser.

Minimal complete definition

line, position, slicedWith

Methods

line :: m ByteString Source #

Retrieve the contents of the current line (from the beginning of the line)

position :: m Delta Source #

Retrieve the current position as a Delta.

slicedWith :: (a -> ByteString -> r) -> m a -> m r Source #

Run a parser, grabbing all of the text between its start and end points

rend :: DeltaParsing m => m Rendering Source #

Retrieve a Rendering of the current linem noting this position, but not placing a Caret there.

restOfLine :: DeltaParsing m => m ByteString Source #

Grab the remainder of the current line

Instances

DeltaParsing Parser Source # 
(MonadPlus m, DeltaParsing m) => DeltaParsing (IdentityT * m) Source # 
(MonadPlus m, DeltaParsing m) => DeltaParsing (StateT s m) Source # 
(MonadPlus m, DeltaParsing m) => DeltaParsing (StateT s m) Source # 
(MonadPlus m, DeltaParsing m, Monoid w) => DeltaParsing (WriterT w m) Source # 
(MonadPlus m, DeltaParsing m, Monoid w) => DeltaParsing (WriterT w m) Source # 
(MonadPlus m, DeltaParsing m) => DeltaParsing (ReaderT * e m) Source # 
(MonadPlus m, DeltaParsing m, Monoid w) => DeltaParsing (RWST r w s m) Source # 

Methods

line :: RWST r w s m ByteString Source #

position :: RWST r w s m Delta Source #

slicedWith :: (a -> ByteString -> r) -> RWST r w s m a -> RWST r w s m r Source #

rend :: RWST r w s m Rendering Source #

restOfLine :: RWST r w s m ByteString Source #

(MonadPlus m, DeltaParsing m, Monoid w) => DeltaParsing (RWST r w s m) Source # 

Methods

line :: RWST r w s m ByteString Source #

position :: RWST r w s m Delta Source #

slicedWith :: (a -> ByteString -> r) -> RWST r w s m a -> RWST r w s m r Source #

rend :: RWST r w s m Rendering Source #

restOfLine :: RWST r w s m ByteString Source #

sliced :: DeltaParsing m => m a -> m ByteString Source #

Run a parser, grabbing all of the text between its start and end points and discarding the original result

careting :: DeltaParsing m => m Caret Source #

Grab a Caret pointing to the current location.

careted :: DeltaParsing m => m a -> m (Careted a) Source #

Parse a Careted result. Pointing the Caret to where you start.

spanning :: DeltaParsing m => m a -> m Span Source #

Discard the result of a parse, returning a Span from where we start to where it ended parsing.

spanned :: DeltaParsing m => m a -> m (Spanned a) Source #

Parse a Spanned result. The Span starts here and runs to the last position parsed.

fixiting :: DeltaParsing m => m ByteString -> m Fixit Source #

Grab a fixit.

class (DeltaParsing m, HasDelta d) => MarkParsing d m | m -> d where Source #

This class is a refinement of DeltaParsing that adds the ability to mark your position in the input and return there for further parsing later.

Minimal complete definition

mark, release

Methods

mark :: m d Source #

mark the current location so it can be used in constructing a span, or for later seeking

release :: d -> m () Source #

Seek a previously marked location

Instances

MarkParsing Delta Parser Source # 
(MonadPlus m, MarkParsing d m) => MarkParsing d (IdentityT * m) Source # 

Methods

mark :: IdentityT * m d Source #

release :: d -> IdentityT * m () Source #

(MonadPlus m, MarkParsing d m, Monoid w) => MarkParsing d (WriterT w m) Source # 

Methods

mark :: WriterT w m d Source #

release :: d -> WriterT w m () Source #

(MonadPlus m, MarkParsing d m, Monoid w) => MarkParsing d (WriterT w m) Source # 

Methods

mark :: WriterT w m d Source #

release :: d -> WriterT w m () Source #

(MonadPlus m, MarkParsing d m) => MarkParsing d (StateT s m) Source # 

Methods

mark :: StateT s m d Source #

release :: d -> StateT s m () Source #

(MonadPlus m, MarkParsing d m) => MarkParsing d (StateT s m) Source # 

Methods

mark :: StateT s m d Source #

release :: d -> StateT s m () Source #

(MonadPlus m, MarkParsing d m) => MarkParsing d (ReaderT * e m) Source # 

Methods

mark :: ReaderT * e m d Source #

release :: d -> ReaderT * e m () Source #

(MonadPlus m, MarkParsing d m, Monoid w) => MarkParsing d (RWST r w s m) Source # 

Methods

mark :: RWST r w s m d Source #

release :: d -> RWST r w s m () Source #

(MonadPlus m, MarkParsing d m, Monoid w) => MarkParsing d (RWST r w s m) Source # 

Methods

mark :: RWST r w s m d Source #

release :: d -> RWST r w s m () Source #