hertz icon indicating copy to clipboard operation
hertz copied to clipboard

[Feature Request]auto gen swagger comment for handler

Open Rainshaw opened this issue 1 year ago • 5 comments

Is your feature request related to a problem? Please describe.

when using idl for generate code, we currently add some simple comments for each handler https://github.com/cloudwego/hertz/blob/0d8b98bc8cf61c16866359e551959e962597d33f/cmd/hz/generator/handler.go#L247-L261

but we have fully information for this endpoint, e.g. http method, serializer type, url path, request params, response params, and we have full info for request struct and response struct, like which field is used in path/query/body. So we can add a flag for hz to control generating swagger style comment for each method.

previous relates issues #28, #538, #558, #692

Describe the solution you'd like

In HttpMethod.InitComment, generate swagger style comment for using https://github.com/hertz-contrib/swagger

Describe alternatives you've considered

maybe we could provider a template like layout and package for the swagger comments.

Additional context

Add any other context or screenshots about the feature request here.

Rainshaw avatar May 06 '23 08:05 Rainshaw