README
¶
path 🏞
Resolve data from arbitrary structures
This is an experimental library for reading/writing values into arbitrary data structures, specifically the map[string]interface{} and []interface{} values returned by Go's json.Unmarshal() functions. It is inspired by the JSON-path standard, but has a very simplified syntax -- using a series of strings separated by dots.
Example Code
s := map[string]interface{}{
"name": "John Connor",
"email": "john@connor.mil",
"relatives": map[string]interface{}{
"mom": "Sarah Connor",
"dad": "Kyle Reese",
},
"enemies": []interface{}{"T-1000", "T-3000", "T-5000"},
}
name, err := path.Get(s, "name") // John Connor
email, err := path.Get(s, "email") // john@connor.mil
sarah, err := path.Get(s, "relatives.0") // t-1000
Pull Requests Welcome
Please use GitHub to make suggestions, pull requests, and enhancements. We're all in this together! 🏞
Documentation
¶
Index ¶
- func Get(object interface{}, path string) (interface{}, error)
- func Set(object interface{}, path string, value interface{}) error
- type Getter
- type Path
- func (path Path) Get(object interface{}) (interface{}, error)
- func (path Path) HasTail() bool
- func (path Path) Head() string
- func (path Path) Index(maximum int) (int, error)
- func (path Path) IsEmpty() bool
- func (path Path) Set(object interface{}, value interface{}) error
- func (path Path) String() string
- func (path Path) Tail() Path
- type Setter
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Getter ¶
Getter interface allows other objects to make it easy to trace through their property trees, and get values from them.
type Path ¶
type Path []string
Path is a reference to a value within another data object.
func (Path) HasTail ¶ added in v0.1.2
HasTail returns TRUE if this path has one or more items in its tail.
func (Path) Index ¶
Index is useful for vetting array indices. It attempts to convert the Head() token int an integer, and then check that the integer is within the designated array bounds (is greater than zero, and less than the maximum value provided to the function).
It returns the array index and an error
Source Files