Swift OpenAPI Generator 1.0 Released

OpenAPI is an open standard for describing the behavior of HTTP services with a rich ecosystem of tooling. One thing OpenAPI is particularly known for is tooling to generate interactive documentation. But the core motivation of OpenAPI is code-generation, which allows adopters to use an API-first approach to server development and, because many existing services document their API in this format, allows client developers to generate type-safe, idiomatic code to call these APIs.

→ swift.org/blog/swift-openapi-generator-1.0/

The Swift OpenAPI Generator has reached its stable 1.0 release, enabling type-safe code generation for HTTP client and server operations from OpenAPI 3.0 and 3.1 documents.

It automates repetitive API tasks, supports streaming with AsyncSequence, and handles various content types like JSON and multipart, integrating flexibly with HTTP libraries via transport implementations. The generated Client struct simplifies API calls, while the APIProtocol and registerHandlers function streamline server implementation, as shown with a GreetingService example using URLSession and Vapor.

The project, built on multiple repositories for extensibility, has seen over 250 pull requests from 20+ contributors, enhancing its API and ecosystem support for frameworks like AsyncHTTPClient and Hummingbird.