value

Documentation

Overview

Helper functions for doing value conversions.

Index

• func AsString(x starlark.Value) (string, bool)
• func SequenceToStringSlice(seq starlark.Sequence) ([]string, error)
• func StringSliceToList(slice []string) *starlark.List
• func ValueGroupToCmdHelper(t *starlark.Thread, cmdVal, cmdBatVal, cmdDir starlark.Value, ...) (model.Cmd, error)
• func ValueOrSequenceToSlice(v starlark.Value) []starlark.Value
• func ValueToAbsPath(thread *starlark.Thread, v starlark.Value) (string, error)
• func ValueToBatCmd(t *starlark.Thread, v, dir starlark.Value, env map[string]string) (model.Cmd, error)
• func ValueToHostCmd(t *starlark.Thread, v, dir starlark.Value, env map[string]string) (model.Cmd, error)
• func ValueToUnixCmd(t *starlark.Thread, v, dir starlark.Value, env map[string]string) (model.Cmd, error)
• type Duration
  • func (d Duration) AsDuration() time.Duration
  • func (d Duration) IsZero() bool
  • func (d *Duration) Unpack(v starlark.Value) error
• type ImageList
  • func (s *ImageList) Unpack(v starlark.Value) error
• type ImplicitStringer
• type Int32
  • func (i Int32) Int32() int32
  • func (i *Int32) Unpack(v starlark.Value) error
• type LabelSet
  • func (ls *LabelSet) Unpack(v starlark.Value) error
• type LabelValue
  • func (lv *LabelValue) String() string
  • func (lv *LabelValue) Unpack(v starlark.Value) error
• type LocalPath
  • func NewLocalPathUnpacker(t *starlark.Thread) LocalPath
  • func (p *LocalPath) Unpack(v starlark.Value) error
• type LocalPathList
  • func NewLocalPathListUnpacker(t *starlark.Thread) LocalPathList
  • func (p *LocalPathList) Unpack(v starlark.Value) error
• type Name
  • func (n Name) String() string
  • func (n *Name) Unpack(v starlark.Value) error
• type Optional
  • func (o *Optional[V]) Unpack(v starlark.Value) error
• type PathMaker
• type StringList
  • func (s *StringList) Unpack(v starlark.Value) error
• type StringOrStringList
  • func (s *StringOrStringList) Unpack(v starlark.Value) error
• type StringSequence
  • func (s StringSequence) Sequence() starlark.Sequence
  • func (s *StringSequence) Unpack(v starlark.Value) error
• type StringStringMap
  • func (s *StringStringMap) AsMap() map[string]string
  • func (s *StringStringMap) Unpack(v starlark.Value) error
• type Stringable
  • func (s *Stringable) Unpack(v starlark.Value) error

Functions

func AsString

func AsString(x starlark.Value) (string, bool)

Wrapper around starlark.AsString

func SequenceToStringSlice

func SequenceToStringSlice(seq starlark.Sequence) ([]string, error)

func StringSliceToList

func StringSliceToList(slice []string) *starlark.List

func ValueGroupToCmdHelper

func ValueGroupToCmdHelper(t *starlark.Thread, cmdVal, cmdBatVal, cmdDir starlark.Value, env map[string]string) (model.Cmd, error)

In other similar build systems (Buck and Bazel), there's a "main" command, and then various per-platform overrides. https://docs.bazel.build/versions/master/be/general.html#genrule.cmd_bat This helper function abstracts out the precedence rules.

func ValueOrSequenceToSlice

func ValueOrSequenceToSlice(v starlark.Value) []starlark.Value

If `v` is a `starlark.Sequence`, return a slice of its elements Otherwise, return it as a single-element slice For functions that take `Union[List[T], T]`

func ValueToAbsPath

func ValueToAbsPath(thread *starlark.Thread, v starlark.Value) (string, error)

func ValueToBatCmd

func ValueToBatCmd(t *starlark.Thread, v, dir starlark.Value, env map[string]string) (model.Cmd, error)

func ValueToHostCmd

func ValueToHostCmd(t *starlark.Thread, v, dir starlark.Value, env map[string]string) (model.Cmd, error)

