apple / swift-openapi-runtime

API package for code generated by Swift OpenAPI Generator.

Swift OpenAPI Generator Runtime

This library provides common abstractions and helper functions used by the client and server code generated by Swift OpenAPI Generator.

Overview

It contains:

• Common types used in the code generated by the swift-openapi-generator package plugin.
• Protocol definitions for pluggable layers, including ClientTransport, ServerTransport, ClientMiddleware, and ServerMiddleware.

Many of the HTTP currency types used are defined in the Swift HTTP Types library.

Tip: Check out the example projects focused on middlewares.

Usage

Add the package dependency in your Package.swift:

.package(url: "https://github.com/apple/swift-openapi-runtime", from: "1.0.0"),

Next, in your target, add OpenAPIRuntime to your dependencies:

.target(name: "MyTarget", dependencies: [
    .product(name: "OpenAPIRuntime", package: "swift-openapi-runtime"),
]),

The next step depends on your use case.

Using Swift OpenAPI Generator for code generation

The generated code depends on types from this library. Check out the adoption guides in the Swift OpenAPI Generator documentation to see how the packages fit together.

Implementing transports and middlewares

Swift OpenAPI Generator generates client and server code that is designed to be used with pluggable transports and middlewares.

Implement a new transport or middleware by providing a type that adopts one of the protocols from the runtime library:

• ClientTransport
• ClientMiddleware
• ServerTransport
• ServerMiddleware

You can also publish your transport or middleware as a Swift package to allow others to use it with their generated code.

Documentation

To learn more, check out the full documentation.

swift-openapi-runtime's Issues

Make RuntimeError public

This error is thrown by the .ok getter but the only way to inspect it is via .localizedDescription or by casting it into CustomStringConvertible and checking errorDescription.

It would be nice if it was public so more details in the response can be extracted.

swift-openapi-runtime/Sources/OpenAPIRuntime/Errors/RuntimeError.swift

Line 18 in 76951d7

internal enum RuntimeError: Error, CustomStringConvertible, LocalizedError, PrettyStringConvertible {