Construct.Classes

The only good reason to import this module is if you intend to add another instance of the classes it exports.

Documentation

class Alternative m => AlternativeFail m where

Subclass of Alternative that carries an error message in case of failure

Minimal complete definition

Nothing

Methods

failure :: String -> m a

Equivalent to empty except it takes an error message it may carry or drop on the floor. The grammatical form of the argument be a noun representing the unexpected value.

expectedName :: String -> m a -> m a

Sets or modifies the expected value.

Instances

AlternativeFail []

Defined in Construct.Classes

Methods

failure :: String -> [a]

expectedName :: String -> [a] -> [a]

AlternativeFail Maybe

Defined in Construct.Classes

Methods

failure :: String -> Maybe a

expectedName :: String -> Maybe a -> Maybe a

AlternativeFail (Either Error)

Defined in Construct.Classes

Methods

failure :: String -> Either Error a

expectedName :: String -> Either Error a -> Either Error a

class LookAheadParsing m => InputParsing m where

Methods for parsing factorial monoid inputs

Minimal complete definition

getInput, take, satisfy

Associated Types

type ParserInput m

Methods

getInput :: m (ParserInput m)

Always sucessful parser that returns the remaining input without consuming it.

anyToken :: m (ParserInput m)

A parser that accepts any single atomic prefix of the input stream. > anyToken == satisfy (const True) > anyToken == take 1

take :: Int -> m (ParserInput m)

A parser that accepts exactly the given number of input atoms.

satisfy :: (ParserInput m -> Bool) -> m (ParserInput m)

A parser that accepts an input atom only if it satisfies the given predicate.

notSatisfy :: (ParserInput m -> Bool) -> m ()

A parser that succeeds exactly when satisfy doesn't, equivalent to notFollowedBy . satisfy

scan :: state -> (state -> ParserInput m -> Maybe state) -> m (ParserInput m)

A stateful scanner. The predicate modifies a state argument, and each transformed state is passed to successive invocations of the predicate on each token of the input until one returns Nothing or the input ends.

This parser does not fail. It will return an empty string if the predicate returns Nothing on the first character.

Note: Because this parser does not fail, do not use it with combinators such as many, because such parsers loop until a failure occurs. Careless use will thus result in an infinite loop.

string :: ParserInput m -> m (ParserInput m)

A parser that consumes and returns the given prefix of the input.

takeWhile :: (ParserInput m -> Bool) -> m (ParserInput m)

A parser accepting the longest sequence of input atoms that match the given predicate; an optimized version of 'concatMany . satisfy'.

Note: Because this parser does not fail, do not use it with combinators such as many, because such parsers loop until a failure occurs. Careless use will thus result in an infinite loop.

takeWhile1 :: (ParserInput m -> Bool) -> m (ParserInput m)

A parser accepting the longest non-empty sequence of input atoms that match the given predicate; an optimized version of 'concatSome . satisfy'.

concatMany :: Monoid a => m a -> m a

Zero or more argument occurrences like many, with concatenated monoidal results.

concatMany :: (Monoid a, Alternative m) => m a -> m a

Zero or more argument occurrences like many, with concatenated monoidal results.

string :: (Monad m, LeftReductive (ParserInput m), FactorialMonoid (ParserInput m), Show (ParserInput m)) => ParserInput m -> m (ParserInput m)

A parser that consumes and returns the given prefix of the input.

scan :: (Monad m, FactorialMonoid (ParserInput m)) => state -> (state -> ParserInput m -> Maybe state) -> m (ParserInput m)

A stateful scanner. The predicate modifies a state argument, and each transformed state is passed to successive invocations of the predicate on each token of the input until one returns Nothing or the input ends.

This parser does not fail. It will return an empty string if the predicate returns Nothing on the first character.

Note: Because this parser does not fail, do not use it with combinators such as many, because such parsers loop until a failure occurs. Careless use will thus result in an infinite loop.

takeWhile :: (Monad m, FactorialMonoid (ParserInput m)) => (ParserInput m -> Bool) -> m (ParserInput m)

