Smithy
AWS Labs has a lot of open source code up on GitHub. In this post, we’re taking a look at AWS Data Wrangler. This project provides a smoother interface between pandas DataFrames and various AWS Cloud data services.
I call out a few more details in the Twitter thread below…
this project “defines and generates clients, services, and documentation for any protocol” which is a big claim
let’s see what’s actually here…
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 2/11 ๐ Next tweet ๐ Start
the previous thread is up at https://markn.ca/2021/aws-data-wrangler/
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 3/11 ๐ Next tweet ๐ Start
ok, so this is DSL-type project. the 4 main features:
- protocol-agnostic
- codify & enforce API governance
- designed to evolve
- resource based
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 4/11 ๐ Next tweet ๐ Start
the project uses the term IDL or interface description language…so not quite a DSL
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 5/11 ๐ Next tweet ๐ Start
AWS uses Smithy to describe their services, metadata, and capabilities in a programmatic way
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 6/11 ๐ Next tweet ๐ Start
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 7/11 ๐ Next tweet ๐ Start
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 8/11 ๐ Next tweet ๐ Start
- resources
- operations
- shapes
resources & operations are straightforward but the “shape” concept deserves a closer look
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 9/11 ๐ Next tweet ๐ Start
shapes can be simple, aggregate, or a service
https://awslabs.github.io/smithy/1.0/spec/core/model.html#shapes
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 10/11 ๐ Next tweet ๐ Start
here’s a complete example from the docs: https://awslabs.github.io/smithy/quickstart.html#complete-example
๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05
Tweet 11/11 ๐ Next tweet ๐ Start
at the very least, you’ll learn a lot about IDLs from @awscloud’s experience
/๐งตโ๏ธ #cloud #devops
@marknca tweeted at 19-Nov-2021, 18:05