Draft diagrams

Author: mpkorstanje

documentation/documentation.gradle.kts

@@ -268,7 +268,10 @@ tasks {
 		outputs.cacheIf { true }
 	}
 
+	// TODO: Loop?
 	val componentDiagram = plantUml.flatMap { it.outputDirectory.file("component-diagram.svg") }
+	val junitPlatformLauncherApiDiagram = plantUml.flatMap { it.outputDirectory.file("junit-platform-launcher-api-diagram.svg") }
+	val suiteEngineMultipleSuitesDiagram = plantUml.flatMap { it.outputDirectory.file("suite-engine-multiple-suites-diagram.svg") }
 
 	withType<AbstractAsciidoctorTask>().configureEach {
 		inputs.files(
@@ -278,7 +281,9 @@ tasks {
 			generateConsoleLauncherEnginesOptions,
 			generateApiTables,
 			generateStandaloneConsoleLauncherShadowedArtifactsFile,
-			componentDiagram
+			componentDiagram,
+			junitPlatformLauncherApiDiagram,
+			suiteEngineMultipleSuitesDiagram
 		)
 
 		resources {
@@ -289,6 +294,12 @@ tasks {
 			from(componentDiagram) {
 				into("user-guide/images")
 			}
+			from(junitPlatformLauncherApiDiagram) {
+				into("user-guide/images")
+			}
+			from(suiteEngineMultipleSuitesDiagram) {
+				into("user-guide/images")
+			}
 		}
 
 		// Temporary workaround for https://github.com/asciidoctor/asciidoctor-gradle-plugin/issues/599

documentation/src/plantuml/junit-platform-launcher-api-diagram.puml

@@ -0,0 +1,28 @@
+@startuml
+object "IDEs"
+object "Build Tools"
+object "Console Launcher"
+object "JUnit Platform"
+
+object "Jupiter Test Engine"
+object "Test Classes"
+
+object "Cucumber Test Engine"
+object "Feature Files"
+
+object "Spock Test Engine"
+object "Specifications"
+
+
+"IDEs" --> "JUnit Platform": ...
+"Build Tools" --> "JUnit Platform" : ...
+"Console Launcher" --> "JUnit Platform" : requests discovery and execution
+"JUnit Platform" --> "Jupiter Test Engine": ...
+"Jupiter Test Engine" --> "Test Classes" : ...
+
+"JUnit Platform" --> "Cucumber Test Engine":  ...
+"Cucumber Test Engine" --> "Feature Files" : ...
+
+"JUnit Platform" --> "Spock Test Engine": forwards request
+"Spock Test Engine" --> "Specifications" : discovers and executes
+@enduml

documentation/src/plantuml/suite-engine-multiple-suites-diagram.puml

@@ -0,0 +1,32 @@
+@startuml
+object IDE
+object "Build Tools"
+object "Console Launcher"
+object "JUnit Platform"
+object "Suite Test Engine"
+
+object "@Suite annotated class A"
+object "JUnit Platform (A)"
+object "JUpiter Test Engine (A)"
+object "ExampleTest (A)"
+
+object "@Suite annotated class B"
+object "JUnit Platform (B)"
+object "JUpiter Test Engine (B)"
+object "ExampleTest (B)"
+
+IDE --> "JUnit Platform": ...
+"Build Tools" --> "JUnit Platform" : ...
+"Console Launcher" --> "JUnit Platform" : requests discovery and execution
+"JUnit Platform" --> "Suite Test Engine": forwards request
+
+"Suite Test Engine" --> "@Suite annotated class A" : ...
+"@Suite annotated class A" --> "JUnit Platform (A)" : ... 
+"JUnit Platform (A)" --> "JUpiter Test Engine (A)" : ...
+"JUpiter Test Engine (A)"  --> "ExampleTest (A)" : ...
+
+"Suite Test Engine" --> "@Suite annotated class B" : discovers and executes
+"@Suite annotated class B" --> "JUnit Platform (B)" : requests discovery and execution
+"JUnit Platform (B)" --> "JUpiter Test Engine (B)" : forwards request
+"JUpiter Test Engine (B)" --> "ExampleTest (B)" : discovers and executes
+@enduml