Principled HTTP Server Generation with Guardrail
summary
Generates server and client code from OpenAPI/Swagger specs (v2 and v3), with SBT, Maven and CLI runners that run during compile so a changed spec fails to compile if spec changes. Targets Scala/JVM/Scala.js, uses Scala Meta, circe, cats and akka-http, emits generates human-readable code into the target directory (no committed generated files). Runs in production (clients ~2 years, servers ~1.5 years, deployed in 4–5 countries).
AI-written summary · about
chapters (26)
- 0:00Introduction
- 1:00Why we started writing Guardrail
- 1:55Specification language
- 4:45Problems with Swagger
- 6:50The Code
- 7:20Human readable code
- 9:00Java
- 9:30akka
- 9:50DTO
- 10:45Target Directory
- 12:30SBT Configuration
- 14:20Scala Configuration
- 16:40Response Type
- 21:25Swagger
- 25:35Drop Wizard
- 26:15Add Parameter
- 27:55Guardrail Dev
- 30:15Nelson
- 36:30Conclusion
- 38:40Driver Trinity
- 40:00Users Handler
- 41:45Springs
- 43:40Swagger Documentation
- 45:15Generator Implementation
- 46:45Questions
- 50:20Servant Swagger
related talks
29mFull Stack Scala Web Application.
26mOpenAPI Generator - The Babel Fish of the API World
31mSCALAJS - WEB WITHOUT PAIN OF JAVASCRIPT
31mHow I learned to stop worrying and love the frontend
32mCode to contract to code: making ironclad APIs
35mAPI-First! Contract-First! Make API development great again!
37mFull Stack Scala Web Application
38mLet me write your networking code