yml

Documentation

Index

• Variables
• func Clone(node *yaml.Node) *yaml.Node
• func Compare(yaml1, yaml2 []byte) bool
• func EqualWithExclusion(a, b *yaml.Node, excludedPath ...string) bool
• func FindNode(node *yaml.Node, path string) (resultNode *yaml.Node, err error)
• func FindNodeValueOrDefault(node *yaml.Node, path string, defaultValue string) string
• func Merge(dst, src *yaml.Node) *yaml.Node
• func SetOrAddNodeValue(node *yaml.Node, path string, value string) error
• func TreeToYaml(tree *yaml.Node, indent int) (string, error)
• type File
  • func LoadFile(filePath string) (*File, error)
  • func NewFile(filePath string, content []byte) (*File, error)
  • func NewFileFromTree(filePath string, indent int, node *yaml.Node) (*File, error)
  • func (y *File) CopyWithNewTree(newTree *yaml.Node) (*File, error)
  • func (y *File) ToYaml() (string, error)
  • func (y *File) UpdateYamlFromTree() error
  • func (y *File) WriteYaml() error
• type KeyValuePair

Variables

var CustomTags = []string{"!lock", "!local"}

var KnownTags = append(StandardTags, CustomTags...)

var StandardTags = []string{
	"",
	"!!int",
	"!!bool",
	"!!float",
	"!!map",
	"!!str",
	"!!seq",
	"!!null",
}

Functions

func Clone

func Clone(node *yaml.Node) *yaml.Node

func Compare

func Compare(yaml1, yaml2 []byte) bool

Compare returns true if the two yaml documents are equivalent in terms of contents and comments, false otherwise, disregarding differences in formatting / whitespace.

func EqualWithExclusion

func EqualWithExclusion(a, b *yaml.Node, excludedPath ...string) bool

func FindNode

func FindNode(node *yaml.Node, path string) (resultNode *yaml.Node, err error)

FindNode traverses a given yaml.Node to locate the value Node of the provided path. The path is interpreted as being relative to the given yaml.Node.

func FindNodeValueOrDefault

func FindNodeValueOrDefault(node *yaml.Node, path string, defaultValue string) string

func Merge

func Merge(dst, src *yaml.Node) *yaml.Node

func SetOrAddNodeValue

func SetOrAddNodeValue(node *yaml.Node, path string, value string) error

func TreeToYaml

func TreeToYaml(tree *yaml.Node, indent int) (string, error)

Types

type File

type File struct {
	// Path is the path to the yaml file.
	Path string

	// Yaml is the raw yaml of the yaml file.
	Yaml []byte

	// Tree is the root node of the tree representation of the yaml file.
	Tree *yaml.Node

	// ApiVersion is the API version of the CRD, if any.
	ApiVersion string

	// Kind is the kind of the CRD, if any.
	Kind string

	// MetadataName is the name of the CRD resource, if any.
	MetadataName string

	// Indent is the indent size of the yaml file to be used when writing it back to disk.
	Indent int
}

File represents a yaml file loaded into memory in different forms, that can be round-tripped back to disk.

func LoadFile

func LoadFile(filePath string) (*File, error)

func NewFile

func NewFile(filePath string, content []byte) (*File, error)

func NewFileFromTree

func NewFileFromTree(filePath string, indent int, node *yaml.Node) (*File, error)

func (*File) CopyWithNewTree

func (y *File) CopyWithNewTree(newTree *yaml.Node) (*File, error)

func (*File) ToYaml

func (y *File) ToYaml() (string, error)

func (*File) UpdateYamlFromTree

func (y *File) UpdateYamlFromTree() error

func (*File) WriteYaml

func (y *File) WriteYaml() error

type KeyValuePair

type KeyValuePair struct {
	Key   *yaml.Node
	Value *yaml.Node
}