bloblang

Documentation

Index

• func NewField(expr string) (*field.Expression, error)
• func NewFieldWithContext(ctx parser.Context, expr string) (*field.Expression, error)
• func NewMapping(path, expr string) (*mapping.Executor, error)
• func NewMappingWithContext(ctx parser.Context, path, expr string) (*mapping.Executor, error)

Functions

func NewField

func NewField(expr string) (*field.Expression, error)

NewField attempts to parse and create a dynamic field expression from a string. If the expression is invalid an error is returned.

When a parsing error occurs the returned error will be a *parser.Error type, which allows you to gain positional and structured error messages.

func NewFieldWithContext

func NewFieldWithContext(ctx parser.Context, expr string) (*field.Expression, error)

NewFieldWithContext attempts to parse and create a dynamic field expression from a string using a provided context to determine available functions, methods and features. If the expression is invalid an error is returned.

When a parsing error occurs the returned error will be a *parser.Error type, which allows you to gain positional and structured error messages.

func NewMapping

func NewMapping(path, expr string) (*mapping.Executor, error)

NewMapping attempts to parse and create a Bloblang mapping from a string. If the mapping was read from a file the path should be provided in order to resolve relative imports, otherwise the path can be left empty.

When a parsing error occurs the returned error may be a *parser.Error type, which allows you to gain positional and structured error messages.

func NewMappingWithContext

func NewMappingWithContext(ctx parser.Context, path, expr string) (*mapping.Executor, error)

NewMappingWithContext attempts to parse and create a Bloblang mapping from a string using a specific context for determining available functions, methods and features. If the mapping was read from a file the path should be provided in order to resolve relative imports, otherwise the path can be left empty.

When a parsing error occurs the returned error may be a *parser.Error type, which allows you to gain positional and structured error messages.