Dynamically generate "examples"

[manuelarte]

Hi,

Imagine that we have the following Error response when there is an error in our application

type ErrorResponse struct {
  Errors []string `json:"errors" example:"['Invalid headers']"`
  Message string `json:"message" example:"['Bad Request']"`
}

When I generate the documentation with swag, I get a "proper" example in swagger.

But now I want to reuse that ErrorResponse for different error scenarios, and I want to use a different "example"

type ErrorResponse struct {
  Errors []string `json:"errors" example:"['TCP connection failed']"`
  Message string `json:"message" example:"['Internal Server Error']"`
}

But I can't have different "examples" for the same Go struct. What I am doing right now, it's to create different structs to cover the different examples that I want to show.

So, something like this:

type ErrorResponse400Example struct {
  Errors []string `json:"errors" example:"['Invalid headers']"`
  Message string `json:"message" example:"['Bad Request']"`
}
type ErrorResponse500Example struct {
  Errors []string `json:"errors" example:"['TCP connection failed']"`
  Message string `json:"message" example:"['Internal Server Error']"`
}
...
// @Failure 400 {object} common.ErrorResponse400Example "Bad Request"
// @Failure 500 {object} common.ErrorResponse500Example "Internal Server Error, please try again later"
func (c *Controller) Update(c *gin.Context) {
...
}

But, is it possible to do it in a different way? Is it possible to dynamically generate the examples in any way?