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
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.27.4

Mar 10, 2026

v0.27.3

Mar 10, 2026

v0.27.2

Mar 8, 2026

v0.27.1

Mar 8, 2026

v0.27.0

Mar 8, 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 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)