5.4.0

• support for ReDoc extensions x-displayName and x-tagGroups #221, #219
• complete overhaul of the documentation 🥳
• upgrade schema-kenerator from 2.4.0 to 2.5.0
• upgrade Ktor from 3.2.3 to 3.3.2
• upgrade kotlin from 2.0.21 to 2.2.21

5.3.0

• fix kotlinx-serialization example encoding #212
• fix missing response bodies from documented resources routes #209
• upgrade schema-kenerator from 2.3.0 to 2.4.0
• upgrade ktor from 3.1.1 to ktor 3.2.3

5.2.0

• upgrade schema-kenerator from 2.1.3 to 2.3.0.
• fix handling of different OpenApi specs with multiple ktor modules

5.1.0

• upgrade schema-kenerator to 2.1.3
• add OpenApi extension support for route documentation (#202)
• add docExpansion property to SwaggerUI configuration controlling the default expansion setting for the operations and tags (#191)

5.0.2

• upgrade schema-kenerator to 2.1.2
• fix incorrect schema for multipart bodies

5.0.1

• upgrade schema-kenerator to 2.1.1
• fixed bug: routes requiring authorization sometimes not automatically detected as "protected" (#186)
• simplify configuration of json naming strategy with pre-built kotlinx schema generators

4.1.7

• fixed bug: routes requiring authorization sometimes not automatically detected as "protected" (#186)

5.0.0

ℹ️ This repository has been renamed from "ktor-swagger-ui" to "ktor-openapi-tools" to better reflects its content and multiple independent libraries ktor-openapi, ktor-swagger-ui and ktor-redoc

• split project into submodules: ktor-openap and ktor-swagger-ui (and ktor-redoc)

  • "ktor-openapi" plugin is responsible only for generating and providing an openapi-file
    • no longer install(SwaggerUI) but now install(OpenApi)
    • can be used without the swagger-ui dependency
  • "ktor-swagger" library to provide routes to server swagger-ui for any openapi-file (based on given url)
    • can be used with any openapi file or generator
  • this split allows for more flexibility and new features using openapi-files without swagger-ui (e.g. redoc)

• cleanup package structure, naming, configuration

  • shorter and cleaner package names
  • shorter and more uniform class names
  • slightly simpler configuration dsl
  • made all internal classes actually "internal" -> less namespace pollution

• TypesafeRouting plugin

  • improved support for TypesafeRouting plugin
  • automatically detect path and query parameters

• improved schema generation

  • added typealias GenericSchemaGenerator for schema generation function
  • create pre-defined configurable schema generators for reflection and kotlinx-serialization
  • kotlinx-serialization schema generator can be configured using the kotlinx "Json" object (also used for serializing real ktor requests and responses)
  • added pre-defined custom analysis and schema generation modules (SchemaGenerator.TypeOverwrites.XYZ) for common types
  • remove old "type overwrites" (no longer necessary due to more powerful and flexible schema generator)

• example encoding

  • renamed typealias ExampleEncoder to GenericExampleEncoder
  • moved default example encoder to ExampleEncoder.internal
  • moved kotlinxExampleEncoder to ExampleEncoder.kotlinx
  • create pre-defined configurable example encoders for internal swagger encoder and kotlinx-serialization
  • kotlinx-serialization example encoder can be configured using the kotlinx "Json" object (also used for serializing real ktor requests and responses)

• added support for ReDoc as new library

• added missing configuration options for Swagger UI

• added basic support for documenting webhooks

• upgrade schema-kenerator to 2.1.0

• upgrade ktor to 3.1.1

• overhauled documentation (https://smiley4.github.io/ktor-openapi-tools/latest/)

4.1.6

• fixed bug: schemas of headers in multipart bodies were not generated correctly and caused exceptions
• added required property to multipart parts

5.0.0-beta.2

• added support for redoc (ktor-redoc-project)