Parses .ninja files. More...

#include <manifest_parser.h>

Inheritance diagram for ManifestParser:

Public Member Functions
bool	Load (const std::string &filename, std::string err, Lexer parent=NULL)
	Load and parse a file. More...

	ManifestParser (State state, FileReader file_reader, ManifestParserOptions options=ManifestParserOptions())

bool	ParseTest (const std::string &input, std::string *err)
	Parse a text string of input. Used by tests. More...

Protected Member Functions
bool	ExpectToken (Lexer::Token expected, std::string *err)
	If the next token is not expected, produce an error string saying "expected foo, got bar". More...

Protected Attributes
FileReader *	file_reader_

Lexer	lexer_

State *	state_

Private Member Functions
bool	Parse (const std::string &filename, const std::string &input, std::string *err)
	Parse a file, given its contents as a string. More...

bool	ParseDefault (std::string *err)

bool	ParseEdge (std::string *err)

bool	ParseFileInclude (bool new_scope, std::string *err)
	Parse either a 'subninja' or 'include' line. More...

bool	ParseLet (std::string key, EvalString val, std::string *err)

bool	ParsePool (std::string *err)
	Parse various statement types. More...

bool	ParseRule (std::string *err)

Private Attributes
BindingEnv *	env_

std::vector< EvalString >	ins_

ManifestParserOptions	options_

std::vector< EvalString >	outs_

bool	quiet_

std::unique_ptr< ManifestParser >	subparser_

std::vector< EvalString >	validations_

Detailed Description

Parses .ninja files.

Definition at line 41 of file manifest_parser.h.

Constructor & Destructor Documentation

◆ ManifestParser()

ManifestParser::ManifestParser	(	State *	state,
		FileReader *	file_reader,
		ManifestParserOptions	options = `ManifestParserOptions()`
	)

Definition at line 31 of file manifest_parser.cc.

References State::bindings_, and env_.

Referenced by ParseFileInclude().

Member Function Documentation

◆ ExpectToken()

bool Parser::ExpectToken	(	Lexer::Token	expected,
		std::string *	err
	)

protectedinherited

If the next token is not expected, produce an error string saying "expected foo, got bar".

Definition at line 40 of file parser.cc.

References Lexer::TokenErrorHint(), and Lexer::TokenName().

Referenced by ParseDefault(), DyndepParser::ParseEdge(), ParseEdge(), ParseFileInclude(), DyndepParser::ParseLet(), ParseLet(), ParsePool(), and ParseRule().

◆ Load()

bool Parser::Load	(	const std::string &	filename,
		std::string *	err,
		Lexer *	parent = `NULL`
	)

inherited

Load and parse a file.

Definition at line 22 of file parser.cc.

References Lexer::Error(), METRIC_RECORD_IF, and FileReader::Okay.

Referenced by DyndepLoader::LoadDyndepFile(), LoadManifests(), and TEST_F().

◆ Parse()

bool ManifestParser::Parse	(	const std::string &	filename,
		const std::string &	input,
		std::string *	err
	)

privatevirtual

Parse a file, given its contents as a string.

Implements Parser.

Definition at line 38 of file manifest_parser.cc.

References BindingEnv::AddBinding(), Lexer::BUILD, CheckNinjaVersion(), Lexer::DEFAULT, Lexer::DescribeLastError(), env_, Lexer::ERROR, Lexer::Error(), EvalString::Evaluate(), Lexer::IDENT, Lexer::INCLUDE, Parser::lexer_, Lexer::NEWLINE, ParseDefault(), ParseEdge(), ParseFileInclude(), ParseLet(), ParsePool(), ParseRule(), Lexer::POOL, Lexer::ReadToken(), Lexer::RULE, Lexer::Start(), Lexer::SUBNINJA, Lexer::TEOF, Lexer::TokenName(), and Lexer::UnreadToken().

Referenced by ParseTest().

◆ ParseDefault()

bool ManifestParser::ParseDefault ( std::string * err )

private

Definition at line 187 of file manifest_parser.cc.

References State::AddDefault(), CanonicalizePath(), EvalString::Clear(), EvalString::empty(), env_, Lexer::Error(), EvalString::Evaluate(), Parser::ExpectToken(), Parser::lexer_, Lexer::NEWLINE, Lexer::ReadPath(), and Parser::state_.

Referenced by Parse().

◆ ParseEdge()

bool ManifestParser::ParseEdge ( std::string * err )

private

Definition at line 212 of file manifest_parser.cc.

References BindingEnv::AddBinding(), State::AddEdge(), State::AddIn(), State::AddOut(), State::AddValidation(), CanonicalizePath(), EvalString::Clear(), Lexer::COLON, Edge::dyndep_, State::edges_, EvalString::empty(), Edge::env_, env_, Lexer::Error(), EvalString::Evaluate(), Parser::ExpectToken(), Node::generated_by_dep_loader(), Edge::GetBinding(), State::GetNode(), Edge::GetUnescapedDyndep(), Edge::implicit_deps_, Edge::implicit_outs_, Lexer::INDENT, Edge::inputs_, ins_, kPhonyCycleActionWarn, Parser::lexer_, State::LookupPool(), BindingEnv::LookupRule(), Edge::maybe_phonycycle_diagnostic(), Lexer::NEWLINE, options_, Edge::order_only_deps_, Edge::outputs_, outs_, ParseLet(), Node::path(), Lexer::PeekToken(), ManifestParserOptions::phony_cycle_action_, Lexer::PIPE, Lexer::PIPE2, Lexer::PIPEAT, Edge::pool_, quiet_, Lexer::ReadIdent(), Lexer::ReadPath(), Node::set_dyndep_pending(), Parser::state_, Edge::validations_, validations_, and Warning().

