Text.Jira.Parser.Core

Core components of the Jira wiki markup parser.

Jira parser and state

type JiraParser = Parsec Text ParserState

Jira Parsec parser

data ParserState

Parser state used to keep track of various parameteres.

Constructors

ParserState

Fields

• stateInLink :: Bool

  whether the parser is within a link

• stateInList :: Bool

  whether the parser is within a list

• stateInTable :: Bool

  whether the parser is within a table

• stateLastStrPos :: Maybe SourcePos

  position at which the last string ended

defaultState :: ParserState

Default parser state (i.e., start state)

parseJira :: JiraParser a -> Text -> Either ParseError a

Parses a string with the given Jira parser.

withStateFlag :: (Bool -> ParserState -> ParserState) -> JiraParser a -> JiraParser a

Set a flag in the parser to True before running a parser, then set the flag's value to False.

String position tracking

updateLastStrPos :: JiraParser ()

Updates the state, marking the current input position as the end of a string.

notAfterString :: JiraParser Bool

Checks whether the parser is directly after a string.

Parsing helpers

endOfPara :: JiraParser ()

Succeeds if the parser is looking at the end of a paragraph.

notFollowedBy' :: Show a => JiraParser a -> JiraParser ()

Variant of parsec's notFollowedBy function which properly fails even if the given parser does not consume any input (like eof does).

blankline :: JiraParser ()

Parses an empty line, i.e., a line with no chars or whitespace only.

skipSpaces :: JiraParser ()

Skip zero or more space chars.

blockNames :: [String]

parameters :: JiraParser (Maybe Text, [Parameter])

Parses a set of panel parameters