refactor(commands)!: Migrate command plugins to new plugin API

Migrate the command plugins to the new plugin API. Relates to #9403. Signed-off-by: Martin Nonnenmacher <martin.nonnenmacher@bosch.com>
oss-review-toolkit · Dec 8, 2024 · 2e60641 · 2e60641
1 parent ef538ee
commit 2e60641
Show file tree

Hide file tree

Showing 32 changed files with 234 additions and 86 deletions.
diff --git a/cli/src/main/kotlin/OrtMain.kt b/cli/src/main/kotlin/OrtMain.kt
@@ -48,7 +48,8 @@ import kotlin.system.exitProcess
 
 import org.ossreviewtoolkit.model.config.LicenseFilePatterns
 import org.ossreviewtoolkit.model.config.OrtConfiguration
-import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.api.PluginConfig
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.utils.common.EnvironmentVariableFilter
 import org.ossreviewtoolkit.utils.common.MaskedString
 import org.ossreviewtoolkit.utils.common.Os
@@ -123,7 +124,8 @@ class OrtMain : CliktCommand(ORT_NAME) {
             helpFormatter = { MordantHelpFormatter(context = it, REQUIRED_OPTION_MARKER, showDefaultValues = true) }
         }
 
-        subcommands(OrtCommand.ALL.values)
+        // Pass an empty PluginConfig here as commands are not configurable.
+        subcommands(OrtCommandFactory.ALL.map { (_, factory) -> factory.create(PluginConfig()) })
 
         versionOption(
             version = env.ortVersion,

diff --git a/plugins/commands/advisor/build.gradle.kts b/plugins/commands/advisor/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.advisor)
     implementation(projects.model)
     implementation(projects.utils.commonUtils)

diff --git a/plugins/commands/advisor/src/main/kotlin/AdvisorCommand.kt b/plugins/commands/advisor/src/main/kotlin/AdvisorCommand.kt
@@ -45,7 +45,10 @@ import org.ossreviewtoolkit.advisor.Advisor
 import org.ossreviewtoolkit.model.FileFormat
 import org.ossreviewtoolkit.model.utils.DefaultResolutionProvider
 import org.ossreviewtoolkit.model.utils.mergeLabels
+import org.ossreviewtoolkit.plugins.api.OrtPlugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.plugins.commands.api.utils.SeverityStatsPrinter
 import org.ossreviewtoolkit.plugins.commands.api.utils.configurationGroup
 import org.ossreviewtoolkit.plugins.commands.api.utils.outputGroup
@@ -57,10 +60,13 @@ import org.ossreviewtoolkit.utils.ort.ORT_FAILURE_STATUS_CODE
 import org.ossreviewtoolkit.utils.ort.ORT_RESOLUTIONS_FILENAME
 import org.ossreviewtoolkit.utils.ort.ortConfigDirectory
 
