function

Documentation

Overview

Package function implements higher-level functionality for dealing with Lambda functions.

Index

• Constants
• Variables
• type Config
• type Function
  • func (f *Function) Clean() error
  • func (f *Function) Create(zip []byte) error
  • func (f *Function) Delete() error
  • func (f *Function) Deploy() error
  • func (f *Function) DeployConfig() error
  • func (f *Function) Info() (*lambda.GetFunctionOutput, error)
  • func (f *Function) Invoke(event, context interface{}, kind InvocationType) (reply, logs io.Reader, err error)
  • func (f *Function) Open() error
  • func (f *Function) SetEnv(name, value string)
  • func (f *Function) Update(zip []byte) error
  • func (f *Function) Zip() (io.Reader, error)
  • func (f *Function) ZipBytes() ([]byte, error)
• type InvocationType
• type InvokeError
  • func (e *InvokeError) Error() string

Constants

const (
	RequestResponse InvocationType = "RequestResponse"
	Event                          = "Event"
	DryRun                         = "DryRun"
)

Invocation types.

Variables

var (
	ErrUnchanged = errors.New("function: unchanged")
)

Errors.

Types

type Config

type Config struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Runtime     string `json:"runtime"`
	Memory      int64  `json:"memory"`
	Timeout     int64  `json:"timeout"`
	Role        string `json:"role"`
	Main        string `json:"main"`
}

Config for a Lambda function.

type Function

type Function struct {
	Config
	Path    string
	Verbose bool
	Service lambdaiface.LambdaAPI
	// contains filtered or unexported fields
}

Function represents a Lambda function, with configuration loaded from the "lambda.json" file on disk. Operations are performed against the function directory as the CWD, so os.Chdir() first.

func (*Function) Clean

func (f *Function) Clean() error

Clean removes build artifacts from compiled runtimes.

func (*Function) Create

func (f *Function) Create(zip []byte) error

Create the function with the given `zip`.

func (*Function) Delete

func (f *Function) Delete() error

Delete the function including all its versions

func (*Function) Deploy

func (f *Function) Deploy() error

Deploy generates a zip and creates or updates the function.

func (*Function) DeployConfig

func (f *Function) DeployConfig() error

DeployConfig deploys changes to configuration.

func (*Function) Info

func (f *Function) Info() (*lambda.GetFunctionOutput, error)

Info returns the function information.

func (*Function) Invoke

func (f *Function) Invoke(event, context interface{}, kind InvocationType) (reply, logs io.Reader, err error)

Invoke the remote Lambda function, returning the response and logs, if any.

func (*Function) Open

func (f *Function) Open() error

Open the lambda.json file and prime the config.

func (*Function) SetEnv

func (f *Function) SetEnv(name, value string)

SetEnv sets environment variable `name` to `value`.

func (*Function) Update

func (f *Function) Update(zip []byte) error

Update the function with the given `zip`.

func (*Function) Zip

func (f *Function) Zip() (io.Reader, error)

Zip returns the zipped contents of the function.

func (*Function) ZipBytes

func (f *Function) ZipBytes() ([]byte, error)

ZipBytes returns the generated zip as bytes.

type InvocationType

type InvocationType string

InvocationType determines how an invocation request is made.

type InvokeError

type InvokeError struct {
	Message string   `json:"errorMessage"`
	Type    string   `json:"errorType"`
	Stack   []string `json:"stackTrace"`
	Handled bool
}

InvokeError records an error from an invocation.

func (*InvokeError) Error

func (e *InvokeError) Error() string

Error message.