README
¶
pointerstructure 
pointerstructure is a Go library for identifying a specific value within any Go structure using a string syntax.
pointerstructure is based on JSON Pointer (RFC 6901), but reimplemented for Go.
The goal of pointerstructure is to provide a single, well-known format for addressing a specific value. This can be useful for user provided input on structures, diffs of structures, etc.
Features
-
Get the value for an address
-
Set the value for an address within an existing structure
-
Delete the value at an address
-
Sorting a list of addresses
Installation
Standard go get:
$ go get github.com/mitchellh/pointerstructure
Usage & Example
For usage and examples see the Godoc.
A quick code example is shown below:
complex := map[string]interface{}{
"alice": 42,
"bob": []interface{}{
map[string]interface{}{
"name": "Bob",
},
},
}
value, err := pointerstructure.Get(complex, "/bob/0/name")
if err != nil {
panic(err)
}
fmt.Printf("%s", value)
// Output:
// Bob
Continuing the example above, you can also set values:
value, err = pointerstructure.Set(complex, "/bob/0/name", "Alice")
if err != nil {
panic(err)
}
value, err = pointerstructure.Get(complex, "/bob/0/name")
if err != nil {
panic(err)
}
fmt.Printf("%s", value)
// Output:
// Alice
Documentation
¶
Overview ¶
Package pointerstructure provides functions for identifying a specific value within any Go structure using a string syntax.
The syntax used is based on JSON Pointer (RFC 6901).
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Get ¶
Get reads the value at the given pointer.
This is a shorthand for calling Parse on the pointer and then calling Get on that result. An error will be returned if the value cannot be found or there is an error with the format of pointer.
Example ¶
complex := map[string]interface{}{
"alice": 42,
"bob": []interface{}{
map[string]interface{}{
"name": "Bob",
},
},
}
value, err := Get(complex, "/bob/0/name")
if err != nil {
panic(err)
}
fmt.Printf("%s", value)
Output: Bob
func Set ¶
Set sets the value at the given pointer.
This is a shorthand for calling Parse on the pointer and then calling Set on that result. An error will be returned if the value cannot be found or there is an error with the format of pointer.
Set returns the complete document, which might change if the pointer value points to the root ("").
Example ¶
complex := map[string]interface{}{
"alice": 42,
"bob": []interface{}{
map[string]interface{}{
"name": "Bob",
},
},
}
value, err := Set(complex, "/bob/0/name", "Alice")
if err != nil {
panic(err)
}
value, err = Get(complex, "/bob/0/name")
if err != nil {
panic(err)
}
fmt.Printf("%s", value)
Output: Alice
Types ¶
type Pointer ¶
type Pointer struct {
// Parts are the pointer parts. No escape codes are processed here.
// The values are expected to be exact. If you have escape codes, use
// the Parse functions.
Parts []string
}
Pointer represents a pointer to a specific value. You can construct a pointer manually or use Parse.
func Parse ¶
Parse parses a pointer from the input string. The input string is expected to follow the format specified by RFC 6901: '/'-separated parts. Each part can contain escape codes to contain '/' or '~'.
func (*Pointer) Delete ¶
Delete deletes the value specified by the pointer p in structure s.
When deleting a slice index, all other elements will be shifted to the left. This is specified in RFC6902 (JSON Patch) and not RFC6901 since RFC6901 doesn't specify operations on pointers. If you don't want to shift elements, you should use Set to set the slice index to the zero value.
The structures s must have non-zero values set up to this pointer. For example, if deleting "/bob/0/name", then "/bob/0" must be set already.
The returned value is potentially a new value if this pointer represents the root document. Otherwise, the returned value will always be s.
func (*Pointer) Parent ¶
Parent returns a pointer to the parent element of this pointer.
If Pointer represents the root (empty parts), a pointer representing the root is returned. Therefore, to check for the root, IsRoot() should be called.
func (*Pointer) Set ¶
Set writes a value v to the pointer p in structure s.
The structures s must have non-zero values set up to this pointer. For example, if setting "/bob/0/name", then "/bob/0" must be set already.
The returned value is potentially a new value if this pointer represents the root document. Otherwise, the returned value will always be s.
type PointerSlice ¶
type PointerSlice []*Pointer
PointerSlice is a slice of pointers that adheres to sort.Interface
func (PointerSlice) Len ¶
func (p PointerSlice) Len() int
func (PointerSlice) Less ¶
func (p PointerSlice) Less(i, j int) bool
func (PointerSlice) Swap ¶
func (p PointerSlice) Swap(i, j int)
Source Files