-class AdvisorCommand : OrtCommand(
-    name = "advise",
-    help = "Check dependencies for security vulnerabilities."
-) {
+@OrtPlugin(
+    id = "advise",
+    displayName = "advise command",
+    description = "Check dependencies for security vulnerabilities.",
+    factory = OrtCommandFactory::class
+)
+class AdvisorCommand(descriptor: PluginDescriptor = AdvisorCommandFactory.descriptor) : OrtCommand(descriptor) {
     private val ortFile by option(
         "--ort-file", "-i",
         help = "An ORT result file with an analyzer result to use."

diff --git a/plugins/commands/analyzer/build.gradle.kts b/plugins/commands/analyzer/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.plugins.packageCurationProviders.packageCurationProviderApi)
 
     implementation(projects.analyzer)

diff --git a/plugins/commands/analyzer/src/main/kotlin/AnalyzerCommand.kt b/plugins/commands/analyzer/src/main/kotlin/AnalyzerCommand.kt
@@ -47,7 +47,10 @@ import org.ossreviewtoolkit.model.config.RepositoryConfiguration
 import org.ossreviewtoolkit.model.readValueOrNull
 import org.ossreviewtoolkit.model.utils.DefaultResolutionProvider
 import org.ossreviewtoolkit.model.utils.mergeLabels
+import org.ossreviewtoolkit.plugins.api.OrtPlugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.plugins.commands.api.utils.SeverityStatsPrinter
 import org.ossreviewtoolkit.plugins.commands.api.utils.configurationGroup
 import org.ossreviewtoolkit.plugins.commands.api.utils.inputGroup
@@ -62,10 +65,13 @@ import org.ossreviewtoolkit.utils.ort.ORT_REPO_CONFIG_FILENAME
 import org.ossreviewtoolkit.utils.ort.ORT_RESOLUTIONS_FILENAME
 import org.ossreviewtoolkit.utils.ort.ortConfigDirectory
 
-class AnalyzerCommand : OrtCommand(
-    name = "analyze",
-    help = "Determine dependencies of a software project."
-) {
+@OrtPlugin(
+    id = "analyze",
+    displayName = "analyze command",
+    description = "Determine dependencies of a software project.",
+    factory = OrtCommandFactory::class
+)
+class AnalyzerCommand(descriptor: PluginDescriptor = AnalyzerCommandFactory.descriptor) : OrtCommand(descriptor) {
     private val inputDir by option(
         "--input-dir", "-i",
         help = "The project directory to analyze. May point to a definition file if only a single package manager is " +

diff --git a/plugins/commands/api/build.gradle.kts b/plugins/commands/api/build.gradle.kts
@@ -24,7 +24,7 @@ plugins {
 
 dependencies {
     api(projects.model)
-    api(projects.utils.commonUtils)
+    api(projects.plugins.api)
 
     api(libs.clikt)
 

diff --git a/plugins/commands/api/src/main/kotlin/OrtCommand.kt b/plugins/commands/api/src/main/kotlin/OrtCommand.kt
@@ -27,23 +27,15 @@ import com.github.ajalt.clikt.core.requireObject
 import java.io.File
 
 import org.ossreviewtoolkit.model.config.OrtConfiguration
-import org.ossreviewtoolkit.utils.common.Plugin
+import org.ossreviewtoolkit.plugins.api.Plugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.utils.ort.ORT_CONFIG_FILENAME
 
 /**
- * An interface for [CliktCommand]-based ORT commands that come as named plugins.
+ * An interface for [CliktCommand]-based ORT commands that come as [Plugin]s.
  */
-abstract class OrtCommand(name: String, private val help: String) : CliktCommand(name), Plugin {
-    companion object {
-        /**
-         * All [ORT commands][OrtCommand] available in the classpath, associated by their names.
-         */
-        val ALL by lazy { Plugin.getAll<OrtCommand>() }
-    }
-
-    override val type = commandName
-
-    override fun help(context: Context) = help
+abstract class OrtCommand(override val descriptor: PluginDescriptor) : CliktCommand(descriptor.id), Plugin {
+    override fun help(context: Context) = descriptor.description
 
     protected val ortConfig by requireObject<OrtConfiguration>()
 

diff --git a/plugins/commands/api/src/main/kotlin/OrtCommandFactory.kt b/plugins/commands/api/src/main/kotlin/OrtCommandFactory.kt
@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2024 The ORT Project Authors (see <https://github.com/oss-review-toolkit/ort/blob/main/NOTICE>)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ * License-Filename: LICENSE
+ */
+
+package org.ossreviewtoolkit.plugins.commands.api
+
+import org.ossreviewtoolkit.plugins.api.PluginFactory
+
+/**
+ * A factory interface for creating [OrtCommand] instances.
+ */
+interface OrtCommandFactory : PluginFactory<OrtCommand> {
+    companion object {
+        /**
+         * All [ORT command factories][OrtCommandFactory] available in the classpath, associated by their ids.
+         */
+        val ALL by lazy { PluginFactory.getAll<OrtCommandFactory, OrtCommand>() }
+    }
+}
diff --git a/plugins/commands/compare/build.gradle.kts b/plugins/commands/compare/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.model)
     implementation(projects.utils.commonUtils)
 

diff --git a/plugins/commands/compare/src/main/kotlin/CompareCommand.kt b/plugins/commands/compare/src/main/kotlin/CompareCommand.kt
@@ -43,15 +43,21 @@ import java.time.Instant
 
 import org.ossreviewtoolkit.model.OrtResult
 import org.ossreviewtoolkit.model.mapper
+import org.ossreviewtoolkit.plugins.api.OrtPlugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.utils.common.expandTilde
 import org.ossreviewtoolkit.utils.common.getCommonParentFile
 import org.ossreviewtoolkit.utils.ort.Environment
 
-class CompareCommand : OrtCommand(
-    name = "compare",
-    help = "Compare two ORT results with various methods."
-) {
+@OrtPlugin(
+    id = "compare",
+    displayName = "compare command",
+    description = "Compare two ORT results with various methods.",
+    factory = OrtCommandFactory::class
+)
+class CompareCommand(descriptor: PluginDescriptor = CompareCommandFactory.descriptor) : OrtCommand(descriptor) {
     private enum class CompareMethod { SEMANTIC_DIFF, TEXT_DIFF }
 
     private val fileA by argument(help = "The first ORT result file to compare.")

diff --git a/plugins/commands/config/build.gradle.kts b/plugins/commands/config/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.model)
     implementation(projects.utils.commonUtils)
 

diff --git a/plugins/commands/config/src/main/kotlin/ConfigCommand.kt b/plugins/commands/config/src/main/kotlin/ConfigCommand.kt
@@ -31,15 +31,21 @@ import com.github.ajalt.mordant.rendering.Theme
 
 import org.ossreviewtoolkit.model.config.OrtConfiguration
 import org.ossreviewtoolkit.model.config.OrtConfigurationWrapper
+import org.ossreviewtoolkit.plugins.api.OrtPlugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.utils.common.collectMessages
 import org.ossreviewtoolkit.utils.common.expandTilde
 import org.ossreviewtoolkit.utils.ort.ORT_REFERENCE_CONFIG_FILENAME
 
-class ConfigCommand : OrtCommand(
-    name = "config",
-    help = "Show different ORT configurations."
-) {
+@OrtPlugin(
+    id = "config",
+    displayName = "config command",
+    description = "Show different ORT configurations.",
+    factory = OrtCommandFactory::class
+)
+class ConfigCommand(descriptor: PluginDescriptor = ConfigCommandFactory.descriptor) : OrtCommand(descriptor) {
     private val showDefault by option(
         "--show-default",
         help = "Show the default configuration used when no custom configuration is present."

diff --git a/plugins/commands/downloader/build.gradle.kts b/plugins/commands/downloader/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.downloader)
     implementation(projects.model)
     implementation(projects.utils.commonUtils)

diff --git a/plugins/commands/downloader/src/main/kotlin/DownloaderCommand.kt b/plugins/commands/downloader/src/main/kotlin/DownloaderCommand.kt
@@ -82,7 +82,10 @@ import org.ossreviewtoolkit.model.licenses.LicenseView
 import org.ossreviewtoolkit.model.licenses.ResolvedLicenseInfo
 import org.ossreviewtoolkit.model.readValue
 import org.ossreviewtoolkit.model.utils.createLicenseInfoResolver
+import org.ossreviewtoolkit.plugins.api.OrtPlugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.plugins.commands.api.utils.GroupTypes.FileType
 import org.ossreviewtoolkit.plugins.commands.api.utils.GroupTypes.StringType
 import org.ossreviewtoolkit.plugins.commands.api.utils.OPTION_GROUP_INPUT
@@ -102,10 +105,13 @@ import org.ossreviewtoolkit.utils.ort.ortConfigDirectory
 import org.ossreviewtoolkit.utils.ort.showStackTrace
 import org.ossreviewtoolkit.utils.spdx.SpdxLicenseChoice
 
-class DownloaderCommand : OrtCommand(
-    name = "download",
-    help = "Fetch source code from a remote location."
-) {
+@OrtPlugin(
+    id = "download",
+    displayName = "download command",
+    description = "Fetch source code from a remote location.",
+    factory = OrtCommandFactory::class
+)
+class DownloaderCommand(descriptor: PluginDescriptor = DownloaderCommandFactory.descriptor) : OrtCommand(descriptor) {
     private val input by mutuallyExclusiveOptions(
         option(
             "--ort-file", "-i",

diff --git a/plugins/commands/evaluator/build.gradle.kts b/plugins/commands/evaluator/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.plugins.packageConfigurationProviders.packageConfigurationProviderApi)
     implementation(projects.plugins.packageCurationProviders.packageCurationProviderApi)
 

diff --git a/plugins/commands/evaluator/src/main/kotlin/EvaluatorCommand.kt b/plugins/commands/evaluator/src/main/kotlin/EvaluatorCommand.kt
@@ -57,7 +57,10 @@ import org.ossreviewtoolkit.model.readValue
 import org.ossreviewtoolkit.model.readValueOrDefault
 import org.ossreviewtoolkit.model.utils.DefaultResolutionProvider
 import org.ossreviewtoolkit.model.utils.mergeLabels
+import org.ossreviewtoolkit.plugins.api.OrtPlugin
+import org.ossreviewtoolkit.plugins.api.PluginDescriptor
 import org.ossreviewtoolkit.plugins.commands.api.OrtCommand
+import org.ossreviewtoolkit.plugins.commands.api.OrtCommandFactory
 import org.ossreviewtoolkit.plugins.commands.api.utils.SeverityStatsPrinter
 import org.ossreviewtoolkit.plugins.commands.api.utils.configurationGroup
 import org.ossreviewtoolkit.plugins.commands.api.utils.inputGroup
@@ -81,10 +84,13 @@ import org.ossreviewtoolkit.utils.ort.ORT_LICENSE_CLASSIFICATIONS_FILENAME
 import org.ossreviewtoolkit.utils.ort.ORT_RESOLUTIONS_FILENAME
 import org.ossreviewtoolkit.utils.ort.ortConfigDirectory
 
-class EvaluatorCommand : OrtCommand(
-    name = "evaluate",
-    help = "Evaluate ORT result files against policy rules."
-) {
+@OrtPlugin(
+    id = "evaluate",
+    displayName = "evaluate command",
+    description = "Evaluate ORT result files against policy rules.",
+    factory = OrtCommandFactory::class
+)
+class EvaluatorCommand(descriptor: PluginDescriptor = EvaluatorCommandFactory.descriptor) : OrtCommand(descriptor) {
     private val ortFile by option(
         "--ort-file", "-i",
         help = "The ORT result file to read as input."

diff --git a/plugins/commands/migrate/build.gradle.kts b/plugins/commands/migrate/build.gradle.kts
@@ -19,12 +19,14 @@
 
 plugins {
     // Apply precompiled plugins.
-    id("ort-library-conventions")
+    id("ort-plugin-conventions")
 }
 
 dependencies {
     api(projects.plugins.commands.commandApi)
 
+    ksp(projects.plugins.commands.commandApi)
+
     implementation(projects.plugins.packageCurationProviders.ortConfigPackageCurationProvider)
     implementation(projects.plugins.packageManagers.nugetPackageManager)
     implementation(projects.utils.commonUtils)