starlib

Documentation

Index

• func FprintErr(w io.Writer, err error)
• func FprintStatus(w io.Writer, status *spb.Status)
• func NewGlobals() starlark.StringDict
• func RunBenches(b *testing.B, pattern string, globals starlark.StringDict)
• func RunTests(t *testing.T, pattern string, globals starlark.StringDict)
• type Args
• type Completer
  • func (c Completer) Complete(line string) (values []string)
• type Loader
  • func NewLoader(globals starlark.StringDict) *Loader
  • func (l *Loader) Load(thread *starlark.Thread, module string) (starlark.StringDict, error)
  • func (l *Loader) LoadSource(ctx context.Context, bktURL string, key string) ([]byte, error)
  • func (l *Loader) StdLoad(thread *starlark.Thread, module string) (starlark.StringDict, error)

Functions

func FprintErr

func FprintErr(w io.Writer, err error)

func FprintStatus

func FprintStatus(w io.Writer, status *spb.Status)

func NewGlobals

func NewGlobals() starlark.StringDict

func RunBenches

func RunBenches(b *testing.B, pattern string, globals starlark.StringDict)

RunBenches calls starlarkassert.RunBenches with options for larking libraries. To use add it to a Benchmark function:

func BenchmarkStarlark(b *testing.B) {
	starlib.RunBenches(b, "testdata/*.star", nil)
}

func RunTests

func RunTests(t *testing.T, pattern string, globals starlark.StringDict)

RunTests calls starlarkassert.RunTests with options for larking libraries. To use add it to a Test function:

func TestStarlark(t *testing.T) {
	starlib.RunTests(b, "testdata/*.star", nil)
}

Types

type Args

type Args interface {
	starlark.Callable
	ArgNames() []string
}

An Args is a starlark Callable with arguments.

type Completer

type Completer struct {
	starlark.StringDict
}

Completer is an experimental autocompletion for starlark lines. TODO: drop and switch to a proper language server.

func (Completer) Complete

func (c Completer) Complete(line string) (values []string)

Complete tries to resolve a starlark line variable to global named values. TODO: use a proper parser to resolve values.

type Loader

type Loader struct {
	starext.Blobs
	// contains filtered or unexported fields
}

Loader is a cloid.Blob backed loader. It uses thread.Name to figure out the current bucket and module.

func NewLoader

func NewLoader(globals starlark.StringDict) *Loader

func (*Loader) Load

func (l *Loader) Load(thread *starlark.Thread, module string) (starlark.StringDict, error)

Load checks the standard library before loading from buckets.

func (*Loader) LoadSource

func (l *Loader) LoadSource(ctx context.Context, bktURL string, key string) ([]byte, error)

LoadSource fetches the source file in bytes from a bucket.

func (*Loader) StdLoad

func (l *Loader) StdLoad(thread *starlark.Thread, module string) (starlark.StringDict, error)

StdLoad loads files from the standard library.