sherpa

Documentation

Index

• func CopyFile(source *os.File, destination string) error
• func Execute(f ExecuteFunc, options ...Option)
• func NodeJSMainModule(path string) (string, error)
• func StaticFile(name string) (string, error)
• func TemplateFile(name string, data interface{}) (string, error)
• 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 NodeJSMainModule

func NodeJSMainModule(path string) (string, error)

NodeJSMainModule returns the name of the main module as defined in <path>/package.json.

func StaticFile

func StaticFile(name string) (string, error)

StaticFile returns the contents of a file in a statik filesystem.

func TemplateFile

func TemplateFile(name string, data interface{}) (string, error)

TemplateFile uses the contents of a file in a statik filesystem as a text/template template and returns the template as applied to the data object.

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.