sherpa

Documentation

Index

• func CopyFile(source *os.File, destination string) error
• func Execute(f ExecuteFunc, options ...Option)
• func ResolveVersion(key string, entry libcnb.BuildpackPlanEntry, id string, ...) string
• type Config
• type ExecuteFunc
• type FileEntry
  • func NewFileListing(root string) ([]FileEntry, error)
• type Option
  • func WithExitHandler(exitHandler libcnb.ExitHandler) Option

Functions

func CopyFile

func CopyFile(source *os.File, destination string) error

CopyFile copies a file from the source to the destination. It ensures that the parent directory is created and matches the source and destination permissions.

func Execute

func Execute(f ExecuteFunc, options ...Option)

Execute is called by the main function of a buildpack helper application, for execution.

func ResolveVersion

func ResolveVersion(key string, entry libcnb.BuildpackPlanEntry, id string, defaultVersions map[string]string) string

ResolveVersion resolves a version declaration through four methods, in order of precedence. 1. An environment variable ($<key>) 2. Buildpack plan entry 3. Buildpack default version 4. Empty version ("")

Types

type Config

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

Config is an object that contains configurable properties for execution.

type ExecuteFunc

type ExecuteFunc func() error

ExecuteFunc is the callback function for buildpack helper application implementations.

type FileEntry

type FileEntry struct {

	// Path is the path of a file.
	Path string `mapstructure:"path" toml:"path"`

	// Mode is the mode of the source file.
	Mode string `mapstructure:"mode" toml:"mode"`

	// ModificationTime is the modification time of the file.
	ModificationTime string `mapstructure:"modification-time" toml:"modification-time"`

	// SHA256 is the SHA256 has of the source file.
	SHA256 string `mapstructure:",omitempty" toml:"sha256,omitempty"`
}

FileEntry is metadata about a file.

func NewFileListing

func NewFileListing(root string) ([]FileEntry, error)

NewFileListing generates a listing of all entries under root.

type Option

type Option func(config Config) Config

Option is a function for configuring a Config instance.

func WithExitHandler

func WithExitHandler(exitHandler libcnb.ExitHandler) Option

WithExitHandler creates an Option that sets an ExitHandler implementation.