package tpath

import "istio.io/istio/operator/pkg/tpath"

struct.go contains functions for traversing and modifying trees of Go structs.

tree.go contains functions for traversing and updating a tree constructed from yaml or json.Unmarshal. Nodes in such trees have the form map[interface{}]interface{} or map[interface{}][]interface{}. For some tree updates, like delete or append, it's necessary to have access to the parent node. PathContext is a tree constructed during tree traversal that gives access to ancestor nodes all the way up to the root, which can be used for this purpose.

Index ¶

• func AddSpecRoot(tree string) (string, error)
• func Delete(root map[string]interface{}, path util.Path) (bool, error)
• func Find(inputTree map[string]interface{}, path util.Path) (interface{}, bool, error)
• func GetConfigSubtree(manifest, path string) (string, error)
• func GetFromStructPath(node interface{}, path string) (interface{}, bool, error)
• func GetSpecSubtree(yml string) (string, error)
• func MergeNode(root interface{}, path util.Path, value interface{}) error
• func Set(val, out interface{}) error
• func SetFromPath(node interface{}, path string, out interface{}) (bool, error)
• func WriteNode(root interface{}, path util.Path, value interface{}) error
• func WritePathContext(nc *PathContext, value interface{}, merge bool) error
• type PathContext
• func GetPathContext(root interface{}, path util.Path, createMissing bool) (*PathContext, bool, error)
• func (nc *PathContext) String() string

Package Files ¶

struct.go tree.go util.go

func AddSpecRoot ¶ Uses

func AddSpecRoot(tree string) (string, error)

AddSpecRoot adds a root node called "spec" to the given tree and returns the resulting tree.

func Delete ¶ Uses

func Delete(root map[string]interface{}, path util.Path) (bool, error)

Delete sets value at path of input untyped tree to nil

func Find ¶ Uses

func Find(inputTree map[string]interface{}, path util.Path) (interface{}, bool, error)

Find returns the value at path from the given tree, or false if the path does not exist. It behaves differently from GetPathContext in that it never creates map entries at the leaf and does not provide a way to mutate the parent of the found node.

func GetConfigSubtree ¶ Uses

func GetConfigSubtree(manifest, path string) (string, error)

GetConfigSubtree returns the subtree at the given path.

func GetFromStructPath ¶ Uses

func GetFromStructPath(node interface{}, path string) (interface{}, bool, error)

GetFromStructPath returns the value at path from the given node, or false if the path does not exist.

func GetSpecSubtree ¶ Uses

func GetSpecSubtree(yml string) (string, error)

GetSpecSubtree returns the subtree under "spec".

func MergeNode ¶ Uses

func MergeNode(root interface{}, path util.Path, value interface{}) error

MergeNode merges value to the tree in root at the given path, creating any required missing internal nodes in path.

func Set ¶ Uses

func Set(val, out interface{}) error

Set sets out with the value at path from node. out is not set if the path doesn't exist or the value is nil.

func SetFromPath ¶ Uses

func SetFromPath(node interface{}, path string, out interface{}) (bool, error)

SetFromPath sets out with the value at path from node. out is not set if the path doesn't exist or the value is nil. All intermediate along path must be type struct ptr. Out must be either a struct ptr or map ptr. TODO: move these out to a separate package (istio/istio#15494).

func WriteNode ¶ Uses

func WriteNode(root interface{}, path util.Path, value interface{}) error

WriteNode writes value to the tree in root at the given path, creating any required missing internal nodes in path.

func WritePathContext ¶ Uses

func WritePathContext(nc *PathContext, value interface{}, merge bool) error

WritePathContext writes the given value to the Node in the given PathContext.

type PathContext ¶ Uses

type PathContext struct {
    // Parent in the Parent of this PathContext.
    Parent *PathContext
    // KeyToChild is the key required to reach the child.
    KeyToChild interface{}
    // Node is the actual Node in the data tree.
    Node interface{}
}

PathContext provides a means for traversing a tree towards the root.

func GetPathContext ¶ Uses

func GetPathContext(root interface{}, path util.Path, createMissing bool) (*PathContext, bool, error)

GetPathContext returns the PathContext for the Node which has the given path from root. It returns false and and no error if the given path is not found, or an error code in other error situations, like a malformed path. It also creates a tree of PathContexts during the traversal so that Parent nodes can be updated if required. This is required when (say) appending to a list, where the parent list itself must be updated.

func (*PathContext) String ¶ Uses

func (nc *PathContext) String() string

String implements the Stringer interface.