feat: add tag 'swaggerignore' to exclude a field from struct (#635)

* add tag 'swaggerignore' to exclude a field from struct

* update

README.md

@@ -31,7 +31,9 @@ Swag converts Go annotations to Swagger Documentation 2.0. We've created a varie
 	- [Example value of struct](#example-value-of-struct)
 	- [Description of struct](#description-of-struct)
 	- [Use swaggertype tag to supported custom type](#use-swaggertype-tag-to-supported-custom-type)
+	- [Use swaggerignore tag to exclude a field](#use-swaggerignore-tag-to-exclude-a-field)
 	- [Add extension info to struct field](#add-extension-info-to-struct-field)
+	- [Rename model to display](#rename-model-to-display)
 	- [How to using security annotations](#how-to-using-security-annotations)
 - [About the Project](#about-the-project)
 
@@ -596,6 +598,17 @@ generated swagger doc as follows:
 
 ```
 
+
+### Use swaggerignore tag to exclude a field
+
+```go
+type Account struct {
+    ID   string    `json:"id"`
+    Name string     `json:"name"`
+    Ignored int     `swaggerignore:"true"`
+}
+```
+
 ### Add extension info to struct field
 
 ```go

parser.go

@@ -1172,6 +1172,12 @@ func (parser *Parser) parseField(pkgName string, field *ast.Field) (*structField
 	}
 	// `json:"tag"` -> json:"tag"
 	structTag := reflect.StructTag(strings.Replace(field.Tag.Value, "`", "", -1))
+
+	if ignoreTag := structTag.Get("swaggerignore"); ignoreTag == "true" {
+		structField.name = ""
+		return structField, nil
+	}
+
 	jsonTag := structTag.Get("json")
 	// json:"tag,hoge"
 	if strings.Contains(jsonTag, ",") {
@@ -1184,6 +1190,7 @@ func (parser *Parser) parseField(pkgName string, field *ast.Field) (*structField
 	}
 	if jsonTag == "-" {
 		structField.name = ""
+		return structField, nil
 	} else if jsonTag != "" {
 		structField.name = jsonTag
 	}