6 ms·

Can anyone point to an example of an OpenAPI generated SDK which they like? There are strong advantages for maintainers to generate from an OpenAPI spec, but I

Can anyone point to an example of an OpenAPI generated SDK which they like? There are strong advantages for maintainers to generate from an OpenAPI spec, but I get the feeling consumers (devs, implementers) don’t like them as much. But that may be dependent on the language, or entirely false. Mostly based on anecdotal feedback, and primarily from those who were happy with an existing SDK and, understandably, didn’t want to change. I’d be keen to hear what HN users think.

scrollaway 5y ago
I'm not sure if it's OpenAPI generated but the AWS python sdk (boto3 bindings) is clearly generated in some way. I quite like it, because it's highly consistent so i always know what to expect. Unfortunately it's not typed either.
- shadycuz 5y ago
  You can get third party library stubs which will add typing. If you use boto alot I highly recommend it.
cloudify 5y ago
As part of a big project I've worked on, we created a tool to generate Typescript types + runtime validation + SDK (client) from an openapi definition. The tool as been used quite extensively to help in the integration of many services and APIs. https://github.com/pagopa/openapi-codegen-ts https://github.com/pagopa/openapi-codegen-ts
nhoughto 5y ago
Yeah takes a lot to make a generated sdk good, lots of bad examples, few good ones. AWS SDKs must be generated and they are mostly good but some of them like S3 are so heavily used they could have teams writing them no probs. GCPs are (or were?) super verbose which is a GRPC generation artifact, same as openapi.
bastawhiz 5y ago
Stripe uses OpenAPI for some of its SDK generation.
- adeelali 5y ago
  I see Stripe and Plaid SDKs being discussed. Has anyone tried out Square's SDKs: https://developer.squareup.com/docs/sdks#square-api-sdks https://developer.squareup.com/docs/sdks#square-api-sdks? Keen to know some thoughts on the code quality.
BerislavLopac 5y ago
Shameless plug: https://pyotr.readthedocs.io/ https://pyotr.readthedocs.io/

scrollaway 5y ago

I'm not sure if it's OpenAPI generated but the AWS python sdk (boto3 bindings) is clearly generated in some way. I quite like it, because it's highly consistent so i always know what to expect. Unfortunately it's not typed either.

shadycuz 5y ago
You can get third party library stubs which will add typing. If you use boto alot I highly recommend it.

cloudify 5y ago

As part of a big project I've worked on, we created a tool to generate Typescript types + runtime validation + SDK (client) from an openapi definition. The tool as been used quite extensively to help in the integration of many services and APIs. https://github.com/pagopa/openapi-codegen-ts https://github.com/pagopa/openapi-codegen-ts

nhoughto 5y ago

Yeah takes a lot to make a generated sdk good, lots of bad examples, few good ones. AWS SDKs must be generated and they are mostly good but some of them like S3 are so heavily used they could have teams writing them no probs. GCPs are (or were?) super verbose which is a GRPC generation artifact, same as openapi.

bastawhiz 5y ago

Stripe uses OpenAPI for some of its SDK generation.

adeelali 5y ago
I see Stripe and Plaid SDKs being discussed. Has anyone tried out Square's SDKs: https://developer.squareup.com/docs/sdks#square-api-sdks https://developer.squareup.com/docs/sdks#square-api-sdks? Keen to know some thoughts on the code quality.

BerislavLopac 5y ago

Shameless plug: https://pyotr.readthedocs.io/ https://pyotr.readthedocs.io/