breaking change: V3 alpha (#256)

2022-08-13 09:59:59 -07:00
parent 48969a8fcc
commit c73c9b4605
308 changed files with 5410 additions and 10204 deletions
--- a/core/Module.md
+++ b/core/Module.md
@ -0,0 +1,108 @@
+# Module kompendium-core
+
+This is where the magic happens. This module houses all the reflective goodness that powers Kompendium.
+
+It is also the only mandatory client-facing module for a basic setup.
+
+# Package io.bkbn.kompendium.core
+
+The root package contains several objects that power Kompendium, including the Kompendium Ktor Plugin, route
+notarization methods, and the reflection engine that analyzes method info type parameters.
+
+## Plugin
+
+The Kompendium plugin is an extremely light-weight plugin, with only a couple areas of customization.
+
+### Serialization
+
+Kompendium relies on your API to provide a properly-configured `ContentNegotiator` in order to convert the `OpenApiSpec`
+into JSON. The advantage to this approach is that all of your data classes will be serialized precisely how you define.
+The downside is that issues could exist in serialization frameworks that have not been tested. At the moment, Jackson,
+Gson and KotlinX serialization have all been tested. If you run into any serialization issues, particularly with a
+serializer not listed above, please open an issue on GitHub 🙏
+
+Note for Kotlinx ⚠️
+
+You will need to include the `SerializersModule` provided in `KompendiumSerializersModule` in order to serialize 
+any provided defaults.  This comes down to how Kotlinx expects users to handle serializing `Any`.  Essentially, this 
+serializer module will convert any `Any` serialization to be `Contextual`.  This is pretty hacky, but seemed to be the
+only way to get Kotlinx to play nice with serializing `Any`.  If you come up with a better solution, definitely go ahead
+and open up a PR!
+
+## Notarization
+
+Central to Kompendium is the concept of notarization.
+
+Notarizing a route is the mechanism by which Kompendium analyzes your route types, along with provided metadata, and
+converts to the expected OpenAPI format.
+
+Before jumping into notarization, lets first look at a standard Ktor route
+
+```kotlin
+routing {
+  get {
+    call.respond(HttpStatusCode.OK, BasicResponse(c = UUID.randomUUID().toString()))
+  }
+}
+```
+
+Now, let's compare this to the same functionality, but notarized using Kompendium
+
+```kotlin
+routing {
+  notarizedGet(simpleGetExample) {
+    call.respond(HttpStatusCode.OK, BasicResponse(c = UUID.randomUUID().toString()))
+  }
+}
+```
+
+Pretty simple huh. But hold on... what is this `simpleGetExample`? How can I know that it is so "simple". Let's take a
+look
+
+```kotlin
+val simpleGetExample = GetInfo<Unit, BasicResponse>(
+  summary = "Simple, Documented GET Request",
+  description = "This is to showcase just how easy it is to document your Ktor API!",
+  responseInfo = ResponseInfo(
+    status = HttpStatusCode.OK,
+    description = "This means everything went as expected!",
+    examples = mapOf("demo" to BasicResponse(c = "52c099d7-8642-46cc-b34e-22f39b923cf4"))
+  ),
+  tags = setOf("Simple")
+)
+```
+
+See, not so bad 😄 `GetInfo<*,*>` is an implementation of `MethodInfo<TParam, TResp>`, a sealed interface designed to
+encapsulate all the metadata required for documenting an API route. Kompendium leverages this data, along with the
+provided type parameters `TParam` and `TResp` to construct the full OpenAPI Specification for your route.
+
+Additionally, just as a backup, each notarization method includes a "post-processing' hook that will allow you to have
+final say in the generated route info prior to being attached to the spec. This can be accessed via the optional
+parameter
+
+```kotlin
+routing {
+  notarizedGet(simpleGetExample, postProcess = { spec -> spec }) {
+    call.respond(HttpStatusCode.OK, BasicResponse(c = UUID.randomUUID().toString()))
+  }
+}
+```
+
+This should only be used in _extremely_ rare scenarios, but it is nice to know it is there if you need it.
+
+# Package io.bkbn.kompendium.core.metadata
+
+Houses all interfaces and types related to describing route metadata.
+
+# Package io.bkbn.kompendium.core.parser
+
+Responsible for the parse of method information. Base implementation is an interface to support extensibility as shown
+in the `kompendium-locations` module.
+
+# Package io.bkbn.kompendium.core.routes
+
+Houses any routes provided by the core module.  At the moment the only supported route is to enable ReDoc support.
+
+# Package io.bkbn.kompendium.core.util
+
+Collection of utility functions used by Kompendium
--- a/core/build.gradle.kts
+++ b/core/build.gradle.kts
@ -0,0 +1,62 @@
+plugins {
+  kotlin("jvm")
+  kotlin("plugin.serialization")
+  id("io.bkbn.sourdough.library.jvm")
+  id("io.gitlab.arturbosch.detekt")
+  id("com.adarshr.test-logger")
+  id("org.jetbrains.dokka")
+  id("maven-publish")
+  id("java-library")
+  id("signing")
+  id("java-test-fixtures")
+}
+
+sourdoughLibrary {
+  libraryName.set("Kompendium Core")
+  libraryDescription.set("Core functionality for the Kompendium library")
+  compilerArgs.set(listOf("-opt-in=kotlin.RequiresOptIn"))
+}
+
+dependencies {
+  // VERSIONS
+  val kotestVersion: String by project
+  val ktorVersion: String by project
+
+  // IMPLEMENTATION
+
+  api(projects.kompendiumOas)
+  api(projects.kompendiumJsonSchema)
+
+  implementation("io.ktor:ktor-server-core:$ktorVersion")
+  implementation("io.ktor:ktor-server-cio:$ktorVersion")
+  implementation("io.ktor:ktor-server-html-builder:$ktorVersion")
+  implementation("io.ktor:ktor-server-content-negotiation:$ktorVersion")
+  implementation("io.ktor:ktor-serialization-kotlinx-json:$ktorVersion")
+  implementation("ch.qos.logback:logback-classic:1.2.11")
+
+  // TEST FIXTURES
+
+  testFixturesApi("io.kotest:kotest-runner-junit5-jvm:$kotestVersion")
+  testFixturesApi("io.kotest:kotest-assertions-core-jvm:$kotestVersion")
+  testFixturesApi("io.kotest:kotest-property-jvm:$kotestVersion")
+  testFixturesApi("io.kotest:kotest-assertions-json-jvm:$kotestVersion")
+  testFixturesApi("io.kotest:kotest-assertions-ktor-jvm:4.4.3")
+
+  testFixturesApi("io.ktor:ktor-server-core:$ktorVersion")
+  testFixturesApi("io.ktor:ktor-server-test-host:$ktorVersion")
+  testFixturesApi("io.ktor:ktor-serialization:$ktorVersion")
+  testFixturesApi("io.ktor:ktor-serialization-jackson:$ktorVersion")
+  testFixturesApi("io.ktor:ktor-serialization-gson:$ktorVersion")
+  testFixturesApi("io.ktor:ktor-serialization-kotlinx-json:$ktorVersion")
+  testFixturesApi("io.ktor:ktor-server-content-negotiation:$ktorVersion")
+
+  testFixturesApi("org.jetbrains.kotlinx:kotlinx-serialization-json:1.3.3")
+}
+
+testing {
+  suites {
+    named("test", JvmTestSuite::class) {
+      useJUnitJupiter()
+    }
+  }
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/attribute/KompendiumAttributes.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/attribute/KompendiumAttributes.kt
@ -0,0 +1,8 @@
+package io.bkbn.kompendium.core.attribute
+
+import io.bkbn.kompendium.oas.OpenApiSpec
+import io.ktor.util.AttributeKey
+
+object KompendiumAttributes {
+  val openApiSpec = AttributeKey<OpenApiSpec>("OpenApiSpec")
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/DeleteInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/DeleteInfo.kt
@ -0,0 +1,40 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class DeleteInfo private constructor(
+  override val response: ResponseInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfo {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): DeleteInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfo.Builder<DeleteInfo>() {
+    override fun build() = DeleteInfo(
+      response = response!!,
+      errors = errors,
+      tags = tags,
+      summary = summary!!,
+      description = description!!,
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/GetInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/GetInfo.kt
@ -0,0 +1,40 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class GetInfo private constructor(
+  override val response: ResponseInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfo {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): GetInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfo.Builder<GetInfo>() {
+    override fun build() = GetInfo(
+      response = response ?: error("You must provide a response in order to notarize a GET"),
+      errors = errors,
+      tags = tags,
+      summary = summary ?: error("You must provide a summary in order to notarize a GET"),
+      description = description ?: error("You must provide a description in order to notarize a GET"),
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/HeadInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/HeadInfo.kt
@ -0,0 +1,40 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class HeadInfo private constructor(
+  override val response: ResponseInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfo {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): HeadInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfo.Builder<HeadInfo>() {
+    override fun build() = HeadInfo(
+      response = response!!,
+      errors = errors,
+      tags = tags,
+      summary = summary!!,
+      description = description!!,
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/MethodInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/MethodInfo.kt
@ -0,0 +1,64 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+sealed interface MethodInfo {
+  val response: ResponseInfo
+  val errors: List<ResponseInfo>
+  val tags: Set<String>
+  val summary: String
+  val description: String
+  val externalDocumentation: ExternalDocumentation?
+    get() = null
+  val operationId: String?
+    get() = null
+  val deprecated: Boolean
+    get() = false
+  val parameters: List<Parameter>
+    get() = emptyList()
+
+  abstract class Builder<T : MethodInfo> {
+    internal var response: ResponseInfo? = null
+    internal var summary: String? = null
+    internal var description: String? = null
+    internal var externalDocumentation: ExternalDocumentation? = null
+    internal var operationId: String? = null
+    internal var deprecated: Boolean = false
+    internal var tags: Set<String> = emptySet()
+    internal var parameters: List<Parameter> = emptyList()
+    internal var errors: MutableList<ResponseInfo> = mutableListOf()
+
+    fun response(init: ResponseInfo.Builder.() -> Unit) = apply {
+      val builder = ResponseInfo.Builder()
+      builder.init()
+      this.response = builder.build()
+    }
+
+    fun canRespond(init: ResponseInfo.Builder.() -> Unit) = apply {
+      val builder = ResponseInfo.Builder()
+      builder.init()
+      errors.add(builder.build())
+    }
+
+    fun canRespond(responses: List<ResponseInfo>) = apply {
+      errors.addAll(responses)
+    }
+
+    fun summary(s: String) = apply { this.summary = s }
+
+    fun description(s: String) = apply { this.description = s }
+
+    fun externalDocumentation(docs: ExternalDocumentation) = apply { this.externalDocumentation = docs }
+
+    fun operationId(id: String) = apply { this.operationId = id }
+
+    fun isDeprecated() = apply { this.deprecated = true }
+
+    fun tags(vararg tags: String) = apply { this.tags = tags.toSet() }
+
+    fun parameters(vararg parameters: Parameter) = apply { this.parameters = parameters.toList() }
+
+    abstract fun build(): T
+  }
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/MethodInfoWithRequest.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/MethodInfoWithRequest.kt
@ -0,0 +1,15 @@
+package io.bkbn.kompendium.core.metadata
+
+sealed interface MethodInfoWithRequest : MethodInfo {
+  val request: RequestInfo
+
+  abstract class Builder<T: MethodInfoWithRequest> : MethodInfo.Builder<T>() {
+    internal var request: RequestInfo? = null
+
+    fun request(init: RequestInfo.Builder.() -> Unit) = apply {
+      val builder = RequestInfo.Builder()
+      builder.init()
+      this.request = builder.build()
+    }
+  }
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/OptionsInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/OptionsInfo.kt
@ -0,0 +1,40 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class OptionsInfo private constructor(
+  override val response: ResponseInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfo {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): OptionsInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfo.Builder<OptionsInfo>() {
+    override fun build() = OptionsInfo(
+      response = response!!,
+      errors = errors,
+      tags = tags,
+      summary = summary!!,
+      description = description!!,
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/PatchInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/PatchInfo.kt
@ -0,0 +1,42 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class PatchInfo private constructor(
+  override val request: RequestInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val response: ResponseInfo,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfoWithRequest {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): PatchInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfoWithRequest.Builder<PatchInfo>() {
+    override fun build() = PatchInfo(
+      request = request!!,
+      errors = errors,
+      response = response!!,
+      tags = tags,
+      summary = summary!!,
+      description = description!!,
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/PostInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/PostInfo.kt
@ -0,0 +1,42 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class PostInfo private constructor(
+  override val request: RequestInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val response: ResponseInfo,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfoWithRequest {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): PostInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfoWithRequest.Builder<PostInfo>() {
+    override fun build() = PostInfo(
+      request = request!!,
+      errors = errors,
+      response = response!!,
+      tags = tags,
+      summary = summary!!,
+      description = description!!,
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/PutInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/PutInfo.kt
@ -0,0 +1,42 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.common.ExternalDocumentation
+import io.bkbn.kompendium.oas.payload.Parameter
+
+class PutInfo private constructor(
+  override val request: RequestInfo,
+  override val errors: MutableList<ResponseInfo>,
+  override val response: ResponseInfo,
+  override val tags: Set<String>,
+  override val summary: String,
+  override val description: String,
+  override val externalDocumentation: ExternalDocumentation?,
+  override val operationId: String?,
+  override val deprecated: Boolean,
+  override val parameters: List<Parameter>
+): MethodInfoWithRequest {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): PutInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder : MethodInfoWithRequest.Builder<PutInfo>() {
+    override fun build() = PutInfo(
+      request = request!!,
+      errors = errors,
+      response = response!!,
+      tags = tags,
+      summary = summary!!,
+      description = description!!,
+      externalDocumentation = externalDocumentation,
+      operationId = operationId,
+      deprecated = deprecated,
+      parameters = parameters
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/RequestInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/RequestInfo.kt
@ -0,0 +1,46 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.payload.MediaType
+import kotlin.reflect.KType
+import kotlin.reflect.typeOf
+
+class RequestInfo private constructor(
+  val requestType: KType,
+  val description: String,
+  val examples: Map<String, MediaType.Example>?
+) {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): RequestInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder {
+    private var requestType: KType? = null
+    private var description: String? = null
+    private var examples: Map<String, MediaType.Example>? = null
+
+    fun requestType(t: KType) = apply {
+      this.requestType = t
+    }
+
+    inline fun <reified T> requestType() = apply { requestType(typeOf<T>()) }
+
+    fun description(s: String) = apply { this.description = s }
+
+    fun examples(vararg e: Pair<String, Any>) = apply {
+      this.examples = e.toMap().mapValues { (_, v) -> MediaType.Example(v) }
+      println(this.examples)
+    }
+
+    fun build() = RequestInfo(
+      requestType = requestType!!,
+      description = description!!,
+      examples = examples
+    )
+  }
+
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/ResponseInfo.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/metadata/ResponseInfo.kt
@ -0,0 +1,53 @@
+package io.bkbn.kompendium.core.metadata
+
+import io.bkbn.kompendium.oas.payload.MediaType
+import io.ktor.http.HttpStatusCode
+import kotlin.reflect.KType
+import kotlin.reflect.typeOf
+
+class ResponseInfo private constructor(
+  val responseCode: HttpStatusCode,
+  val responseType: KType,
+  val description: String,
+  val examples: Map<String, MediaType.Example>?
+) {
+
+  companion object {
+    fun builder(init: Builder.() -> Unit): ResponseInfo {
+      val builder = Builder()
+      builder.init()
+      return builder.build()
+    }
+  }
+
+  class Builder {
+    private var responseCode: HttpStatusCode? = null
+    private var responseType: KType? = null
+    private var description: String? = null
+    private var examples: Map<String, MediaType.Example>? = null
+
+    fun responseCode(code: HttpStatusCode) = apply {
+      this.responseCode = code
+    }
+
+    fun responseType(t: KType) = apply {
+      this.responseType = t
+    }
+
+    inline fun <reified T> responseType() = apply { responseType(typeOf<T>()) }
+
+    fun description(s: String) = apply { this.description = s }
+
+    fun examples(vararg e: Pair<String, Any>) = apply {
+      this.examples = e.toMap().mapValues { (_, v) -> MediaType.Example(v) }
+      println(this.examples)
+    }
+
+    fun build() = ResponseInfo(
+      responseCode = responseCode ?: error("You must provide a response code in order to build a Response!"),
+      responseType = responseType ?: error("You must provide a response type in order to build a Response!"),
+      description = description ?: error("You must provide a description in order to build a Response!"),
+      examples = examples
+    )
+  }
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/plugin/NotarizedApplication.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/plugin/NotarizedApplication.kt
@ -0,0 +1,45 @@
+package io.bkbn.kompendium.core.plugin
+
+import io.bkbn.kompendium.core.attribute.KompendiumAttributes
+import io.bkbn.kompendium.json.schema.definition.JsonSchema
+import io.bkbn.kompendium.json.schema.util.Helpers.getSimpleSlug
+import io.bkbn.kompendium.oas.OpenApiSpec
+import io.ktor.http.HttpStatusCode
+import io.ktor.server.application.call
+import io.ktor.server.application.createApplicationPlugin
+import io.ktor.server.response.respond
+import io.ktor.server.routing.Routing
+import io.ktor.server.routing.application
+import io.ktor.server.routing.get
+import io.ktor.server.routing.route
+import io.ktor.server.routing.routing
+import kotlin.reflect.KClass
+import kotlin.reflect.KType
+
+object NotarizedApplication {
+
+  class Config {
+    lateinit var spec: OpenApiSpec
+    var openApiJson: Routing.() -> Unit = {
+      route("/openapi.json") {
+        get {
+          call.respond(HttpStatusCode.OK, this@route.application.attributes[KompendiumAttributes.openApiSpec])
+        }
+      }
+    }
+    var customTypes: Map<KType, JsonSchema> = emptyMap()
+  }
+
+  operator fun invoke() = createApplicationPlugin(
+    name = "NotarizedApplication",
+    createConfiguration = ::Config
+  ) {
+    val spec = pluginConfig.spec
+    val routing = application.routing { }
+    pluginConfig.openApiJson(routing)
+    pluginConfig.customTypes.forEach { (type, schema) ->
+      spec.components.schemas[type.getSimpleSlug()] = schema
+    }
+    application.attributes.put(KompendiumAttributes.openApiSpec, spec)
+  }
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/plugin/NotarizedRoute.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/plugin/NotarizedRoute.kt
@ -0,0 +1,171 @@
+package io.bkbn.kompendium.core.plugin
+
+import io.bkbn.kompendium.core.attribute.KompendiumAttributes
+import io.bkbn.kompendium.core.metadata.DeleteInfo
+import io.bkbn.kompendium.core.metadata.GetInfo
+import io.bkbn.kompendium.core.metadata.HeadInfo
+import io.bkbn.kompendium.core.metadata.MethodInfo
+import io.bkbn.kompendium.core.metadata.MethodInfoWithRequest
+import io.bkbn.kompendium.core.metadata.OptionsInfo
+import io.bkbn.kompendium.core.metadata.PatchInfo
+import io.bkbn.kompendium.core.metadata.PostInfo
+import io.bkbn.kompendium.core.metadata.PutInfo
+import io.bkbn.kompendium.core.metadata.ResponseInfo
+import io.bkbn.kompendium.core.util.Helpers.getReferenceSlug
+import io.bkbn.kompendium.core.util.Helpers.getSimpleSlug
+import io.bkbn.kompendium.json.schema.SchemaGenerator
+import io.bkbn.kompendium.json.schema.definition.ReferenceDefinition
+import io.bkbn.kompendium.oas.OpenApiSpec
+import io.bkbn.kompendium.oas.path.Path
+import io.bkbn.kompendium.oas.path.PathOperation
+import io.bkbn.kompendium.oas.payload.MediaType
+import io.bkbn.kompendium.oas.payload.Parameter
+import io.bkbn.kompendium.oas.payload.Request
+import io.bkbn.kompendium.oas.payload.Response
+import io.ktor.server.application.ApplicationCallPipeline
+import io.ktor.server.application.Hook
+import io.ktor.server.application.createRouteScopedPlugin
+import io.ktor.server.routing.Route
+import kotlin.reflect.KClass
+import kotlin.reflect.KType
+
+object NotarizedRoute {
+
+  class Config {
+    var tags: Set<String> = emptySet()
+    var parameters: List<Parameter> = emptyList()
+    var get: GetInfo? = null
+    var post: PostInfo? = null
+    var put: PutInfo? = null
+    var delete: DeleteInfo? = null
+    var patch: PatchInfo? = null
+    var head: HeadInfo? = null
+    var options: OptionsInfo? = null
+    var security: Map<String, List<String>>? = null
+    internal var path: Path? = null
+  }
+
+  private object InstallHook : Hook<(ApplicationCallPipeline) -> Unit> {
+    override fun install(pipeline: ApplicationCallPipeline, handler: (ApplicationCallPipeline) -> Unit) {
+      handler(pipeline)
+    }
+  }
+
+  operator fun invoke() = createRouteScopedPlugin(
+    name = "NotarizedRoute",
+    createConfiguration = ::Config
+  ) {
+
+    // This is required in order to introspect the route path
+    on(InstallHook) {
+      val route = it as? Route ?: return@on
+      val spec = application.attributes[KompendiumAttributes.openApiSpec]
+      val routePath = route.calculateRoutePath()
+      require(spec.paths[routePath] == null) {
+        """
+        The specified path ${Parameter.Location.path} has already been documented!
+        Please make sure that all notarized paths are unique
+      """.trimIndent()
+      }
+      spec.paths[routePath] = pluginConfig.path!!
+    }
+
+    val spec = application.attributes[KompendiumAttributes.openApiSpec]
+
+    val path = Path()
+    path.parameters = pluginConfig.parameters
+
+    pluginConfig.get?.addToSpec(path, spec, pluginConfig)
+    pluginConfig.delete?.addToSpec(path, spec, pluginConfig)
+    pluginConfig.head?.addToSpec(path, spec, pluginConfig)
+    pluginConfig.options?.addToSpec(path, spec, pluginConfig)
+    pluginConfig.post?.addToSpec(path, spec, pluginConfig)
+    pluginConfig.put?.addToSpec(path, spec, pluginConfig)
+    pluginConfig.patch?.addToSpec(path, spec, pluginConfig)
+
+    pluginConfig.path = path
+  }
+
+  private fun MethodInfo.addToSpec(path: Path, spec: OpenApiSpec, config: Config) {
+    SchemaGenerator.fromTypeOrUnit(this.response.responseType, spec.components.schemas)?.let { schema ->
+      spec.components.schemas[this.response.responseType.getSimpleSlug()] = schema
+    }
+
+    errors.forEach { error ->
+      SchemaGenerator.fromTypeOrUnit(error.responseType, spec.components.schemas)?.let { schema ->
+        spec.components.schemas[error.responseType.getSimpleSlug()] = schema
+      }
+    }
+
+    when (this) {
+      is MethodInfoWithRequest -> {
+        SchemaGenerator.fromTypeOrUnit(this.request.requestType, spec.components.schemas)?.let { schema ->
+          spec.components.schemas[this.request.requestType.getSimpleSlug()] = schema
+        }
+      }
+
+      else -> {}
+    }
+
+    val operations = this.toPathOperation(config)
+
+    when (this) {
+      is DeleteInfo -> path.delete = operations
+      is GetInfo -> path.get = operations
+      is HeadInfo -> path.head = operations
+      is PatchInfo -> path.patch = operations
+      is PostInfo -> path.post = operations
+      is PutInfo -> path.put = operations
+      is OptionsInfo -> path.options = operations
+    }
+  }
+
+  private fun MethodInfo.toPathOperation(config: Config) = PathOperation(
+    tags = config.tags.plus(this.tags),
+    summary = this.summary,
+    description = this.description,
+    externalDocs = this.externalDocumentation,
+    operationId = this.operationId,
+    deprecated = this.deprecated,
+    parameters = this.parameters,
+    security = config.security
+      ?.map { (k, v) -> k to v }
+      ?.map { listOf(it).toMap() }
+      ?.toList(),
+    requestBody = when (this) {
+      is MethodInfoWithRequest -> Request(
+        description = this.request.description,
+        content = this.request.requestType.toReferenceContent(this.request.examples),
+        required = true
+      )
+
+      else -> null
+    },
+    responses = mapOf(
+      this.response.responseCode.value to Response(
+        description = this.response.description,
+        content = this.response.responseType.toReferenceContent(this.response.examples)
+      )
+    ).plus(this.errors.toResponseMap())
+  )
+
+  private fun List<ResponseInfo>.toResponseMap(): Map<Int, Response> = associate { error ->
+    error.responseCode.value to Response(
+      description = error.description,
+      content = error.responseType.toReferenceContent(error.examples)
+    )
+  }
+
+  private fun KType.toReferenceContent(examples: Map<String, MediaType.Example>?): Map<String, MediaType>? =
+    when (this.classifier as KClass<*>) {
+      Unit::class -> null
+      else -> mapOf(
+        "application/json" to MediaType(
+          schema = ReferenceDefinition(this.getReferenceSlug()),
+          examples = examples
+        )
+      )
+    }
+
+  private fun Route.calculateRoutePath() = toString().replace(Regex("/\\(.+\\)"), "")
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/routes/Redoc.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/routes/Redoc.kt
@ -0,0 +1,57 @@
+package io.bkbn.kompendium.core.routes
+
+import io.ktor.http.HttpStatusCode
+import io.ktor.server.application.call
+import io.ktor.server.html.respondHtml
+import io.ktor.server.routing.Routing
+import io.ktor.server.routing.get
+import io.ktor.server.routing.route
+import kotlinx.html.body
+import kotlinx.html.head
+import kotlinx.html.link
+import kotlinx.html.meta
+import kotlinx.html.script
+import kotlinx.html.style
+import kotlinx.html.title
+import kotlinx.html.unsafe
+
+/**
+ * Provides an out-of-the-box route to view docs using ReDoc
+ * @param pageTitle Webpage title you wish to be displayed on your docs
+ * @param specUrl url to point ReDoc to the OpenAPI json document
+ */
+fun Routing.redoc(pageTitle: String = "Docs", specUrl: String = "/openapi.json") {
+  route("/docs") {
+    get {
+      call.respondHtml(HttpStatusCode.OK) {
+        head {
+          title {
+            +pageTitle
+          }
+          meta {
+            charset = "utf-8"
+          }
+          meta {
+            name = "viewport"
+            content = "width=device-width, initial-scale=1"
+          }
+          link {
+            href = "https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700"
+            rel = "stylesheet"
+          }
+          style {
+            unsafe {
+              raw("body { margin: 0; padding: 0; }")
+            }
+          }
+        }
+        body {
+          unsafe { +"<redoc spec-url='${specUrl}'></redoc>" }
+          script {
+            src = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"
+          }
+        }
+      }
+    }
+  }
+}
--- a/core/src/main/kotlin/io/bkbn/kompendium/core/util/Helpers.kt
+++ b/core/src/main/kotlin/io/bkbn/kompendium/core/util/Helpers.kt
@ -0,0 +1,35 @@
+package io.bkbn.kompendium.core.util
+
+import kotlin.reflect.KClass
+import kotlin.reflect.KProperty
+import kotlin.reflect.KType
+import kotlin.reflect.full.createType
+import kotlin.reflect.jvm.javaField
+import org.slf4j.LoggerFactory
+import java.lang.reflect.ParameterizedType
+import java.util.Locale
+
+object Helpers {
+
+  private const val COMPONENT_SLUG = "#/components/schemas"
+
+  fun KType.getSimpleSlug(): String = when {
+    this.arguments.isNotEmpty() -> genericNameAdapter(this, classifier as KClass<*>)
+    else -> (classifier as KClass<*>).simpleName ?: error("Could not determine simple name for $this")
+  }
+
+  fun KType.getReferenceSlug(): String = when {
+    arguments.isNotEmpty() -> "$COMPONENT_SLUG/${genericNameAdapter(this, classifier as KClass<*>)}"
+    else -> "$COMPONENT_SLUG/${(classifier as KClass<*>).simpleName}"
+  }
+
+  /**
+   * Adapts a class with type parameters into a reference friendly string
+   */
+  private fun genericNameAdapter(type: KType, clazz: KClass<*>): String {
+    val classNames = type.arguments
+      .map { it.type?.classifier as KClass<*> }
+      .map { it.simpleName }
+    return classNames.joinToString(separator = "-", prefix = "${clazz.simpleName}-")
+  }
+}
--- a/core/src/test/kotlin/io/bkbn/kompendium/core/KompendiumTest.kt
+++ b/core/src/test/kotlin/io/bkbn/kompendium/core/KompendiumTest.kt
@ -0,0 +1,201 @@
+package io.bkbn.kompendium.core
+
+import io.bkbn.kompendium.core.fixtures.TestHelpers.openApiTestAllSerializers
+import io.bkbn.kompendium.core.util.TestModules.complexRequest
+import io.bkbn.kompendium.core.util.TestModules.dateTimeString
+import io.bkbn.kompendium.core.util.TestModules.defaultField
+import io.bkbn.kompendium.core.util.TestModules.defaultParameter
+import io.bkbn.kompendium.core.util.TestModules.exampleParams
+import io.bkbn.kompendium.core.util.TestModules.nestedUnderRoot
+import io.bkbn.kompendium.core.util.TestModules.nonRequiredParams
+import io.bkbn.kompendium.core.util.TestModules.notarizedDelete
+import io.bkbn.kompendium.core.util.TestModules.notarizedGet
+import io.bkbn.kompendium.core.util.TestModules.singleException
+import io.bkbn.kompendium.core.util.TestModules.genericException
+import io.bkbn.kompendium.core.util.TestModules.genericPolymorphicResponse
+import io.bkbn.kompendium.core.util.TestModules.genericPolymorphicResponseMultipleImpls
+import io.bkbn.kompendium.core.util.TestModules.headerParameter
+import io.bkbn.kompendium.core.util.TestModules.multipleExceptions
+import io.bkbn.kompendium.core.util.TestModules.nestedGenericResponse
+import io.bkbn.kompendium.core.util.TestModules.nonRequiredParam
+import io.bkbn.kompendium.core.util.TestModules.polymorphicException
+import io.bkbn.kompendium.core.util.TestModules.notarizedHead
+import io.bkbn.kompendium.core.util.TestModules.notarizedOptions
+import io.bkbn.kompendium.core.util.TestModules.notarizedPatch
+import io.bkbn.kompendium.core.util.TestModules.notarizedPost
+import io.bkbn.kompendium.core.util.TestModules.notarizedPut
+import io.bkbn.kompendium.core.util.TestModules.nullableEnumField
+import io.bkbn.kompendium.core.util.TestModules.nullableField
+import io.bkbn.kompendium.core.util.TestModules.nullableNestedObject
+import io.bkbn.kompendium.core.util.TestModules.polymorphicCollectionResponse
+import io.bkbn.kompendium.core.util.TestModules.polymorphicMapResponse
+import io.bkbn.kompendium.core.util.TestModules.polymorphicResponse
+import io.bkbn.kompendium.core.util.TestModules.primitives
+import io.bkbn.kompendium.core.util.TestModules.reqRespExamples
+import io.bkbn.kompendium.core.util.TestModules.requiredParams
+import io.bkbn.kompendium.core.util.TestModules.returnsList
+import io.bkbn.kompendium.core.util.TestModules.rootRoute
+import io.bkbn.kompendium.core.util.TestModules.simpleGenericResponse
+import io.bkbn.kompendium.core.util.TestModules.simplePathParsing
+import io.bkbn.kompendium.core.util.TestModules.trailingSlash
+import io.bkbn.kompendium.core.util.TestModules.withOperationId
+import io.bkbn.kompendium.json.schema.definition.TypeDefinition
+import io.kotest.core.spec.style.DescribeSpec
+import kotlin.reflect.typeOf
+import java.time.Instant
+
+class KompendiumTest : DescribeSpec({
+  describe("Notarized Open API Metadata Tests") {
+    it("Can notarize a get request") {
+      openApiTestAllSerializers("T0001__notarized_get.json") { notarizedGet() }
+    }
+    it("Can notarize a post request") {
+      openApiTestAllSerializers("T0002__notarized_post.json") { notarizedPost() }
+    }
+    it("Can notarize a put request") {
+      openApiTestAllSerializers("T0003__notarized_put.json") { notarizedPut() }
+    }
+    it("Can notarize a delete request") {
+      openApiTestAllSerializers("T0004__notarized_delete.json") { notarizedDelete() }
+    }
+    it("Can notarize a patch request") {
+      openApiTestAllSerializers("T0005__notarized_patch.json") { notarizedPatch() }
+    }
+    it("Can notarize a head request") {
+      openApiTestAllSerializers("T0006__notarized_head.json") { notarizedHead() }
+    }
+    it("Can notarize an options request") {
+      openApiTestAllSerializers("T0007__notarized_options.json") { notarizedOptions() }
+    }
+    it("Can notarize a complex type") {
+      openApiTestAllSerializers("T0008__complex_type.json") { complexRequest() }
+    }
+    it("Can notarize primitives") {
+      openApiTestAllSerializers("T0009__notarized_primitives.json") { primitives() }
+    }
+    it("Can notarize a top level list response") {
+      openApiTestAllSerializers("T0010__response_list.json") { returnsList() }
+    }
+    it("Can notarize a route with non-required params") {
+      openApiTestAllSerializers("T0011__non_required_params.json") { nonRequiredParams() }
+    }
+  }
+  describe("Route Parsing") {
+    it("Can parse a simple path and store it under the expected route") {
+      openApiTestAllSerializers("T0012__path_parser.json") { simplePathParsing() }
+    }
+    it("Can notarize the root route") {
+      openApiTestAllSerializers("T0013__root_route.json") { rootRoute() }
+    }
+    it("Can notarize a route under the root module without appending trailing slash") {
+      openApiTestAllSerializers("T0014__nested_under_root.json") { nestedUnderRoot() }
+    }
+    it("Can notarize a route with a trailing slash") {
+      openApiTestAllSerializers("T0015__trailing_slash.json") { trailingSlash() }
+    }
+  }
+  describe("Exceptions") {
+    it("Can add an exception status code to a response") {
+      openApiTestAllSerializers("T0016__notarized_get_with_exception_response.json") { singleException() }
+    }
+    it("Can support multiple response codes") {
+      openApiTestAllSerializers("T0017__notarized_get_with_multiple_exception_responses.json") { multipleExceptions() }
+    }
+    it("Can add a polymorphic exception response") {
+      openApiTestAllSerializers("T0018__polymorphic_error_status_codes.json") { polymorphicException() }
+    }
+    it("Can add a generic exception response") {
+      openApiTestAllSerializers("T0019__generic_exception.json") { genericException() }
+    }
+  }
+  describe("Examples") {
+    it("Can generate example response and request bodies") {
+      openApiTestAllSerializers("T0020__example_req_and_resp.json") { reqRespExamples() }
+    }
+    it("Can describe example parameters") {
+      openApiTestAllSerializers("T0021__example_parameters.json") { exampleParams() }
+    }
+  }
+  describe("Defaults") {
+    it("Can generate a default parameter value") {
+      openApiTestAllSerializers("T0022__query_with_default_parameter.json") { defaultParameter() }
+    }
+  }
+  describe("Required Fields") {
+    it("Marks a parameter as required if there is no default and it is not marked nullable") {
+      openApiTestAllSerializers("T0023__required_param.json") { requiredParams() }
+    }
+    it("Can mark a parameter as not required") {
+      openApiTestAllSerializers("T0024__non_required_param.json") { nonRequiredParam() }
+    }
+    it("Does not mark a field as required if a default value is provided") {
+      openApiTestAllSerializers("T0025__default_field.json") { defaultField() }
+    }
+    it("Does not mark a nullable field as required") {
+      openApiTestAllSerializers("T0026__nullable_field.json") { nullableField() }
+    }
+  }
+  describe("Polymorphism and Generics") {
+    it("can generate a polymorphic response type") {
+      openApiTestAllSerializers("T0027__polymorphic_response.json") { polymorphicResponse() }
+    }
+    it("Can generate a collection with polymorphic response type") {
+      openApiTestAllSerializers("T0028__polymorphic_list_response.json") { polymorphicCollectionResponse() }
+    }
+    it("Can generate a map with a polymorphic response type") {
+      openApiTestAllSerializers("T0029__polymorphic_map_response.json") { polymorphicMapResponse() }
+    }
+    it("Can generate a response type with a generic type") {
+      openApiTestAllSerializers("T0030__simple_generic_response.json") { simpleGenericResponse() }
+    }
+    it("Can generate a response type with a nested generic type") {
+      openApiTestAllSerializers("T0031__nested_generic_response.json") { nestedGenericResponse() }
+    }
+    it("Can generate a polymorphic response type with generics") {
+      openApiTestAllSerializers("T0032__polymorphic_response_with_generics.json") { genericPolymorphicResponse() }
+    }
+    it("Can handle an absolutely psycho inheritance test") {
+      openApiTestAllSerializers("T0033__crazy_polymorphic_example.json") { genericPolymorphicResponseMultipleImpls() }
+    }
+  }
+  describe("Miscellaneous") {
+    xit("Can generate the necessary ReDoc home page") {
+      // TODO apiFunctionalityTest(getFileSnapshot("redoc.html"), "/docs") { returnsList() }
+    }
+    it("Can add an operation id to a notarized route") {
+      openApiTestAllSerializers("T0034__notarized_get_with_operation_id.json") { withOperationId() }
+    }
+    xit("Can add an undeclared field") {
+      // TODO openApiTestAllSerializers("undeclared_field.json") { undeclaredType() }
+    }
+    it("Can add a custom header parameter with a name override") {
+      openApiTestAllSerializers("T0035__override_parameter_name.json") { headerParameter() }
+    }
+    xit("Can override field name") {
+      // TODO Assess strategies here
+    }
+    xit("Can serialize a recursive type") {
+      // TODO openApiTestAllSerializers("simple_recursive.json") { simpleRecursive() }
+    }
+    it("Nullable fields do not lead to doom") {
+      openApiTestAllSerializers("T0036__nullable_fields.json") { nullableNestedObject() }
+    }
+    it("Can have a nullable enum as a member field") {
+      openApiTestAllSerializers("T0037__nullable_enum_field.json") { nullableEnumField() }
+    }
+  }
+  describe("Constraints") {
+    // TODO Assess strategies here
+  }
+  describe("Formats") {
+    it("Can set a format for a simple type schema") {
+      openApiTestAllSerializers(
+        snapshotName = "T0038__formatted_date_time_string.json",
+        customTypes = mapOf(typeOf<Instant>() to TypeDefinition(type = "string", format = "date"))
+      ) { dateTimeString() }
+    }
+  }
+  describe("Free Form") {
+    // todo Assess strategies here
+  }
+})
--- a/core/src/test/kotlin/io/bkbn/kompendium/core/util/TestModules.kt
+++ b/core/src/test/kotlin/io/bkbn/kompendium/core/util/TestModules.kt
@ -0,0 +1,609 @@
+package io.bkbn.kompendium.core.util
+
+import io.bkbn.kompendium.core.fixtures.ColumnSchema
+import io.bkbn.kompendium.core.fixtures.ComplexRequest
+import io.bkbn.kompendium.core.fixtures.DateTimeString
+import io.bkbn.kompendium.core.fixtures.DefaultField
+import io.bkbn.kompendium.core.fixtures.ExceptionResponse
+import io.bkbn.kompendium.core.fixtures.Flibbity
+import io.bkbn.kompendium.core.fixtures.FlibbityGibbit
+import io.bkbn.kompendium.core.fixtures.Gibbity
+import io.bkbn.kompendium.core.fixtures.NullableEnum
+import io.bkbn.kompendium.core.fixtures.NullableField
+import io.bkbn.kompendium.core.fixtures.ProfileUpdateRequest
+import io.bkbn.kompendium.core.fixtures.TestCreatedResponse
+import io.bkbn.kompendium.core.fixtures.TestNested
+import io.bkbn.kompendium.core.fixtures.TestRequest
+import io.bkbn.kompendium.core.fixtures.TestResponse
+import io.bkbn.kompendium.core.fixtures.TestSimpleRequest
+import io.bkbn.kompendium.core.metadata.DeleteInfo
+import io.bkbn.kompendium.core.metadata.GetInfo
+import io.bkbn.kompendium.core.metadata.HeadInfo
+import io.bkbn.kompendium.core.metadata.OptionsInfo
+import io.bkbn.kompendium.core.metadata.PatchInfo
+import io.bkbn.kompendium.core.metadata.PostInfo
+import io.bkbn.kompendium.core.metadata.PutInfo
+import io.bkbn.kompendium.core.plugin.NotarizedRoute
+import io.bkbn.kompendium.json.schema.definition.TypeDefinition
+import io.bkbn.kompendium.oas.payload.Parameter
+import io.ktor.http.HttpStatusCode
+import io.ktor.server.application.call
+import io.ktor.server.application.install
+import io.ktor.server.response.respond
+import io.ktor.server.response.respondText
+import io.ktor.server.routing.Routing
+import io.ktor.server.routing.delete
+import io.ktor.server.routing.get
+import io.ktor.server.routing.head
+import io.ktor.server.routing.options
+import io.ktor.server.routing.patch
+import io.ktor.server.routing.post
+import io.ktor.server.routing.put
+import io.ktor.server.routing.route
+
+object TestModules {
+  private const val defaultPath = "/test/{a}"
+  private const val rootPath = "/"
+  private const val defaultResponseDescription = "A Successful Endeavor"
+  private const val defaultRequestDescription = "You gotta send it"
+  private const val defaultPathSummary = "Great Summary!"
+  private const val defaultPathDescription = "testing more"
+
+  private val defaultParams = listOf(
+    Parameter(
+      name = "a",
+      `in` = Parameter.Location.path,
+      schema = TypeDefinition.STRING,
+    ),
+    Parameter(
+      name = "aa",
+      `in` = Parameter.Location.query,
+      schema = TypeDefinition.INT
+    )
+  )
+
+  fun Routing.notarizedGet() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        get = GetInfo.builder {
+          response {
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+            description(defaultResponseDescription)
+          }
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+        }
+      }
+      get {
+        call.respondText { "hey dude ‼️ congrats on the get request" }
+      }
+    }
+  }
+
+  fun Routing.notarizedPost() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        post = PostInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          request {
+            requestType<TestSimpleRequest>()
+            description("A Test request")
+          }
+          response {
+            responseCode(HttpStatusCode.Created)
+            responseType<TestCreatedResponse>()
+            description(defaultResponseDescription)
+          }
+        }
+      }
+      post {
+        call.respondText { "hey dude ‼️ congrats on the post request" }
+      }
+    }
+  }
+
+  fun Routing.notarizedPut() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        put = PutInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          request {
+            requestType<TestSimpleRequest>()
+            description("A Test request")
+          }
+          response {
+            responseCode(HttpStatusCode.Created)
+            responseType<TestCreatedResponse>()
+            description(defaultResponseDescription)
+          }
+        }
+      }
+      put {
+        call.respondText { "hey dude ‼️ congrats on the post request" }
+      }
+    }
+  }
+
+  fun Routing.notarizedDelete() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        delete = DeleteInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            responseCode(HttpStatusCode.NoContent)
+            responseType<Unit>()
+            description(defaultResponseDescription)
+          }
+        }
+      }
+    }
+    delete {
+      call.respond(HttpStatusCode.NoContent)
+    }
+  }
+
+  fun Routing.notarizedPatch() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        patch = PatchInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          request {
+            description("A Test request")
+            requestType<TestSimpleRequest>()
+          }
+          response {
+            responseCode(HttpStatusCode.Created)
+            responseType<TestCreatedResponse>()
+            description(defaultResponseDescription)
+          }
+        }
+      }
+      patch {
+        call.respond(HttpStatusCode.Created) { TestCreatedResponse(123, "Nice!") }
+      }
+    }
+  }
+
+  fun Routing.notarizedHead() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        head = HeadInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+
+          response {
+            description("great!")
+            responseCode(HttpStatusCode.Created)
+            responseType<Unit>()
+          }
+        }
+      }
+      head {
+        call.respond(HttpStatusCode.OK)
+      }
+    }
+  }
+
+  fun Routing.notarizedOptions() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        options = OptionsInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+            description("nice")
+          }
+        }
+      }
+      options {
+        call.respond(HttpStatusCode.NoContent)
+      }
+    }
+  }
+
+  fun Routing.complexRequest() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        put = PutInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          request {
+            requestType<ComplexRequest>()
+            description("A Complex request")
+          }
+          response {
+            responseCode(HttpStatusCode.Created)
+            responseType<TestCreatedResponse>()
+            description(defaultResponseDescription)
+          }
+        }
+      }
+      patch {
+        call.respond(HttpStatusCode.Created, TestCreatedResponse(123, "nice!"))
+      }
+    }
+  }
+
+  fun Routing.primitives() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        put = PutInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          request {
+            requestType<Int>()
+            description("A Test Request")
+          }
+          response {
+            responseCode(HttpStatusCode.Created)
+            responseType<Boolean>()
+            description(defaultResponseDescription)
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.returnsList() {
+    route(defaultPath) {
+      install(NotarizedRoute()) {
+        parameters = defaultParams
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            description("A Successful List-y Endeavor")
+            responseCode(HttpStatusCode.OK)
+            responseType<List<TestResponse>>()
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.nonRequiredParams() {
+    route("/optional") {
+      install(NotarizedRoute()) {
+        parameters = listOf(
+          Parameter(
+            name = "notRequired",
+            `in` = Parameter.Location.query,
+            schema = TypeDefinition.STRING,
+            required = false,
+          ),
+          Parameter(
+            name = "required",
+            `in` = Parameter.Location.query,
+            schema = TypeDefinition.STRING
+          )
+        )
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            responseType<Unit>()
+            description("Empty")
+            responseCode(HttpStatusCode.NoContent)
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.simplePathParsing() {
+    route("/this") {
+      route("/is") {
+        route("/a") {
+          route("/complex") {
+            route("path") {
+              route("with/an/{id}") {
+                install(NotarizedRoute()) {
+                  get = GetInfo.builder {
+                    parameters = listOf(
+                      Parameter(
+                        name = "id",
+                        `in` = Parameter.Location.path,
+                        schema = TypeDefinition.STRING
+                      )
+                    )
+                    summary(defaultPathSummary)
+                    description(defaultPathDescription)
+                    response {
+                      description(defaultResponseDescription)
+                      responseCode(HttpStatusCode.OK)
+                      responseType<TestResponse>()
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.rootRoute() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        parameters = listOf(defaultParams.last())
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.nestedUnderRoot() {
+    route("/") {
+      route("/testerino") {
+        install(NotarizedRoute()) {
+          get = GetInfo.builder {
+            summary(defaultPathSummary)
+            description(defaultPathDescription)
+            response {
+              description(defaultResponseDescription)
+              responseCode(HttpStatusCode.OK)
+              responseType<TestResponse>()
+            }
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.trailingSlash() {
+    route("/test") {
+      route("/") {
+        install(NotarizedRoute()) {
+          get = GetInfo.builder {
+            summary(defaultPathSummary)
+            description(defaultPathDescription)
+            response {
+              description(defaultResponseDescription)
+              responseCode(HttpStatusCode.OK)
+              responseType<TestResponse>()
+            }
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.singleException() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+          }
+          canRespond {
+            description("Bad Things Happened")
+            responseCode(HttpStatusCode.BadRequest)
+            responseType<ExceptionResponse>()
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.multipleExceptions() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+          }
+          canRespond {
+            description("Bad Things Happened")
+            responseCode(HttpStatusCode.BadRequest)
+            responseType<ExceptionResponse>()
+          }
+          canRespond {
+            description("Access Denied")
+            responseCode(HttpStatusCode.Forbidden)
+            responseType<ExceptionResponse>()
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.polymorphicException() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+          }
+          canRespond {
+            description("Bad Things Happened")
+            responseCode(HttpStatusCode.InternalServerError)
+            responseType<FlibbityGibbit>()
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.genericException() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+          }
+          canRespond {
+            description("Bad Things Happened")
+            responseCode(HttpStatusCode.BadRequest)
+            responseType<Flibbity<String>>()
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.reqRespExamples() {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        post = PostInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          request {
+            description(defaultRequestDescription)
+            requestType<TestRequest>()
+            examples(
+              "Testerina" to TestRequest(TestNested("asdf"), 1.5, emptyList())
+            )
+          }
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<TestResponse>()
+            examples(
+              "Testerino" to TestResponse("Heya")
+            )
+          }
+        }
+      }
+    }
+  }
+
+  fun Routing.exampleParams() = basicGetGenerator<TestResponse>(
+    params = listOf(
+      Parameter(
+        name = "id",
+        `in` = Parameter.Location.path,
+        schema = TypeDefinition.STRING,
+        examples = mapOf(
+          "foo" to Parameter.Example("testing")
+        )
+      )
+    )
+  )
+
+  fun Routing.defaultParameter() = basicGetGenerator<TestResponse>(
+    params = listOf(
+      Parameter(
+        name = "id",
+        `in` = Parameter.Location.path,
+        schema = TypeDefinition.STRING.withDefault("IDK")
+      )
+    )
+  )
+
+  fun Routing.requiredParams() = basicGetGenerator<TestResponse>(
+    params = listOf(
+      Parameter(
+        name = "id",
+        `in` = Parameter.Location.path,
+        schema = TypeDefinition.STRING
+      )
+    )
+  )
+
+  fun Routing.nonRequiredParam() = basicGetGenerator<TestResponse>(
+    params = listOf(
+      Parameter(
+        name = "id",
+        `in` = Parameter.Location.query,
+        schema = TypeDefinition.STRING,
+        required = false
+      )
+    )
+  )
+
+  fun Routing.defaultField() = basicGetGenerator<DefaultField>()
+
+  fun Routing.nullableField() = basicGetGenerator<NullableField>()
+
+  fun Routing.polymorphicResponse() = basicGetGenerator<FlibbityGibbit>()
+
+  fun Routing.polymorphicCollectionResponse() = basicGetGenerator<List<FlibbityGibbit>>()
+
+  fun Routing.polymorphicMapResponse() = basicGetGenerator<Map<String, FlibbityGibbit>>()
+
+  fun Routing.simpleGenericResponse() = basicGetGenerator<Gibbity<String>>()
+
+  fun Routing.nestedGenericResponse() = basicGetGenerator<Gibbity<Map<String, String>>>()
+
+  fun Routing.genericPolymorphicResponse() = basicGetGenerator<Flibbity<Double>>()
+
+  fun Routing.genericPolymorphicResponseMultipleImpls() = basicGetGenerator<Flibbity<FlibbityGibbit>>()
+
+  fun Routing.withOperationId() = basicGetGenerator<TestResponse>(operationId = "getThisDude")
+
+  fun Routing.nullableNestedObject() = basicGetGenerator<ProfileUpdateRequest>()
+
+  fun Routing.nullableEnumField() = basicGetGenerator<NullableEnum>()
+
+  fun Routing.dateTimeString() = basicGetGenerator<DateTimeString>()
+
+  fun Routing.headerParameter() = basicGetGenerator<TestResponse>( params = listOf(
+    Parameter(
+      name = "X-User-Email",
+      `in` = Parameter.Location.header,
+      schema = TypeDefinition.STRING,
+      required = true
+    )
+  ))
+
+  fun Routing.simpleRecursive() = basicGetGenerator<ColumnSchema>()
+
+  private inline fun <reified T> Routing.basicGetGenerator(
+    params: List<Parameter> = emptyList(),
+    operationId: String? = null
+  ) {
+    route(rootPath) {
+      install(NotarizedRoute()) {
+        get = GetInfo.builder {
+          summary(defaultPathSummary)
+          description(defaultPathDescription)
+          operationId?.let { operationId(it) }
+          parameters = params
+          response {
+            description(defaultResponseDescription)
+            responseCode(HttpStatusCode.OK)
+            responseType<T>()
+          }
+        }
+      }
+    }
+  }
+}
--- a/core/src/test/resources/T0001__notarized_get.json
+++ b/core/src/test/resources/T0001__notarized_get.json
@ -0,0 +1,92 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0002__notarized_post.json
+++ b/core/src/test/resources/T0002__notarized_post.json
@ -0,0 +1,124 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "post": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "requestBody": {
+          "description": "A Test request",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestSimpleRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestCreatedResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestCreatedResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          },
+          "id": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "c",
+          "id"
+        ]
+      },
+      "TestSimpleRequest": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "b": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "a",
+          "b"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0003__notarized_put.json
+++ b/core/src/test/resources/T0003__notarized_put.json
@ -0,0 +1,124 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "put": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "requestBody": {
+          "description": "A Test request",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestSimpleRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestCreatedResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestCreatedResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          },
+          "id": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "c",
+          "id"
+        ]
+      },
+      "TestSimpleRequest": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "b": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "a",
+          "b"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0004__notarized_delete.json
+++ b/core/src/test/resources/T0004__notarized_delete.json
@ -0,0 +1,73 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "delete": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "204": {
+            "description": "A Successful Endeavor"
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {},
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0005__notarized_patch.json
+++ b/core/src/test/resources/T0005__notarized_patch.json
@ -0,0 +1,124 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "patch": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "requestBody": {
+          "description": "A Test request",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestSimpleRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestCreatedResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestCreatedResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          },
+          "id": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "c",
+          "id"
+        ]
+      },
+      "TestSimpleRequest": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "b": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "a",
+          "b"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0006__notarized_head.json
+++ b/core/src/test/resources/T0006__notarized_head.json
@ -0,0 +1,73 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "head": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "201": {
+            "description": "great!"
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {},
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0007__notarized_options.json
+++ b/core/src/test/resources/T0007__notarized_options.json
@ -0,0 +1,92 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "options": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "nice",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0008__complex_type.json
+++ b/core/src/test/resources/T0008__complex_type.json
@ -0,0 +1,142 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "put": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "requestBody": {
+          "description": "A Complex request",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ComplexRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestCreatedResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestCreatedResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          },
+          "id": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "c",
+          "id"
+        ]
+      },
+      "ComplexRequest": {
+        "type": "object",
+        "properties": {
+          "amazingField": {
+            "type": "string"
+          },
+          "org": {
+            "type": "string"
+          },
+          "tables": {
+            "items": {
+              "$ref": "#/components/schemas/NestedComplexItem"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "amazingField",
+          "org",
+          "tables"
+        ]
+      },
+      "NestedComplexItem": {
+        "type": "object",
+        "properties": {
+          "alias": {
+            "additionalProperties": {
+              "$ref": "#/components/schemas/CrazyItem"
+            },
+            "type": "object"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "alias",
+          "name"
+        ]
+      },
+      "CrazyItem": {
+        "type": "object",
+        "properties": {
+          "enumeration": {
+            "enum": [
+              "ONE",
+              "TWO"
+            ]
+          }
+        },
+        "required": [
+          "enumeration"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0009__notarized_primitives.json
+++ b/core/src/test/resources/T0009__notarized_primitives.json
@ -0,0 +1,79 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "put": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "requestBody": {
+          "description": "A Test Request",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Int"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Boolean"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "Boolean": {
+        "type": "boolean"
+      },
+      "Int": {
+        "type": "number",
+        "format": "int32"
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0010__response_list.json
+++ b/core/src/test/resources/T0010__response_list.json
@ -0,0 +1,98 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/{a}": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful List-y Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/List-TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "a",
+          "in": "path",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        },
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      },
+      "List-TestResponse": {
+        "items": {
+          "$ref": "#/components/schemas/TestResponse"
+        },
+        "type": "array"
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0011__non_required_params.json
+++ b/core/src/test/resources/T0011__non_required_params.json
@ -0,0 +1,72 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/optional": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "204": {
+            "description": "Empty"
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "notRequired",
+          "in": "query",
+          "schema": {
+            "type": "string"
+          },
+          "required": false,
+          "deprecated": false
+        },
+        {
+          "name": "required",
+          "in": "query",
+          "schema": {
+            "type": "string"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {},
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0012__path_parser.json
+++ b/core/src/test/resources/T0012__path_parser.json
@ -0,0 +1,82 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/this/is/a/complex/path/with/an/{id}": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "deprecated": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0013__root_route.json
+++ b/core/src/test/resources/T0013__root_route.json
@ -0,0 +1,83 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": [
+        {
+          "name": "aa",
+          "in": "query",
+          "schema": {
+            "type": "number",
+            "format": "int32"
+          },
+          "required": true,
+          "deprecated": false
+        }
+      ]
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0014__nested_under_root.json
+++ b/core/src/test/resources/T0014__nested_under_root.json
@ -0,0 +1,72 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/testerino": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0015__trailing_slash.json
+++ b/core/src/test/resources/T0015__trailing_slash.json
@ -0,0 +1,72 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/test/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0016__notarized_get_with_exception_response.json
+++ b/core/src/test/resources/T0016__notarized_get_with_exception_response.json
@ -0,0 +1,93 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Things Happened",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ExceptionResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      },
+      "ExceptionResponse": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "message"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0017__notarized_get_with_multiple_exception_responses.json
+++ b/core/src/test/resources/T0017__notarized_get_with_multiple_exception_responses.json
@ -0,0 +1,103 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Things Happened",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ExceptionResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Access Denied",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ExceptionResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      },
+      "ExceptionResponse": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "message"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0018__polymorphic_error_status_codes.json
+++ b/core/src/test/resources/T0018__polymorphic_error_status_codes.json
@ -0,0 +1,126 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Bad Things Happened",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      },
+      "ComplexGibbit": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "c": {
+            "type": "number",
+            "format": "int32"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "b",
+          "c",
+          "z"
+        ]
+      },
+      "SimpleGibbit": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "FlibbityGibbit": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/ComplexGibbit"
+          },
+          {
+            "$ref": "#/components/schemas/SimpleGibbit"
+          }
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0019__generic_exception.json
+++ b/core/src/test/resources/T0019__generic_exception.json
@ -0,0 +1,118 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Things Happened",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Flibbity-String"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      },
+      "Bibbity-String": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "f": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "b",
+          "f"
+        ]
+      },
+      "Gibbity-String": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "Flibbity-String": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/Bibbity-String"
+          },
+          {
+            "$ref": "#/components/schemas/Gibbity-String"
+          }
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0020__example_req_and_resp.json
+++ b/core/src/test/resources/T0020__example_req_and_resp.json
@ -0,0 +1,136 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "post": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "requestBody": {
+          "description": "You gotta send it",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TestRequest"
+              },
+              "examples": {
+                "Testerina": {
+                  "value": {
+                    "fieldName": {
+                      "nesty": "asdf"
+                    },
+                    "b": 1.5,
+                    "aaa": []
+                  }
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                },
+                "examples": {
+                  "Testerino": {
+                    "value": {
+                      "c": "Heya"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      },
+      "TestRequest": {
+        "type": "object",
+        "properties": {
+          "aaa": {
+            "items": {
+              "type": "number",
+              "format": "int64"
+            },
+            "type": "array"
+          },
+          "b": {
+            "type": "number",
+            "format": "double"
+          },
+          "fieldName": {
+            "$ref": "#/components/schemas/TestNested"
+          }
+        },
+        "required": [
+          "aaa",
+          "b",
+          "fieldName"
+        ]
+      },
+      "TestNested": {
+        "type": "object",
+        "properties": {
+          "nesty": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "nesty"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0021__example_parameters.json
+++ b/core/src/test/resources/T0021__example_parameters.json
@ -0,0 +1,87 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "deprecated": false,
+            "examples": {
+              "foo": {
+                "value": "testing"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0022__query_with_default_parameter.json
+++ b/core/src/test/resources/T0022__query_with_default_parameter.json
@ -0,0 +1,83 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "schema": {
+              "type": "string",
+              "default": "IDK"
+            },
+            "required": true,
+            "deprecated": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0023__required_param.json
+++ b/core/src/test/resources/T0023__required_param.json
@ -0,0 +1,82 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "deprecated": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0024__non_required_param.json
+++ b/core/src/test/resources/T0024__non_required_param.json
@ -0,0 +1,82 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "deprecated": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0025__default_field.json
+++ b/core/src/test/resources/T0025__default_field.json
@ -0,0 +1,76 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DefaultField"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "DefaultField": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "b": {
+            "type": "number",
+            "format": "int32"
+          }
+        },
+        "required": [
+          "b"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0026__nullable_field.json
+++ b/core/src/test/resources/T0026__nullable_field.json
@ -0,0 +1,77 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NullableField"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "NullableField": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": []
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0027__polymorphic_response.json
+++ b/core/src/test/resources/T0027__polymorphic_response.json
@ -0,0 +1,105 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "ComplexGibbit": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "c": {
+            "type": "number",
+            "format": "int32"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "b",
+          "c",
+          "z"
+        ]
+      },
+      "SimpleGibbit": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "FlibbityGibbit": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/ComplexGibbit"
+          },
+          {
+            "$ref": "#/components/schemas/SimpleGibbit"
+          }
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0028__polymorphic_list_response.json
+++ b/core/src/test/resources/T0028__polymorphic_list_response.json
@ -0,0 +1,108 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/List-FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "ComplexGibbit": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "c": {
+            "type": "number",
+            "format": "int32"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "b",
+          "c",
+          "z"
+        ]
+      },
+      "SimpleGibbit": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "List-FlibbityGibbit": {
+        "items": {
+          "anyOf": [
+            {
+              "$ref": "#/components/schemas/ComplexGibbit"
+            },
+            {
+              "$ref": "#/components/schemas/SimpleGibbit"
+            }
+          ]
+        },
+        "type": "array"
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0029__polymorphic_map_response.json
+++ b/core/src/test/resources/T0029__polymorphic_map_response.json
@ -0,0 +1,108 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Map-String-FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "ComplexGibbit": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "c": {
+            "type": "number",
+            "format": "int32"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "b",
+          "c",
+          "z"
+        ]
+      },
+      "SimpleGibbit": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "Map-String-FlibbityGibbit": {
+        "additionalProperties": {
+          "anyOf": [
+            {
+              "$ref": "#/components/schemas/ComplexGibbit"
+            },
+            {
+              "$ref": "#/components/schemas/SimpleGibbit"
+            }
+          ]
+        },
+        "type": "object"
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0030__simple_generic_response.json
+++ b/core/src/test/resources/T0030__simple_generic_response.json
@ -0,0 +1,72 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Gibbity-String"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "Gibbity-String": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0031__nested_generic_response.json
+++ b/core/src/test/resources/T0031__nested_generic_response.json
@ -0,0 +1,75 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Gibbity-Map"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "Gibbity-Map": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0032__polymorphic_response_with_generics.json
+++ b/core/src/test/resources/T0032__polymorphic_response_with_generics.json
@ -0,0 +1,99 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Flibbity-Double"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "Bibbity-Double": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "f": {
+            "type": "number",
+            "format": "double"
+          }
+        },
+        "required": [
+          "b",
+          "f"
+        ]
+      },
+      "Gibbity-Double": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "number",
+            "format": "double"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "Flibbity-Double": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/Bibbity-Double"
+          },
+          {
+            "$ref": "#/components/schemas/Gibbity-Double"
+          }
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0033__crazy_polymorphic_example.json
+++ b/core/src/test/resources/T0033__crazy_polymorphic_example.json
@ -0,0 +1,145 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Flibbity-FlibbityGibbit"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "ComplexGibbit": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "c": {
+            "type": "number",
+            "format": "int32"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "b",
+          "c",
+          "z"
+        ]
+      },
+      "SimpleGibbit": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string"
+          },
+          "z": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "Bibbity-FlibbityGibbit": {
+        "type": "object",
+        "properties": {
+          "b": {
+            "type": "string"
+          },
+          "f": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ComplexGibbit"
+              },
+              {
+                "$ref": "#/components/schemas/SimpleGibbit"
+              }
+            ]
+          }
+        },
+        "required": [
+          "b",
+          "f"
+        ]
+      },
+      "Gibbity-FlibbityGibbit": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ComplexGibbit"
+              },
+              {
+                "$ref": "#/components/schemas/SimpleGibbit"
+              }
+            ]
+          }
+        },
+        "required": [
+          "a"
+        ]
+      },
+      "Flibbity-FlibbityGibbit": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/Bibbity-FlibbityGibbit"
+          },
+          {
+            "$ref": "#/components/schemas/Gibbity-FlibbityGibbit"
+          }
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0034__notarized_get_with_operation_id.json
+++ b/core/src/test/resources/T0034__notarized_get_with_operation_id.json
@ -0,0 +1,73 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "operationId": "getThisDude",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0035__override_parameter_name.json
+++ b/core/src/test/resources/T0035__override_parameter_name.json
@ -0,0 +1,82 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [
+          {
+            "name": "X-User-Email",
+            "in": "header",
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "deprecated": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestResponse"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "TestResponse": {
+        "type": "object",
+        "properties": {
+          "c": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "c"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0036__nullable_fields.json
+++ b/core/src/test/resources/T0036__nullable_fields.json
@ -0,0 +1,121 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProfileUpdateRequest"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "ProfileUpdateRequest": {
+        "type": "object",
+        "properties": {
+          "metadata": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "isPrivate": {
+                    "oneOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "type": "boolean"
+                      }
+                    ]
+                  },
+                  "otherThing": {
+                    "oneOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "type": "string"
+                      }
+                    ]
+                  }
+                },
+                "required": []
+              }
+            ]
+          },
+          "mood": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "string"
+              }
+            ]
+          },
+          "viewCount": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "number",
+                "format": "int64"
+              }
+            ]
+          }
+        },
+        "required": []
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0037__nullable_enum_field.json
+++ b/core/src/test/resources/T0037__nullable_enum_field.json
@ -0,0 +1,80 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NullableEnum"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "NullableEnum": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "enum": [
+                  "YES",
+                  "NO"
+                ]
+              }
+            ]
+          }
+        },
+        "required": []
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/T0038__formatted_date_time_string.json
+++ b/core/src/test/resources/T0038__formatted_date_time_string.json
@ -0,0 +1,77 @@
+{
+  "openapi": "3.1.0",
+  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
+  "info": {
+    "title": "Test API",
+    "version": "1.33.7",
+    "description": "An amazing, fully-ish 😉 generated API spec",
+    "termsOfService": "https://example.com",
+    "contact": {
+      "name": "Homer Simpson",
+      "url": "https://gph.is/1NPUDiM",
+      "email": "chunkylover53@aol.com"
+    },
+    "license": {
+      "name": "MIT",
+      "url": "https://github.com/bkbnio/kompendium/blob/main/LICENSE"
+    }
+  },
+  "servers": [
+    {
+      "url": "https://myawesomeapi.com",
+      "description": "Production instance of my API"
+    },
+    {
+      "url": "https://staging.myawesomeapi.com",
+      "description": "Where the fun stuff happens"
+    }
+  ],
+  "paths": {
+    "/": {
+      "get": {
+        "tags": [],
+        "summary": "Great Summary!",
+        "description": "testing more",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "A Successful Endeavor",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DateTimeString"
+                }
+              }
+            }
+          }
+        },
+        "deprecated": false
+      },
+      "parameters": []
+    }
+  },
+  "webhooks": {},
+  "components": {
+    "schemas": {
+      "Instant": {
+        "type": "string",
+        "format": "date"
+      },
+      "DateTimeString": {
+        "type": "object",
+        "properties": {
+          "a": {
+            "type": "string",
+            "format": "date"
+          }
+        },
+        "required": [
+          "a"
+        ]
+      }
+    },
+    "securitySchemes": {}
+  },
+  "security": [],
+  "tags": []
+}
--- a/core/src/test/resources/redoc.html
+++ b/core/src/test/resources/redoc.html
@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Docs</title>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+    <style>body { margin: 0; padding: 0; }</style>
+  </head>
+  <body><redoc spec-url='/openapi.json'></redoc>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"></script>
+  </body>
+</html>
--- a/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/SupportedSerializers.kt
+++ b/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/SupportedSerializers.kt
@ -0,0 +1,7 @@
+package io.bkbn.kompendium.core.fixtures
+
+enum class SupportedSerializer {
+  KOTLINX,
+  GSON,
+  JACKSON
+}
--- a/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/TestHelpers.kt
+++ b/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/TestHelpers.kt
@ -0,0 +1,104 @@
+package io.bkbn.kompendium.core.fixtures
+
+import com.fasterxml.jackson.annotation.JsonInclude
+import com.fasterxml.jackson.databind.SerializationFeature
+import io.bkbn.kompendium.core.fixtures.TestSpecs.defaultSpec
+import io.bkbn.kompendium.core.plugin.NotarizedApplication
+import io.bkbn.kompendium.core.routes.redoc
+import io.bkbn.kompendium.json.schema.definition.JsonSchema
+import io.bkbn.kompendium.oas.OpenApiSpec
+import io.bkbn.kompendium.oas.info.Contact
+import io.bkbn.kompendium.oas.info.Info
+import io.bkbn.kompendium.oas.info.License
+import io.bkbn.kompendium.oas.serialization.KompendiumSerializersModule
+import io.bkbn.kompendium.oas.server.Server
+import io.kotest.assertions.json.shouldEqualJson
+import io.kotest.assertions.ktor.client.shouldHaveStatus
+import io.kotest.matchers.shouldNot
+import io.kotest.matchers.string.beBlank
+import io.ktor.client.request.get
+import io.ktor.client.statement.bodyAsText
+import io.ktor.http.ContentType
+import io.ktor.http.HttpStatusCode
+import io.ktor.serialization.gson.gson
+import io.ktor.serialization.jackson.jackson
+import io.ktor.serialization.kotlinx.json.json
+import io.ktor.server.plugins.contentnegotiation.ContentNegotiation
+import io.ktor.server.routing.Routing
+import io.ktor.server.testing.ApplicationTestBuilder
+import io.ktor.server.testing.testApplication
+import kotlin.reflect.KType
+import kotlinx.serialization.json.Json
+import java.io.File
+import java.net.URI
+
+object TestHelpers {
+  private const val OPEN_API_ENDPOINT = "/openapi.json"
+
+  fun getFileSnapshot(fileName: String): String {
+    val snapshotPath = "src/test/resources"
+    val file = File("$snapshotPath/$fileName")
+    return file.readText()
+  }
+
+  /**
+   * Performs the baseline expected tests on an OpenAPI result.  Confirms that the endpoint
+   * exists as expected, and that the content matches the expected blob found in the specified file
+   * @param snapshotName The snapshot file to retrieve from the resources folder
+   */
+  private suspend fun ApplicationTestBuilder.compareOpenAPISpec(snapshotName: String) {
+    val response = client.get(OPEN_API_ENDPOINT)
+    response shouldHaveStatus HttpStatusCode.OK
+    response.bodyAsText() shouldNot beBlank()
+    response.bodyAsText() shouldEqualJson getFileSnapshot(snapshotName)
+  }
+
+  /**
+   * This will take a provided JSON snapshot file, retrieve it from the resource folder,
+   * and build a test ktor server to compare the expected output with the output found in the default
+   * OpenAPI json endpoint.  By default, this will run the same test with Gson, Kotlinx, and Jackson serializers
+   * @param snapshotName The snapshot file to retrieve from the resources folder
+   * @param moduleFunction Initializer for the application to allow tests to pass the required Ktor modules
+   */
+  fun openApiTestAllSerializers(
+    snapshotName: String,
+    customTypes: Map<KType, JsonSchema> = emptyMap(),
+    routeUnderTest: Routing.() -> Unit
+  ) {
+    openApiTest(snapshotName, SupportedSerializer.KOTLINX, routeUnderTest, customTypes)
+    openApiTest(snapshotName, SupportedSerializer.JACKSON, routeUnderTest, customTypes)
+    openApiTest(snapshotName, SupportedSerializer.GSON, routeUnderTest, customTypes)
+  }
+
+  private fun openApiTest(
+    snapshotName: String,
+    serializer: SupportedSerializer,
+    routeUnderTest: Routing.() -> Unit,
+    typeOverrides: Map<KType, JsonSchema> = emptyMap()
+  ) = testApplication {
+    install(NotarizedApplication()) {
+      customTypes = typeOverrides
+      spec = defaultSpec()
+    }
+    install(ContentNegotiation) {
+      when (serializer) {
+        SupportedSerializer.KOTLINX -> json(Json {
+          encodeDefaults = true
+          explicitNulls = false
+          serializersModule = KompendiumSerializersModule.module
+        })
+
+        SupportedSerializer.GSON -> gson()
+        SupportedSerializer.JACKSON -> jackson(ContentType.Application.Json) {
+          enable(SerializationFeature.INDENT_OUTPUT)
+          setSerializationInclusion(JsonInclude.Include.NON_NULL)
+        }
+      }
+    }
+    routing {
+      redoc()
+      routeUnderTest()
+    }
+    compareOpenAPISpec(snapshotName)
+  }
+}
--- a/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/TestModels.kt
+++ b/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/TestModels.kt
@ -0,0 +1,120 @@
+package io.bkbn.kompendium.core.fixtures
+
+import kotlinx.serialization.Serializable
+import java.time.Instant
+
+@Serializable
+data class TestNested(val nesty: String)
+
+@Serializable
+data class TestRequest(
+  val fieldName: TestNested,
+  val b: Double,
+  val aaa: List<Long>
+)
+
+@Serializable
+data class TestSimpleRequest(
+  val a: String,
+  val b: Int
+)
+
+@Serializable
+data class TestResponse(val c: String)
+
+@Serializable
+enum class TestEnum {
+  YES,
+  NO
+}
+
+@Serializable
+data class NullableEnum(val a: TestEnum? = null)
+
+data class TestCreatedResponse(val id: Int, val c: String)
+
+data class DateTimeString(
+  val a: Instant
+)
+
+data class DefaultField(
+  val a: String = "hi",
+  val b: Int
+)
+
+data class NullableField(
+  val a: String?
+)
+
+data class ComplexRequest(
+  val org: String,
+  val amazingField: String,
+  val tables: List<NestedComplexItem>
+)
+
+data class NestedComplexItem(
+  val name: String,
+  val alias: CustomAlias
+)
+
+typealias CustomAlias = Map<String, CrazyItem>
+
+data class CrazyItem(val enumeration: SimpleEnum)
+
+enum class SimpleEnum {
+  ONE,
+  TWO
+}
+
+data class ExceptionResponse(val message: String)
+
+sealed class FlibbityGibbit {
+  abstract val z: String
+}
+
+data class SimpleGibbit(val a: String, override val z: String = "z") : FlibbityGibbit()
+data class ComplexGibbit(val b: String, val c: Int, override val z: String) : FlibbityGibbit()
+
+sealed interface SlammaJamma
+
+data class OneJamma(val a: Int) : SlammaJamma
+data class AnothaJamma(val b: Float) : SlammaJamma
+
+data class InsaneJamma(val c: SlammaJamma) : SlammaJamma
+
+sealed interface Flibbity<T>
+
+data class Gibbity<T>(val a: T) : Flibbity<T>
+data class Bibbity<T>(val b: String, val f: T) : Flibbity<T>
+
+data class NestedFlibbity<T>(
+  val flibbity: Flibbity<T>
+)
+
+enum class ColumnMode {
+  NULLABLE,
+  REQUIRED,
+  REPEATED
+}
+
+data class ColumnSchema(
+  val name: String,
+  val type: String,
+  val description: String,
+  val mode: ColumnMode,
+  val subColumns: List<ColumnSchema> = emptyList()
+)
+
+@Serializable
+public data class ProfileUpdateRequest(
+  public val mood: String?,
+  public val viewCount: Long?,
+  public val metadata: ProfileMetadataUpdateRequest?
+)
+
+
+@Serializable
+public data class ProfileMetadataUpdateRequest(
+  public val isPrivate: Boolean?,
+  public val otherThing: String?
+)
--- a/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/TestSpecs.kt
+++ b/core/src/testFixtures/kotlin/io/bkbn/kompendium/core/fixtures/TestSpecs.kt
@ -0,0 +1,40 @@
+package io.bkbn.kompendium.core.fixtures
+
+import io.bkbn.kompendium.oas.OpenApiSpec
+import io.bkbn.kompendium.oas.info.Contact
+import io.bkbn.kompendium.oas.info.Info
+import io.bkbn.kompendium.oas.info.License
+import io.bkbn.kompendium.oas.server.Server
+import java.net.URI
+
+object TestSpecs {
+  val defaultSpec: () -> OpenApiSpec = {
+    OpenApiSpec(
+      info = Info(
+        title = "Test API",
+        version = "1.33.7",
+        description = "An amazing, fully-ish \uD83D\uDE09 generated API spec",
+        termsOfService = URI("https://example.com"),
+        contact = Contact(
+          name = "Homer Simpson",
+          email = "chunkylover53@aol.com",
+          url = URI("https://gph.is/1NPUDiM")
+        ),
+        license = License(
+          name = "MIT",
+          url = URI("https://github.com/bkbnio/kompendium/blob/main/LICENSE")
+        )
+      ),
+      servers = mutableListOf(
+        Server(
+          url = URI("https://myawesomeapi.com"),
+          description = "Production instance of my API"
+        ),
+        Server(
+          url = URI("https://staging.myawesomeapi.com"),
+          description = "Where the fun stuff happens"
+        )
+      )
+    )
+  }
+}