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