Describing Your World with Seahorse
summary
A small Ruby DSL defines a reusable service model that describes APIs with four parameter types, generates documentation and generates clients for Ruby Python and JavaScript, and produces Rails routes and strong-parameter filters plus automatic type coercion. Demos use a NewsFeed Rails app, the AWS Python CLI, and the Node and Ruby SDKs; AWS already has ~30 services so hand‑writing clients doesn’t scale. Seahorse is a working tech demo that wires docs tests routes and clients from one JSON/Ruby description but is not yet production‑ready.
AI-written summary · about
chapters (11)
- 0:00Start
- 8:30Describing Your World with Seahorse
- 15:00Whitelisted Attributes
- 22:05Structures
- 23:03Maps
- 23:47Scalar Types
- 24:11Type Metadata
- 36:31Enumeration and Pagination
- 38:03Strongly Typed Clients
- 38:46Configurable Retry Logic
- 39:04Where Can I get Seahorse?
related talks
23mAbstracting a Service - A Case Study in Forward Thinking with SOA
42mLightweight Web Services
27mIt Looks Like You're Writing A Service: Would You Like Help?
37mRails as an SOA Client
23mIntegrating Web Apps
30mRswag: Automated API Documentation
24mDesigning the APIs for an Internal Set of Services
35mBuilding Ambitious APIs with Ruby