pypuppetdbquery.parser module

exception pypuppetdbquery.parser.ParseException(message, position)

Bases: Exception

Raised for errors encountered during parsing.

The position of the lexer when the error was encountered (the index into the input string) is stored in the position attribute.

class pypuppetdbquery.parser.Parser(lex_options=None, yacc_options=None)

Bases: object

Parser for the PuppetDBQuery language.

This class uses ply.yacc.yacc() to implement the parser. In concert with pypuppetdbquery.lexer.Lexer, it produces an Abstract Syntax Tree (AST) as declared in pypuppetdbquery.ast.

Parameters:

• lex_options (dict) – Passed as keyword arguments to pypuppetdbquery.lexer.Lexer
• yacc_options (dict) – Passed as keyword arguments to ply.yacc.yacc()

Note

Many of the docstrings in this class are used by ply.yacc to build the parser. These strings are not particularly useful for generating documentation from, so the built documentation for this class may not be very useful.

p_block_expr(p)

block_expr : LBRACE expr RBRACE

p_boolean(p)

boolean : BOOLEAN

p_comparison_expr(p)

comparison_expr : identifier_path comparison_op literal

p_comparison_op(p)

comparison_op : MATCH

NOTMATCH

EQUALS

NOTEQUALS

GREATERTHAN

GREATERTHANEQ

LESSTHAN

LESSTHANEQ

p_empty(p)

empty :

p_error(p)

p_expr(p)

expr : resource_expr

comparison_expr

subquery

p_expr_and(p)

expr : expr AND expr

p_expr_identifier_path(p)

expr : identifier_path

p_expr_not(p)

expr : NOT expr

p_expr_or(p)

expr : expr OR expr

p_expr_parenthesized(p)

expr : LPAREN expr RPAREN

p_float(p)

float : FLOAT

p_identifier(p)

identifier : string

integer

p_identifier_path(p)

identifier_path : identifier

p_identifier_path_nested(p)

identifier_path : identifier_path DOT identifier

p_identifier_regexp(p)

identifier : MATCH string

p_identifier_wild(p)

identifier : ASTERISK

p_integer(p)

integer : NUMBER

p_literal(p)

literal : boolean

string

integer

float

p_literal_date(p)

literal : AT string

p_query(p)

query : expr

empty

p_resource_expr(p)

resource_expr : string LBRACK identifier RBRACK

p_resource_expr_exported(p)

resource_expr : EXPORTED string LBRACK identifier RBRACK

p_resource_expr_exported_param(p)

resource_expr : EXPORTED string LBRACK identifier RBRACK block_expr

p_resource_expr_param(p)

resource_expr : string LBRACK identifier RBRACK block_expr

p_string(p)

string : STRING

p_subquery_block(p)

subquery : HASH string block_expr

p_subquery_comparison(p)

subquery : HASH string DOT comparison_expr

parse(text, debug=0)

Parse the input string and return an AST.

Parameters:

• text (str) – The query to parse
• debug (bool) – Output detailed information during the parsing process

Returns:

An Abstract Syntax Tree

Return type:

pypuppetdbquery.ast.Query

precedence = (('left', 'OR'), ('left', 'AND'), ('left', 'EQUALS', 'MATCH', 'LESSTHAN', 'GREATERTHAN'), ('right', 'NOT'))

Precedence rules in lowest to highest order

start = 'query'

Non-terminal to use as the starting grammar symbol