Idiomatic Client

[karitham]

The current client code generation is a bit un-idiomatic and pretty painful to use.

We want to make one that is closer to idiomatic go, and that would actually make it simpler and nicer to consume the API.

This issue is here for the sake of tracking progress on the client, as to say:

• Define the API interface
• Write the code
• Make it nice
  • Non 2XX responses should return a proper error

References

Code generators

https://github.com/deepmap/oapi-codegen
https://github.com/openapitools/openapi-generator

Example client

https://github.com/google/go-github