github.com/medzin/terraform@v0.11.11/config/loader.go (about) 1 package config 2 3 import ( 4 "encoding/json" 5 "fmt" 6 "io" 7 "os" 8 "path/filepath" 9 "sort" 10 "strings" 11 12 "github.com/hashicorp/hcl" 13 ) 14 15 // ErrNoConfigsFound is the error returned by LoadDir if no 16 // Terraform configuration files were found in the given directory. 17 type ErrNoConfigsFound struct { 18 Dir string 19 } 20 21 func (e ErrNoConfigsFound) Error() string { 22 return fmt.Sprintf( 23 "No Terraform configuration files found in directory: %s", 24 e.Dir) 25 } 26 27 // LoadJSON loads a single Terraform configuration from a given JSON document. 28 // 29 // The document must be a complete Terraform configuration. This function will 30 // NOT try to load any additional modules so only the given document is loaded. 31 func LoadJSON(raw json.RawMessage) (*Config, error) { 32 obj, err := hcl.Parse(string(raw)) 33 if err != nil { 34 return nil, fmt.Errorf( 35 "Error parsing JSON document as HCL: %s", err) 36 } 37 38 // Start building the result 39 hclConfig := &hclConfigurable{ 40 Root: obj, 41 } 42 43 return hclConfig.Config() 44 } 45 46 // LoadFile loads the Terraform configuration from a given file. 47 // 48 // This file can be any format that Terraform recognizes, and import any 49 // other format that Terraform recognizes. 50 func LoadFile(path string) (*Config, error) { 51 importTree, err := loadTree(path) 52 if err != nil { 53 return nil, err 54 } 55 56 configTree, err := importTree.ConfigTree() 57 58 // Close the importTree now so that we can clear resources as quickly 59 // as possible. 60 importTree.Close() 61 62 if err != nil { 63 return nil, err 64 } 65 66 return configTree.Flatten() 67 } 68 69 // LoadDir loads all the Terraform configuration files in a single 70 // directory and appends them together. 71 // 72 // Special files known as "override files" can also be present, which 73 // are merged into the loaded configuration. That is, the non-override 74 // files are loaded first to create the configuration. Then, the overrides 75 // are merged into the configuration to create the final configuration. 76 // 77 // Files are loaded in lexical order. 78 func LoadDir(root string) (*Config, error) { 79 files, overrides, err := dirFiles(root) 80 if err != nil { 81 return nil, err 82 } 83 if len(files) == 0 && len(overrides) == 0 { 84 return nil, &ErrNoConfigsFound{Dir: root} 85 } 86 87 // Determine the absolute path to the directory. 88 rootAbs, err := filepath.Abs(root) 89 if err != nil { 90 return nil, err 91 } 92 93 var result *Config 94 95 // Sort the files and overrides so we have a deterministic order 96 sort.Strings(files) 97 sort.Strings(overrides) 98 99 // Load all the regular files, append them to each other. 100 for _, f := range files { 101 c, err := LoadFile(f) 102 if err != nil { 103 return nil, err 104 } 105 106 if result != nil { 107 result, err = Append(result, c) 108 if err != nil { 109 return nil, err 110 } 111 } else { 112 result = c 113 } 114 } 115 if len(files) == 0 { 116 result = &Config{} 117 } 118 119 // Load all the overrides, and merge them into the config 120 for _, f := range overrides { 121 c, err := LoadFile(f) 122 if err != nil { 123 return nil, err 124 } 125 126 result, err = Merge(result, c) 127 if err != nil { 128 return nil, err 129 } 130 } 131 132 // Mark the directory 133 result.Dir = rootAbs 134 135 return result, nil 136 } 137 138 // IsEmptyDir returns true if the directory given has no Terraform 139 // configuration files. 140 func IsEmptyDir(root string) (bool, error) { 141 if _, err := os.Stat(root); err != nil && os.IsNotExist(err) { 142 return true, nil 143 } 144 145 fs, os, err := dirFiles(root) 146 if err != nil { 147 return false, err 148 } 149 150 return len(fs) == 0 && len(os) == 0, nil 151 } 152 153 // Ext returns the Terraform configuration extension of the given 154 // path, or a blank string if it is an invalid function. 155 func ext(path string) string { 156 if strings.HasSuffix(path, ".tf") { 157 return ".tf" 158 } else if strings.HasSuffix(path, ".tf.json") { 159 return ".tf.json" 160 } else { 161 return "" 162 } 163 } 164 165 func dirFiles(dir string) ([]string, []string, error) { 166 f, err := os.Open(dir) 167 if err != nil { 168 return nil, nil, err 169 } 170 defer f.Close() 171 172 fi, err := f.Stat() 173 if err != nil { 174 return nil, nil, err 175 } 176 if !fi.IsDir() { 177 return nil, nil, fmt.Errorf( 178 "configuration path must be a directory: %s", 179 dir) 180 } 181 182 var files, overrides []string 183 err = nil 184 for err != io.EOF { 185 var fis []os.FileInfo 186 fis, err = f.Readdir(128) 187 if err != nil && err != io.EOF { 188 return nil, nil, err 189 } 190 191 for _, fi := range fis { 192 // Ignore directories 193 if fi.IsDir() { 194 continue 195 } 196 197 // Only care about files that are valid to load 198 name := fi.Name() 199 extValue := ext(name) 200 if extValue == "" || IsIgnoredFile(name) { 201 continue 202 } 203 204 // Determine if we're dealing with an override 205 nameNoExt := name[:len(name)-len(extValue)] 206 override := nameNoExt == "override" || 207 strings.HasSuffix(nameNoExt, "_override") 208 209 path := filepath.Join(dir, name) 210 if override { 211 overrides = append(overrides, path) 212 } else { 213 files = append(files, path) 214 } 215 } 216 } 217 218 return files, overrides, nil 219 } 220 221 // IsIgnoredFile returns true or false depending on whether the 222 // provided file name is a file that should be ignored. 223 func IsIgnoredFile(name string) bool { 224 return strings.HasPrefix(name, ".") || // Unix-like hidden files 225 strings.HasSuffix(name, "~") || // vim 226 strings.HasPrefix(name, "#") && strings.HasSuffix(name, "#") // emacs 227 }