enh(api-gen): generate kdoc from api json (#534)

* enh(api-gen): generate kdoc from api json

Author: piiertho

kt/api-generator/src/main/kotlin/godot/codegen/constants/JvmReservedMethods.kt

@@ -14,7 +14,9 @@ val jvmReservedMethods = listOf(
             hashCompatibility = listOf(),
             returnValue = null,
             returnType = null,
-            arguments = null
+            arguments = null,
+            description = null,
+            briefDescription = null
         ),
         ""
     )

kt/api-generator/src/main/kotlin/godot/codegen/generationEntry.kt

@@ -11,19 +11,16 @@ import godot.codegen.repositories.*
 import godot.codegen.repositories.impl.*
 import godot.codegen.services.*
 import godot.codegen.services.impl.*
-import godot.docgen.DocGen
 import godot.tools.common.constants.GENERATED_COMMENT
 import java.io.File
 
 fun File.generateApiFrom(jsonSource: File, docsDir: File? = null) {
-    val classDocs = docsDir?.let { DocGen.deserializeDoc(it) } ?: mapOf()
     val apiDescription = ObjectMapper().readValue(jsonSource, object : TypeReference<ApiDescription>() {})
 
     val classRepository: ClassRepository = JsonClassRepository(apiDescription.classes.toEnriched())
     val singletonRepository: SingletonRepository = JsonSingletonRepository(apiDescription.singletons.toEnriched())
     val globalEnumRepository: GlobalEnumRepository = JsonGlobalEnumRepository(apiDescription.globalEnums.toEnriched())
     val coreTypeEnumRepository: CoreTypeEnumRepository = KnownCoreTypeEnumRepository()
-    val docRepository: IDocRepository = DocRepository(classDocs)
     val nativeStructureRepository = NativeStructureRepository(apiDescription.nativeStructures.toEnriched())
 
     val classGraphService: IClassGraphService = ClassGraphService(classRepository)
@@ -33,7 +30,7 @@ fun File.generateApiFrom(jsonSource: File, docsDir: File? = null) {
         classGraphService
     )
     val enumService: IEnumService = EnumService(globalEnumRepository, coreTypeEnumRepository, classService)
-    val generationService: IGenerationService = GenerationService(docRepository, classGraphService, enumService, nativeStructureRepository)
+    val generationService: IGenerationService = GenerationService(classGraphService, enumService, nativeStructureRepository)
 
     classService.findGetSetMethodsAndUpdateProperties()
 

kt/api-generator/src/main/kotlin/godot/codegen/models/BuiltinClass.kt

@@ -13,5 +13,7 @@ data class BuiltinClass @JsonCreator constructor (
     @JsonProperty("members") val members: List<Member>?,
     @JsonProperty("constants") val constants: List<Constant>?,
     @JsonProperty("enums") val enums: List<Enum>?,
-    @JsonProperty("indexing_return_type") val indexingReturnType: String?
+    @JsonProperty("indexing_return_type") val indexingReturnType: String?,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 )

kt/api-generator/src/main/kotlin/godot/codegen/models/Class.kt

@@ -13,7 +13,9 @@ data class Class @JsonCreator constructor (
     @JsonProperty("methods") val methods : List<Method>?,
     @JsonProperty("properties") val properties: List<Property>?,
     @JsonProperty("constants") val constants: List<Constant>?,
-    @JsonProperty("signals") val signals : List<Signal>?
+    @JsonProperty("signals") val signals : List<Signal>?,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 ) {
     fun copy(newName: String) = Class(
         newName,
@@ -25,6 +27,8 @@ data class Class @JsonCreator constructor (
         methods,
         properties,
         constants,
-        signals
+        signals,
+        description,
+        briefDescription
     )
 }

kt/api-generator/src/main/kotlin/godot/codegen/models/Constant.kt

@@ -7,5 +7,7 @@ import godot.codegen.traits.TypedTrait
 data class Constant @JsonCreator constructor(
     @JsonProperty("name") val name: String,
     @JsonProperty("type") val type: String?,
-    @JsonProperty("value") val value: String
+    @JsonProperty("value") val value: String,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 )

kt/api-generator/src/main/kotlin/godot/codegen/models/Constructor.kt

@@ -5,5 +5,7 @@ import com.fasterxml.jackson.annotation.JsonProperty
 
 data class Constructor @JsonCreator constructor (
 	@JsonProperty("index") val index : Int,
-    @JsonProperty("arguments") val arguments: List<Argument>?
+    @JsonProperty("arguments") val arguments: List<Argument>?,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 )

kt/api-generator/src/main/kotlin/godot/codegen/models/EnumValue.kt

@@ -2,8 +2,10 @@ package godot.codegen.models
 
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import godot.codegen.traits.IDocumented
 
 data class EnumValue @JsonCreator constructor(
     @JsonProperty("name") val name : String,
-    @JsonProperty("value") val value : Long
-)
+    @JsonProperty("value") val value : Long,
+    @JsonProperty("description") override val description: String? = null
+) : IDocumented

kt/api-generator/src/main/kotlin/godot/codegen/models/Member.kt

@@ -6,5 +6,7 @@ import godot.codegen.traits.TypedTrait
 
 data class Member @JsonCreator constructor(
     @JsonProperty("name") val name: String,
-    @JsonProperty("type") override val type: String
+    @JsonProperty("type") override val type: String,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 ) : TypedTrait

kt/api-generator/src/main/kotlin/godot/codegen/models/Method.kt

@@ -13,5 +13,7 @@ data class Method @JsonCreator constructor(
     @JsonProperty("hash_compatibility") val hashCompatibility: List<Long>?,
     @JsonProperty("return_value") val returnValue : ReturnValue?,
     @JsonProperty("return_type") val returnType: String?,
-    @JsonProperty("arguments") val arguments : List<Argument>?
+    @JsonProperty("arguments") val arguments : List<Argument>?,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 )

kt/api-generator/src/main/kotlin/godot/codegen/models/Operator.kt

@@ -2,9 +2,12 @@ package godot.codegen.models
 
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import godot.codegen.traits.IDocumented
 
 data class Operator @JsonCreator constructor(
     @JsonProperty("name") val name : String,
     @JsonProperty("right_type") val rightType : String?,
-    @JsonProperty("return_type") val returnType : String
+    @JsonProperty("return_type") val returnType : String,
+    @JsonProperty("description") val description: String?,
+    @JsonProperty("brief_description") val briefDescription: String?
 )