cmd

Documentation

Index

• func Create(info *resource.Info, namespace string, obj runtime.Object) (runtime.Object, error)
• func CreateMessage(labels map[string]string) string
• func NewPrintErrorAfter(mapper meta.RESTMapper, errs io.Writer) func(*resource.Info, error) bool
• func NoOp(info *resource.Info, namespace string, obj runtime.Object) (runtime.Object, error)
• type AfterFunc
  • func HaltOnError(fn AfterFunc) AfterFunc
  • func NewPrintNameOrErrorAfter(mapper meta.RESTMapper, short bool, operation string, out, errs io.Writer) AfterFunc
  • func NewPrintNameOrErrorAfterIndent(mapper meta.RESTMapper, short bool, operation string, out, errs io.Writer, ...) AfterFunc
• type Bulk
  • func (b *Bulk) Run(list *kapi.List, namespace string) []error
• type BulkAction
  • func (b *BulkAction) BindForAction(flags *pflag.FlagSet)
  • func (b *BulkAction) BindForOutput(flags *pflag.FlagSet)
  • func (b *BulkAction) Compact()
  • func (b *BulkAction) DefaultIndent() string
  • func (b *BulkAction) Run(list *kapi.List, namespace string) []error
  • func (b *BulkAction) ShouldPrint() bool
  • func (b *BulkAction) Verbose() bool
  • func (b BulkAction) WithMessage(action, individual string) Runner
• type Mapper
• type OpFunc
• type RetryFunc
• type Runner

Functions

func Create

func Create(info *resource.Info, namespace string, obj runtime.Object) (runtime.Object, error)

Create is the default create operation for a generic resource.

func CreateMessage

func CreateMessage(labels map[string]string) string

func NewPrintErrorAfter

func NewPrintErrorAfter(mapper meta.RESTMapper, errs io.Writer) func(*resource.Info, error) bool

func NoOp

func NoOp(info *resource.Info, namespace string, obj runtime.Object) (runtime.Object, error)

Types

type AfterFunc

type AfterFunc func(*resource.Info, error) bool

AfterFunc takes an info and an error, and returns true if processing should stop.

func HaltOnError

func HaltOnError(fn AfterFunc) AfterFunc

func NewPrintNameOrErrorAfter

func NewPrintNameOrErrorAfter(mapper meta.RESTMapper, short bool, operation string, out, errs io.Writer) AfterFunc

func NewPrintNameOrErrorAfterIndent

func NewPrintNameOrErrorAfterIndent(mapper meta.RESTMapper, short bool, operation string, out, errs io.Writer, indent string) AfterFunc

type Bulk

type Bulk struct {
	Mapper Mapper

	Op    OpFunc
	After AfterFunc
	Retry RetryFunc
}

Bulk provides helpers for iterating over a list of items

func (*Bulk) Run

func (b *Bulk) Run(list *kapi.List, namespace string) []error

Create attempts to create each item generically, gathering all errors in the event a failure occurs. The contents of list will be updated to include the version from the server.

type BulkAction

type BulkAction struct {
	// required setup
	Bulk        Bulk
	Out, ErrOut io.Writer

	// flags
	Output      string
	DryRun      bool
	StopOnError bool

	// output modifiers
	Action string
}

func (*BulkAction) BindForAction

func (b *BulkAction) BindForAction(flags *pflag.FlagSet)

BindForAction sets flags on this action for when setting -o should only change how the operation results are displayed. Passing -o is changing the default output format.

func (*BulkAction) BindForOutput

func (b *BulkAction) BindForOutput(flags *pflag.FlagSet)

BindForOutput sets flags on this action for when setting -o will not execute the action (the point of the action is primarily to generate the output). Passing -o is asking for output, not execution.

func (*BulkAction) Compact

func (b *BulkAction) Compact()

Compact sets the output to a minimal set

func (*BulkAction) DefaultIndent

func (b *BulkAction) DefaultIndent() string

func (*BulkAction) Run

func (b *BulkAction) Run(list *kapi.List, namespace string) []error

func (*BulkAction) ShouldPrint

func (b *BulkAction) ShouldPrint() bool

ShouldPrint returns true if an external printer should handle this action instead of execution.

func (*BulkAction) Verbose

func (b *BulkAction) Verbose() bool

func (BulkAction) WithMessage

func (b BulkAction) WithMessage(action, individual string) Runner

type Mapper

type Mapper interface {
	meta.RESTMapper
	InfoForObject(obj runtime.Object, preferredGVKs []unversioned.GroupVersionKind) (*resource.Info, error)
}

Mapper is an interface testability that is equivalent to resource.Mapper

type OpFunc

type OpFunc func(info *resource.Info, namespace string, obj runtime.Object) (runtime.Object, error)

OpFunc takes the provided info and attempts to perform the operation

type RetryFunc

type RetryFunc func(info *resource.Info, err error) runtime.Object

RetryFunc can retry the operation a single time by returning a non-nil object. TODO: make this a more general retry "loop" function rather than one time.

type Runner

type Runner interface {
	Run(list *kapi.List, namespace string) []error
}