github.com/serbaut/terraform@v0.6.12-0.20160607213102-ac2d195cc560/config/interpolate.go (about)

     1  package config
     2  
     3  import (
     4  	"fmt"
     5  	"strconv"
     6  	"strings"
     7  
     8  	"github.com/hashicorp/hil/ast"
     9  )
    10  
    11  // An InterpolatedVariable is a variable reference within an interpolation.
    12  //
    13  // Implementations of this interface represents various sources where
    14  // variables can come from: user variables, resources, etc.
    15  type InterpolatedVariable interface {
    16  	FullKey() string
    17  }
    18  
    19  // CountVariable is a variable for referencing information about
    20  // the count.
    21  type CountVariable struct {
    22  	Type CountValueType
    23  	key  string
    24  }
    25  
    26  // CountValueType is the type of the count variable that is referenced.
    27  type CountValueType byte
    28  
    29  const (
    30  	CountValueInvalid CountValueType = iota
    31  	CountValueIndex
    32  )
    33  
    34  // A ModuleVariable is a variable that is referencing the output
    35  // of a module, such as "${module.foo.bar}"
    36  type ModuleVariable struct {
    37  	Name  string
    38  	Field string
    39  	key   string
    40  }
    41  
    42  // A PathVariable is a variable that references path information about the
    43  // module.
    44  type PathVariable struct {
    45  	Type PathValueType
    46  	key  string
    47  }
    48  
    49  type PathValueType byte
    50  
    51  const (
    52  	PathValueInvalid PathValueType = iota
    53  	PathValueCwd
    54  	PathValueModule
    55  	PathValueRoot
    56  )
    57  
    58  // A ResourceVariable is a variable that is referencing the field
    59  // of a resource, such as "${aws_instance.foo.ami}"
    60  type ResourceVariable struct {
    61  	Mode  ResourceMode
    62  	Type  string // Resource type, i.e. "aws_instance"
    63  	Name  string // Resource name
    64  	Field string // Resource field
    65  
    66  	Multi bool // True if multi-variable: aws_instance.foo.*.id
    67  	Index int  // Index for multi-variable: aws_instance.foo.1.id == 1
    68  
    69  	key string
    70  }
    71  
    72  // SelfVariable is a variable that is referencing the same resource
    73  // it is running on: "${self.address}"
    74  type SelfVariable struct {
    75  	Field string
    76  
    77  	key string
    78  }
    79  
    80  // SimpleVariable is an unprefixed variable, which can show up when users have
    81  // strings they are passing down to resources that use interpolation
    82  // internally. The template_file resource is an example of this.
    83  type SimpleVariable struct {
    84  	Key string
    85  }
    86  
    87  // A UserVariable is a variable that is referencing a user variable
    88  // that is inputted from outside the configuration. This looks like
    89  // "${var.foo}"
    90  type UserVariable struct {
    91  	Name string
    92  	Elem string
    93  
    94  	key string
    95  }
    96  
    97  func NewInterpolatedVariable(v string) (InterpolatedVariable, error) {
    98  	if strings.HasPrefix(v, "count.") {
    99  		return NewCountVariable(v)
   100  	} else if strings.HasPrefix(v, "path.") {
   101  		return NewPathVariable(v)
   102  	} else if strings.HasPrefix(v, "self.") {
   103  		return NewSelfVariable(v)
   104  	} else if strings.HasPrefix(v, "var.") {
   105  		return NewUserVariable(v)
   106  	} else if strings.HasPrefix(v, "module.") {
   107  		return NewModuleVariable(v)
   108  	} else if !strings.ContainsRune(v, '.') {
   109  		return NewSimpleVariable(v)
   110  	} else {
   111  		return NewResourceVariable(v)
   112  	}
   113  }
   114  
   115  func NewCountVariable(key string) (*CountVariable, error) {
   116  	var fieldType CountValueType
   117  	parts := strings.SplitN(key, ".", 2)
   118  	switch parts[1] {
   119  	case "index":
   120  		fieldType = CountValueIndex
   121  	}
   122  
   123  	return &CountVariable{
   124  		Type: fieldType,
   125  		key:  key,
   126  	}, nil
   127  }
   128  
   129  func (c *CountVariable) FullKey() string {
   130  	return c.key
   131  }
   132  
   133  func NewModuleVariable(key string) (*ModuleVariable, error) {
   134  	parts := strings.SplitN(key, ".", 3)
   135  	if len(parts) < 3 {
   136  		return nil, fmt.Errorf(
   137  			"%s: module variables must be three parts: module.name.attr",
   138  			key)
   139  	}
   140  
   141  	return &ModuleVariable{
   142  		Name:  parts[1],
   143  		Field: parts[2],
   144  		key:   key,
   145  	}, nil
   146  }
   147  
   148  func (v *ModuleVariable) FullKey() string {
   149  	return v.key
   150  }
   151  
   152  func NewPathVariable(key string) (*PathVariable, error) {
   153  	var fieldType PathValueType
   154  	parts := strings.SplitN(key, ".", 2)
   155  	switch parts[1] {
   156  	case "cwd":
   157  		fieldType = PathValueCwd
   158  	case "module":
   159  		fieldType = PathValueModule
   160  	case "root":
   161  		fieldType = PathValueRoot
   162  	}
   163  
   164  	return &PathVariable{
   165  		Type: fieldType,
   166  		key:  key,
   167  	}, nil
   168  }
   169  
   170  func (v *PathVariable) FullKey() string {
   171  	return v.key
   172  }
   173  
   174  func NewResourceVariable(key string) (*ResourceVariable, error) {
   175  	var mode ResourceMode
   176  	var parts []string
   177  	if strings.HasPrefix(key, "data.") {
   178  		mode = DataResourceMode
   179  		parts = strings.SplitN(key, ".", 4)
   180  		if len(parts) < 4 {
   181  			return nil, fmt.Errorf(
   182  				"%s: data variables must be four parts: data.TYPE.NAME.ATTR",
   183  				key)
   184  		}
   185  
   186  		// Don't actually need the "data." prefix for parsing, since it's
   187  		// always constant.
   188  		parts = parts[1:]
   189  	} else {
   190  		mode = ManagedResourceMode
   191  		parts = strings.SplitN(key, ".", 3)
   192  		if len(parts) < 3 {
   193  			return nil, fmt.Errorf(
   194  				"%s: resource variables must be three parts: TYPE.NAME.ATTR",
   195  				key)
   196  		}
   197  	}
   198  
   199  	field := parts[2]
   200  	multi := false
   201  	var index int
   202  
   203  	if idx := strings.Index(field, "."); idx != -1 {
   204  		indexStr := field[:idx]
   205  		multi = indexStr == "*"
   206  		index = -1
   207  
   208  		if !multi {
   209  			indexInt, err := strconv.ParseInt(indexStr, 0, 0)
   210  			if err == nil {
   211  				multi = true
   212  				index = int(indexInt)
   213  			}
   214  		}
   215  
   216  		if multi {
   217  			field = field[idx+1:]
   218  		}
   219  	}
   220  
   221  	return &ResourceVariable{
   222  		Mode:  mode,
   223  		Type:  parts[0],
   224  		Name:  parts[1],
   225  		Field: field,
   226  		Multi: multi,
   227  		Index: index,
   228  		key:   key,
   229  	}, nil
   230  }
   231  
   232  func (v *ResourceVariable) ResourceId() string {
   233  	switch v.Mode {
   234  	case ManagedResourceMode:
   235  		return fmt.Sprintf("%s.%s", v.Type, v.Name)
   236  	case DataResourceMode:
   237  		return fmt.Sprintf("data.%s.%s", v.Type, v.Name)
   238  	default:
   239  		panic(fmt.Errorf("unknown resource mode %s", v.Mode))
   240  	}
   241  }
   242  
   243  func (v *ResourceVariable) FullKey() string {
   244  	return v.key
   245  }
   246  
   247  func NewSelfVariable(key string) (*SelfVariable, error) {
   248  	field := key[len("self."):]
   249  
   250  	return &SelfVariable{
   251  		Field: field,
   252  
   253  		key: key,
   254  	}, nil
   255  }
   256  
   257  func (v *SelfVariable) FullKey() string {
   258  	return v.key
   259  }
   260  
   261  func (v *SelfVariable) GoString() string {
   262  	return fmt.Sprintf("*%#v", *v)
   263  }
   264  
   265  func NewSimpleVariable(key string) (*SimpleVariable, error) {
   266  	return &SimpleVariable{key}, nil
   267  }
   268  
   269  func (v *SimpleVariable) FullKey() string {
   270  	return v.Key
   271  }
   272  
   273  func (v *SimpleVariable) GoString() string {
   274  	return fmt.Sprintf("*%#v", *v)
   275  }
   276  
   277  func NewUserVariable(key string) (*UserVariable, error) {
   278  	name := key[len("var."):]
   279  	elem := ""
   280  	if idx := strings.Index(name, "."); idx > -1 {
   281  		elem = name[idx+1:]
   282  		name = name[:idx]
   283  	}
   284  
   285  	return &UserVariable{
   286  		key: key,
   287  
   288  		Name: name,
   289  		Elem: elem,
   290  	}, nil
   291  }
   292  
   293  func (v *UserVariable) FullKey() string {
   294  	return v.key
   295  }
   296  
   297  func (v *UserVariable) GoString() string {
   298  	return fmt.Sprintf("*%#v", *v)
   299  }
   300  
   301  // DetectVariables takes an AST root and returns all the interpolated
   302  // variables that are detected in the AST tree.
   303  func DetectVariables(root ast.Node) ([]InterpolatedVariable, error) {
   304  	var result []InterpolatedVariable
   305  	var resultErr error
   306  
   307  	// Visitor callback
   308  	fn := func(n ast.Node) ast.Node {
   309  		if resultErr != nil {
   310  			return n
   311  		}
   312  
   313  		switch vn := n.(type) {
   314  		case *ast.VariableAccess:
   315  			v, err := NewInterpolatedVariable(vn.Name)
   316  			if err != nil {
   317  				resultErr = err
   318  				return n
   319  			}
   320  			result = append(result, v)
   321  		case *ast.Index:
   322  			if va, ok := vn.Target.(*ast.VariableAccess); ok {
   323  				v, err := NewInterpolatedVariable(va.Name)
   324  				if err != nil {
   325  					resultErr = err
   326  					return n
   327  				}
   328  				result = append(result, v)
   329  			}
   330  			if va, ok := vn.Key.(*ast.VariableAccess); ok {
   331  				v, err := NewInterpolatedVariable(va.Name)
   332  				if err != nil {
   333  					resultErr = err
   334  					return n
   335  				}
   336  				result = append(result, v)
   337  			}
   338  		default:
   339  			return n
   340  		}
   341  
   342  		return n
   343  	}
   344  
   345  	// Visitor pattern
   346  	root.Accept(fn)
   347  
   348  	if resultErr != nil {
   349  		return nil, resultErr
   350  	}
   351  
   352  	return result, nil
   353  }