extract/improve name from ref creation (#291)

Author: hauner

openapi-processor-core-parser-api/build.gradle.kts

@@ -1,4 +1,5 @@
 plugins {
+    id("openapiprocessor.test")
     id("openapiprocessor.library")
     id("openapiprocessor.publish")
 }
@@ -12,3 +13,10 @@ publishing {
         }
     }
 }
+
+dependencies {
+    testImplementation (platform(libs.kotest.bom))
+    testImplementation (libs.kotest.runner)
+    testImplementation (libs.kotest.datatest)
+    testImplementation (libs.mockk)
+}

openapi-processor-core-parser-api/src/main/kotlin/io/openapiprocessor/core/parser/RefResolver.kt

@@ -16,3 +16,27 @@ class NamedSchema(val name: String?, val schema: Schema) {
     val hasName = name != null
     val hasNoName = name == null
 }
+
+/**
+ * Extract a name from the $ref that can be used to name classes.
+ *
+ * @param ref the $ref path
+ */
+fun getRefName(ref: String): String? {
+    val split = ref.split('#')
+
+    if (split.size == 1) {
+        val fileName = ref.substring(ref.lastIndexOf('/') + 1)
+        val lastDot = fileName.lastIndexOf('.')
+        if (lastDot == -1) {
+            return fileName
+        }
+        return fileName.take(lastDot)
+
+    } else if (split.size > 1) {
+        val hash = split[1]
+        return hash.substring(hash.lastIndexOf('/') + 1)
+    }
+
+    return null
+}

openapi-processor-core-parser-api/src/test/kotlin/io/openapiprocessor/core/parser/RefNameSpec.kt

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2025 https://github.com/openapi-processor/openapi-processor-base
+ * PDX-License-Identifier: Apache-2.0
+ */
+
+package io.openapiprocessor.core.parser
+
+import io.kotest.core.spec.style.FreeSpec
+import io.kotest.datatest.withData
+import io.kotest.matchers.shouldBe
+
+class RefNameSpec : FreeSpec({
+
+    data class TestCase(val ref: String, val expected: String)
+
+    withData(
+        nameFn = { "${it.ref} -> ${it.expected}" },
+        listOf(
+            TestCase("foo.yaml#/Foo", "Foo"),
+            TestCase("components/schemas/foo.yaml#/Foo", "Foo"),
+            TestCase("Foo.yaml", "Foo"),
+            TestCase("components/schemas/Foo.yaml", "Foo"),
+            TestCase("Foo.yml", "Foo"),
+            TestCase("components/schemas/Foo.yml", "Foo"),
+            TestCase("Foo", "Foo"),
+            TestCase("components/schemas/Foo", "Foo")
+        )
+    ) { (ref, expected) ->
+        getRefName(ref) shouldBe expected
+    }
+})