archive

Documentation

Index

• type Extractor
  • func NewExtractor(log logrus.FieldLogger, fs filesystem.Interface) *Extractor
  • func (e *Extractor) UnzipAndExtractBackup(src io.Reader) (string, error)
• type Parser
  • func NewParser(log logrus.FieldLogger, fs filesystem.Interface) *Parser
  • func (p *Parser) Parse(dir string) (map[string]*ResourceItems, error)
• type ResourceItems

Types

type Extractor

type Extractor struct {
	// contains filtered or unexported fields
}

Extractor unzips/extracts a backup tarball to a local temp directory.

func NewExtractor

func NewExtractor(log logrus.FieldLogger, fs filesystem.Interface) *Extractor

func (*Extractor) UnzipAndExtractBackup

func (e *Extractor) UnzipAndExtractBackup(src io.Reader) (string, error)

UnzipAndExtractBackup extracts a reader on a gzipped tarball to a local temp directory

type Parser

type Parser struct {
	// contains filtered or unexported fields
}

Parser traverses an extracted archive on disk to validate it and provide a helpful representation of it to consumers.

func NewParser

func NewParser(log logrus.FieldLogger, fs filesystem.Interface) *Parser

NewParser constructs a Parser.

func (*Parser) Parse

func (p *Parser) Parse(dir string) (map[string]*ResourceItems, error)

Parse reads an extracted backup on the file system and returns a structured catalog of the resources and items contained within it.

type ResourceItems

type ResourceItems struct {
	// GroupResource is API group and resource name,
	// formatted as "resource.group". For the "core"
	// API group, the ".group" suffix is omitted.
	GroupResource string

	// ItemsByNamespace is a map from namespace (or empty string
	// for cluster-scoped resources) to a list of individual item
	// names contained in the archive. Item names **do not** include
	// the file extension.
	ItemsByNamespace map[string][]string
}

ResourceItems contains the collection of items of a given resource type within a backup, grouped by namespace (or empty string for cluster-scoped resources).