Referenced by Parse().

◆ ParseFileInclude()

bool ManifestParser::ParseFileInclude	(	bool	new_scope,
		std::string *	err
	)

private

Parse either a 'subninja' or 'include' line.

Definition at line 419 of file manifest_parser.cc.

References env_, EvalString::Evaluate(), Parser::ExpectToken(), Parser::file_reader_, Parser::lexer_, ManifestParser(), Lexer::NEWLINE, options_, Lexer::ReadPath(), Parser::state_, and subparser_.

Referenced by Parse().

◆ ParseLet()

bool ManifestParser::ParseLet	(	std::string *	key,
		EvalString *	val,
		std::string *	err
	)

private

Definition at line 177 of file manifest_parser.cc.

References Lexer::EQUALS, Lexer::Error(), Parser::ExpectToken(), Parser::lexer_, Lexer::ReadIdent(), and Lexer::ReadVarValue().

Referenced by Parse(), ParseEdge(), ParsePool(), and ParseRule().

◆ ParsePool()

bool ManifestParser::ParsePool ( std::string * err )

private

Parse various statement types.

Definition at line 99 of file manifest_parser.cc.

References State::AddPool(), env_, Lexer::Error(), EvalString::Evaluate(), Parser::ExpectToken(), Lexer::INDENT, Parser::lexer_, State::LookupPool(), Lexer::NEWLINE, ParseLet(), Lexer::PeekToken(), Lexer::ReadIdent(), and Parser::state_.

Referenced by Parse().

◆ ParseRule()

bool ManifestParser::ParseRule ( std::string * err )

private

Definition at line 136 of file manifest_parser.cc.

References BindingEnv::AddRule(), env_, Lexer::Error(), Parser::ExpectToken(), Lexer::INDENT, Rule::IsReservedBinding(), Parser::lexer_, BindingEnv::LookupRuleCurrentScope(), Lexer::NEWLINE, ParseLet(), Lexer::PeekToken(), and Lexer::ReadIdent().

Referenced by Parse().

◆ ParseTest()

bool ManifestParser::ParseTest	(	const std::string &	input,
		std::string *	err
	)

inline

Parse a text string of input. Used by tests.

Definition at line 46 of file manifest_parser.h.

References Parse(), and quiet_.

Referenced by ParserTest::AssertParse(), AssertParse(), TEST_F(), and WriteTestData().

Member Data Documentation

◆ env_

BindingEnv* ManifestParser::env_

private

Definition at line 66 of file manifest_parser.h.

Referenced by ManifestParser(), Parse(), ParseDefault(), ParseEdge(), ParseFileInclude(), ParsePool(), and ParseRule().

◆ file_reader_

FileReader* Parser::file_reader_

protectedinherited

Definition at line 40 of file parser.h.

Referenced by ParseFileInclude().

◆ ins_

std::vector<EvalString> ManifestParser::ins_

private

Definition at line 74 of file manifest_parser.h.

Referenced by ParseEdge().

◆ lexer_

Lexer Parser::lexer_

protectedinherited

Definition at line 41 of file parser.h.

Referenced by DyndepParser::Parse(), Parse(), ParseDefault(), DyndepParser::ParseDyndepVersion(), DyndepParser::ParseEdge(), ParseEdge(), ParseFileInclude(), DyndepParser::ParseLet(), ParseLet(), ParsePool(), and ParseRule().

◆ options_

ManifestParserOptions ManifestParser::options_

private

Definition at line 67 of file manifest_parser.h.

Referenced by ParseEdge(), and ParseFileInclude().

◆ outs_

std::vector<EvalString> ManifestParser::outs_

private

Definition at line 74 of file manifest_parser.h.

Referenced by ParseEdge().

◆ quiet_

bool ManifestParser::quiet_

private

Definition at line 68 of file manifest_parser.h.

Referenced by ParseEdge(), and ParseTest().

◆ state_

State* Parser::state_

protectedinherited

Definition at line 39 of file parser.h.

Referenced by ParseDefault(), DyndepParser::ParseEdge(), ParseEdge(), ParseFileInclude(), and ParsePool().

◆ subparser_

std::unique_ptr<ManifestParser> ManifestParser::subparser_

private

Definition at line 73 of file manifest_parser.h.

Referenced by ParseFileInclude().

◆ validations_

std::vector<EvalString> ManifestParser::validations_

private

Definition at line 74 of file manifest_parser.h.

Referenced by ParseEdge().

The documentation for this struct was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ManifestParser()

Member Function Documentation

◆ ExpectToken()

◆ Load()

◆ Parse()

◆ ParseDefault()

◆ ParseEdge()

◆ ParseFileInclude()

◆ ParseLet()

◆ ParsePool()

◆ ParseRule()

◆ ParseTest()

Member Data Documentation

◆ env_

◆ file_reader_

◆ ins_

◆ lexer_

◆ options_

◆ outs_

◆ quiet_

◆ state_

◆ subparser_

◆ validations_