Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

parser

package

Go to main page

Versions in this module

v0

v0.32.0

Aug 19, 2026

Changes in this version

+ const HiddenAccumulatorName

+ var AllMacro = NewReceiverMacro(operators.All, 2, MakeAll, ...)

+ var ExistsMacro = NewReceiverMacro(operators.Exists, 2, MakeExists, ...)

+ var ExistsOneMacro = NewReceiverMacro(operators.ExistsOne, 2, MakeExistsOne, ...)

+ var ExistsOneMacroNew = NewReceiverMacro("existsOne", 2, MakeExistsOne, ...)

+ var FilterMacro = NewReceiverMacro(operators.Filter, 2, MakeFilter, ...)

+ var HasMacro = NewGlobalMacro(operators.Has, 1, MakeHas, ...)

+ var MapFilterMacro = NewReceiverMacro(operators.Map, 3, MakeMap, ...)

+ var MapMacro = NewReceiverMacro(operators.Map, 2, MakeMap, ...)

+ func MakeAll(eh ExprHelper, target ast.Expr, args []ast.Expr) (ast.Expr, *common.Error)

+ func MakeExists(eh ExprHelper, target ast.Expr, args []ast.Expr) (ast.Expr, *common.Error)

+ func MakeExistsOne(eh ExprHelper, target ast.Expr, args []ast.Expr) (ast.Expr, *common.Error)

+ func MakeFilter(eh ExprHelper, target ast.Expr, args []ast.Expr) (ast.Expr, *common.Error)

+ func MakeHas(eh ExprHelper, target ast.Expr, args []ast.Expr) (ast.Expr, *common.Error)

+ func MakeMap(eh ExprHelper, target ast.Expr, args []ast.Expr) (ast.Expr, *common.Error)

+ func Unparse(expr ast.Expr, info *ast.SourceInfo, opts ...UnparserOption) (string, error)

type ExprHelper

+ AccuIdentName func() string

+ Copy func(ast.Expr) ast.Expr

+ NewAccuIdent func() ast.Expr

+ NewCall func(function string, args ...ast.Expr) ast.Expr

+ NewComprehension func(iterRange ast.Expr, iterVar, accuVar string, ...) ast.Expr

+ NewComprehensionTwoVar func(iterRange ast.Expr, iterVar, iterVar2, accuVar string, ...) ast.Expr

+ NewError func(exprID int64, message string) *common.Error

+ NewIdent func(name string) ast.Expr

+ NewLiteral func(value ref.Val) ast.Expr

+ NewMemberCall func(function string, target ast.Expr, args ...ast.Expr) ast.Expr

+ NewPresenceTest func(operand ast.Expr, field string) ast.Expr

+ NewSelect func(operand ast.Expr, field string) ast.Expr

+ NewStruct func(typeName string, fieldInits ...ast.EntryExpr) ast.Expr

+ NewStructField func(field string, init ast.Expr, optional bool) ast.EntryExpr

+ type MacroOpt func(*macro) *macro

+ func MacroDocs(docs ...string) MacroOpt

+ func MacroExamples(examples ...string) MacroOpt

+ type Option func(*options) error

+ func EnableHiddenAccumulatorName(enabled bool) Option

+ func EnableIdentEscapeSyntax(enableIdentEscapeSyntax bool) Option

+ func EnableOptionalSyntax(optionalSyntax bool) Option

+ func EnableVariadicOperatorASTs(varArgASTs bool) Option

+ func ErrorRecoveryLimit(limit int) Option

+ func ErrorRecoveryLookaheadTokenLimit(limit int) Option

+ func ErrorReportingLimit(limit int) Option

+ func ExpressionSizeCodePointLimit(expressionSizeCodePointLimit int) Option

+ func Macros(macros ...Macro) Option

+ func MaxExpressionNodeCount(limit int) Option

+ func MaxRecursionDepth(limit int) Option

+ func PopulateMacroCalls(populateMacroCalls bool) Option

+ type Parser struct

+ func NewParser(opts ...Option) (*Parser, error)

+ func (p *Parser) Parse(source common.Source) (*ast.AST, *common.Errors)

+ type UnparserOption func(*unparserOption) (*unparserOption, error)

+ func WrapAfterColumnLimit(wrapAfter bool) UnparserOption

+ func WrapOnColumn(col int) UnparserOption

+ func WrapOnOperators(symbols ...string) UnparserOption

v0.1.0

Feb 5, 2019

Changes in this version

+ const AccumulatorName

+ var AllMacros = []Macro

+ var NoMacros = []Macro

+ func Parse(source common.Source) (*exprpb.ParsedExpr, *common.Errors)

+ func ParseWithMacros(source common.Source, macros []Macro) (*exprpb.ParsedExpr, *common.Errors)

+ type ExprHelper interface

+ Fold func(iterVar string, iterRange *exprpb.Expr, accuVar string, accuInit *exprpb.Expr, ...) *exprpb.Expr

+ GlobalCall func(function string, args ...*exprpb.Expr) *exprpb.Expr

+ Ident func(name string) *exprpb.Expr

+ LiteralBool func(value bool) *exprpb.Expr

+ LiteralBytes func(value []byte) *exprpb.Expr

+ LiteralDouble func(value float64) *exprpb.Expr

+ LiteralInt func(value int64) *exprpb.Expr

+ LiteralString func(value string) *exprpb.Expr

+ LiteralUint func(value uint64) *exprpb.Expr

+ NewList func(elems ...*exprpb.Expr) *exprpb.Expr

+ NewMap func(entries ...*exprpb.Expr_CreateStruct_Entry) *exprpb.Expr

+ NewMapEntry func(key *exprpb.Expr, val *exprpb.Expr) *exprpb.Expr_CreateStruct_Entry

+ NewObject func(typeName string, fieldInits ...*exprpb.Expr_CreateStruct_Entry) *exprpb.Expr

+ NewObjectFieldInit func(field string, init *exprpb.Expr) *exprpb.Expr_CreateStruct_Entry

+ OffsetLocation func(exprID int64) common.Location

+ PresenceTest func(operand *exprpb.Expr, field string) *exprpb.Expr

+ ReceiverCall func(function string, target *exprpb.Expr, args ...*exprpb.Expr) *exprpb.Expr

+ Select func(operand *exprpb.Expr, field string) *exprpb.Expr

+ type Macro interface

+ ArgCount func() int

+ Expander func() MacroExpander

+ Function func() string

+ IsReceiverStyle func() bool

+ MacroKey func() string

+ func NewGlobalMacro(function string, argCount int, expander MacroExpander) Macro

+ func NewGlobalVarArgMacro(function string, expander MacroExpander) Macro

+ func NewReceiverMacro(function string, argCount int, expander MacroExpander) Macro

+ func NewReceiverVarArgMacro(function string, expander MacroExpander) Macro

+ type MacroExpander func(eh ExprHelper, target *exprpb.Expr, args []*exprpb.Expr) (*exprpb.Expr, *common.Error)