A parser accepting the longest sequence of input atoms that match the given predicate; an optimized version of 'concatMany . satisfy'.

Note: Because this parser does not fail, do not use it with combinators such as many, because such parsers loop until a failure occurs. Careless use will thus result in an infinite loop.

takeWhile1 :: (Monad m, FactorialMonoid (ParserInput m)) => (ParserInput m -> Bool) -> m (ParserInput m)

A parser accepting the longest non-empty sequence of input atoms that match the given predicate; an optimized version of 'concatSome . satisfy'.

Instances

InputParsing Parser

Defined in Construct.Classes

Associated Types

type ParserInput Parser :: Type

Methods

getInput :: Parser (ParserInput Parser)

anyToken :: Parser (ParserInput Parser)

take :: Int -> Parser (ParserInput Parser)

satisfy :: (ParserInput Parser -> Bool) -> Parser (ParserInput Parser)

notSatisfy :: (ParserInput Parser -> Bool) -> Parser ()

scan :: state -> (state -> ParserInput Parser -> Maybe state) -> Parser (ParserInput Parser)

string :: ParserInput Parser -> Parser (ParserInput Parser)

takeWhile :: (ParserInput Parser -> Bool) -> Parser (ParserInput Parser)

takeWhile1 :: (ParserInput Parser -> Bool) -> Parser (ParserInput Parser)

concatMany :: Monoid a => Parser a -> Parser a

InputParsing Parser

Defined in Construct.Classes

Associated Types

type ParserInput Parser :: Type

Methods

getInput :: Parser (ParserInput Parser)

anyToken :: Parser (ParserInput Parser)

take :: Int -> Parser (ParserInput Parser)

satisfy :: (ParserInput Parser -> Bool) -> Parser (ParserInput Parser)

notSatisfy :: (ParserInput Parser -> Bool) -> Parser ()

scan :: state -> (state -> ParserInput Parser -> Maybe state) -> Parser (ParserInput Parser)

string :: ParserInput Parser -> Parser (ParserInput Parser)

takeWhile :: (ParserInput Parser -> Bool) -> Parser (ParserInput Parser)

takeWhile1 :: (ParserInput Parser -> Bool) -> Parser (ParserInput Parser)

concatMany :: Monoid a => Parser a -> Parser a

InputParsing ReadP

Defined in Construct.Classes

Associated Types

type ParserInput ReadP :: Type

Methods

getInput :: ReadP (ParserInput ReadP)

anyToken :: ReadP (ParserInput ReadP)

take :: Int -> ReadP (ParserInput ReadP)

satisfy :: (ParserInput ReadP -> Bool) -> ReadP (ParserInput ReadP)

notSatisfy :: (ParserInput ReadP -> Bool) -> ReadP ()

scan :: state -> (state -> ParserInput ReadP -> Maybe state) -> ReadP (ParserInput ReadP)

string :: ParserInput ReadP -> ReadP (ParserInput ReadP)

takeWhile :: (ParserInput ReadP -> Bool) -> ReadP (ParserInput ReadP)

takeWhile1 :: (ParserInput ReadP -> Bool) -> ReadP (ParserInput ReadP)

concatMany :: Monoid a => ReadP a -> ReadP a

(FactorialMonoid s, LeftReductive s, LookAheadParsing (Parser t s)) => InputParsing (Parser t s)

Defined in Construct.Classes

Associated Types

type ParserInput (Parser t s) :: Type

Methods

getInput :: Parser t s (ParserInput (Parser t s))

anyToken :: Parser t s (ParserInput (Parser t s))

take :: Int -> Parser t s (ParserInput (Parser t s))

satisfy :: (ParserInput (Parser t s) -> Bool) -> Parser t s (ParserInput (Parser t s))

notSatisfy :: (ParserInput (Parser t s) -> Bool) -> Parser t s ()

scan :: state -> (state -> ParserInput (Parser t s) -> Maybe state) -> Parser t s (ParserInput (Parser t s))

string :: ParserInput (Parser t s) -> Parser t s (ParserInput (Parser t s))

takeWhile :: (ParserInput (Parser t s) -> Bool) -> Parser t s (ParserInput (Parser t s))

