✨ BOM support (#239)

Fixes #225 

I avoided rolling this out more extensively because I anticipate this
use case is far more common with test plugins compared to others - but
we now have more escape hatches for users and can monitor use cases as
we go

Author: ryandens

README.md

@@ -13,6 +13,31 @@ development and/or in production
 
 > The work on this software project is in no way associated with my employer nor with the role I'm having at my employer. Any requests for changes will be decided upon exclusively by myself based on my personal preferences. I maintain this project as much or as little as my spare time permits.
 
+## Mockito Example
+
+The Java community is quickly preparing for upcoming JDK restrictions that will improve the security and stability of the java community. One of these restrictions is the removal of the ability to self-attach javaagents.
+
+You may have come across this plugin because you encountered the following message in your build:
+> Mockito is currently self-attaching to enable the inline-mock-maker. This will no longer work in future releases of the JDK. Please add Mockito as an agent to your build as described in Mockito's documentation: https://javadoc.io/doc/org.mockito/mockito-core/latest/org.mockito/org/mockito/Mockito.html#0.3
+
+This plugin enables you to quickly and easily resolve these constraints by adding the Mockito agent to your build as a javaagent, while maintaining compatability with the Gradle concepts such as up to date checks, test task caching, and configuration caching.
+
+
+```kotlin
+plugins {
+    java
+    id("com.ryandens.javaagent-application") version "0.9.0"
+}
+
+dependencies {
+    testImplementation(platform("org.mockito:mockito-bom:5.18.0"))
+    testImplementation("org.mockito:mockito-core")
+    testJavaagent("org.mockito:mockito-core")
+}
+```
+
+> ℹ️ **Note:** The [Javaagent Test Plugin](#java-test-task-integration) automatically resolves dependency versions for javaagents dependencies that did not request one from the test runtime classpath. 
+
 ## Application Plugin integration
 
 This Gradle plugin tightly integrates with the [Gradle application plugin](https://docs.gradle.org/current/userguide/application_plugin.html) 
@@ -22,7 +47,7 @@ then specify the javaagent you would like to attach in the dependencies block
 ```kotlin
 plugins {
     application
-    id("com.ryandens.javaagent-application") version "0.6.1"
+    id("com.ryandens.javaagent-application") version "0.9.0"
 }
 
 application {
@@ -52,7 +77,7 @@ would like to attach in the dependencies block.
 plugins {
     java
     id("com.google.cloud.tools.jib") version "3.1.4"
-    id("com.ryandens.javaagent-jib") version "0.6.1"
+    id("com.ryandens.javaagent-jib") version "0.9.0"
 }
 
 jib.container {
@@ -75,7 +100,7 @@ Testing (IAST) product.
 ```kotlin
 plugins {
     java
-    id("com.ryandens.javaagent-test") version "0.6.1"
+    id("com.ryandens.javaagent-test") version "0.9.0"
 }
 
 tasks.named<Test>("test") {
@@ -112,8 +137,8 @@ desired application distribution or execution method.
 ```kotlin
 plugins {
   application
-  id("com.ryandens.javaagent-otel-modification") version "0.6.1"
-  id("com.ryandens.javaagent-application") version "0.6.1"
+  id("com.ryandens.javaagent-otel-modification") version "0.9.0"
+  id("com.ryandens.javaagent-application") version "0.9.0"
 }
 
 dependencies {

example-projects/buildSrc/build.gradle.kts

@@ -8,8 +8,8 @@ repositories {
 }
 dependencies {
     /* uncomment when doing local testing on this project, leave commented out for functional test to resolve latest plugin
-    implementation("com.ryandens:otel:0.6.1")
-    implementation("com.ryandens:plugin:0.6.1")
+    implementation("com.ryandens:otel:0.9.0")
+    implementation("com.ryandens:plugin:0.9.0")
     */
     implementation("io.opentelemetry.instrumentation.muzzle-generation:io.opentelemetry.instrumentation.muzzle-generation.gradle.plugin:2.8.0-alpha")
     implementation("io.opentelemetry.instrumentation.muzzle-check:io.opentelemetry.instrumentation.muzzle-check.gradle.plugin:2.8.0-alpha")

gradle.properties

@@ -5,5 +5,5 @@ org.gradle.jvmargs=--add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAME
   --add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED
 org.gradle.configuration-cache=true
 org.gradle.caching=true
-version=0.8.0
+version=0.9.0
 group=com.ryandens

plugin/src/main/kotlin/com/ryandens/javaagent/JavaagentTestPlugin.kt

@@ -1,5 +1,6 @@
 package com.ryandens.javaagent
 
+import com.ryandens.javaagent.utils.JavaagentVersionUtil
 import org.gradle.api.NamedDomainObjectProvider
 import org.gradle.api.Plugin
 import org.gradle.api.Project
@@ -27,6 +28,18 @@ class JavaagentTestPlugin :
                 // we expect javaagents to come as shaded JARs
                 it.isTransitive = false
                 it.extendsFrom(javaagentConfiguration.get())
+                it.resolutionStrategy { strategy ->
+                    strategy.eachDependency { dep ->
+                        if (dep.requested.version.isNullOrBlank()) {
+                            dep.useVersion(
+                                JavaagentVersionUtil.versionFromDependencyAndConfiguration(
+                                    dep.requested,
+                                    project.configurations.named("testRuntimeClasspath"),
+                                ),
+                            )
+                        }
+                    }
+                }
             }
 
         val extension = project.extensions.create("javaagentTest", JavaagentTestExtension::class.java)

plugin/src/main/kotlin/com/ryandens/javaagent/utils/JavaagentVersionUtil.kt

@@ -0,0 +1,45 @@
+package com.ryandens.javaagent.utils
+
+import org.gradle.api.NamedDomainObjectProvider
+import org.gradle.api.artifacts.Configuration
+import org.gradle.api.artifacts.ModuleVersionSelector
+import org.gradle.api.artifacts.component.ModuleComponentIdentifier
+
+/**
+ * Utility class for determining the version of a dependency in the javaagent configuration from other configurations
+ */
+object JavaagentVersionUtil {
+    /**
+     * Determines the version of a dependency in the javaagent configuration from another configuration based on the
+     * requested [ModuleVersionSelector] and the provided [NamedDomainObjectProvider] of [Configuration]s to search.
+     *
+     * @param requested the requested dependency
+     * @param configuration the configuration to search
+     * @return the version of the dependency to use in the javaagent configuration
+     */
+    fun versionFromDependencyAndConfiguration(
+        requested: ModuleVersionSelector,
+        configuration: NamedDomainObjectProvider<Configuration>,
+    ): String {
+        val artifacts =
+            configuration
+                .get()
+                .incoming
+                .artifactView { viewConfiguration ->
+                    viewConfiguration.componentFilter {
+                        it.displayName.startsWith("${requested.group}:${requested.name}:")
+                    }
+                }.artifacts
+
+        if (artifacts.count() == 0) {
+            throw IllegalArgumentException(
+                "No artifacts found for ${requested.group}:${requested.name} in configuration ${configuration.name}",
+            )
+        } else if (artifacts.count() > 1) {
+            throw IllegalArgumentException(
+                "Multiple artifacts found for ${requested.group}:${requested.name} in configuration ${configuration.name}",
+            )
+        }
+        return (artifacts.single().id.componentIdentifier as ModuleComponentIdentifier).version
+    }
+}