Safe Haskell	None
Language	Haskell2010

Data.Makefile.Parse.Internal

Synopsis

Documentation

>>> :set -XOverloadedStrings

parseMakefile :: IO (Either String Makefile) #

Parse makefile.

Tries to open and parse a file name Makefile in the current directory.

parseAsMakefile :: FilePath -> IO (Either String Makefile) #

Parse the specified file as a makefile.

parseMakefileContents :: Text -> Either String Makefile #

makefile :: Parser Makefile #

Parser for a makefile

entry :: Parser Entry #

Parser for a makefile entry (either a rule or a variable assignment)

assignment :: Parser Entry #

Parser of variable assignment (see Assignment). Note that leading and trailing whitespaces will be stripped both from the variable name and assigned value.

Note that this tries to follow GNU make's (crazy) behavior when it comes to variable names and assignment operators.

>>> Atto.parseOnly assignment "foo = bar "
Right (Assignment RecursiveAssign "foo" "bar")

>>> Atto.parseOnly assignment "foo := bar "
Right (Assignment SimpleAssign "foo" "bar")

>>> Atto.parseOnly assignment "foo ::= bar "
Right (Assignment SimplePosixAssign "foo" "bar")

>>> Atto.parseOnly assignment "foo?= bar "
Right (Assignment ConditionalAssign "foo" "bar")

>>> Atto.parseOnly assignment "foo??= bar "
Right (Assignment ConditionalAssign "foo?" "bar")

>>> Atto.parseOnly assignment "foo!?!= bar "
Right (Assignment ShellAssign "foo!?" "bar")

takeWhileM :: (Char -> Parser Bool) -> Parser Text #

Read chars while some (Parser, monadic) predicate is True.

XXX: extremely inefficient.

variableName :: Parser Text #

Parse a variable name, not consuming any of the assignment operator. See also assignment.

>>> Atto.parseOnly variableName "foo!?!= bar "
Right "foo!?"

assignmentType :: Parser AssignmentType #

Parse an assignment type, not consuming any of the assigned value. See also assignment.

>>> Atto.parseOnly assignmentType "!= bar "
Right ShellAssign

rule :: Parser Entry #

Parser for an entire rule

command :: Parser Command #

Parser for a command

target :: Parser Target #

Parser for a (rule) target

dependency :: Parser Dependency #

Parser for a (rule) dependency

comment :: Parser Text #

Parser for a comment (the comment starts with the hashtag)

>>> Atto.parseOnly comment "# I AM A COMMENT"
Right " I AM A COMMENT"

nextLine :: Parser () #

Consume a newline character ('\n')

emptyLine :: Parser () #

Consume an empty line (potentially containing spaces and/or tabs).

>>> Atto.parseOnly emptyLine "\t\t   \t   \t\n"
Right ()

toLineEnd :: Parser Text #

toEscapedLineEnd :: Parser Text #

Get the contents until the end of the (potentially multi) line. Multiple lines are separated by a \ char and individual lines will be stripped and spaces will be interspersed.

The final n character is consumed.

>>> Atto.parseOnly toEscapedLineEnd "foo bar \\\n baz"
Right "foo bar baz"

>>> Atto.parseOnly toEscapedLineEnd "foo \t\\\n bar \\\n baz \\\n \t"
Right "foo bar baz"

stripped :: Parser Text -> Parser Text #