takeWhile1 :: (ParserInput (Parser t s) -> Bool) -> Parser t s (ParserInput (Parser t s))

concatMany :: Monoid a => Parser t s a -> Parser t s a

class (CharParsing m, InputParsing m) => InputCharParsing m where

Methods for parsing textual monoid inputs

Minimal complete definition

Nothing

Methods

satisfyCharInput :: (Char -> Bool) -> m (ParserInput m)

Specialization of satisfy on textual inputs, accepting an input character only if it satisfies the given predicate, and returning the input atom that represents the character. Equivalent to fmap singleton . Char.satisfy

notSatisfyChar :: (Char -> Bool) -> m ()

A parser that succeeds exactly when satisfy doesn't, equivalent to notFollowedBy . Char.satisfy

scanChars :: state -> (state -> Char -> Maybe state) -> m (ParserInput m)

Stateful scanner like scan, but specialized for TextualMonoid inputs.

takeCharsWhile :: (Char -> Bool) -> m (ParserInput m)

Specialization of takeWhile on TextualMonoid inputs, accepting the longest sequence of input characters that match the given predicate; an optimized version of fmap fromString . many . Char.satisfy.

Note: Because this parser does not fail, do not use it with combinators such as many, because such parsers loop until a failure occurs. Careless use will thus result in an infinite loop.

takeCharsWhile1 :: (Char -> Bool) -> m (ParserInput m)

Specialization of takeWhile1 on TextualMonoid inputs, accepting the longest sequence of input characters that match the given predicate; an optimized version of fmap fromString . some . Char.satisfy.

satisfyCharInput :: IsString (ParserInput m) => (Char -> Bool) -> m (ParserInput m)

Specialization of satisfy on textual inputs, accepting an input character only if it satisfies the given predicate, and returning the input atom that represents the character. Equivalent to fmap singleton . Char.satisfy

scanChars :: (Monad m, TextualMonoid (ParserInput m)) => state -> (state -> Char -> Maybe state) -> m (ParserInput m)

Stateful scanner like scan, but specialized for TextualMonoid inputs.

takeCharsWhile :: (Monad m, TextualMonoid (ParserInput m)) => (Char -> Bool) -> m (ParserInput m)

Specialization of takeWhile on TextualMonoid inputs, accepting the longest sequence of input characters that match the given predicate; an optimized version of fmap fromString . many . Char.satisfy.

Note: Because this parser does not fail, do not use it with combinators such as many, because such parsers loop until a failure occurs. Careless use will thus result in an infinite loop.

takeCharsWhile1 :: (Monad m, TextualMonoid (ParserInput m)) => (Char -> Bool) -> m (ParserInput m)

Specialization of takeWhile1 on TextualMonoid inputs, accepting the longest sequence of input characters that match the given predicate; an optimized version of fmap fromString . some . Char.satisfy.

Instances

InputCharParsing Parser

Defined in Construct.Classes

Methods

satisfyCharInput :: (Char -> Bool) -> Parser (ParserInput Parser)

notSatisfyChar :: (Char -> Bool) -> Parser ()

scanChars :: state -> (state -> Char -> Maybe state) -> Parser (ParserInput Parser)

takeCharsWhile :: (Char -> Bool) -> Parser (ParserInput Parser)

takeCharsWhile1 :: (Char -> Bool) -> Parser (ParserInput Parser)

InputCharParsing Parser

Defined in Construct.Classes

Methods

satisfyCharInput :: (Char -> Bool) -> Parser (ParserInput Parser)

notSatisfyChar :: (Char -> Bool) -> Parser ()

scanChars :: state -> (state -> Char -> Maybe state) -> Parser (ParserInput Parser)

takeCharsWhile :: (Char -> Bool) -> Parser (ParserInput Parser)

takeCharsWhile1 :: (Char -> Bool) -> Parser (ParserInput Parser)

InputCharParsing ReadP

Defined in Construct.Classes

Methods

satisfyCharInput :: (Char -> Bool) -> ReadP (ParserInput ReadP)

