Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Generate Swagger Spec From API #187

Open
marwan-at-work opened this issue Feb 8, 2019 · 1 comment
Open

Generate Swagger Spec From API #187

marwan-at-work opened this issue Feb 8, 2019 · 1 comment

Comments

@marwan-at-work
Copy link
Contributor

Whether the input is Go code and the output is Swagger Spec
Or whether the input is Swagger Spec and the output is Go Code

API documentation should be locked with the API implementation so that the documentation never goes stale.
@jprobinson
Copy link
Contributor

Similar to my thoughts in #186, I'm down for a spec driven approach. I've tried this a few times, but the projects always sizzled out as I've run out of time. That was all before we had openapi2proto and it's underlying tools though.

Perhaps we could make an openapi2gizmo that leans on the tools in https://godoc.org/github.com/NYTimes/openapi2proto/ to generate the boilerplates for servers and clients?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@jprobinson @marwan-at-work