provides dockerfile-style behavior of: a string gets interpreted as a shell command (like, sh -c 'foo bar $X') an array of strings gets interpreted as a raw argv to exec

func ValueToUnixCmd

func ValueToUnixCmd(t *starlark.Thread, v, dir starlark.Value, env map[string]string) (model.Cmd, error)

Types

type Duration

type Duration time.Duration

Parse duration constants from starlark.

func (Duration) AsDuration

func (d Duration) AsDuration() time.Duration

func (Duration) IsZero

func (d Duration) IsZero() bool

func (*Duration) Unpack

func (d *Duration) Unpack(v starlark.Value) error

type ImageList

type ImageList []reference.Named

func (*ImageList) Unpack

func (s *ImageList) Unpack(v starlark.Value) error

Unpack an argument that can be expressed as a list or tuple of image references.

type ImplicitStringer

type ImplicitStringer interface {
	ImplicitString() string
}

type Int32

type Int32 struct {
	starlark.Int
}

Int32 is a convenience type for unpacking int32 bounded values.

func (Int32) Int32

func (i Int32) Int32() int32

Int32 returns the value as an int32.

It will panic if the value cannot be accurate represented as an int32.

func (*Int32) Unpack

func (i *Int32) Unpack(v starlark.Value) error

type LabelSet

type LabelSet struct {
	Values map[string]string
}

func (*LabelSet) Unpack

func (ls *LabelSet) Unpack(v starlark.Value) error

Unpack an argument that can either be expressed as a string or as a list of strings.

type LabelValue

type LabelValue string

func (*LabelValue) String

func (lv *LabelValue) String() string

func (*LabelValue) Unpack

func (lv *LabelValue) Unpack(v starlark.Value) error

type LocalPath

type LocalPath struct {
	Value string
	IsSet bool
	// contains filtered or unexported fields
}

func NewLocalPathUnpacker

func NewLocalPathUnpacker(t *starlark.Thread) LocalPath

func (*LocalPath) Unpack

func (p *LocalPath) Unpack(v starlark.Value) error

type LocalPathList

type LocalPathList struct {
	Value []string
	// contains filtered or unexported fields
}

func NewLocalPathListUnpacker

func NewLocalPathListUnpacker(t *starlark.Thread) LocalPathList

func (*LocalPathList) Unpack

func (p *LocalPathList) Unpack(v starlark.Value) error

type Name

type Name string

Names in Tilt should be valid Kubernetes API names.

We use the loosest validation rules: valid path segment names.

For discussion, see: https://github.com/tilt-dev/tilt/issues/4309

func (Name) String

func (n Name) String() string

func (*Name) Unpack

func (n *Name) Unpack(v starlark.Value) error

type Optional

type Optional[V starlark.Value] struct {
	IsSet bool
	Value V
}

Unpack values that could be V or starlark.None

func (*Optional[V]) Unpack

func (o *Optional[V]) Unpack(v starlark.Value) error

type PathMaker

type PathMaker interface {
	MakeLocalPath(relPath string) string
}

type StringList

type StringList []string

func (*StringList) Unpack

func (s *StringList) Unpack(v starlark.Value) error

Unpack an argument that can be expressed as a list or tuple of strings.

type StringOrStringList

type StringOrStringList struct {
	Values []string
	IsSet  bool
}

func (*StringOrStringList) Unpack

func (s *StringOrStringList) Unpack(v starlark.Value) error

Unpack an argument that can either be expressed as a string or as a list of strings.

type StringSequence

type StringSequence []string

StringSequence is a convenience type for dealing with string slices in Starlark.

func (StringSequence) Sequence

func (s StringSequence) Sequence() starlark.Sequence

func (*StringSequence) Unpack

func (s *StringSequence) Unpack(v starlark.Value) error

type StringStringMap

type StringStringMap map[string]string

func (*StringStringMap) AsMap

func (s *StringStringMap) AsMap() map[string]string

func (*StringStringMap) Unpack

func (s *StringStringMap) Unpack(v starlark.Value) error

type Stringable

type Stringable struct {
	Value string
	IsSet bool
}

func (*Stringable) Unpack

func (s *Stringable) Unpack(v starlark.Value) error