github.com

classParser

packages/bison-parser/src/Parser.php:29
final class Parser
Public API: explicitly declared with @visibility public.

Reads a GNU Bison grammar file into a syntax tree that keeps everything the file says.

The reader follows Bison's own scan-gram.l and parse-gram.y, so a file Bison accepts is read the way Bison reads it, and a file Bison rejects raises a SyntaxException naming the place. Host code is kept as text, never interpreted.

Reading a grammardoctest
$file = (new \BisonParser\Parser())->parse("%token NUM\n%left '+'\n%%\nexpr: expr '+' expr | NUM ;\n");
    count($file->declarations) // => 2
    $file->rules()[0]->name->value // => 'expr'
Rejecting a file Bison rejectsdoctest
(new \BisonParser\Parser())->parse("%tokens A\n%%\ns: A;\n") // throws \BisonParser\SyntaxException: Invalid directive: %tokens at 1:1

Methods§

public function __construct(
    private Scanner $scanner = new \BisonParser\Scanner\Scanner(),
    private GrammarParser $grammar = new \BisonParser\Syntax\GrammarParser(),
)
source§

Parameters

$scannerScannerSplits the file into tokens
$grammarGrammarParserBuilds the tree from the tokens
Calls 2

Private surface 2§

Implementation details, listed for orientation only.

private Scanner $scanner = new \BisonParser\Scanner\Scanner()
private GrammarParser $grammar = new \BisonParser\Syntax\GrammarParser()

Test cases 16§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 2
Other tests reaching this symbol 14

Relations§

Instantiated in 2
Method calls 2
Type declarations 2