feat: 新增一个新的组 love.forte.simbot.processor, 以及其中一个新的用于组件开发的ksp处理器 simbot-processor-message-element-polymorphic-include

Author: ForteScarlet

buildSrc/build.gradle.kts

@@ -37,6 +37,7 @@ val kotlinVersion: String = libs.versions.kotlin.get()
 dependencies {
     implementation(kotlin("gradle-plugin", kotlinVersion))
     implementation(kotlin("serialization", kotlinVersion))
+    implementation(kotlin("power-assert", kotlinVersion))
     implementation(libs.bundles.dokka)
 
     // see https://github.com/gradle-nexus/publish-plugin

buildSrc/src/main/kotlin/P.kt

@@ -64,6 +64,7 @@ sealed class P(override val group: String) : ProjectDetail() {
         const val GROUP_QUANTCAT = "love.forte.simbot.quantcat"
         const val GROUP_EXTENSION = "love.forte.simbot.extension"
         const val GROUP_BENCHMARK = "love.forte.simbot.benchmark"
+        const val GROUP_PROCESSOR = "love.forte.simbot.processor"
 
         // const val COMPONENT_GROUP = "love.forte.simbot.component"
         const val DESCRIPTION = "Simple Robot，一个通用的bot风格事件调度框架，以灵活的统一标准来编写bot应用。"

settings.gradle.kts

@@ -42,6 +42,9 @@ include(":internal-processors:interface-uml-processor")
 // gradle
 include(":simbot-gradles:simbot-gradle-suspendtransforms")
 
+// processors
+include("simbot-processors:simbot-processor-message-element-polymorphic-include")
+
 include(":simbot-commons:simbot-common-annotations")
 include(":simbot-commons:simbot-common-collection")
 include(":simbot-commons:simbot-common-streamable")

simbot-api/build.gradle.kts

@@ -21,6 +21,7 @@
  *
  */
 
+import com.google.devtools.ksp.gradle.KspTaskMetadata
 import love.forte.gradle.common.kotlin.multiplatform.applyTier1
 import love.forte.gradle.common.kotlin.multiplatform.applyTier2
 import love.forte.gradle.common.kotlin.multiplatform.applyTier3
@@ -136,6 +137,7 @@ kotlin {
 dependencies {
     // add("kspJvm", libs.suspend.reversal.processor)
     add("kspJvm", project(":internal-processors:interface-uml-processor"))
+    add("kspCommonMainMetadata", project(":simbot-processors:simbot-processor-message-element-polymorphic-include"))
 }
 
 ksp {
@@ -145,6 +147,19 @@ ksp {
     // arg("simbot.internal.processor.uml.target", "love.forte.simbot.definition.Actor")
     arg("simbot.internal.processor.uml.output", rootDir.resolve("generated-docs/event-uml.md").absolutePath)
     // arg("simbot.internal.processor.uml.output", rootDir.resolve("generated-docs/actor-uml.md").absolutePath)
+
+    // simbot-processor-message-element-polymorphic-include
+    arg("simbot.processor.message-element-polymorphic-include.localOnly", "true")
+    arg("simbot.processor.message-element-polymorphic-include.outputPackage", "love.forte.simbot.message")
+    arg("simbot.processor.message-element-polymorphic-include.visibility", "internal")
+}
+
+kotlin.sourceSets.commonMain {
+    // solves all implicit dependency trouble and IDEs source code detection
+    // see https://github.com/google/ksp/issues/963#issuecomment-1894144639
+    tasks.withType<KspTaskMetadata> {
+        kotlin.srcDir(destinationDirectory.file("kotlin"))
+    }
 }
 
 // BuildConfig for the current version

simbot-api/src/commonMain/kotlin/love/forte/simbot/message/Messages.kt

@@ -37,7 +37,6 @@ import kotlinx.serialization.json.Json
 import kotlinx.serialization.modules.PolymorphicModuleBuilder
 import kotlinx.serialization.modules.SerializersModule
 import kotlinx.serialization.modules.polymorphic
-import kotlinx.serialization.modules.subclass
 import love.forte.simbot.message.MessagesBuilder.Companion.create
 import kotlin.jvm.JvmMultifileClass
 import kotlin.jvm.JvmName
@@ -95,19 +94,7 @@ public sealed interface Messages : Message, Iterable<Message.Element> {
         @get:JvmName("standardSerializersModule")
         public val standardSerializersModule: SerializersModule = SerializersModule {
             polymorphic(Message.Element::class) {
-                subclass(Text.serializer())
-                subclass(At.serializer())
-                subclass(AtAll.serializer())
-                // images
-                subclass(OfflineByteArrayImage.serializer())
-                subclass(SimpleOfflineResourceImage.serializer())
-                subclass(RemoteIDImage.serializer())
-
-                subclass(Emoji.serializer())
-                subclass(Face.serializer())
-                subclass(MessageIdReference.serializer())
-
-
+                includeMessageElementPolymorphic()
                 resolvePlatformStandardSerializers()
             }
         }

simbot-processors/build.gradle.kts

@@ -0,0 +1,26 @@
+/*
+ *     Copyright (c) 2024. ForteScarlet.
+ *
+ *     Project    https://github.com/simple-robot/simpler-robot
+ *     Email      [email protected]
+ *
+ *     This file is part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU Lesser General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     Lesser GNU General Public License for more details.
+ *
+ *     You should have received a copy of the Lesser GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
+
+subprojects {
+    group = P.GROUP_PROCESSOR
+}

simbot-processors/simbot-processor-message-element-polymorphic-include/README.md

@@ -0,0 +1,34 @@
+# Message element polymorphic include
+
+为所有 `Message.Element` (或某个指定子类) 生成一个注册多态序列化信息的聚合函数的 KSP 处理器，
+常用于组件开发等场景。
+
+```kotlin
+// 生成类似于如下的API
+internal fun PolymorphicModuleBuilder<Message.Element>.includeElements() {
+    subclass(...)
+    subclass(...)
+    subclass(...)
+}
+
+```
+
+会寻找指定的类型的所有**非抽象**、**非接口**、且标记了 `kotlinx.serialization.Serializable` 注解的子类。
+
+可选配置项：
+
+```kotlin
+// 选项参数以 `simbot.processor.message-element-polymorphic-include` 开头
+ksp {
+    // 是否启用
+    arg("simbot.processor.message-element-polymorphic-include.enable", "true")
+    arg("simbot.processor.message-element-polymorphic-include.localOnly", "false")
+    arg("simbot.processor.message-element-polymorphic-include.baseClass", "love.forte.simbot.message.Message.Element")
+    arg("simbot.processor.message-element-polymorphic-include.visibility", "internal") // 默认 internal 可选: public, internal
+    arg("simbot.processor.message-element-polymorphic-include.generateFunName", "includeMessageElementPolymorphic")
+    arg("simbot.processor.message-element-polymorphic-include.outputPackage", "love.forte.simbot.message") // 默认为 null，如果不提供（不是空字符串哦）则与 baseClass 同包
+    arg("simbot.processor.message-element-polymorphic-include.outputFileName", "MessageElementPolymorphicInclude.generated")
+    arg("simbot.processor.message-element-polymorphic-include.outputFileJvmName", "") // 默认 null
+    arg("simbot.processor.message-element-polymorphic-include.outputFileJvmMultifile", "false") // 默认 false
+}
+```

simbot-processors/simbot-processor-message-element-polymorphic-include/build.gradle.kts

@@ -0,0 +1,47 @@
+/*
+ *     Copyright (c) 2024. ForteScarlet.
+ *
+ *     Project    https://github.com/simple-robot/simpler-robot
+ *     Email      [email protected]
+ *
+ *     This file is part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU Lesser General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     Lesser GNU General Public License for more details.
+ *
+ *     You should have received a copy of the Lesser GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
+
+plugins {
+    kotlin("jvm")
+    id("simbot.dokka-module-configuration")
+    kotlin("plugin.serialization")
+}
+
+configJavaCompileWithModule()
+apply(plugin = "simbot-jvm-maven-publish")
+
+kotlin {
+    explicitApi()
+    configKotlinJvm(JVMConstants.KT_JVM_TARGET_VALUE)
+}
+
+dependencies {
+    implementation(libs.ksp)
+    implementation(libs.kotlinPoet.ksp)
+    implementation(libs.kotlinx.serialization.core)
+    implementation(libs.kotlinx.serialization.properties)
+}
+
+tasks.getByName<Test>("test") {
+    useJUnitPlatform()
+}

simbot-processors/simbot-processor-message-element-polymorphic-include/src/main/kotlin/love/forte/simbot/processor/message/element/polymorphic/include/MessageElementPolymorphicIncludeConfiguration.kt

@@ -0,0 +1,60 @@
+/*
+ *     Copyright (c) 2024. ForteScarlet.
+ *
+ *     Project    https://github.com/simple-robot/simpler-robot
+ *     Email      [email protected]
+ *
+ *     This file is part of the Simple Robot Library (Alias: simple-robot, simbot, etc.).
+ *
+ *     This program is free software: you can redistribute it and/or modify
+ *     it under the terms of the GNU Lesser General Public License as published by
+ *     the Free Software Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
+ *
+ *     This program is distributed in the hope that it will be useful,
+ *     but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *     Lesser GNU General Public License for more details.
+ *
+ *     You should have received a copy of the Lesser GNU General Public License
+ *     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
+
+package love.forte.simbot.processor.message.element.polymorphic.include
+
+import com.squareup.kotlinpoet.KModifier
+import kotlinx.serialization.Serializable
+
+
+/**
+ * configurations for [MessageElementPolymorphicIncludeProcessor].
+ *
+ * @author ForteScarlet
+ */
+@Serializable
+public open class MessageElementPolymorphicIncludeConfiguration {
+    public open var baseClass: String = "love.forte.simbot.message.Message.Element"
+    public open var enable: Boolean = true
+    public open var localOnly: Boolean = false
+    public open var visibility: String = "internal"
+    public open var generateFunName: String = "includeMessageElementPolymorphic"
+    public open var outputPackage: String? = null
+    public open var outputFileName: String = "MessageElementPolymorphicInclude.generated"
+    public open var outputFileJvmName: String? = null
+    public open var outputFileJvmMultifile: Boolean = false
+
+    public open fun visibilityValue(): KModifier {
+        return when {
+            visibility.equals("internal", ignoreCase = true) -> KModifier.INTERNAL
+            visibility.equals("public", ignoreCase = true) -> KModifier.PUBLIC
+            else -> throw IllegalArgumentException("Unknown visibility: $visibility, not in ['internal', 'public']")
+        }
+    }
+
+    public companion object {
+        public const val CONFIG_PREFIX: String = "simbot.processor.message-element-polymorphic-include"
+
+    }
+}
+