Data.Makefile.Parse

Documentation

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.

>>> parseAll assignment "foo = bar "
Right (Assignment RecursiveAssign "foo" "bar")

>>> parseAll assignment "foo := bar "
Right (Assignment SimpleAssign "foo" "bar")

>>> parseAll assignment "foo ::= bar "
Right (Assignment SimplePosixAssign "foo" "bar")

>>> parseAll assignment "foo?= bar "
Right (Assignment ConditionalAssign "foo" "bar")

>>> parseAll assignment "foo??= bar "
Right (Assignment ConditionalAssign "foo?" "bar")

>>> parseAll assignment "foo!?!= bar "
Right (Assignment ShellAssign "foo!?" "bar")

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

otherLine :: Parser Entry

Catch all, used for * comments, empty lines * lines that failed to parse

>>> parseAll otherLine "# I AM A COMMENT\n"
Right (OtherLine "# I AM A COMMENT")

Ensure all Entrys consume the end of line: >>> parseAll otherLine "n" Right (OtherLine "")

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"