Playing with tapirs Scala Vienna UserGroup

A presentation about the tapir library from softwaremill

Transcript

1. tAPIr Playing with Tapirs Michele Vigilante @_zZKato: Twitter
2. Agenda • Conventional API definitions • What is tapir • Why tapir • Inputs and Outputs • Capabilities • Live Demo - Customer Application
3. Conventional Endpoint definitions • Routes file ◦ No type safety ◦ Difficult to maintain • Spring annotations ◦ limited type safety ◦ **magic**
4. What is Tapir? • tapir -> Typed API descRiptions • created by Adam Warski from Softwaremill • define HTTP endpoints as Scala values • gain for free via interpretation ◦ [framework] Route ◦ OpenAPI documentation ◦ sttp API client
5. Supported frameworks • akka-http • finatra • http4s • playframework (Soon™) • BYOI -> bring your own interpreter
6. Why tapir • Full type safety • No magic, just simple code • framework agnostic • free server, client and docs • very “ergonomic”
7. Inputs and Outputs Endpoint[I, E, O, _] tapir Endpoint type I Inputs E Error Outputs O Outputs
8. Capabilities • Custom Types (provided Codec) • Input/Output validation • Authentication -> bearer token / basic / OAuth2 • Payload -> JSON / URL-encoded Forms / Multipart Forms etc. • Streaming
9. Live Demo
10. Q & A Thanks for your attention! • Links ◦ https://www.firstbird.com/en/ ◦ https://tapir-scala.readthedocs.io/en/latest/index.html ◦ https://github.com/softwaremill/tapir ◦ https://github.com/zZKato/tapir-live-demo-scala-usergroup