package ast import ( "fmt" "strings" "gopkg.in/yaml.v3" "github.com/go-task/task/v3/internal/experiments" "github.com/go-task/task/v3/internal/omap" ) // Vars is a string[string] variables map. type Vars struct { omap.OrderedMap[string, Var] } // ToCacheMap converts Vars to a map containing only the static // variables func (vs *Vars) ToCacheMap() (m map[string]any) { m = make(map[string]any, vs.Len()) _ = vs.Range(func(k string, v Var) error { if v.Sh != "" { // Dynamic variable is not yet resolved; trigger // to be used in templates. return nil } if v.Live != nil { m[k] = v.Live } else { m[k] = v.Value } return nil }) return } // Wrapper around OrderedMap.Set to ensure we don't get nil pointer errors func (vs *Vars) Range(f func(k string, v Var) error) error { if vs == nil { return nil } return vs.OrderedMap.Range(f) } // Wrapper around OrderedMap.Merge to ensure we don't get nil pointer errors func (vs *Vars) Merge(other *Vars) { if vs == nil || other == nil { return } vs.OrderedMap.Merge(other.OrderedMap) } // Wrapper around OrderedMap.Len to ensure we don't get nil pointer errors func (vs *Vars) Len() int { if vs == nil { return 0 } return vs.OrderedMap.Len() } // DeepCopy creates a new instance of Vars and copies // data by value from the source struct. func (vs *Vars) DeepCopy() *Vars { if vs == nil { return nil } return &Vars{ OrderedMap: vs.OrderedMap.DeepCopy(), } } // Var represents either a static or dynamic variable. type Var struct { Value any Live any Sh string Ref string Json string Yaml string Dir string } func (v *Var) UnmarshalYAML(node *yaml.Node) error { if experiments.MapVariables.Enabled { // This implementation is not backwards-compatible and replaces the 'sh' key with map variables if experiments.MapVariables.Value == "1" { var value any if err := node.Decode(&value); err != nil { return err } // If the value is a string and it starts with $, then it's a shell command if str, ok := value.(string); ok { if str, ok = strings.CutPrefix(str, "$"); ok { v.Sh = str return nil } } v.Value = value return nil } // This implementation IS backwards-compatible and keeps the 'sh' key and allows map variables to be added under the `map` key if experiments.MapVariables.Value == "2" { switch node.Kind { case yaml.MappingNode: key := node.Content[0].Value switch key { case "sh", "ref", "map", "json", "yaml": var m struct { Sh string Ref string Map any Json string Yaml string } if err := node.Decode(&m); err != nil { return err } v.Sh = m.Sh v.Ref = m.Ref v.Value = m.Map v.Json = m.Json v.Yaml = m.Yaml return nil default: return fmt.Errorf(`yaml: line %d: %q is not a valid variable type. Try "sh", "ref", "map", "json", "yaml" or using a scalar value`, node.Line, key) } default: var value any if err := node.Decode(&value); err != nil { return err } v.Value = value return nil } } } switch node.Kind { case yaml.MappingNode: if len(node.Content) > 2 || node.Content[0].Value != "sh" { return fmt.Errorf(`task: line %d: maps cannot be assigned to variables`, node.Line) } var sh struct { Sh string } if err := node.Decode(&sh); err != nil { return err } v.Sh = sh.Sh return nil default: var value any if err := node.Decode(&value); err != nil { return err } v.Value = value return nil } }