add spring-boot deps runtime check

Author: osoykan

starters/spring/stove-spring-testing-e2e-kafka/src/main/kotlin/com/trendyol/stove/testing/e2e/kafka/Options.kt

@@ -229,6 +229,7 @@ internal fun TestSystem.kafka(): KafkaSystem = getOrNone<KafkaSystem>().getOrEls
 fun WithDsl.kafka(
   configure: () -> KafkaSystemOptions
 ): TestSystem {
+  SpringKafkaVersionCheck.ensureSpringKafkaAvailable()
   val options = configure()
 
   val runtime: SystemRuntime = if (options is ProvidedKafkaSystemOptions) {

starters/spring/stove-spring-testing-e2e-kafka/src/main/kotlin/com/trendyol/stove/testing/e2e/kafka/SpringKafkaVersionCheck.kt

@@ -0,0 +1,52 @@
+package com.trendyol.stove.testing.e2e.kafka
+
+/**
+ * Utility object to check Spring Kafka availability at runtime.
+ * Since Spring Kafka is a `compileOnly` dependency, users must bring their own version.
+ */
+internal object SpringKafkaVersionCheck {
+  private const val KAFKA_TEMPLATE_CLASS = "org.springframework.kafka.core.KafkaTemplate"
+
+  /**
+   * Checks if Spring Kafka is available on the classpath.
+   * @throws IllegalStateException if Spring Kafka is not found
+   */
+  fun ensureSpringKafkaAvailable() {
+    try {
+      Class.forName(KAFKA_TEMPLATE_CLASS)
+    } catch (e: ClassNotFoundException) {
+      throw IllegalStateException(
+        """
+        |
+        |═══════════════════════════════════════════════════════════════════════════════
+        |  Spring Kafka Not Found on Classpath!
+        |═══════════════════════════════════════════════════════════════════════════════
+        |
+        |  stove-spring-testing-e2e-kafka requires Spring Kafka to be on your classpath.
+        |  Spring Kafka is declared as a 'compileOnly' dependency, so you must add it
+        |  to your project.
+        |
+        |  Add one of the following to your build.gradle.kts:
+        |
+        |  For Spring Boot 2.x:
+        |    testImplementation("org.springframework.kafka:spring-kafka:2.9.x")
+        |    // or use the starter:
+        |    testImplementation("org.springframework.boot:spring-boot-starter-kafka:2.7.x")
+        |
+        |  For Spring Boot 3.x:
+        |    testImplementation("org.springframework.kafka:spring-kafka:3.x.x")
+        |    // or use the starter:
+        |    testImplementation("org.springframework.boot:spring-boot-starter-kafka:3.x.x")
+        |
+        |  For Spring Boot 4.x:
+        |    testImplementation("org.springframework.kafka:spring-kafka:4.x.x")
+        |    // or use the starter:
+        |    testImplementation("org.springframework.boot:spring-boot-starter-kafka:4.x.x")
+        |
+        |═══════════════════════════════════════════════════════════════════════════════
+        """.trimMargin(),
+        e
+      )
+    }
+  }
+}

starters/spring/stove-spring-testing-e2e/src/main/kotlin/com/trendyol/stove/testing/e2e/SpringApplicationUnderTest.kt

@@ -23,7 +23,10 @@ internal fun TestSystem.systemUnderTest(
 fun WithDsl.springBoot(
   runner: Runner<ConfigurableApplicationContext>,
   withParameters: List<String> = listOf()
-): ReadyTestSystem = this.testSystem.systemUnderTest(runner, withParameters)
+): ReadyTestSystem {
+  SpringBootVersionCheck.ensureSpringBootAvailable()
+  return this.testSystem.systemUnderTest(runner, withParameters)
+}
 
 @StoveDsl
 class SpringApplicationUnderTest(

starters/spring/stove-spring-testing-e2e/src/main/kotlin/com/trendyol/stove/testing/e2e/SpringBootVersionCheck.kt

@@ -0,0 +1,72 @@
+@file:Suppress("TooGenericExceptionCaught", "SwallowedException")
+
+package com.trendyol.stove.testing.e2e
+
+/**
+ * Utility object to check Spring Boot availability and version at runtime.
+ * Since Spring Boot is a `compileOnly` dependency, users must bring their own version.
+ */
+internal object SpringBootVersionCheck {
+  private const val SPRING_APPLICATION_CLASS = "org.springframework.boot.SpringApplication"
+  private const val SPRING_BOOT_VERSION_CLASS = "org.springframework.boot.SpringBootVersion"
+
+  /**
+   * Checks if Spring Boot is available on the classpath.
+   * @throws IllegalStateException if Spring Boot is not found
+   */
+  fun ensureSpringBootAvailable() {
+    try {
+      Class.forName(SPRING_APPLICATION_CLASS)
+    } catch (e: ClassNotFoundException) {
+      throw IllegalStateException(
+        """
+        |
+        |═══════════════════════════════════════════════════════════════════════════════
+        |  Spring Boot Not Found on Classpath!
+        |═══════════════════════════════════════════════════════════════════════════════
+        |
+        |  stove-spring-testing-e2e requires Spring Boot to be on your classpath.
+        |  Spring Boot is declared as a 'compileOnly' dependency, so you must add it
+        |  to your project.
+        |
+        |  Add one of the following to your build.gradle.kts:
+        |
+        |  For Spring Boot 2.x:
+        |    testImplementation("org.springframework.boot:spring-boot-starter:2.7.x")
+        |
+        |  For Spring Boot 3.x:
+        |    testImplementation("org.springframework.boot:spring-boot-starter:3.x.x")
+        |
+        |  For Spring Boot 4.x:
+        |    testImplementation("org.springframework.boot:spring-boot-starter:4.x.x")
+        |
+        |═══════════════════════════════════════════════════════════════════════════════
+        """.trimMargin(),
+        e
+      )
+    }
+  }
+
+  /**
+   * Gets the Spring Boot version if available.
+   * @return the Spring Boot version string, or "unknown" if not determinable
+   */
+  fun getSpringBootVersion(): String = try {
+    val versionClass = Class.forName(SPRING_BOOT_VERSION_CLASS)
+    val getVersionMethod = versionClass.getMethod("getVersion")
+    getVersionMethod.invoke(null) as? String ?: "unknown"
+  } catch (_: Exception) {
+    "unknown"
+  }
+
+  /**
+   * Gets the major version of Spring Boot.
+   * @return the major version (2, 3, 4, etc.) or -1 if not determinable
+   */
+  fun getSpringBootMajorVersion(): Int = try {
+    val version = getSpringBootVersion()
+    version.split(".").firstOrNull()?.toIntOrNull() ?: -1
+  } catch (e: Exception) {
+    -1
+  }
+}