Schema for Juju RPC messages
Mark Shuttleworth
mark at ubuntu.com
Wed Jul 27 18:48:27 UTC 2016
On 27/07/16 19:43, Reed O'Brien wrote:
> +1
>
> On Wed, Jul 27, 2016 at 9:52 AM, Katherine Cox-Buday
> <katherine.cox-buday at canonical.com
> <mailto:katherine.cox-buday at canonical.com>> wrote:
>
>
> I am a huge fan of publishing schema's and then generating SDKs
> and documentation websites off of them. It brings your API closer
> to language agnostic, removes the burden on us having to
> hand-craft both our API client and our documentation site, and
> makes validation implicit. I'm not up on what the best tools for
> doing this are, but Swagger[1] seems to be popular.
>
Schemas are excellent for test suites and tool validation, but
auto-generated bindings are *always* uuuuugly. Please don't make that
plan A for any language you care about. From a house perspective, Go, JS
and Python need designed and human-curated bindings that are idiomatic
for coders who love those languages.
Mark
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/juju-dev/attachments/20160727/3b5fe1cd/attachment.html>
More information about the Juju-dev
mailing list