cmdlib

Documentation

Overview

Package cmdlib contains shared functions for the bundle CLI commands.

Index

• Variables
• func MergeOptions(ctx context.Context, rw files.FileReaderWriter, files []string) (options.JSONOptions, error)
• func ParseStringMap(p string) map[string]string
• type BundleReaderWriter
  • func NewBundleReaderWriter(rw files.FileReaderWriter, stdio StdioReaderWriter) BundleReaderWriter
• type GlobalOptions
  • func (g *GlobalOptions) Copy() *GlobalOptions
• type RealStdioReaderWriter
  • func (r *RealStdioReaderWriter) ReadAll() ([]byte, error)
  • func (r *RealStdioReaderWriter) Write(b []byte) (int, error)
• type StdioReaderWriter

Variables

var GlobalOptionsValues = &GlobalOptions{}

GlobalOptionsValues is a global tracker for global options (for command line executions only).

Functions

func MergeOptions

func MergeOptions(ctx context.Context, rw files.FileReaderWriter, files []string) (options.JSONOptions, error)

MergeOptions reads multiple options files and combines them into a single map. Option values will be overwritten if a later file has the same key.

func ParseStringMap

func ParseStringMap(p string) map[string]string

ParseStringMap parses a CLI flag value into a map of string to string. It expects the raw flag value to have the form "key1=value1,key2=value2,etc".

Types

type BundleReaderWriter

type BundleReaderWriter interface {
	ReadBundleData(context.Context, *GlobalOptions) (*wrapper.BundleWrapper, error)
	WriteBundleData(context.Context, *wrapper.BundleWrapper, *GlobalOptions) error
	WriteStructuredContents(context.Context, interface{}, *GlobalOptions) error
}

BundleReaderWriter provides a mockable reading / writing interface for reading / writing bundle data.

func NewBundleReaderWriter

func NewBundleReaderWriter(rw files.FileReaderWriter, stdio StdioReaderWriter) BundleReaderWriter

NewBundleReaderWriter creates a new BundleReaderWriter.

type GlobalOptions

type GlobalOptions struct {
	// InputFile is a path to an input file. If a file is not specified, it's
	// assumed the input is provided via STDIN.
	InputFile string

	// InputFormat is the text format for the input. By default, assumes YAML
	// but also can be JSON.
	InputFormat string

	// OutputFormat is the the format for any output. By default, assumes YAML.
	OutputFormat string
}

GlobalOptions are options that apply to all commands

func (*GlobalOptions) Copy

func (g *GlobalOptions) Copy() *GlobalOptions

Copy creates an options copy.

type RealStdioReaderWriter

type RealStdioReaderWriter struct{}

RealStdioReaderWriter provides a real STDIN / STDOUT implementation.

func (*RealStdioReaderWriter) ReadAll

func (r *RealStdioReaderWriter) ReadAll() ([]byte, error)

ReadAll reads all the input from STDIN.

func (*RealStdioReaderWriter) Write

func (r *RealStdioReaderWriter) Write(b []byte) (int, error)

Write writes content to STDOUT.

type StdioReaderWriter

type StdioReaderWriter interface {
	ReadAll() ([]byte, error)
	io.Writer
}

StdioReaderWriter can read from STDIN and write to STDOUT.