Swiftpack.co - Package - IBM-Swift/Kitura-OpenAPI

Kitura

Docs Build Status - Master macOS Linux Apache 2 Slack Status

Kitura-OpenAPI

Kitura-OpenAPI is a library which makes it easy to add OpenAPI (aka Swagger) support to your Codable routing-based Kitura application.

By using Kitura-OpenAPI you can:

  1. Host an automatically generated OpenAPI definition of your application on a defined endpoint, for example /openapi.
  2. Host the SwaggerUI tool on a defined endpoint, for example /openapi/ui.

Getting Started

Add Kitura-OpenAPI to the dependencies within your application's Package.swift file. Substitute "x.x.x" with the latest Kitura-OpenAPI release.

.package(url: "https://github.com/IBM-Swift/Kitura-OpenAPI.git", from: "x.x.x")

Add KituraOpenAPI to your target's dependencies:

.target(name: "example", dependencies: ["KituraOpenAPI"]),

Import the package inside your application:

import KituraOpenAPI

Example

Inside your application, add a call to KituraOpenAPI.addEndpoints(to:with:) during startup, passing through the Kitura Router that you want to host the OpenAPI endpoints on. The with parameter optionally allows you to configure where the endpoints are hosted.

For example:

KituraOpenAPI.addEndpoints(to: router) // Use the default endpoints

You can then visit /openapi in a web browser to view the generated OpenAPI definition, and /openapi/ui to view SwaggerUI.

More information

Kitura-OpenAPI works by using Kitura's ability to introspect the registered Codable routes at runtime. This feature was added in Kitura 2.4. Hence, if you are not using Codable routing you unfortunately cannot take advantage of this feature. This is because only Codable routes provide the strong type information required in order to generate an OpenAPI definition at runtime.

Community

We love to talk server-side Swift and Kitura. Join our Slack to meet the team!

License

This library is licensed under Apache 2.0. Full license text is available in LICENSE.

This library includes components from Swagger-UI, which is licensed under Apache 2.0. Full license text is available in swagger-ui/LICENSE.

Github

link
Stars: 7
Help us keep the lights on

Used By

Total:

Releases

1.1.1 - Sep 4, 2018

  • Lower log level of two messages.

1.1.0 - Aug 31, 2018

  • Update swaggerui to 3.18.0 (#9)
  • Allow swaggerui to be served from custom path (#10)

1.0.3 - Jul 24, 2018

Fix SwaggerUI when deployed into cloud.

1.0.2 - Jun 8, 2018

1.0.1 - Jun 1, 2018