notSatisfyChar :: (Char -> Bool) -> ReadP ()

scanChars :: state -> (state -> Char -> Maybe state) -> ReadP (ParserInput ReadP)

takeCharsWhile :: (Char -> Bool) -> ReadP (ParserInput ReadP)

takeCharsWhile1 :: (Char -> Bool) -> ReadP (ParserInput ReadP)

(TextualMonoid s, LeftReductive s, LookAheadParsing (Parser t s)) => InputCharParsing (Parser t s)

Defined in Construct.Classes

Methods

satisfyCharInput :: (Char -> Bool) -> Parser t s (ParserInput (Parser t s))

notSatisfyChar :: (Char -> Bool) -> Parser t s ()

scanChars :: state -> (state -> Char -> Maybe state) -> Parser t s (ParserInput (Parser t s))

takeCharsWhile :: (Char -> Bool) -> Parser t s (ParserInput (Parser t s))

takeCharsWhile1 :: (Char -> Bool) -> Parser t s (ParserInput (Parser t s))

class InputMappableParsing m where

A subclass of InputParsing for parsers that can switch the input stream type

Methods

mapParserInput :: (InputParsing (m s), s ~ ParserInput (m s), Monoid s, Monoid s') => (s -> s') -> (s' -> s) -> m s a -> m s' a

Converts a parser accepting one input stream type to another. The functions forth and back must be inverses of each other and they must distribute through <>:

f (s1 <> s2) == f s1 <> f s2

mapMaybeParserInput :: (InputParsing (m s), s ~ ParserInput (m s), Monoid s, Monoid s') => (s -> Maybe s') -> (s' -> Maybe s) -> m s a -> m s' a

Converts a parser accepting one input stream type to another just like mapParserInput, except the argument functions can return Nothing to indicate they need more input.

Instances

InputMappableParsing (Parser t)

Defined in Construct.Classes

Methods

mapParserInput :: (InputParsing (Parser t s), s ~ ParserInput (Parser t s), Monoid s, Monoid s') => (s -> s') -> (s' -> s) -> Parser t s a -> Parser t s' a

mapMaybeParserInput :: (InputParsing (Parser t s), s ~ ParserInput (Parser t s), Monoid s, Monoid s') => (s -> Maybe s') -> (s' -> Maybe s) -> Parser t s a -> Parser t s' a

class Monad m => FixTraversable m where

A subclass of MonadFix for monads that can fix a function that handles higher-kinded data

Minimal complete definition

Nothing

Methods

fixSequence :: (Traversable g, Applicative n) => g m -> m (g n)

This specialized form of traverse can be used inside mfix.

Instances

FixTraversable Parser

Defined in Construct.Classes

Methods

fixSequence :: (Traversable g, Applicative n) => g Parser -> Parser (g n)

Monoid s => FixTraversable (Parser t s)

Defined in Construct.Classes

Methods

fixSequence :: (Traversable g, Applicative n) => g (Parser t s) -> Parser t s (g n)

data Error

Constructors

Error [String] (Maybe String)

Instances

Eq Error

Defined in Construct.Classes

Methods

(==) :: Error -> Error -> Bool

(/=) :: Error -> Error -> Bool

Show Error

Defined in Construct.Classes

Methods

showsPrec :: Int -> Error -> ShowS

show :: Error -> String

showList :: [Error] -> ShowS

Semigroup Error

Defined in Construct.Classes

Methods

(<>) :: Error -> Error -> Error

sconcat :: NonEmpty Error -> Error

stimes :: Integral b => b -> Error -> Error

Alternative (Either Error)

Defined in Construct.Classes

Methods

empty :: Either Error a

(<|>) :: Either Error a -> Either Error a -> Either Error a

some :: Either Error a -> Either Error [a]

many :: Either Error a -> Either Error [a]

AlternativeFail (Either Error)

Defined in Construct.Classes

Methods

failure :: String -> Either Error a

expectedName :: String -> Either Error a -> Either Error a

errorString :: Error -> String

concatExpected :: [String] -> Maybe String

oxfordComma :: String -> [String] -> String