// Command aws-gen-gocli parses a JSON description of an AWS API and generates a // Go file containing a client for the API. // // aws-gen-gocli apis/s3/2006-03-03/api-2.json package main import ( "flag" "fmt" "io/ioutil" "os" "path/filepath" "runtime/debug" "sort" "strings" "sync" "github.com/aws/aws-sdk-go/internal/model/api" "github.com/aws/aws-sdk-go/internal/util" ) type generateInfo struct { *api.API PackageDir string } var excludeServices = map[string]struct{}{ "simpledb": {}, "importexport": {}, } // newGenerateInfo initializes the service API's folder structure for a specific service. // If the SERVICES environment variable is set, and this service is not apart of the list // this service will be skipped. func newGenerateInfo(modelFile, svcPath string) *generateInfo { g := &generateInfo{API: &api.API{}} g.API.Attach(modelFile) if _, ok := excludeServices[g.API.PackageName()]; ok { return nil } paginatorsFile := strings.Replace(modelFile, "api-2.json", "paginators-1.json", -1) if _, err := os.Stat(paginatorsFile); err == nil { g.API.AttachPaginators(paginatorsFile) } docsFile := strings.Replace(modelFile, "api-2.json", "docs-2.json", -1) if _, err := os.Stat(docsFile); err == nil { g.API.AttachDocs(docsFile) } g.API.Setup() if svc := os.Getenv("SERVICES"); svc != "" { svcs := strings.Split(svc, ",") included := false for _, s := range svcs { if s == g.API.PackageName() { included = true break } } if !included { // skip this non-included service return nil } } // ensure the directory exists pkgDir := filepath.Join(svcPath, g.API.PackageName()) os.MkdirAll(pkgDir, 0775) os.MkdirAll(filepath.Join(pkgDir, g.API.InterfacePackageName()), 0775) g.PackageDir = pkgDir return g } // Generates service api, examples, and interface from api json definition files. // // Flags: // -path alternative service path to write generated files to for each service. // // Env: // SERVICES comma separated list of services to generate. func main() { var svcPath string flag.StringVar(&svcPath, "path", "service", "generate in a specific directory (default: 'service')") flag.Parse() files := []string{} for i := 0; i < flag.NArg(); i++ { file := flag.Arg(i) if strings.Contains(file, "*") { paths, _ := filepath.Glob(file) files = append(files, paths...) } else { files = append(files, file) } } for svcName := range excludeServices { if strings.Contains(os.Getenv("SERVICES"), svcName) { fmt.Printf("Service %s is not supported\n", svcName) os.Exit(1) } } sort.Strings(files) // Remove old API versions from list m := map[string]bool{} for i := range files { idx := len(files) - 1 - i parts := strings.Split(files[idx], string(filepath.Separator)) svc := parts[len(parts)-3] // service name is 2nd-to-last component if m[svc] { files[idx] = "" // wipe this one out if we already saw the service } m[svc] = true } w := sync.WaitGroup{} for i := range files { file := files[i] if file == "" { // empty file continue } w.Add(1) go func() { defer func() { w.Done() if r := recover(); r != nil { fmtStr := "Error generating %s\n%s\n%s\n" fmt.Fprintf(os.Stderr, fmtStr, file, r, debug.Stack()) } }() if g := newGenerateInfo(file, svcPath); g != nil { if _, ok := excludeServices[g.API.PackageName()]; !ok { // Skip services not yet supported. fmt.Printf("Generating %s (%s)...\n", g.API.PackageName(), g.API.Metadata.APIVersion) // write api.go and service.go files g.writeAPIFile() g.writeExamplesFile() g.writeServiceFile() g.writeInterfaceFile() } } }() } w.Wait() } const codeLayout = `// THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT. %s package %s %s ` func writeGoFile(file string, layout string, args ...interface{}) error { return ioutil.WriteFile(file, []byte(util.GoFmt(fmt.Sprintf(layout, args...))), 0664) } // writeExamplesFile writes out the service example file. func (g *generateInfo) writeExamplesFile() { writeGoFile(filepath.Join(g.PackageDir, "examples_test.go"), codeLayout, "", g.API.PackageName()+"_test", g.API.ExampleGoCode(), ) } // writeServiceFile writes out the service initialization file. func (g *generateInfo) writeServiceFile() { writeGoFile(filepath.Join(g.PackageDir, "service.go"), codeLayout, "", g.API.PackageName(), g.API.ServiceGoCode(), ) } // writeInterfaceFile writes out the service interface file. func (g *generateInfo) writeInterfaceFile() { writeGoFile(filepath.Join(g.PackageDir, g.API.InterfacePackageName(), "interface.go"), codeLayout, fmt.Sprintf("\n// Package %s provides an interface for the %s.", g.API.InterfacePackageName(), g.API.Metadata.ServiceFullName), g.API.InterfacePackageName(), g.API.InterfaceGoCode(), ) writeGoFile(filepath.Join(g.PackageDir, g.API.InterfacePackageName(), "interface_test.go"), codeLayout, "", g.API.InterfacePackageName()+"_test", g.API.InterfaceTestGoCode(), ) } // writeAPIFile writes out the service api file. func (g *generateInfo) writeAPIFile() { writeGoFile(filepath.Join(g.PackageDir, "api.go"), codeLayout, fmt.Sprintf("\n// Package %s provides a client for %s.", g.API.PackageName(), g.API.Metadata.ServiceFullName), g.API.PackageName(), g.API.APIGoCode(), ) }