// Copyright 2016-2021, Pulumi Corporation. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package test import ( "bytes" "encoding/json" "fmt" "io" "io/ioutil" "net/http" "os" "path/filepath" "sort" "testing" "github.com/pkg/errors" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" "gopkg.in/yaml.v3" "github.com/pulumi/pulumi/pkg/v3/codegen/schema" "github.com/pulumi/pulumi/pkg/v3/testing/integration" "github.com/pulumi/pulumi/sdk/v3/go/common/util/executable" ) // GenPkgSignature corresponds to the shape of the codegen GeneratePackage functions. type GenPkgSignature func(string, *schema.Package, map[string][]byte) (map[string][]byte, error) // GeneratePackageFilesFromSchema loads a schema and generates files using the provided GeneratePackage function. func GeneratePackageFilesFromSchema(schemaPath string, genPackageFunc GenPkgSignature) (map[string][]byte, error) { // Read in, decode, and import the schema. schemaBytes, err := ioutil.ReadFile(schemaPath) if err != nil { return nil, err } ext := filepath.Ext(schemaPath) var pkgSpec schema.PackageSpec if ext == ".yaml" || ext == ".yml" { err = yaml.Unmarshal(schemaBytes, &pkgSpec) } else { err = json.Unmarshal(schemaBytes, &pkgSpec) } if err != nil { return nil, err } pkg, err := schema.ImportSpec(pkgSpec, nil) if err != nil { return nil, err } return genPackageFunc("test", pkg, nil) } // LoadFiles loads the provided list of files from a directory. func LoadFiles(dir, lang string, files []string) (map[string][]byte, error) { result := map[string][]byte{} for _, file := range files { fileBytes, err := ioutil.ReadFile(filepath.Join(dir, lang, file)) if err != nil { return nil, err } result[file] = fileBytes } return result, nil } func PathExists(path string) (bool, error) { _, err := os.Stat(path) if os.IsNotExist(err) { return false, nil } if err == nil { return true, nil } return false, err } // `LoadBaseline` loads the contents of the given baseline directory, // by inspecting its `codegen-manifest.json`. func LoadBaseline(dir, lang string) (map[string][]byte, error) { cm := &codegenManifest{} err := cm.load(filepath.Join(dir, lang)) if err != nil { return nil, fmt.Errorf("Failed to load codegen-manifest.json: %w", err) } files := make(map[string][]byte) for _, f := range cm.EmittedFiles { bytes, err := ioutil.ReadFile(filepath.Join(dir, lang, f)) if err != nil { return nil, fmt.Errorf("Failed to load file %s referenced in codegen-manifest.json: %w", f, err) } files[f] = bytes } return files, nil } type codegenManifest struct { EmittedFiles []string `json:"emittedFiles"` } func (cm *codegenManifest) load(dir string) error { bytes, err := ioutil.ReadFile(filepath.Join(dir, "codegen-manifest.json")) if err != nil { return err } return json.Unmarshal(bytes, cm) } func (cm *codegenManifest) save(dir string) error { sort.Strings(cm.EmittedFiles) buf := &bytes.Buffer{} enc := json.NewEncoder(buf) enc.SetIndent("", " ") err := enc.Encode(cm) if err != nil { return err } data := buf.Bytes() return ioutil.WriteFile(filepath.Join(dir, "codegen-manifest.json"), data, 0600) } // ValidateFileEquality compares maps of files for equality. func ValidateFileEquality(t *testing.T, actual, expected map[string][]byte) bool { ok := true for name, file := range expected { _, inActual := actual[name] if inActual { if !assert.Equal(t, string(file), string(actual[name]), name) { t.Logf("%s did not agree", name) ok = false } } else { t.Logf("File %s was expected but is missing from the actual fileset", name) ok = false } } for name := range actual { if _, inExpected := expected[name]; !inExpected { t.Logf("File %s from the actual fileset was not expected", name) ok = false } } return ok } // If PULUMI_ACCEPT is set, writes out actual output to the expected // file set, so we can continue enjoying golden tests without manually // modifying the expected output. func RewriteFilesWhenPulumiAccept(t *testing.T, dir, lang string, actual map[string][]byte) bool { if os.Getenv("PULUMI_ACCEPT") == "" { return false } cm := &codegenManifest{} baseline := filepath.Join(dir, lang) // Remove the baseline directory's current contents. _, err := os.ReadDir(baseline) switch { case err == nil: err = os.RemoveAll(baseline) require.NoError(t, err) case os.IsNotExist(err): // OK default: require.NoError(t, err) } for file, bytes := range actual { relPath := filepath.FromSlash(file) path := filepath.Join(dir, lang, relPath) cm.EmittedFiles = append(cm.EmittedFiles, relPath) err := writeFileEnsuringDir(path, bytes) require.NoError(t, err) } err = cm.save(filepath.Join(dir, lang)) require.NoError(t, err) return true } // Useful for populating code-generated destination // `codeDir=$dir/$lang` with extra manually written files such as the // unit test files. These files are copied from `$dir/$lang-extras` // folder if present. func CopyExtraFiles(t *testing.T, dir, lang string) { codeDir := filepath.Join(dir, lang) extrasDir := filepath.Join(dir, fmt.Sprintf("%s-extras", lang)) gotExtras, err := PathExists(extrasDir) if !gotExtras { return } if err != nil { require.NoError(t, err) return } err = filepath.Walk(extrasDir, func(path string, info os.FileInfo, err error) error { if err != nil { return err } if info.IsDir() { return nil } relPath, err := filepath.Rel(extrasDir, path) if err != nil { return err } destPath := filepath.Join(codeDir, relPath) bytes, err := ioutil.ReadFile(path) if err != nil { return err } err = writeFileEnsuringDir(destPath, bytes) if err != nil { return err } t.Logf("Copied %s to %s", path, destPath) return nil }) require.NoError(t, err) } func writeFileEnsuringDir(path string, bytes []byte) error { if err := os.MkdirAll(filepath.Dir(path), 0755); err != nil && !os.IsExist(err) { return err } return ioutil.WriteFile(path, bytes, 0600) } // CheckAllFilesGenerated ensures that the set of expected and actual files generated // are exactly equivalent. func CheckAllFilesGenerated(t *testing.T, actual, expected map[string][]byte) { seen := map[string]bool{} for x := range expected { seen[x] = true } for a := range actual { assert.Contains(t, seen, a, "Unexpected file generated: %s", a) if seen[a] { delete(seen, a) } } for s := range seen { assert.Fail(t, "No content generated for expected file %s", s) } } // Validates a transformer on a single file. func ValidateFileTransformer( t *testing.T, inputFile string, expectedOutputFile string, transformer func(reader io.Reader, writer io.Writer) error) { reader, err := os.Open(inputFile) if err != nil { t.Error(err) return } var buf bytes.Buffer err = transformer(reader, &buf) if err != nil { t.Error(err) return } actualBytes := buf.Bytes() if os.Getenv("PULUMI_ACCEPT") != "" { err := ioutil.WriteFile(expectedOutputFile, actualBytes, 0600) if err != nil { t.Error(err) return } } actual := map[string][]byte{expectedOutputFile: actualBytes} expectedBytes, err := ioutil.ReadFile(expectedOutputFile) if err != nil { t.Error(err) return } expected := map[string][]byte{expectedOutputFile: expectedBytes} ValidateFileEquality(t, actual, expected) } func RunCommand(t *testing.T, name string, cwd string, exec string, args ...string) { exec, err := executable.FindExecutable(exec) if err != nil { t.Error(err) t.FailNow() } wd, err := filepath.Abs(cwd) require.NoError(t, err) var stdout, stderr bytes.Buffer cmdOptions := integration.ProgramTestOptions{Stderr: &stderr, Stdout: &stdout, Verbose: true} err = integration.RunCommand(t, name, append([]string{exec}, args...), wd, &cmdOptions) if !assert.NoError(t, err) { stdout := stdout.String() stderr := stderr.String() if len(stdout) > 0 { t.Logf("stdout: %s", stdout) } if len(stderr) > 0 { t.Logf("stderr: %s", stderr) } t.FailNow() } } type SchemaVersion = string const ( AwsSchema SchemaVersion = "4.21.1" AzureNativeSchema SchemaVersion = "1.29.0" AzureSchema SchemaVersion = "4.18.0" KubernetesSchema SchemaVersion = "3.7.2" RandomSchema SchemaVersion = "4.2.0" ) var schemaVersions = map[string]struct { version SchemaVersion url string }{ "aws.json": { version: AwsSchema, url: "https://raw.githubusercontent.com/pulumi/pulumi-aws/v%s/provider/cmd/pulumi-resource-aws/schema.json", //nolint:lll }, "azure.json": { version: AzureSchema, url: "https://raw.githubusercontent.com/pulumi/pulumi-azure/v%s/provider/cmd/pulumi-resource-azure/schema.json", }, "azure-native.json": { version: AzureNativeSchema, url: "https://raw.githubusercontent.com/pulumi/pulumi-azure-native/v%s/provider/cmd/pulumi-resource-azure-native/schema.json", //nolint:lll }, "kubernetes.json": { version: KubernetesSchema, url: "https://raw.githubusercontent.com/pulumi/pulumi-kubernetes/v%s/provider/cmd/pulumi-resource-kubernetes/schema.json", //nolint:lll }, "random.json": { version: RandomSchema, url: "https://raw.githubusercontent.com/pulumi/pulumi-random/v%s/provider/cmd/pulumi-resource-random/schema.json", }, } // ensureValidSchemaVersions ensures that we have downloaded valid schema for // the tests. If it does not find such schema, or the schema found have the // wrong version, the function downloads correct schema. func ensureValidSchemaVersions(t *testing.T) { c := make(chan error) updates := 0 for k, v := range schemaVersions { path := filepath.Join("..", "internal", "test", "testdata", k) current, err := currentVersion(path) var isJSONSyntaxError bool if err != nil { _, isJSONSyntaxError = err.(*json.SyntaxError) } if os.IsNotExist(err) || isJSONSyntaxError || (err == nil && current != v.version) { t.Logf("Updating %s from %s to %s", k, current, v.version) updates++ go replaceSchema(c, path, v.version, v.url) } else if err != nil { t.Errorf("failed to get schema version: %s", err) } } var err error for i := 0; i < updates; i++ { err = <-c if err != nil { t.Errorf("failed to update schema: %s", err) } } if err != nil { t.FailNow() } } // Reads the current version of the installed package schema func currentVersion(path string) (string, error) { str, err := ioutil.ReadFile(path) if err != nil { return "", err } var data interface{} err = json.Unmarshal(str, &data) if err != nil { return "", err } json, ok := data.(map[string]interface{}) if !ok { return "", errors.Errorf("%s could not be read", path) } version, ok := json["version"] if !ok { return "", errors.New("Could not find version field") } versionString, ok := version.(string) if !ok { return "", errors.New("version value is not a string") } return versionString, nil } // Replaces the installed package schema with one containing the correct version. func replaceSchema(c chan error, path, version, url string) { // This is safe because url is always a reference to a page Pulumi // controls in github. resp, err := http.Get(fmt.Sprintf(url, version)) //nolint:gosec if err != nil { c <- err return } defer resp.Body.Close() err = os.Remove(path) if !os.IsNotExist(err) && err != nil { c <- errors.Wrap(err, "failed to replace schema") return } schemaFile, err := os.Create(path) if err != nil { c <- err return } defer schemaFile.Close() var schemaRaw interface{} decoder := json.NewDecoder(resp.Body) err = decoder.Decode(&schemaRaw) if err != nil { c <- err return } schema, ok := schemaRaw.(map[string]interface{}) if !ok { c <- errors.New("failed to convert schema to map") return } schema["version"] = version encoded, err := json.MarshalIndent(schema, "", " ") if err != nil { c <- err return } written, err := schemaFile.Write(encoded) if err != nil { c <- err } else if written != len(encoded) { c <- errors.New("failed to write full message") } else { c <- nil } }