modulecontext

Documentation

Index

• Constants
• func DatabasesFromEnvironment(ctx context.Context, module string) (map[string]Database, error)
• type Builder
  • func NewBuilder(module string) *Builder
  • func (b *Builder) AddConfigs(configs map[string][]byte) *Builder
  • func (b *Builder) AddDatabases(databases map[string]Database) *Builder
  • func (b *Builder) AddSecrets(secrets map[string][]byte) *Builder
  • func (b *Builder) Build() ModuleContext
  • func (b *Builder) UpdateForTesting(mockVerbs map[schema.RefKey]Verb, allowDirectVerbBehavior bool) *Builder
• type DBType
  • func (x DBType) String() string
• type Database
  • func NewDatabase(dbType DBType, dsn string) (Database, error)
• type DirectBehavior
  • func (DirectBehavior) Call(ctx context.Context, verb Verb, req any) (any, error)
• type MockBehavior
  • func (b MockBehavior) Call(ctx context.Context, verb Verb, req any) (any, error)
• type ModuleContext
  • func FromContext(ctx context.Context) ModuleContext
  • func FromProto(response *ftlv1.ModuleContextResponse) (ModuleContext, error)
  • func (m ModuleContext) ApplyToContext(ctx context.Context) context.Context
  • func (m ModuleContext) BehaviorForVerb(ref schema.Ref) (optional.Option[VerbBehavior], error)
  • func (m ModuleContext) GetConfig(name string, value any) error
  • func (m ModuleContext) GetDatabase(name string, dbType DBType) (*sql.DB, error)
  • func (m ModuleContext) GetSecret(name string, value any) error
  • func (m ModuleContext) ToProto() *ftlv1.ModuleContextResponse
• type Verb
• type VerbBehavior

Constants

const (
	DBTypePostgres = DBType(ftlv1.ModuleContextResponse_POSTGRES)
)

Functions

func DatabasesFromEnvironment

func DatabasesFromEnvironment(ctx context.Context, module string) (map[string]Database, error)

DatabasesFromEnvironment finds DSNs in environment variables and creates a map of databases.

Types

type Builder

type Builder ModuleContext

Builder is used to build a ModuleContext

func NewBuilder

func NewBuilder(module string) *Builder

NewBuilder creates a new blank Builder for the given module.

func (*Builder) AddConfigs

func (b *Builder) AddConfigs(configs map[string][]byte) *Builder

AddConfigs adds configuration values (as bytes) to the builder

func (*Builder) AddDatabases

func (b *Builder) AddDatabases(databases map[string]Database) *Builder

AddDatabases adds databases to the builder

func (*Builder) AddSecrets

func (b *Builder) AddSecrets(secrets map[string][]byte) *Builder

AddSecrets adds configuration values (as bytes) to the builder

func (*Builder) Build

func (b *Builder) Build() ModuleContext

func (*Builder) UpdateForTesting

func (b *Builder) UpdateForTesting(mockVerbs map[schema.RefKey]Verb, allowDirectVerbBehavior bool) *Builder

UpdateForTesting marks the builder as part of a test environment and adds mock verbs and flags for other test features.

type DBType

type DBType ftlv1.ModuleContextResponse_DBType

func (DBType) String

func (x DBType) String() string

type Database

type Database struct {
	DSN    string
	DBType DBType
	// contains filtered or unexported fields
}

Database represents a database connection based on a DSN

It holds a private field for the database which is accessible through moduleCtx.GetDatabase(name)

func NewDatabase

func NewDatabase(dbType DBType, dsn string) (Database, error)

NewDatabase creates a Database that can be added to ModuleContext

type DirectBehavior

type DirectBehavior struct{}

DirectBehavior indicates that the verb should be executed by calling the function directly (for testing)

func (DirectBehavior) Call

func (DirectBehavior) Call(ctx context.Context, verb Verb, req any) (any, error)

type MockBehavior

type MockBehavior struct {
	Mock Verb
}

MockBehavior indicates the verb has a mock implementation

func (MockBehavior) Call

func (b MockBehavior) Call(ctx context.Context, verb Verb, req any) (any, error)

type ModuleContext

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

ModuleContext holds the context needed for a module, including configs, secrets and DSNs

ModuleContext is immutable

func FromContext

func FromContext(ctx context.Context) ModuleContext

FromContext returns the ModuleContext attached to a context.

func FromProto

func FromProto(response *ftlv1.ModuleContextResponse) (ModuleContext, error)

func (ModuleContext) ApplyToContext

func (m ModuleContext) ApplyToContext(ctx context.Context) context.Context

ApplyToContext returns a Go context.Context with ModuleContext added.

func (ModuleContext) BehaviorForVerb

func (m ModuleContext) BehaviorForVerb(ref schema.Ref) (optional.Option[VerbBehavior], error)

BehaviorForVerb returns what to do to execute a verb

This allows module context to dictate behavior based on testing options Returning optional.Nil indicates the verb should be executed normally via the controller

func (ModuleContext) GetConfig

func (m ModuleContext) GetConfig(name string, value any) error

GetConfig reads a configuration value for the module.

"value" must be a pointer to a Go type that can be unmarshalled from JSON.

func (ModuleContext) GetDatabase

func (m ModuleContext) GetDatabase(name string, dbType DBType) (*sql.DB, error)

GetDatabase gets a database connection

Returns an error if no database with that name is found or it is not the expected type

func (ModuleContext) GetSecret

func (m ModuleContext) GetSecret(name string, value any) error

GetSecret reads a secret value for the module.

"value" must be a pointer to a Go type that can be unmarshalled from JSON.

func (ModuleContext) ToProto

func (m ModuleContext) ToProto() *ftlv1.ModuleContextResponse

ToProto converts a ModuleContext to a proto response.

type Verb

type Verb func(ctx context.Context, req any) (resp any, err error)

Verb is a function that takes a request and returns a response but is not constrained by request/response type like ftl.Verb

It is used for definitions of mock verbs as well as real implementations of verbs to directly execute

type VerbBehavior

type VerbBehavior interface {
	Call(ctx context.Context, verb Verb, request any) (any, error)
}

VerbBehavior indicates how to execute a verb