rewrite using own parser & bundler (#5, #6)

Author: hauner

build.gradle.kts

@@ -41,13 +41,11 @@ tasks.compileTestGroovy {
 
 dependencies {
     implementation (libs.openapi.processor.api)
+    implementation (platform(libs.openapi.parser.bom))
+    implementation (libs.openapi.parser.parser)
+    implementation (libs.io.jackson)
 
-    implementation("io.swagger.parser.v3:swagger-parser:2.0.24") {
-        exclude(group = "io.swagger.parser.v3", module = "swagger-parser-v2-converter")
-        exclude(group = "io.swagger.core.v3", module = "swagger-annotations")
-    }
-
-    testImplementation("io.github.java-diff-utils:java-diff-utils:4.9")
+    testImplementation(libs.diff)
     testImplementation (platform(libs.groovy.bom))
     testImplementation ("org.apache.groovy:groovy")
     testImplementation ("org.apache.groovy:groovy-nio")
@@ -58,7 +56,7 @@ dependencies {
     testImplementation (libs.mockk)
     testImplementation (libs.logback)
 
-    testIntImplementation("io.github.java-diff-utils:java-diff-utils:4.9")
+    testIntImplementation(libs.diff)
     testIntImplementation (platform(libs.groovy.bom))
     testIntImplementation ("org.apache.groovy:groovy")
     testIntImplementation ("org.apache.groovy:groovy-nio")

gradle/libs.versions.toml

@@ -7,13 +7,17 @@ build-jdk = "17"
 build-plugins = "2025.9"
 
 api = "2024.2"
-#base = "2025.5.1"
+parser = "2025.5-SNAPSHOT"
 
 junit = "5.9.3"
 jacoco = "0.8.7"
 
 [libraries]
 openapi-processor-api = { module = "io.openapiprocessor:openapi-processor-api", version.ref = "api" }
+openapi-parser-bom = { module = "io.openapiprocessor:openapi-parser-bom", version.ref = "parser" }
+openapi-parser-parser = { module = "io.openapiprocessor:openapi-parser" }
+io-jackson = { module = "io.openapiprocessor:io-jackson" }
+diff = { module = "io.github.java-diff-utils:java-diff-utils", version = "4.16" }
 
 logback = "ch.qos.logback:logback-classic:1.5.18"
 

src/main/kotlin/com/github/hauner/openapi/json/processor/JsonProcessor.kt

@@ -5,22 +5,20 @@
 
 package com.github.hauner.openapi.json.processor
 
-import io.openapiprocessor.api.OpenApiProcessor
-import io.swagger.v3.core.util.Json
-import io.swagger.v3.parser.OpenAPIV3Parser
-import io.swagger.v3.parser.core.models.ParseOptions
-import io.swagger.v3.parser.core.models.SwaggerParseResult
-import java.net.URL
-import java.nio.file.Files
-import java.nio.file.Paths
+import io.openapiparser.OpenApiParser
+import io.openapiprocessor.jackson.JacksonConverter
+import io.openapiprocessor.jackson.JacksonJsonWriter
+import io.openapiprocessor.jsonschema.reader.UriReader
+import io.openapiprocessor.jsonschema.schema.DocumentLoader
+import io.openapiprocessor.jsonschema.schema.DocumentStore
+import java.io.File
+import java.io.FileWriter
 
 /**
  *  Entry point of the openapi-processor-json.
- *
- *  @author Martin Hauner
  */
-class JsonProcessor : OpenApiProcessor {
-
+class JsonProcessor : io.openapiprocessor.api.v2.OpenApiProcessor
+{
     /**
      * provides the generatr name.
      */
@@ -45,55 +43,26 @@ class JsonProcessor : OpenApiProcessor {
             return
         }
 
-        apiPath = toURL(apiPath).toString()
-
         var targetDir: String? = options["targetDir"]?.toString()
         if (targetDir == null) {
             println("openapi-processor-json: missing targetDir!")
             return
         }
 
-        targetDir = toURL(targetDir).toString()
-
-        val opts = ParseOptions()
-        val result: SwaggerParseResult = OpenAPIV3Parser()
-                .readLocation(apiPath, null, opts)
+        val reader = UriReader()
+        val converter = JacksonConverter()
+        val loader = DocumentLoader(reader, converter)
 
-        var json= Json.pretty(result.openAPI)
-        json += "\n"
+        val documents = DocumentStore()
+        val parser = OpenApiParser(documents, loader)
 
-        val p = Paths.get(URL(targetDir).toURI())
-        val dir = Files.createDirectories(p)
-        val targetPath = dir.resolve("openapi.json")
-        targetPath.toFile().writeText(json)
-    }
+        val baseUri = toURI(apiPath)
+        val result = parser.parse (baseUri)
+        val bundled = result.bundle()
 
-    /**
-     * convert source to a valid URL.
-     *
-     * if the source is an url string it converts it to an URL
-     * if the source is not an URL it assumes a local path and prefixes it with file://(//) to
-     * create a valid URL.
-     *
-     * @param source source path or url
-     * @return an URL to the given source
-     */
-    private fun toURL(source: String): URL {
-        try {
-            return URL(source)
-        } catch (ignore: Exception) {
-            // catch
-        }
+        val out = FileWriter(listOf(targetDir, "openapi.json").joinToString(File.separator))
+        val writer = JacksonJsonWriter(out)
 
-        try {
-            return Paths.get(source)
-                .normalize ()
-                .toUri ()
-                .toURL ()
-        } catch (e: Exception) {
-            throw e
-        }
+        writer.write(bundled)
     }
-
-
-}
+}

src/main/kotlin/com/github/hauner/openapi/json/processor/URI.kt

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2020 https://github.com/openapi-processor/openapi-processor-core
+ * PDX-License-Identifier: Apache-2.0
+ */
+
+package com.github.hauner.openapi.json.processor
+
+import java.net.URI
+import java.nio.file.Paths
+
+/**
+ * convert a source string to a valid URI.
+ *
+ * if the source is an uri string, it converts it to a URI. If the source has no scheme it assumes
+ * a local path and adds the file scheme (i.e., file:).
+ *
+ * @param source source path or url
+ * @return a URI to the given source
+ */
+fun toURI(source: String): URI {
+    try {
+        val uri = URI(source)
+        if (uri.scheme != null) {
+            return uri
+        }
+    } catch (ignore: Exception) {
+        // ignore
+    }
+
+    // no scheme, assume a file path
+    return Paths.get(source)
+        .normalize()
+        .toAbsolutePath()
+        .toUri()
+}

…thub.hauner.openapi.api.OpenApiProcessor …b.hauner.openapi.api.v2.OpenApiProcessorsrc/main/resources/META-INF/services/com.github.hauner.openapi.api.OpenApiProcessor renamed to src/main/resources/META-INF/services/com.github.hauner.openapi.api.v2.OpenApiProcessor src/main/resources/META-INF/services/com.github.hauner.openapi.api.OpenApiProcessor renamed to src/main/resources/META-INF/services/com.github.hauner.openapi.api.v2.OpenApiProcessor

@@ -22,7 +22,7 @@ class JsonProcessorSpec extends Specification {
         def targetPath = [targetDir, 'openapi.json'].join(File.separator)
 
         def options = [
-            apiPath: new File(apiPath).canonicalPath,
+            apiPath: new File(apiPath).absolutePath,
             targetDir: targetDir
         ]
 

src/test/groovy/com/github/hauner/openapi/json/processor/JsonProcessorSpec.groovy

@@ -4,9 +4,6 @@
     "title" : "sample api",
     "version" : "1.0.0"
   },
-  "servers" : [ {
-    "url" : "/"
-  } ],
   "paths" : {
     "/ping" : {
       "get" : {
@@ -34,11 +31,9 @@
         "description" : "sample endpoint with parameter",
         "parameters" : [ {
           "name" : "source",
-          "in" : "query",
           "description" : "query, required, string",
+          "in" : "query",
           "required" : true,
-          "style" : "form",
-          "explode" : true,
           "schema" : {
             "type" : "string"
           }
@@ -58,4 +53,4 @@
       }
     }
   }
-}
+}