GoParser
Golang (1.18) parser written in PHP 8.1
Installation
To install this package, run:
composer require tuqqu/go-parser
Example
$parser = new \GoParser\Parser('
package main
import "fmt"
func main() {
res := add(1, 2)
fmt.Println("1+2 =", res)
}
');
$ast = $parser->parse();
$errs = $parser->getErrors();
Supported language level: Go 1.18 (generics).
Parsing single declarations
If you want, you can parse only a single declaration (e.g. a single function), instead of a fully defined Go program:
$parser = new \GoParser\Parser(
'func add(x, y int) int { return x + y }',
mode: \GoParser\ParseMode::SingleDecl
);
$decl = $parser->parseSingleDecl();
Parser is able to recover itself if a parse error occurs, in this case it will continue parsing at the closest node it is able to recognise.
The resulting AST will be as full as possible, and you have to check getErrors() to see errors.
Abstract Syntax Tree
Parsing results in an Abstract Syntax Tree result. See src/Ast.
For the most part the AST nodes structure follows closely the official Golang specification.
Some Nodes may also have a bit different name (e.g. ExpressionList vs ExprList), but mostly the names are either the same or easily recognisable.
CLI
Package comes with a CLI command:
./vendor/bin/go-parser main.go [--flags]
By default, it uses a simple NodeDumper to print AST.
Use --help to see other options.
55 Jul 31, 2022
1 Jan 7, 2022
113 Dec 6, 2022
0 Jul 27, 2022
272 Dec 22, 2022
951 Dec 25, 2022
24 Oct 4, 2022
173 Dec 30, 2022
12.6k Dec 30, 2022
4 Feb 12, 2022
32 Dec 29, 2022
15.9k Jan 8, 2023
350 Dec 27, 2022
3 May 30, 2022
4 Sep 3, 2022
523 Dec 21, 2022
25 Aug 24, 2022
6.6k Dec 29, 2022