[Feature] Support type aliases

integration_test/test_data/handler/restaurants.go

@@ -26,7 +26,7 @@ func GetRestaurants() {
 // @param commodityGroup query string false "Use as filter.commodityGroup! Commodity Group"
 // @param isDigitalScreen query string false "Use as filter.isDigitalScreen! IsDigitalScreen. Can be: true, false"
 // @success 200 {object} GetPogsResponse
-// @failure 400 {object} ValidationError
+// @failure 400 {object} aliasValidationError
 // @failure 404 {object} ErrResponse
 // @failure 500 {object} ErrResponse
 // @route assortment/planogram [get]
@@ -37,6 +37,9 @@ type GetPogsResponse struct {
 	Planograms []int `json:"planograms"`
 }
 
+// make a type alias of ValidationError
+type aliasValidationError = ValidationError
+
 type ValidationError struct {
 	StatusCode int     `json:"statusCode" xml:"statusCode"`
 	Errors     []error `json:"errors" xml:"errors"`

integration_test/test_data/spec/expected.json

@@ -183,7 +183,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ValidationError"
+                  "$ref": "#/components/schemas/aliasValidationError"
                 }
               }
             }
@@ -489,7 +489,7 @@
           }
         }
       },
-      "ValidationError": {
+      "aliasValidationError": {
         "type": "object",
         "properties": {
           "statusCode": {

integration_test/test_data/spec/expected_with_pkg.json

@@ -183,7 +183,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/github.com.parvez3019.go-swagger3.handler.ValidationError"
+                  "$ref": "#/components/schemas/github.com.parvez3019.go-swagger3.handler.aliasValidationError"
                 }
               }
             }
@@ -382,7 +382,7 @@
           }
         }
       },
-      "github.com.parvez3019.go-swagger3.handler.ValidationError": {
+      "github.com.parvez3019.go-swagger3.handler.aliasValidationError": {
         "type": "object",
         "properties": {
           "statusCode": {

parser/apis/parser.go

@@ -18,6 +18,7 @@ type parser struct {
 	model.Utils
 	schemaParser    schema.Parser
 	operationParser operations.Parser
+	TypeAliases     map[string]map[string]string // pkgName -> alias -> original
 }
 
 func NewParser(utils model.Utils, api *oas.OpenAPIObject, schemaParser schema.Parser) Parser {
@@ -26,6 +27,7 @@ func NewParser(utils model.Utils, api *oas.OpenAPIObject, schemaParser schema.Pa
 		OpenAPI:         api,
 		schemaParser:    schemaParser,
 		operationParser: operations.NewParser(utils, api, schemaParser),
+		TypeAliases:     make(map[string]map[string]string),
 	}
 }
 

parser/apis/type_specs.go

@@ -30,10 +30,27 @@ func (p *parser) parseTypeSpecs() error {
 			p.parseTypeSpecsFromPackage(astPackage, pkgName)
 		}
 	}
+	// After all type specifications have been parsed, resolve the type aliases
+	for pkgName, aliases := range p.TypeAliases {
+		for alias, original := range aliases {
+			if originalTypeSpec, ok := p.TypeSpecs[pkgName][original]; ok {
+				p.TypeSpecs[pkgName][alias] = originalTypeSpec
+			}
+		}
+	}
 
 	return nil
 }
 
+func (p *parser) parseTypeAlias(typeSpec *ast.TypeSpec, pkgName string) {
+	if ident, ok := typeSpec.Type.(*ast.Ident); ok {
+		if _, ok := p.TypeAliases[pkgName]; !ok {
+			p.TypeAliases[pkgName] = map[string]string{}
+		}
+		p.TypeAliases[pkgName][typeSpec.Name.String()] = ident.Name
+	}
+}
+
 func (p *parser) parseTypeSpecsFromPackage(astPackage *ast.Package, pkgName string) {
 	for _, astFile := range astPackage.Files {
 		p.parseTypeSpecsFromFile(astFile, pkgName)
@@ -54,11 +71,11 @@ func (p *parser) parseTypeSpecFromDeclaration(astDeclaration ast.Decl, pkgName s
 	}
 }
 
-// parseTypeSpecFromGenDeclaration find type declaration
 func (p *parser) parseTypeSpecFromGenDeclaration(astGenDeclaration *ast.GenDecl, pkgName string) {
 	for _, astSpec := range astGenDeclaration.Specs {
 		if typeSpec, ok := astSpec.(*ast.TypeSpec); ok {
 			p.TypeSpecs[pkgName][typeSpec.Name.String()] = typeSpec
+			p.parseTypeAlias(typeSpec, pkgName)
 		}
 	}
 }