jsonpath

Documentation

Overview

Package jsonpath implements Stefan Goener's JSONPath http://goessner.net/articles/JsonPath/

A jsonpath applies to any JSON decoded data using interface{} when decoded with encoding/json (http://golang.org/pkg/encoding/json/) :

var bookstore interface{}
err := json.Unmarshal(data, &bookstore)
authors, err := jsonpath.Read(bookstore, "$..authors")

A jsonpath expression can be prepared to be reused multiple times :

allAuthors, err := jsonpath.Prepare("$..authors")
...
var bookstore interface{}
err = json.Unmarshal(data, &bookstore)
authors, err := allAuthors(bookstore)

The type of the values returned by the `Read` method or `Prepare` functions depends on the jsonpath expression.

Limitations

No support for subexpressions and filters. Strings in brackets must use double quotes. It cannot operate on JSON decoded struct fields.

Index

• func Find(j interface{}, jpath string) interface{}
• func FindFirst(j interface{}, jpath string) interface{}
• func Read(value interface{}, path string) (interface{}, error)
• func Replace(originMap map[string]interface{}, path string, replaceValue interface{}) (map[string]interface{}, error)
• func ReplaceAll(j interface{}, jpath string, replaceValue interface{}) map[string]interface{}
• type FilterFunc
  • func Prepare(path string) (FilterFunc, error)

Functions

func Find

func Find(j interface{}, jpath string) interface{}

func FindFirst

func FindFirst(j interface{}, jpath string) interface{}

func Read

func Read(value interface{}, path string) (interface{}, error)

Read a path from a decoded JSON array or object ([]interface{} or map[string]interface{}) and returns the corresponding value or an error.

The returned value type depends on the requested path and the JSON value.

func Replace

func Replace(originMap map[string]interface{}, path string, replaceValue interface{}) (map[string]interface{}, error)

Replace

func ReplaceAll

func ReplaceAll(j interface{}, jpath string, replaceValue interface{}) map[string]interface{}

Types

type FilterFunc

type FilterFunc func(value interface{}) (interface{}, error)

FilterFunc applies a prepared json path to a JSON decoded value

func Prepare

func Prepare(path string) (FilterFunc, error)

Prepare will parse the path and return a filter function that can then be applied to decoded JSON values.