operations

Documentation

Index

• func Delete(root types.Node, path []types.PathElement, args ...any) error
• func Merge(root types.Node, path []types.PathElement, args ...any) error
• func Pop(root types.Node, path []types.PathElement, args ...any) error
• func Push(root types.Node, path []types.PathElement, args ...any) error
• func Set(root types.Node, path []types.PathElement, args ...any) error
• type Argument
• type ArrIndexPathElement
  • func (b *ArrIndexPathElement) Capture(values []string) error
• type Boolean
  • func (b *Boolean) Capture(values []string) error
• type Call
• type JSON
  • func (b *JSON) Capture(values []string) error
• type OpInstance
  • func (op *OpInstance) Apply(root types.Node) error
  • func (op *OpInstance) String() string
• type Operation
• type Parser
  • func NewParser() *Parser
  • func (p *Parser) Parse(s string) (*OpInstance, error)
• type PathElement
• type StringPathElement
  • func (b *StringPathElement) Capture(values []string) error

Functions

func Delete

func Delete(root types.Node, path []types.PathElement, args ...any) error

func Merge

func Merge(root types.Node, path []types.PathElement, args ...any) error

func Pop

func Pop(root types.Node, path []types.PathElement, args ...any) error

func Push

func Push(root types.Node, path []types.PathElement, args ...any) error

func Set

func Set(root types.Node, path []types.PathElement, args ...any) error

Types

type Argument

type Argument struct {
	Float  *float64 `  @Float`
	Int    *int     `| @Int`
	Bool   *Boolean `| @("true" | "false")`
	Null   bool     `| @"null"`
	String *string  `| @String | @Ident`
	JSON   *JSON    `| @JSON`
}

type ArrIndexPathElement

type ArrIndexPathElement int

func (*ArrIndexPathElement) Capture

func (b *ArrIndexPathElement) Capture(values []string) error

we need to do this because lexer will return text like `[0]` as a single token because of json

type Boolean

type Boolean bool

func (*Boolean) Capture

func (b *Boolean) Capture(values []string) error

type Call

type Call struct {
	Name      string        `@Ident`
	Path      []PathElement `"(" @@+`
	Arguments []Argument    `( "," @@ )* ")"`
}

type JSON

type JSON struct {
	Val any
}

func (*JSON) Capture

func (b *JSON) Capture(values []string) error

It's unfortunate that we have parse json one more time instead of having the value in the token already

type OpInstance

type OpInstance struct {
	Op   Operation
	Name string
	Path types.PathElementSlice
	Args []any
}

func (*OpInstance) Apply

func (op *OpInstance) Apply(root types.Node) error

func (*OpInstance) String

func (op *OpInstance) String() string

type Operation

type Operation func(root types.Node, path []types.PathElement, args ...any) error

type Parser

type Parser struct {
	// contains filtered or unexported fields
}

func NewParser

func NewParser() *Parser

func (*Parser) Parse

func (p *Parser) Parse(s string) (*OpInstance, error)

We should be parsing things like set(field, "123") // set a string set(field, 123) // set a number set(field, { a: 1 }) // assign an object to a field set(field, "{ a: 1 }") // assign an string to a field del(field.item) // delete a field Problems: - Only double quotes are supported for strings which makes passing valid json a pain - array indexes are not supported

type PathElement

type PathElement struct {
	// potential foot gun there, I did not want to have a
	// leading dot, but I could not write a grammar rule
	// to exclude it from the first match only, hence
	// I've made it optional
	ObjectField StringPathElement   ` "."? (@String | @Ident)`
	ArrayIdx    ArrIndexPathElement ` | @JSON`
}

type StringPathElement

type StringPathElement string

func (*StringPathElement) Capture

func (b *StringPathElement) Capture(values []string) error