Add support for specifying the relative path to the OAS documentation

gen/http/chi/generator.go

@@ -51,7 +51,7 @@ func NewHTTPRouterWithOAS(svc {{.Result.SrcPkgPrefix}}{{.Result.Interface.Name}}
 	{{- end}}
 
 	if schema != nil {
-		r.Method("GET", "/api", oasv2.Handler(OASv2APIDoc, schema))
+		r.Method("GET", "{{.Spec.Metadata.DocsPath}}", oasv2.Handler(OASv2APIDoc, schema))
 	}
 
 	var codec httpcodec.Codec

gen/util/openapi/spec.go

@@ -30,10 +30,15 @@ type Specification struct {
 }
 
 type Metadata struct {
+	// Relative path to the OAS documentation.
+	DocsPath string
+
 	Title       string
 	Version     string
 	Description string
 	BasePath    string
+
+	// Default tags for operations those have no tags.
 	DefaultTags []string
 }
 

gen/util/openapi/util.go

@@ -50,6 +50,7 @@ func buildSuccessResponse(text string, results map[string]*reflector.Param, opNa
 
 func buildMetadata(comments []string) (m *Metadata, err error) {
 	m = &Metadata{
+		DocsPath:    "/api",
 		Title:       "No Title",
 		Version:     "0.0.0",
 		Description: getDescriptionFromDoc(comments),
@@ -72,8 +73,10 @@ func buildMetadata(comments []string) (m *Metadata, err error) {
 			return nil, fmt.Errorf(`%q does not match the expected format: "<key>:<value>"`, value)
 		}
 
-		k, v := parts[0], parts[1]
+		k, v := strings.TrimSpace(parts[0]), strings.TrimSpace(parts[1])
 		switch k {
+		case "docsPath":
+			m.DocsPath = v
 		case "title":
 			m.Title = v
 		case "version":