cli

Documentation

Index

• func NewRootCmd(version string) *cobra.Command
• type CheckpointEntry
• type SaveOptions
• type SaveResult
  • func ExecuteSave(opts SaveOptions) (*SaveResult, error)

Functions

func NewRootCmd

func NewRootCmd(version string) *cobra.Command

NewRootCmd creates the root bento command.

Types

type CheckpointEntry

type CheckpointEntry = registry.CheckpointEntry

CheckpointEntry re-export for this file (same type from registry package).

type SaveOptions

type SaveOptions struct {
	Dir                  string // absolute path to workspace root
	Message              string // checkpoint message
	Tag                  string // custom tag (empty = auto cp-N)
	SkipSecretScan       bool
	AllowMissingExternal bool
	Quiet                bool // suppress per-layer output (used by watch mode)
	ForceSave            bool // skip the unchanged-detection check (for pre-open backups)
}

SaveOptions configures a save operation. Used by both `bento save` and `bento watch`.

type SaveResult

type SaveResult struct {
	Tag     string // the tag assigned to this checkpoint (e.g. "cp-3")
	Digest  string // manifest digest
	Seq     int    // checkpoint sequence number
	Skipped bool   // true if save was elided because nothing changed
	Reason  string // human-readable reason when Skipped is true
	Hint    string // backend-specific restore hint (display variant, may contain secrets)
}

SaveResult holds the outcome of a save operation.

func ExecuteSave

func ExecuteSave(opts SaveOptions) (*SaveResult, error)

ExecuteSave performs a full save operation: scan, pack, build manifest, store. It acquires a file lock to prevent concurrent saves from corrupting the store. If all layer digests match the parent checkpoint, the save is skipped and SaveResult.Skipped is set to true.