Update api spec (#121)

* YOYO NEW API SPEC!

* fixes

Signed-off-by: Jess Frazelle <[email protected]>

---------

Signed-off-by: Jess Frazelle <[email protected]>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Jess Frazelle <[email protected]>

Author: 3 people

VERSION.txt

@@ -1 +1 @@
-v0.2.32
+v0.2.33

client.go

@@ -269,10 +269,23 @@ func (data *Data) generateMethod(doc *openapi3.T, method string, pathName string
 	// Now we can get the description since we have filled in everything else.
 	function.Description = function.getDescription(operation)
 
+	isMultiPart := false
+	if operation.RequestBody != nil {
+		for mediaType := range operation.RequestBody.Value.Content {
+			if strings.Contains(mediaType, "multipart/form-data") {
+				isMultiPart = true
+				break
+			}
+		}
+	}
+
 	exampleTemplatePath := "function-example.tmpl"
 	if _, ok := operation.Extensions["x-dropshot-websocket"]; ok {
 		exampleTemplatePath = "function-example-ws.tmpl"
 	}
+	if isMultiPart {
+		exampleTemplatePath = "function-example-multipart.tmpl"
+	}
 
 	// Build the example function.
 	example, err := templateToString(exampleTemplatePath, function)
@@ -285,6 +298,10 @@ func (data *Data) generateMethod(doc *openapi3.T, method string, pathName string
 	if _, ok := operation.Extensions["x-dropshot-websocket"]; ok {
 		templatePath = "websocket.tmpl"
 	}
+	// If its a multipart request, we need to use a different template.
+	if isMultiPart {
+		templatePath = "multipart.tmpl"
+	}
 
 	// Print the template for the function.
 	f, err := templateToString(templatePath, function)

cmd/paths.go

@@ -0,0 +1,22 @@
+// {{.Description}}
+func Example{{.Tag}}Service_{{.Name}}() {
+    client, err := {{.PackageName}}.NewClientFromEnv("your apps user agent")
+    if err != nil {
+        panic(err)
+    }
+
+    buf := new(bytes.Buffer)
+
+    {{if .Response}}
+        result, err := client.{{.Tag}}.{{.Name}}({{range .Args -}}{{.Example}},{{end -}} buf)
+        if err != nil {
+            panic(err)
+        }
+
+        fmt.Printf("%#v", result)
+    {{else}}
+    if err := client.{{.Tag}}.{{.Name}}({{range .Args -}}{{.Example}},{{end -}} buf); err != nil {
+        panic(err)
+    }
+    {{end}}
+}

cmd/tmpl/function-example-multipart.tmpl

@@ -0,0 +1,58 @@
+// {{.Description}}
+func (s *{{.Tag}}Service) {{.Name}}({{range .Args -}}{{.Name}} {{.Type}},{{end -}} body *bytes.Buffer) {{if .Response}}(*{{.Response.Type}}, error){{else}}error{{end}} {
+	// Create the url.
+    path := "{{.Path}}"
+	uri := resolveRelative(s.client.server, path)
+
+
+	// Create the request.
+    req, err := http.NewRequest("{{.Method}}", uri, body)
+	if err != nil {
+        return {{if .Response}}nil,{{end}} fmt.Errorf("error creating request: %v", err)
+	}
+
+    {{if .RequestBody}}
+        // Add our headers.
+        req.Header.Add("Content-Type", "{{.RequestBody.MediaType}}")
+    {{end}}
+
+    {{if .Args}}
+	// Add the parameters to the url.
+	if err := expandURL(req.URL, map[string]string{
+    {{range .Args -}}
+        "{{.Property}}": {{.ToString}},
+    {{end -}}
+	}); err != nil {
+		return {{if .Response}}nil,{{end}} fmt.Errorf("expanding URL with parameters failed: %v", err)
+	}
+    {{end}}
+
+	// Send the request.
+	resp, err := s.client.client.Do(req)
+	if err != nil {
+		return {{if .Response}}nil,{{end}} fmt.Errorf("error sending request: %v", err)
+	}
+	defer resp.Body.Close()
+
+	// Check the response.
+	if err := checkResponse(resp); err != nil {
+		return {{if .Response}}nil,{{end}} err
+	}
+
+    {{if .Response}}
+        // Decode the body from the response.
+        if resp.Body == nil {
+            return nil, errors.New("request returned an empty body in the response")
+        }
+        var decoded {{.Response.Type}}
+        if err := json.NewDecoder(resp.Body).Decode(&decoded); err != nil {
+            return nil, fmt.Errorf("error decoding response body: %v", err)
+        }
+
+        // Return the response.
+	    return &decoded, nil
+    {{else}}
+	    // Return.
+	    return nil
+    {{end}}
+}

cmd/tmpl/multipart.tmpl

@@ -298,6 +298,11 @@ func (data *Data) generateOneOfType(name string, s *openapi3.Schema, spec *opena
 		}, enumDocs)
 	}
 
+	if len(s.OneOf) == 1 && s.OneOf[0].Value.Type == "object" {
+		// We need to generate the one of type.
+		return data.generateSchemaType(name, s.OneOf[0].Value, spec)
+	}
+
 	// Check if they all have a type.
 	types := []string{}
 	typeName := ""