From e99be615ce7c2c2b5c3ee5e3f8941c41c1e7a944 Mon Sep 17 00:00:00 2001
From: Kamil Doległo <kamilok1965@interia.pl>
Date: Fri, 31 Jan 2020 00:37:29 +0100
Subject: Bump Gradle version, migrate to Kotlin DSL, refactor publishing

---
 integration-tests/build.gradle.kts | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 integration-tests/build.gradle.kts

(limited to 'integration-tests/build.gradle.kts')

diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
new file mode 100644
index 00000000..e69de29b
-- 
cgit 


From a573641a70a626983c1d63965e377ea0be274f41 Mon Sep 17 00:00:00 2001
From: "sebastian.sellmair" <sebastian.sellmair@jetbrains.com>
Date: Thu, 2 Jul 2020 14:18:51 +0200
Subject: Implement AndroidGradleIntegrationTest

---
 .github/workflows/gradle-build.pr.yml              |  16 --
 .github/workflows/gradle-integration-test.pr.yml   |  13 ++
 .github/workflows/gradle-test.pr.yml               |  16 ++
 .idea/jarRepositories.xml                          |   5 +
 .run/it-android-0_dokka.run.xml                    |  24 +++
 .../src/main/kotlin/org/jetbrains/projectUtils.kt  |  16 ++
 integration-tests/build.gradle.kts                 |  30 ++++
 integration-tests/gradle/build.gradle.kts          |  19 ++-
 .../gradle/projects/it-android-0/build.gradle.kts  |  19 +++
 .../gradle/projects/it-android-0/gradle.properties |   2 +
 .../it-android-0/gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 58695 bytes
 .../gradle/wrapper/gradle-wrapper.properties       |   5 +
 .../gradle/projects/it-android-0/gradlew           | 183 +++++++++++++++++++++
 .../gradle/projects/it-android-0/gradlew.bat       | 100 +++++++++++
 .../projects/it-android-0/settings.gradle.kts      |   5 +
 .../it-android-0/src/main/AndroidManifest.xml      |   1 +
 .../main/java/it/android/AndroidSpecificClass.kt   |  16 ++
 .../gradle/projects/template.root.gradle.kts       |   4 +
 .../gradle/projects/template.settings.gradle.kts   |  11 ++
 .../it/gradle/Android0GradleIntegrationTest.kt     |  69 ++++++++
 .../dokka/it/gradle/BasicGradleIntegrationTest.kt  |  71 ++++++++
 .../gradle/Multiplatform0GradleIntegrationTest.kt  |  43 +++++
 ...AbstractDefaultVersionsGradleIntegrationTest.kt |  84 ----------
 .../it/gradle/AbstractGradleIntegrationTest.kt     |  30 ++--
 .../org/jetbrains/dokka/it/gradle/BuildVersions.kt |  38 ++++-
 .../kotlin/org/jetbrains/dokka/it/gradle/utils.kt  |  29 ----
 .../dokka/it/gradle/BasicGradleIntegrationTest.kt  |  62 -------
 .../gradle/Multiplatform0GradleIntegrationTest.kt  |  41 -----
 settings.gradle.kts                                |   1 +
 29 files changed, 702 insertions(+), 251 deletions(-)
 delete mode 100644 .github/workflows/gradle-build.pr.yml
 create mode 100644 .github/workflows/gradle-integration-test.pr.yml
 create mode 100644 .github/workflows/gradle-test.pr.yml
 create mode 100644 .run/it-android-0_dokka.run.xml
 create mode 100644 buildSrc/src/main/kotlin/org/jetbrains/projectUtils.kt
 create mode 100644 integration-tests/gradle/projects/it-android-0/build.gradle.kts
 create mode 100644 integration-tests/gradle/projects/it-android-0/gradle.properties
 create mode 100644 integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.jar
 create mode 100644 integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.properties
 create mode 100755 integration-tests/gradle/projects/it-android-0/gradlew
 create mode 100644 integration-tests/gradle/projects/it-android-0/gradlew.bat
 create mode 100644 integration-tests/gradle/projects/it-android-0/settings.gradle.kts
 create mode 100644 integration-tests/gradle/projects/it-android-0/src/main/AndroidManifest.xml
 create mode 100644 integration-tests/gradle/projects/it-android-0/src/main/java/it/android/AndroidSpecificClass.kt
 create mode 100644 integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
 create mode 100644 integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
 create mode 100644 integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
 delete mode 100644 integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractDefaultVersionsGradleIntegrationTest.kt
 delete mode 100644 integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/utils.kt
 delete mode 100644 integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
 delete mode 100644 integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt

(limited to 'integration-tests/build.gradle.kts')

diff --git a/.github/workflows/gradle-build.pr.yml b/.github/workflows/gradle-build.pr.yml
deleted file mode 100644
index 2723ecf4..00000000
--- a/.github/workflows/gradle-build.pr.yml
+++ /dev/null
@@ -1,16 +0,0 @@
-name: CI
-
-on: pull_request
-
-jobs:
-  build:
-    strategy:
-      matrix:
-        os: [ubuntu-latest, windows-latest]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-java@v1
-        with:
-          java-version: 11
-      - run: ./gradlew clean build --stacktrace
\ No newline at end of file
diff --git a/.github/workflows/gradle-integration-test.pr.yml b/.github/workflows/gradle-integration-test.pr.yml
new file mode 100644
index 00000000..bfc1b9d3
--- /dev/null
+++ b/.github/workflows/gradle-integration-test.pr.yml
@@ -0,0 +1,13 @@
+name: CI (Integration Test)
+
+on: pull_request
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 11
+      - run: ./gradlew clean integrationTest -s
diff --git a/.github/workflows/gradle-test.pr.yml b/.github/workflows/gradle-test.pr.yml
new file mode 100644
index 00000000..2838d975
--- /dev/null
+++ b/.github/workflows/gradle-test.pr.yml
@@ -0,0 +1,16 @@
+name: CI (Test)
+
+on: pull_request
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: 11
+      - run: ./gradlew clean test --stacktrace
diff --git a/.idea/jarRepositories.xml b/.idea/jarRepositories.xml
index e0b545b3..0c589859 100644
--- a/.idea/jarRepositories.xml
+++ b/.idea/jarRepositories.xml
@@ -96,5 +96,10 @@
       <option name="name" value="maven" />
       <option name="url" value="https://dl.bintray.com/kotlin/kotlin-dev/" />
     </remote-repository>
+    <remote-repository>
+      <option name="id" value="MavenLocal" />
+      <option name="name" value="MavenLocal" />
+      <option name="url" value="file:$MAVEN_REPOSITORY$" />
+    </remote-repository>
   </component>
 </project>
\ No newline at end of file
diff --git a/.run/it-android-0_dokka.run.xml b/.run/it-android-0_dokka.run.xml
new file mode 100644
index 00000000..dcb61e2e
--- /dev/null
+++ b/.run/it-android-0_dokka.run.xml
@@ -0,0 +1,24 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="it-android-0:dokka" type="GradleRunConfiguration" factoryName="Gradle" folderName="sample-projects">
+    <ExternalSystemSettings>
+      <option name="executionName" />
+      <option name="externalProjectPath" value="$PROJECT_DIR$/integration-tests/gradle/projects/it-android-0" />
+      <option name="externalSystemIdString" value="GRADLE" />
+      <option name="scriptParameters" value="" />
+      <option name="taskDescriptions">
+        <list />
+      </option>
+      <option name="taskNames">
+        <list>
+          <option value="clean" />
+          <option value="dokka" />
+        </list>
+      </option>
+      <option name="vmOptions" value="" />
+    </ExternalSystemSettings>
+    <GradleScriptDebugEnabled>true</GradleScriptDebugEnabled>
+    <method v="2">
+      <option name="Gradle.BeforeRunTask" enabled="false" tasks="publishToMavenLocal" externalProjectPath="$PROJECT_DIR$" vmOptions="" scriptParameters="" />
+    </method>
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/buildSrc/src/main/kotlin/org/jetbrains/projectUtils.kt b/buildSrc/src/main/kotlin/org/jetbrains/projectUtils.kt
new file mode 100644
index 00000000..46d803a5
--- /dev/null
+++ b/buildSrc/src/main/kotlin/org/jetbrains/projectUtils.kt
@@ -0,0 +1,16 @@
+package org.jetbrains
+
+import org.gradle.api.Project
+
+fun Project.whenEvaluated(action: Project.() -> Unit) {
+    if (state.executed) {
+        action()
+    } else {
+        afterEvaluate { action() }
+    }
+}
+
+fun Project.invokeWhenEvaluated(action: (project: Project) -> Unit) {
+    whenEvaluated { action(this) }
+}
+
diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
index e69de29b..ec9b4004 100644
--- a/integration-tests/build.gradle.kts
+++ b/integration-tests/build.gradle.kts
@@ -0,0 +1,30 @@
+subprojects {
+    sourceSets {
+        create("integrationTest") {
+            compileClasspath += sourceSets.main.get().output
+            runtimeClasspath += sourceSets.main.get().output
+        }
+    }
+    configurations.getByName("integrationTestImplementation") {
+        extendsFrom(configurations.implementation.get())
+    }
+
+    configurations.getByName("integrationTestRuntimeOnly") {
+        extendsFrom(configurations.runtimeOnly.get())
+    }
+
+    val integrationTest = task<Test>("integrationTest") {
+        maxHeapSize = "2G"
+        description = "Runs integration tests."
+        group = "verification"
+
+        testClassesDirs = sourceSets["integrationTest"].output.classesDirs
+        classpath = sourceSets["integrationTest"].runtimeClasspath
+
+        useJUnit()
+    }
+
+    tasks.check {
+        dependsOn(integrationTest)
+    }
+}
diff --git a/integration-tests/gradle/build.gradle.kts b/integration-tests/gradle/build.gradle.kts
index fb5e5739..2c526af7 100644
--- a/integration-tests/gradle/build.gradle.kts
+++ b/integration-tests/gradle/build.gradle.kts
@@ -1,15 +1,22 @@
+import org.jetbrains.invokeWhenEvaluated
+
 dependencies {
     implementation(kotlin("stdlib"))
     implementation(kotlin("test-junit"))
     implementation(gradleTestKit())
 }
 
-tasks {
-    test {
-        inputs.dir(file("projects"))
+val integrationTest by tasks.integrationTest
+integrationTest.inputs.dir(file("projects"))
 
-        rootProject.allprojects
-            .mapNotNull { project -> project.tasks.findByName("publishToMavenLocal") }
-            .forEach { publishTask -> this.dependsOn(publishTask) }
+rootProject.allprojects.forEach { otherProject ->
+    otherProject.invokeWhenEvaluated { evaluatedProject ->
+        evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
+            integrationTest.dependsOn(publishingTask)
+        }
     }
 }
+
+tasks.clean {
+    delete(File(buildDir, "gradle-test-kit"))
+}
diff --git a/integration-tests/gradle/projects/it-android-0/build.gradle.kts b/integration-tests/gradle/projects/it-android-0/build.gradle.kts
new file mode 100644
index 00000000..32c5c56c
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/build.gradle.kts
@@ -0,0 +1,19 @@
+plugins {
+    id("com.android.library")
+    id("org.jetbrains.dokka")
+    kotlin("android")
+}
+
+apply(from = "../template.root.gradle.kts")
+
+android {
+    defaultConfig {
+        minSdkVersion(21)
+        setCompileSdkVersion(29)
+    }
+}
+
+dependencies {
+    implementation(kotlin("stdlib"))
+}
+
diff --git a/integration-tests/gradle/projects/it-android-0/gradle.properties b/integration-tests/gradle/projects/it-android-0/gradle.properties
new file mode 100644
index 00000000..1332de19
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/gradle.properties
@@ -0,0 +1,2 @@
+dokka_it_kotlin_version=1.3.72
+dokka_it_android_gradle_plugin_version=4.0.0
diff --git a/integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.jar b/integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 00000000..f3d88b1c
Binary files /dev/null and b/integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.properties b/integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 00000000..1b16c34a
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/integration-tests/gradle/projects/it-android-0/gradlew b/integration-tests/gradle/projects/it-android-0/gradlew
new file mode 100755
index 00000000..2fe81a7d
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/gradlew
@@ -0,0 +1,183 @@
+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# 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.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=`expr $i + 1`
+    done
+    case $i in
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=`save "$@"`
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"
diff --git a/integration-tests/gradle/projects/it-android-0/gradlew.bat b/integration-tests/gradle/projects/it-android-0/gradlew.bat
new file mode 100644
index 00000000..24467a14
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/gradlew.bat
@@ -0,0 +1,100 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto init
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto init
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:init
+@rem Get command-line arguments, handling Windows variants
+
+if not "%OS%" == "Windows_NT" goto win9xME_args
+
+:win9xME_args
+@rem Slurp the command line arguments.
+set CMD_LINE_ARGS=
+set _SKIP=2
+
+:win9xME_args_slurp
+if "x%~1" == "x" goto execute
+
+set CMD_LINE_ARGS=%*
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/integration-tests/gradle/projects/it-android-0/settings.gradle.kts b/integration-tests/gradle/projects/it-android-0/settings.gradle.kts
new file mode 100644
index 00000000..664d2cb7
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/settings.gradle.kts
@@ -0,0 +1,5 @@
+@file:Suppress("LocalVariableName", "UnstableApiUsage")
+
+apply(from = "../template.settings.gradle.kts")
+rootProject.name = "it-android-0"
+
diff --git a/integration-tests/gradle/projects/it-android-0/src/main/AndroidManifest.xml b/integration-tests/gradle/projects/it-android-0/src/main/AndroidManifest.xml
new file mode 100644
index 00000000..a35f86be
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/src/main/AndroidManifest.xml
@@ -0,0 +1 @@
+<manifest package="org.jetbrains.dokka.it.android"/>
diff --git a/integration-tests/gradle/projects/it-android-0/src/main/java/it/android/AndroidSpecificClass.kt b/integration-tests/gradle/projects/it-android-0/src/main/java/it/android/AndroidSpecificClass.kt
new file mode 100644
index 00000000..cb9046b1
--- /dev/null
+++ b/integration-tests/gradle/projects/it-android-0/src/main/java/it/android/AndroidSpecificClass.kt
@@ -0,0 +1,16 @@
+@file:Suppress("unused")
+
+package it.android
+
+import android.content.Context
+import android.util.SparseIntArray
+import android.view.View
+
+/**
+ * This class is specific to android and uses android classes like:
+ * [Context], [SparseIntArray] or [View]
+ */
+class AndroidSpecificClass {
+    fun sparseIntArray() = SparseIntArray()
+    fun createView(context: Context): View = View(context)
+}
diff --git a/integration-tests/gradle/projects/template.root.gradle.kts b/integration-tests/gradle/projects/template.root.gradle.kts
index 1285375d..de516cb0 100644
--- a/integration-tests/gradle/projects/template.root.gradle.kts
+++ b/integration-tests/gradle/projects/template.root.gradle.kts
@@ -4,10 +4,14 @@ allprojects {
         jcenter()
         mavenLocal()
         mavenCentral()
+        google()
     }
 }
 
 afterEvaluate {
     logger.quiet("Gradle version: ${gradle.gradleVersion}")
     logger.quiet("Kotlin version: ${properties["dokka_it_kotlin_version"]}")
+    properties["dokka_it_android_gradle_plugin_version"]?.let { androidVersion ->
+        logger.quiet("Android version: $androidVersion")
+    }
 }
diff --git a/integration-tests/gradle/projects/template.settings.gradle.kts b/integration-tests/gradle/projects/template.settings.gradle.kts
index f28de32a..253c4e1b 100644
--- a/integration-tests/gradle/projects/template.settings.gradle.kts
+++ b/integration-tests/gradle/projects/template.settings.gradle.kts
@@ -2,9 +2,11 @@
 
 pluginManagement {
     val dokka_it_kotlin_version: String by settings
+    val dokka_it_android_gradle_plugin_version: String? by settings
 
     plugins {
         id("org.jetbrains.kotlin.jvm") version dokka_it_kotlin_version
+        id("org.jetbrains.kotlin.android") version dokka_it_kotlin_version
         id("org.jetbrains.kotlin.multiplatform") version dokka_it_kotlin_version
     }
 
@@ -13,6 +15,14 @@ pluginManagement {
             if (requested.id.id == "org.jetbrains.dokka") {
                 useModule("org.jetbrains.dokka:dokka-gradle-plugin:for-integration-tests-SNAPSHOT")
             }
+
+            if (requested.id.id == "com.android.library") {
+                useModule("com.android.tools.build:gradle:$dokka_it_android_gradle_plugin_version")
+            }
+
+            if (requested.id.id == "com.android.application") {
+                useModule("com.android.tools.build:gradle:$dokka_it_android_gradle_plugin_version")
+            }
         }
     }
     repositories {
@@ -21,5 +31,6 @@ pluginManagement {
         mavenCentral()
         jcenter()
         gradlePluginPortal()
+        google()
     }
 }
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
new file mode 100644
index 00000000..93d84e1f
--- /dev/null
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
@@ -0,0 +1,69 @@
+package org.jetbrains.dokka.it.gradle
+
+import org.gradle.testkit.runner.TaskOutcome
+import org.junit.Assume
+import org.junit.runners.Parameterized.Parameters
+import java.io.File
+import kotlin.test.BeforeTest
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertNotNull
+
+class Android0GradleIntegrationTest(override val versions: BuildVersions) : AbstractGradleIntegrationTest() {
+
+    companion object {
+        @get:JvmStatic
+        @get:Parameters(name = "{0}")
+        val versions = BuildVersions.permutations(
+            gradleVersions = listOf("6.5.1", "5.6.4"),
+            kotlinVersions = listOf("1.3.72", "1.4-M2-eap-70"),
+            androidGradlePluginVersions = listOf("3.5.3", "3.6.3")
+        ) + BuildVersions.permutations(
+            gradleVersions = listOf("6.5.1","6.1.1"),
+            kotlinVersions = listOf("1.3.72", "1.4-M2-eap-70"),
+            androidGradlePluginVersions = listOf("4.0.0")
+        ) + BuildVersions.permutations(
+            gradleVersions = listOf("6.5.1"),
+            kotlinVersions = listOf("1.3.72", "1.4-M2-eap-70"),
+            androidGradlePluginVersions = listOf("4.1.0-beta02")
+        )
+    }
+
+    @BeforeTest
+    fun assumeAndroidInstallation() {
+        val isCI = System.getenv("CI") != null
+        if (isCI) {
+            return
+        }
+
+        val androidSdkRoot = System.getenv("ANDROID_SDK_ROOT")
+        val androidHome = System.getenv("ANDROID_HOME")
+
+        val isAndroidSdkInstalled = androidSdkRoot != null || androidHome != null
+
+        Assume.assumeTrue(
+            "Missing ANDROID_SDK_ROOT",
+            isAndroidSdkInstalled
+        )
+    }
+
+    @BeforeTest
+    fun prepareProjectFiles() {
+        val templateProjectDir = File("projects", "it-android-0")
+
+        templateProjectDir.listFiles().orEmpty()
+            .filter { it.isFile }
+            .filterNot { it.name == "local.properties" }
+            .filterNot { it.name.startsWith("gradlew") }
+            .forEach { topLevelFile -> topLevelFile.copyTo(File(projectDir, topLevelFile.name)) }
+
+        File(templateProjectDir, "src").copyRecursively(File(projectDir, "src"))
+    }
+
+    @Test
+    fun execute() {
+        val result = createGradleRunner("dokka", "--stacktrace").build()
+        assertEquals(TaskOutcome.SUCCESS, assertNotNull(result.task(":dokka")).outcome)
+    }
+
+}
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
new file mode 100644
index 00000000..c3adce4f
--- /dev/null
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
@@ -0,0 +1,71 @@
+package org.jetbrains.dokka.it.gradle
+
+import org.gradle.testkit.runner.TaskOutcome
+import org.junit.runners.Parameterized
+import org.junit.runners.Parameterized.Parameters
+import java.io.File
+import kotlin.test.*
+
+class BasicGradleIntegrationTest(override val versions: BuildVersions) : AbstractGradleIntegrationTest() {
+
+    companion object {
+        @get:JvmStatic
+        @get:Parameters(name = "{0}")
+        val versions = BuildVersions.permutations(
+            gradleVersions = listOf("6.5.1", "6.4.1", "6.3", "6.2.2", "6.1.1", "6.0", "5.6.4"),
+            kotlinVersions = listOf("1.3.30", "1.3.72", "1.4-M2-eap-70")
+        )
+    }
+
+    @BeforeTest
+    fun prepareProjectFiles() {
+        val templateProjectDir = File("projects", "it-basic")
+
+        templateProjectDir.listFiles().orEmpty()
+            .filter { it.isFile }
+            .forEach { topLevelFile -> topLevelFile.copyTo(File(projectDir, topLevelFile.name)) }
+
+        File(templateProjectDir, "src").copyRecursively(File(projectDir, "src"))
+    }
+
+    @Test
+    fun execute() {
+        val result = createGradleRunner("dokka", "--stacktrace").build()
+        assertEquals(TaskOutcome.SUCCESS, assertNotNull(result.task(":dokka")).outcome)
+
+        val dokkaOutputDir = File(projectDir, "build/dokka")
+        assertTrue(dokkaOutputDir.isDirectory, "Missing dokka output directory")
+
+        val imagesDir = File(dokkaOutputDir, "images")
+        assertTrue(imagesDir.isDirectory, "Missing images directory")
+
+        val scriptsDir = File(dokkaOutputDir, "scripts")
+        assertTrue(scriptsDir.isDirectory, "Missing scripts directory")
+
+        val stylesDir = File(dokkaOutputDir, "styles")
+        assertTrue(stylesDir.isDirectory, "Missing styles directory")
+
+        val navigationHtml = File(dokkaOutputDir, "navigation.html")
+        assertTrue(navigationHtml.isFile, "Missing navigation.html")
+
+        val moduleOutputDir = File(dokkaOutputDir, "it-basic")
+        assertTrue(moduleOutputDir.isDirectory, "Missing module directory")
+
+        val moduleIndexHtml = File(moduleOutputDir, "index.html")
+        assertTrue(moduleIndexHtml.isFile, "Missing module index.html")
+
+        val modulePackageDir = File(moduleOutputDir, "it.basic")
+        assertTrue(modulePackageDir.isDirectory, "Missing it.basic package directory")
+
+        val modulePackageIndexHtml = File(modulePackageDir, "index.html")
+        assertTrue(modulePackageIndexHtml.isFile, "Missing module package index.html")
+
+        val moduleJavaPackageDir = File(moduleOutputDir, "it.basic.java")
+        assertTrue(moduleJavaPackageDir.isDirectory, "Missing it.basic.java package directory")
+
+        dokkaOutputDir.allHtmlFiles().forEach { file ->
+            assertContainsNoErrorClass(file)
+            assertNoUnresolvedLInks(file)
+        }
+    }
+}
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
new file mode 100644
index 00000000..b54eecb1
--- /dev/null
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
@@ -0,0 +1,43 @@
+package org.jetbrains.dokka.it.gradle
+
+import org.gradle.testkit.runner.TaskOutcome
+import org.gradle.util.GradleVersion
+import org.junit.runners.Parameterized
+import java.io.File
+import kotlin.test.*
+
+class Multiplatform0GradleIntegrationTest(override val versions: BuildVersions) : AbstractGradleIntegrationTest() {
+
+    companion object {
+        @get:JvmStatic
+        @get:Parameterized.Parameters(name = "{0}")
+        val versions = BuildVersions.permutations(
+            gradleVersions = listOf("6.5.1", "6.1.1"),
+            kotlinVersions = listOf("1.3.30", "1.3.72", "1.4-M2-eap-70")
+        )
+    }
+
+    @BeforeTest
+    fun prepareProjectFiles() {
+        val templateProjectDir = File("projects", "it-multiplatform-0")
+        templateProjectDir.listFiles().orEmpty()
+            .filter { it.isFile }
+            .forEach { topLevelFile -> topLevelFile.copyTo(File(projectDir, topLevelFile.name)) }
+        File(templateProjectDir, "src").copyRecursively(File(projectDir, "src"))
+    }
+
+    @Test
+    fun execute() {
+        val result = createGradleRunner("dokka", "--stacktrace").build()
+
+        assertEquals(TaskOutcome.SUCCESS, assertNotNull(result.task(":dokka")).outcome)
+
+        val dokkaOutputDir = File(projectDir, "build/dokka")
+        assertTrue(dokkaOutputDir.isDirectory, "Missing dokka output directory")
+
+        dokkaOutputDir.allHtmlFiles().forEach { file ->
+            assertContainsNoErrorClass(file)
+            assertNoUnresolvedLInks(file)
+        }
+    }
+}
diff --git a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractDefaultVersionsGradleIntegrationTest.kt b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractDefaultVersionsGradleIntegrationTest.kt
deleted file mode 100644
index 80737129..00000000
--- a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractDefaultVersionsGradleIntegrationTest.kt
+++ /dev/null
@@ -1,84 +0,0 @@
-package org.jetbrains.dokka.it.gradle
-
-import org.gradle.util.GradleVersion
-import org.junit.Assume
-import org.junit.Test
-
-abstract class AbstractDefaultVersionsGradleIntegrationTest(
-    private val minGradleVersion: GradleVersion? = null,
-    private val maxGradleVersion: GradleVersion? = null
-) : AbstractGradleIntegrationTest() {
-
-    protected abstract fun execute(versions: BuildVersions)
-
-    private fun executeIfRequirementsAreMet(versions: BuildVersions) {
-        if (minGradleVersion != null) {
-            Assume.assumeTrue(versions.gradleVersion >= minGradleVersion)
-        }
-        if (maxGradleVersion != null) {
-            Assume.assumeTrue(versions.gradleVersion <= maxGradleVersion)
-        }
-
-        execute(versions )
-    }
-
-    @Test
-    open fun `gradle 5_6_4 kotlin 1_3_72`() {
-        executeIfRequirementsAreMet(
-            BuildVersions(
-                gradleVersion = "5.6.4",
-                kotlinVersion = "1.3.72"
-            )
-        )
-    }
-
-    @Test
-    open fun `gradle 5_6_4 kotlin 1_3_30`() {
-        executeIfRequirementsAreMet(
-            BuildVersions(
-                gradleVersion = "5.6.4",
-                kotlinVersion = "1.3.30"
-            )
-        )
-    }
-
-    @Test
-    open fun `gradle 5_6_4 kotlin 1_4_M2_eap_70`() {
-        executeIfRequirementsAreMet(
-            BuildVersions(
-                gradleVersion = "5.6.4",
-                kotlinVersion = "1.4-M2-eap-70"
-            )
-        )
-    }
-
-    @Test
-    open fun `gradle 6_1_1 kotlin 1_3_72`() {
-        executeIfRequirementsAreMet(
-            BuildVersions(
-                gradleVersion = "6.1.1",
-                kotlinVersion = "1.3.72"
-            )
-        )
-    }
-
-    @Test
-    open fun `gradle 6_5_1 kotlin 1_4_M2_eap_70`() {
-        executeIfRequirementsAreMet(
-            BuildVersions(
-                gradleVersion = "6.5.1",
-                kotlinVersion = "1.4-M2-eap-70"
-            )
-        )
-    }
-
-    @Test
-    open fun `gradle 6_5_1 kotlin 1_3_72`() {
-        executeIfRequirementsAreMet(
-            BuildVersions(
-                gradleVersion = "6.5.1",
-                kotlinVersion = "1.3.72"
-            )
-        )
-    }
-}
diff --git a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt
index e6b6b0eb..bb2d0cc6 100644
--- a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt
+++ b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt
@@ -1,21 +1,26 @@
 package org.jetbrains.dokka.it.gradle
 
 import org.gradle.testkit.runner.GradleRunner
+import org.gradle.testkit.runner.internal.DefaultGradleRunner
 import org.junit.Rule
 import org.junit.rules.TemporaryFolder
+import org.junit.runner.RunWith
+import org.junit.runners.Parameterized
 import java.io.File
 import kotlin.test.BeforeTest
+import kotlin.test.Test
 import kotlin.test.assertFalse
 
+@RunWith(Parameterized::class)
 abstract class AbstractGradleIntegrationTest {
 
+    abstract val versions: BuildVersions
+
     @get:Rule
     val temporaryTestFolder = TemporaryFolder()
 
     val projectDir get() = File(temporaryTestFolder.root, "project")
 
-    val projectPath get() = projectDir.toPath()
-
     @BeforeTest
     fun copyTemplates() {
         File("projects").listFiles().orEmpty()
@@ -25,19 +30,24 @@ abstract class AbstractGradleIntegrationTest {
     }
 
     fun createGradleRunner(
-        buildVersions: BuildVersions, arguments: Array<String>
+        vararg arguments: String
     ): GradleRunner {
         return GradleRunner.create()
             .withProjectDir(projectDir)
-            .withGradleVersion(buildVersions.gradleVersion.version)
+            .withGradleVersion(versions.gradleVersion.version)
             .forwardOutput()
+            .withTestKitDir(File("build", "gradle-test-kit").absoluteFile)
             .withArguments(
-                "-Pkotlin_version=${buildVersions.kotlinVersion}",
-                "-Pdokka_it_kotlin_version=${buildVersions.kotlinVersion}",
-                * arguments
-            )
-            .withDebug(true)
-
+                listOfNotNull(
+                    "-Pkotlin_version=${versions.kotlinVersion}",
+                    "-Pdokka_it_kotlin_version=${versions.kotlinVersion}",
+                    versions.androidGradlePluginVersion?.let { androidVersion ->
+                        "-Pdokka_it_android_gradle_plugin_version=$androidVersion"
+                    },
+                    * arguments
+                )
+            ).run { this as DefaultGradleRunner }
+            .withJvmArguments("-Xmx4G", "-XX:MaxMetaspaceSize=512M")
     }
 
     fun File.allDescendentsWithExtension(extension: String): Sequence<File> {
diff --git a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/BuildVersions.kt b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/BuildVersions.kt
index 2fdd0368..84a7f1e8 100644
--- a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/BuildVersions.kt
+++ b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/BuildVersions.kt
@@ -4,13 +4,45 @@ import org.gradle.util.GradleVersion
 
 data class BuildVersions(
     val gradleVersion: GradleVersion,
-    val kotlinVersion: String
+    val kotlinVersion: String,
+    val androidGradlePluginVersion: String? = null,
 ) {
     constructor(
         gradleVersion: String,
-        kotlinVersion: String
+        kotlinVersion: String,
+        androidGradlePluginVersion: String? = null
     ) : this(
         gradleVersion = GradleVersion.version(gradleVersion),
-        kotlinVersion = kotlinVersion
+        kotlinVersion = kotlinVersion,
+        androidGradlePluginVersion = androidGradlePluginVersion
     )
+
+    override fun toString(): String {
+        return buildString {
+            append("Gradle ${gradleVersion.version}, Kotlin $kotlinVersion")
+            if (androidGradlePluginVersion != null) {
+                append(", Android $androidGradlePluginVersion")
+            }
+        }
+    }
+
+    companion object {
+        fun permutations(
+            gradleVersions: List<String>,
+            kotlinVersions: List<String>,
+            androidGradlePluginVersions: List<String?> = listOf(null)
+        ): List<BuildVersions> {
+            return gradleVersions.distinct().flatMap { gradleVersion ->
+                kotlinVersions.distinct().flatMap { kotlinVersion ->
+                    androidGradlePluginVersions.distinct().map { androidVersion ->
+                        BuildVersions(
+                            gradleVersion = gradleVersion,
+                            kotlinVersion = kotlinVersion,
+                            androidGradlePluginVersion = androidVersion
+                        )
+                    }
+                }
+            }
+        }
+    }
 }
diff --git a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/utils.kt b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/utils.kt
deleted file mode 100644
index 2516b151..00000000
--- a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/utils.kt
+++ /dev/null
@@ -1,29 +0,0 @@
-package org.jetbrains.dokka.it.gradle
-
-import java.io.IOException
-import java.nio.file.*
-import java.nio.file.attribute.BasicFileAttributes
-
-fun Path.copy(to: Path) {
-    Files.walkFileTree(this, CopyFileVisitor(this, to))
-}
-
-class CopyFileVisitor(private var sourcePath: Path, private val targetPath: Path) : SimpleFileVisitor<Path>() {
-    @Throws(IOException::class)
-    override fun preVisitDirectory(
-        dir: Path,
-        attrs: BasicFileAttributes
-    ): FileVisitResult {
-        Files.createDirectories(targetPath.resolve(sourcePath.relativize(dir)))
-        return FileVisitResult.CONTINUE
-    }
-
-    @Throws(IOException::class)
-    override fun visitFile(
-        file: Path,
-        attrs: BasicFileAttributes
-    ): FileVisitResult {
-        Files.copy(file, targetPath.resolve(sourcePath.relativize(file)), StandardCopyOption.REPLACE_EXISTING)
-        return FileVisitResult.CONTINUE
-    }
-}
diff --git a/integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt b/integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
deleted file mode 100644
index b4d9e82c..00000000
--- a/integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
+++ /dev/null
@@ -1,62 +0,0 @@
-package org.jetbrains.dokka.it.gradle
-
-import org.gradle.testkit.runner.TaskOutcome
-import java.io.File
-import kotlin.test.*
-
-class BasicGradleIntegrationTest : AbstractDefaultVersionsGradleIntegrationTest() {
-
-    @BeforeTest
-    fun prepareProjectFiles() {
-        val templateProjectDir = File("projects", "it-basic")
-
-        templateProjectDir.listFiles().orEmpty()
-            .filter { it.isFile }
-            .forEach { topLevelFile -> topLevelFile.copyTo(File(projectDir, topLevelFile.name)) }
-
-        File(templateProjectDir, "src").copyRecursively(File(projectDir, "src"))
-    }
-
-    override fun execute(versions: BuildVersions) {
-        val result = createGradleRunner(
-            buildVersions = versions,
-            arguments = arrayOf("dokka", "--stacktrace")
-        ).build()
-        assertEquals(TaskOutcome.SUCCESS, assertNotNull(result.task(":dokka")).outcome)
-
-        val dokkaOutputDir = File(projectDir, "build/dokka")
-        assertTrue(dokkaOutputDir.isDirectory, "Missing dokka output directory")
-
-        val imagesDir = File(dokkaOutputDir, "images")
-        assertTrue(imagesDir.isDirectory, "Missing images directory")
-
-        val scriptsDir = File(dokkaOutputDir, "scripts")
-        assertTrue(scriptsDir.isDirectory, "Missing scripts directory")
-
-        val stylesDir = File(dokkaOutputDir, "styles")
-        assertTrue(stylesDir.isDirectory, "Missing styles directory")
-
-        val navigationHtml = File(dokkaOutputDir, "navigation.html")
-        assertTrue(navigationHtml.isFile, "Missing navigation.html")
-
-        val moduleOutputDir = File(dokkaOutputDir, "it-basic")
-        assertTrue(moduleOutputDir.isDirectory, "Missing module directory")
-
-        val moduleIndexHtml = File(moduleOutputDir, "index.html")
-        assertTrue(moduleIndexHtml.isFile, "Missing module index.html")
-
-        val modulePackageDir = File(moduleOutputDir, "it.basic")
-        assertTrue(modulePackageDir.isDirectory, "Missing it.basic package directory")
-
-        val modulePackageIndexHtml = File(modulePackageDir, "index.html")
-        assertTrue(modulePackageIndexHtml.isFile, "Missing module package index.html")
-
-        val moduleJavaPackageDir = File(moduleOutputDir, "it.basic.java")
-        assertTrue(moduleJavaPackageDir.isDirectory, "Missing it.basic.java package directory")
-
-        dokkaOutputDir.allHtmlFiles().forEach { file ->
-            assertContainsNoErrorClass(file)
-            assertNoUnresolvedLInks(file)
-        }
-    }
-}
diff --git a/integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt b/integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
deleted file mode 100644
index a0f6be24..00000000
--- a/integration-tests/gradle/src/test/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
+++ /dev/null
@@ -1,41 +0,0 @@
-package org.jetbrains.dokka.it.gradle
-
-import org.gradle.testkit.runner.TaskOutcome
-import org.gradle.util.GradleVersion
-import java.io.File
-import kotlin.test.BeforeTest
-import kotlin.test.assertEquals
-import kotlin.test.assertNotNull
-import kotlin.test.assertTrue
-
-class Multiplatform0GradleIntegrationTest : AbstractDefaultVersionsGradleIntegrationTest(
-    minGradleVersion = GradleVersion.version("6.0.0")
-) {
-
-    @BeforeTest
-    fun prepareProjectFiles() {
-        val templateProjectDir = File("projects", "it-multiplatform-0")
-        templateProjectDir.listFiles().orEmpty()
-            .filter { it.isFile }
-            .forEach { topLevelFile -> topLevelFile.copyTo(File(projectDir, topLevelFile.name)) }
-        File(templateProjectDir, "src").copyRecursively(File(projectDir, "src"))
-    }
-
-    override fun execute(versions: BuildVersions) {
-        val result = createGradleRunner(
-            buildVersions = versions,
-            arguments = arrayOf("dokka", "--stacktrace")
-        ).build()
-
-        assertEquals(TaskOutcome.SUCCESS, assertNotNull(result.task(":dokka")).outcome)
-
-        val dokkaOutputDir = File(projectDir, "build/dokka")
-        assertTrue(dokkaOutputDir.isDirectory, "Missing dokka output directory")
-
-        dokkaOutputDir.allHtmlFiles().forEach { file ->
-            assertContainsNoErrorClass(file)
-            assertNoUnresolvedLInks(file)
-        }
-    }
-
-}
diff --git a/settings.gradle.kts b/settings.gradle.kts
index a9d8d852..e634c7d2 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -17,6 +17,7 @@ include("plugins:gfm")
 include("plugins:jekyll")
 include("plugins:kotlin-as-java")
 include("plugins:javadoc")
+include("integration-tests")
 include("integration-tests:gradle-integration-tests")
 include("integration-tests:gradle")
 
-- 
cgit 


From cb20227d354b1b74ca6784d55ea75cc8b5281abd Mon Sep 17 00:00:00 2001
From: "sebastian.sellmair" <sebastian.sellmair@jetbrains.com>
Date: Tue, 7 Jul 2020 11:08:34 +0200
Subject: Implement simple cli integration test

---
 .idea/codeStyles/Project.xml                       | 16 +++++
 integration-tests/build.gradle.kts                 | 10 +++
 integration-tests/cli/build.gradle.kts             | 39 ++++++++++
 .../main/java/it/basic/java/SampleJavaClass.java   | 17 +++++
 .../it-cli/src/main/kotlin/it/basic/PublicClass.kt | 48 +++++++++++++
 .../jetbrains/dokka/it/cli/CliIntegrationTest.kt   | 82 ++++++++++++++++++++++
 .../dokka/it/cli/AbstractCliIntegrationTest.kt     | 36 ++++++++++
 .../org/jetbrains/dokka/it/cli/processUtils.kt     | 51 ++++++++++++++
 .../it/gradle/AbstractGradleIntegrationTest.kt     | 37 +---------
 .../jetbrains/dokka/it/AbstractIntegrationTest.kt  | 39 ++++++++++
 runners/cli/src/main/kotlin/cli/main.kt            | 10 +--
 settings.gradle.kts                                |  1 +
 12 files changed, 346 insertions(+), 40 deletions(-)
 create mode 100644 integration-tests/cli/build.gradle.kts
 create mode 100644 integration-tests/cli/projects/it-cli/src/main/java/it/basic/java/SampleJavaClass.java
 create mode 100644 integration-tests/cli/projects/it-cli/src/main/kotlin/it/basic/PublicClass.kt
 create mode 100644 integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt
 create mode 100644 integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/AbstractCliIntegrationTest.kt
 create mode 100644 integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt
 create mode 100644 integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt

(limited to 'integration-tests/build.gradle.kts')

diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml
index 1bec35e5..31d977a0 100644
--- a/.idea/codeStyles/Project.xml
+++ b/.idea/codeStyles/Project.xml
@@ -1,6 +1,22 @@
 <component name="ProjectCodeStyleConfiguration">
   <code_scheme name="Project" version="173">
     <JetCodeStyleSettings>
+      <option name="PACKAGES_TO_USE_STAR_IMPORTS">
+        <value>
+          <package name="java.util" alias="false" withSubpackages="false" />
+          <package name="kotlinx.android.synthetic" alias="false" withSubpackages="true" />
+          <package name="io.ktor" alias="false" withSubpackages="true" />
+        </value>
+      </option>
+      <option name="PACKAGES_IMPORT_LAYOUT">
+        <value>
+          <package name="" alias="false" withSubpackages="true" />
+          <package name="java" alias="false" withSubpackages="true" />
+          <package name="javax" alias="false" withSubpackages="true" />
+          <package name="kotlin" alias="false" withSubpackages="true" />
+          <package name="" alias="true" withSubpackages="true" />
+        </value>
+      </option>
       <option name="CODE_STYLE_DEFAULTS" value="KOTLIN_OFFICIAL" />
     </JetCodeStyleSettings>
     <codeStyleSettings language="kotlin">
diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
index ec9b4004..44da74cf 100644
--- a/integration-tests/build.gradle.kts
+++ b/integration-tests/build.gradle.kts
@@ -5,6 +5,7 @@ subprojects {
             runtimeClasspath += sourceSets.main.get().output
         }
     }
+
     configurations.getByName("integrationTestImplementation") {
         extendsFrom(configurations.implementation.get())
     }
@@ -13,6 +14,10 @@ subprojects {
         extendsFrom(configurations.runtimeOnly.get())
     }
 
+    dependencies {
+        implementation(project(":integration-tests"))
+    }
+
     val integrationTest = task<Test>("integrationTest") {
         maxHeapSize = "2G"
         description = "Runs integration tests."
@@ -28,3 +33,8 @@ subprojects {
         dependsOn(integrationTest)
     }
 }
+
+dependencies {
+    implementation(kotlin("stdlib"))
+    implementation(kotlin("test-junit"))
+}
diff --git a/integration-tests/cli/build.gradle.kts b/integration-tests/cli/build.gradle.kts
new file mode 100644
index 00000000..c3e98d0a
--- /dev/null
+++ b/integration-tests/cli/build.gradle.kts
@@ -0,0 +1,39 @@
+import com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar
+
+
+plugins {
+    id("com.github.johnrengelman.shadow")
+}
+
+val dokka_version: String by project
+evaluationDependsOn(":runners:cli")
+evaluationDependsOn(":plugins:base")
+
+dependencies {
+    implementation(kotlin("stdlib"))
+    implementation(kotlin("test-junit"))
+
+    val coroutines_version: String by project
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")
+
+}
+
+/* Create a fat base plugin jar for cli tests */
+val basePluginShadow: Configuration by configurations.creating
+dependencies {
+    basePluginShadow(project(":plugins:base"))
+}
+val basePluginShadowJar = tasks.create("basePluginShadowJar", ShadowJar::class) {
+    configurations = listOf(basePluginShadow)
+    archiveFileName.set("fat-base-plugin-$dokka_version.jar")
+    archiveClassifier.set("")
+}
+
+tasks.integrationTest {
+    val cliJar = tasks.getByPath(":runners:cli:shadowJar") as ShadowJar
+    environment("CLI_JAR_PATH", cliJar.archiveFile.get())
+    environment("BASE_PLUGIN_JAR_PATH", basePluginShadowJar.archiveFile.get())
+    dependsOn(cliJar)
+    dependsOn(basePluginShadowJar)
+}
+
diff --git a/integration-tests/cli/projects/it-cli/src/main/java/it/basic/java/SampleJavaClass.java b/integration-tests/cli/projects/it-cli/src/main/java/it/basic/java/SampleJavaClass.java
new file mode 100644
index 00000000..23b0202c
--- /dev/null
+++ b/integration-tests/cli/projects/it-cli/src/main/java/it/basic/java/SampleJavaClass.java
@@ -0,0 +1,17 @@
+package it.basic.java;
+
+import it.basic.PublicClass;
+
+/**
+ * This class is, unlike {@link PublicClass}, written in Java
+ */
+@SuppressWarnings("unused")
+public class SampleJavaClass {
+
+    /**
+     * @return Empty instance of {@link PublicClass}
+     */
+    public PublicClass publicDocumentedFunction() {
+        return new PublicClass();
+    }
+}
diff --git a/integration-tests/cli/projects/it-cli/src/main/kotlin/it/basic/PublicClass.kt b/integration-tests/cli/projects/it-cli/src/main/kotlin/it/basic/PublicClass.kt
new file mode 100644
index 00000000..71bc7e63
--- /dev/null
+++ b/integration-tests/cli/projects/it-cli/src/main/kotlin/it/basic/PublicClass.kt
@@ -0,0 +1,48 @@
+@file:Suppress("unused")
+
+package it.basic
+
+class PublicClass {
+    /**
+     * This function is public and documented
+     */
+    fun publicDocumentedFunction(): String = ""
+
+    fun publicUndocumentedFunction(): String = ""
+
+    /**
+     * This function is internal and documented
+     */
+    internal fun internalDocumentedFunction(): String = ""
+
+    internal fun internalUndocumentedFunction(): String = ""
+
+    /**
+     * This function is private and documented
+     */
+    private fun privateDocumentedFunction(): String = ""
+
+    private fun privateUndocumentedFunction(): String = ""
+
+
+    /**
+     * This property is public and documented
+     */
+    val publicDocumentedProperty: Int = 0
+
+    val publicUndocumentedProperty: Int = 0
+
+    /**
+     * This property internal and documented
+     */
+    val internalDocumentedProperty: Int = 0
+
+    val internalUndocumentedProperty: Int = 0
+
+    /**
+     * This property private and documented
+     */
+    private val privateDocumentedProperty: Int = 0
+
+    private val privateUndocumentedProperty: Int = 0
+}
diff --git a/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt b/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt
new file mode 100644
index 00000000..5e24c1cd
--- /dev/null
+++ b/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt
@@ -0,0 +1,82 @@
+package org.jetbrains.dokka.it.cli
+
+import java.io.File
+import kotlin.test.BeforeTest
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertTrue
+
+class CliIntegrationTest : AbstractCliIntegrationTest() {
+
+    @BeforeTest
+    fun copyProject() {
+        val templateProjectDir = File("projects", "it-cli")
+        templateProjectDir.copyRecursively(projectDir)
+    }
+
+    @Test
+    fun runHelp() {
+        val process = ProcessBuilder("java", "-jar", cliJarFile.path, "-h")
+            .redirectErrorStream(true)
+            .start()
+
+        val result = process.awaitProcessResult()
+        assertEquals(0, result.exitCode, "Expected exitCode 0 (Success)")
+        assertTrue("Usage: " in result.output)
+    }
+
+    @Test
+    fun runCli() {
+        val dokkaOutputDir = File(projectDir, "output")
+        assertTrue(dokkaOutputDir.mkdirs())
+        val process = ProcessBuilder(
+            "java", "-jar", cliJarFile.path,
+            "-outputDir", dokkaOutputDir.path,
+            "-format", "html",
+            "-pluginsClasspath", basePluginJarFile.path,
+            "-sourceSet",
+            buildString {
+                append(" -moduleName it-cli")
+                append(" -moduleDisplayName CLI-Example")
+                append(" -sourceSetName cliMain")
+                append(" -src ${File(projectDir, "src").path}")
+                append(" -jdkVersion 8")
+                append(" -analysisPlatform jvm")
+                append(" -reportUndocumented")
+                append(" -skipDeprecated")
+            }
+        )
+            .redirectErrorStream(true)
+            .start()
+
+        val result = process.awaitProcessResult()
+        assertEquals(0, result.exitCode, "Expected exitCode 0 (Success)")
+
+        val extensionLoadedRegex = Regex("""Extension: org\.jetbrains\.dokka\.base\.DokkaBase""")
+        val amountOfExtensionsLoaded = extensionLoadedRegex.findAll(result.output).count()
+
+        assertTrue(
+            amountOfExtensionsLoaded > 10,
+            "Expected more than 10 extensions being present (found $amountOfExtensionsLoaded)"
+        )
+
+        assertTrue(dokkaOutputDir.isDirectory, "Missing dokka output directory")
+
+        val imagesDir = File(dokkaOutputDir, "images")
+        assertTrue(imagesDir.isDirectory, "Missing images directory")
+
+        val scriptsDir = File(dokkaOutputDir, "scripts")
+        assertTrue(scriptsDir.isDirectory, "Missing scripts directory")
+
+        val stylesDir = File(dokkaOutputDir, "styles")
+        assertTrue(stylesDir.isDirectory, "Missing styles directory")
+
+        val navigationHtml = File(dokkaOutputDir, "navigation.html")
+        assertTrue(navigationHtml.isFile, "Missing navigation.html")
+
+        projectDir.allHtmlFiles().forEach { file ->
+            assertContainsNoErrorClass(file)
+            assertNoUnresolvedLInks(file)
+        }
+    }
+}
diff --git a/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/AbstractCliIntegrationTest.kt b/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/AbstractCliIntegrationTest.kt
new file mode 100644
index 00000000..7f6f9433
--- /dev/null
+++ b/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/AbstractCliIntegrationTest.kt
@@ -0,0 +1,36 @@
+package org.jetbrains.dokka.it.cli
+
+import org.jetbrains.dokka.it.AbstractIntegrationTest
+import java.io.File
+import kotlin.test.BeforeTest
+import kotlin.test.assertTrue
+
+abstract class AbstractCliIntegrationTest : AbstractIntegrationTest() {
+
+    protected val cliJarFile: File by lazy {
+        File(temporaryTestFolder.root, "dokka.jar")
+    }
+
+    protected val basePluginJarFile: File by lazy {
+        File(temporaryTestFolder.root, "base-plugin.jar")
+    }
+
+    @BeforeTest
+    fun copyJarFiles() {
+        val cliJarPathEnvironmentKey = "CLI_JAR_PATH"
+        val cliJarFile = File(System.getenv(cliJarPathEnvironmentKey))
+        assertTrue(
+            cliJarFile.exists() && cliJarFile.isFile,
+            "Missing path to CLI jar System.getenv($cliJarPathEnvironmentKey)"
+        )
+        cliJarFile.copyTo(this.cliJarFile)
+
+        val basePluginPathEnvironmentKey = "BASE_PLUGIN_JAR_PATH"
+        val basePluginJarFile = File(System.getenv(basePluginPathEnvironmentKey))
+        assertTrue(
+            basePluginJarFile.exists() && basePluginJarFile.isFile,
+            "Missing path to base plugin jar System.getenv($basePluginPathEnvironmentKey)"
+        )
+        basePluginJarFile.copyTo(this.basePluginJarFile)
+    }
+}
diff --git a/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt b/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt
new file mode 100644
index 00000000..d2fa3b31
--- /dev/null
+++ b/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt
@@ -0,0 +1,51 @@
+package org.jetbrains.dokka.it.cli
+
+import kotlinx.coroutines.CompletableDeferred
+import kotlinx.coroutines.async
+import kotlinx.coroutines.runBlocking
+import kotlin.concurrent.thread
+
+class ProcessResult(
+    val exitCode: Int,
+    val output: String
+)
+
+fun Process.awaitProcessResult() = runBlocking {
+    val exitCode = async { awaitExitCode() }
+    val output = async { awaitOutput() }
+    ProcessResult(
+        exitCode.await(),
+        output.await()
+    )
+}
+
+private suspend fun Process.awaitExitCode(): Int {
+    val deferred = CompletableDeferred<Int>()
+    thread {
+        try {
+            deferred.complete(this.waitFor())
+        } catch (e: Throwable) {
+            deferred.completeExceptionally(e)
+        }
+    }
+
+    return deferred.await()
+}
+
+private suspend fun Process.awaitOutput(): String {
+    val deferred = CompletableDeferred<String>()
+    thread {
+        try {
+            var string = ""
+            this.inputStream.bufferedReader().forEachLine { line ->
+                println(line)
+                string += line + System.lineSeparator()
+            }
+            deferred.complete(string)
+        } catch (e: Throwable) {
+            deferred.completeExceptionally(e)
+        }
+    }
+
+    return deferred.await()
+}
diff --git a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt
index bb2d0cc6..c8c8c844 100644
--- a/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt
+++ b/integration-tests/gradle/src/main/kotlin/org/jetbrains/dokka/it/gradle/AbstractGradleIntegrationTest.kt
@@ -2,25 +2,17 @@ package org.jetbrains.dokka.it.gradle
 
 import org.gradle.testkit.runner.GradleRunner
 import org.gradle.testkit.runner.internal.DefaultGradleRunner
-import org.junit.Rule
-import org.junit.rules.TemporaryFolder
+import org.jetbrains.dokka.it.AbstractIntegrationTest
 import org.junit.runner.RunWith
 import org.junit.runners.Parameterized
 import java.io.File
 import kotlin.test.BeforeTest
-import kotlin.test.Test
-import kotlin.test.assertFalse
 
 @RunWith(Parameterized::class)
-abstract class AbstractGradleIntegrationTest {
+abstract class AbstractGradleIntegrationTest : AbstractIntegrationTest() {
 
     abstract val versions: BuildVersions
 
-    @get:Rule
-    val temporaryTestFolder = TemporaryFolder()
-
-    val projectDir get() = File(temporaryTestFolder.root, "project")
-
     @BeforeTest
     fun copyTemplates() {
         File("projects").listFiles().orEmpty()
@@ -49,30 +41,5 @@ abstract class AbstractGradleIntegrationTest {
             ).run { this as DefaultGradleRunner }
             .withJvmArguments("-Xmx4G", "-XX:MaxMetaspaceSize=512M")
     }
-
-    fun File.allDescendentsWithExtension(extension: String): Sequence<File> {
-        return this.walkTopDown().filter { it.isFile && it.extension == extension }
-    }
-
-    fun File.allHtmlFiles(): Sequence<File> {
-        return allDescendentsWithExtension("html")
-    }
-
-    protected fun assertContainsNoErrorClass(file: File) {
-        val fileText = file.readText()
-        assertFalse(
-            fileText.contains("ERROR CLASS", ignoreCase = true),
-            "Unexpected `ERROR CLASS` in ${file.path}\n" + fileText
-        )
-    }
-
-    protected fun assertNoUnresolvedLInks(file: File) {
-        val regex = Regex("[\"']#[\"']")
-        val fileText = file.readText()
-        assertFalse(
-            fileText.contains(regex),
-            "Unexpected unresolved link in ${file.path}\n" + fileText
-        )
-    }
 }
 
diff --git a/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt
new file mode 100644
index 00000000..4af523a2
--- /dev/null
+++ b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt
@@ -0,0 +1,39 @@
+package org.jetbrains.dokka.it
+
+import org.junit.Rule
+import org.junit.rules.TemporaryFolder
+import java.io.File
+import kotlin.test.assertFalse
+
+abstract class AbstractIntegrationTest {
+
+    @get:Rule
+    val temporaryTestFolder = TemporaryFolder()
+
+    val projectDir get() = File(temporaryTestFolder.root, "project")
+
+    fun File.allDescendentsWithExtension(extension: String): Sequence<File> {
+        return this.walkTopDown().filter { it.isFile && it.extension == extension }
+    }
+
+    fun File.allHtmlFiles(): Sequence<File> {
+        return allDescendentsWithExtension("html")
+    }
+
+    protected fun assertContainsNoErrorClass(file: File) {
+        val fileText = file.readText()
+        assertFalse(
+            fileText.contains("ERROR CLASS", ignoreCase = true),
+            "Unexpected `ERROR CLASS` in ${file.path}\n" + fileText
+        )
+    }
+
+    protected fun assertNoUnresolvedLInks(file: File) {
+        val regex = Regex("[\"']#[\"']")
+        val fileText = file.readText()
+        assertFalse(
+            fileText.contains(regex),
+            "Unexpected unresolved link in ${file.path}\n" + fileText
+        )
+    }
+}
diff --git a/runners/cli/src/main/kotlin/cli/main.kt b/runners/cli/src/main/kotlin/cli/main.kt
index 5e5cd6b2..d284e653 100644
--- a/runners/cli/src/main/kotlin/cli/main.kt
+++ b/runners/cli/src/main/kotlin/cli/main.kt
@@ -118,7 +118,7 @@ private fun parseSourceSet(args: Array<String>): DokkaConfiguration.DokkaSourceS
     val moduleName by parser.option(
         ArgType.String,
         description = "Name of the documentation module",
-        fullName = "module"
+        fullName = "moduleName"
     ).required()
 
     val moduleDisplayName by parser.option(
@@ -126,12 +126,12 @@ private fun parseSourceSet(args: Array<String>): DokkaConfiguration.DokkaSourceS
         description = "Name of the documentation module"
     )
 
-    val name by parser.option(
+    val sourceSetName by parser.option(
         ArgType.String,
         description = "Name of the source set"
     ).default("main")
 
-    val displayName by parser.option(
+    val sourceSetDisplayName by parser.option(
         ArgType.String,
         description = "Displayed name of the source set"
     ).default("JVM")
@@ -235,8 +235,8 @@ private fun parseSourceSet(args: Array<String>): DokkaConfiguration.DokkaSourceS
 
     return object : DokkaConfiguration.DokkaSourceSet {
         override val moduleDisplayName = moduleDisplayName ?: moduleName
-        override val displayName = displayName
-        override val sourceSetID = DokkaSourceSetID(moduleName, name)
+        override val displayName = sourceSetDisplayName
+        override val sourceSetID = DokkaSourceSetID(moduleName, sourceSetName)
         override val classpath = classpath
         override val sourceRoots = sourceRoots.map { SourceRootImpl(it.toAbsolutePath()) }
         override val dependentSourceSets: Set<DokkaSourceSetID> = dependentSourceSets
diff --git a/settings.gradle.kts b/settings.gradle.kts
index 969bb53f..54245a96 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -19,6 +19,7 @@ include("plugins:kotlin-as-java")
 include("plugins:javadoc")
 include("integration-tests")
 include("integration-tests:gradle")
+include("integration-tests:cli")
 
 pluginManagement {
     val kotlin_version: String by settings
-- 
cgit 


From 14b9352b9b7a4084f72209ba686170e313f7863b Mon Sep 17 00:00:00 2001
From: "sebastian.sellmair" <sebastian.sellmair@jetbrains.com>
Date: Tue, 7 Jul 2020 13:12:05 +0200
Subject: Lazily configure integration test tasks

---
 integration-tests/build.gradle.kts        |  2 +-
 integration-tests/cli/build.gradle.kts    |  2 +-
 integration-tests/gradle/build.gradle.kts | 14 +++++++-------
 3 files changed, 9 insertions(+), 9 deletions(-)

(limited to 'integration-tests/build.gradle.kts')

diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
index 44da74cf..70b6db26 100644
--- a/integration-tests/build.gradle.kts
+++ b/integration-tests/build.gradle.kts
@@ -18,7 +18,7 @@ subprojects {
         implementation(project(":integration-tests"))
     }
 
-    val integrationTest = task<Test>("integrationTest") {
+    val integrationTest by tasks.register<Test>("integrationTest") {
         maxHeapSize = "2G"
         description = "Runs integration tests."
         group = "verification"
diff --git a/integration-tests/cli/build.gradle.kts b/integration-tests/cli/build.gradle.kts
index c3e98d0a..f825a148 100644
--- a/integration-tests/cli/build.gradle.kts
+++ b/integration-tests/cli/build.gradle.kts
@@ -23,7 +23,7 @@ val basePluginShadow: Configuration by configurations.creating
 dependencies {
     basePluginShadow(project(":plugins:base"))
 }
-val basePluginShadowJar = tasks.create("basePluginShadowJar", ShadowJar::class) {
+val basePluginShadowJar by tasks.register("basePluginShadowJar", ShadowJar::class) {
     configurations = listOf(basePluginShadow)
     archiveFileName.set("fat-base-plugin-$dokka_version.jar")
     archiveClassifier.set("")
diff --git a/integration-tests/gradle/build.gradle.kts b/integration-tests/gradle/build.gradle.kts
index 2c526af7..28e20cf9 100644
--- a/integration-tests/gradle/build.gradle.kts
+++ b/integration-tests/gradle/build.gradle.kts
@@ -6,13 +6,13 @@ dependencies {
     implementation(gradleTestKit())
 }
 
-val integrationTest by tasks.integrationTest
-integrationTest.inputs.dir(file("projects"))
-
-rootProject.allprojects.forEach { otherProject ->
-    otherProject.invokeWhenEvaluated { evaluatedProject ->
-        evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
-            integrationTest.dependsOn(publishingTask)
+tasks.integrationTest {
+    inputs.dir(file("projects"))
+    rootProject.allprojects.forEach { otherProject ->
+        otherProject.invokeWhenEvaluated { evaluatedProject ->
+            evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
+                this.dependsOn(publishingTask)
+            }
         }
     }
 }
-- 
cgit 


From caf48e76f3bff5e9907cd094cf0719f623e528d5 Mon Sep 17 00:00:00 2001
From: "sebastian.sellmair" <sebastian.sellmair@jetbrains.com>
Date: Wed, 8 Jul 2020 10:47:05 +0200
Subject: Implement simple MavenIntegrationTest.kt

---
 .../src/main/kotlin/org/jetbrains/taskUtils.kt     |  13 ++
 integration-tests/build.gradle.kts                 |   3 +-
 integration-tests/cli/build.gradle.kts             |   5 +-
 .../jetbrains/dokka/it/cli/CliIntegrationTest.kt   |   1 +
 .../org/jetbrains/dokka/it/cli/processUtils.kt     |  51 -------
 integration-tests/gradle/build.gradle.kts          |  10 +-
 .../it/gradle/Android0GradleIntegrationTest.kt     |  14 +-
 integration-tests/maven/build.gradle.kts           |  17 +++
 integration-tests/maven/projects/it-maven/pom.xml  | 170 +++++++++++++++++++++
 .../main/java/it/basic/java/SampleJavaClass.java   |  22 +++
 .../src/main/kotlin/it/basic/PublicClass.kt        |  48 ++++++
 .../dokka/it/maven/MavenIntegrationTest.kt         |  78 ++++++++++
 .../org/jetbrains/dokka/it/environmentUtils.kt     |  16 ++
 .../kotlin/org/jetbrains/dokka/it/processUtils.kt  |  51 +++++++
 runners/maven-plugin/build.gradle.kts              |   3 +
 runners/maven-plugin/src/main/kotlin/DokkaMojo.kt  |   3 -
 settings.gradle.kts                                |   1 +
 17 files changed, 428 insertions(+), 78 deletions(-)
 create mode 100644 buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt
 delete mode 100644 integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt
 create mode 100644 integration-tests/maven/build.gradle.kts
 create mode 100644 integration-tests/maven/projects/it-maven/pom.xml
 create mode 100644 integration-tests/maven/projects/it-maven/src/main/java/it/basic/java/SampleJavaClass.java
 create mode 100644 integration-tests/maven/projects/it-maven/src/main/kotlin/it/basic/PublicClass.kt
 create mode 100644 integration-tests/maven/src/integrationTest/kotlin/org/jetbrains/dokka/it/maven/MavenIntegrationTest.kt
 create mode 100644 integration-tests/src/main/kotlin/org/jetbrains/dokka/it/environmentUtils.kt
 create mode 100644 integration-tests/src/main/kotlin/org/jetbrains/dokka/it/processUtils.kt

(limited to 'integration-tests/build.gradle.kts')

diff --git a/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt b/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt
new file mode 100644
index 00000000..b018ba13
--- /dev/null
+++ b/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt
@@ -0,0 +1,13 @@
+package org.jetbrains
+
+import org.gradle.api.Task
+
+fun Task.dependsOnMavenLocalPublication() {
+        project.rootProject.allprojects.forEach { otherProject ->
+            otherProject.invokeWhenEvaluated { evaluatedProject ->
+                evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
+                    this.dependsOn(publishingTask)
+                }
+            }
+        }
+}
diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
index 70b6db26..070091a0 100644
--- a/integration-tests/build.gradle.kts
+++ b/integration-tests/build.gradle.kts
@@ -37,4 +37,5 @@ subprojects {
 dependencies {
     implementation(kotlin("stdlib"))
     implementation(kotlin("test-junit"))
-}
+    val coroutines_version: String by project
+    api("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")}
diff --git a/integration-tests/cli/build.gradle.kts b/integration-tests/cli/build.gradle.kts
index 5fdf0ff5..60d3a298 100644
--- a/integration-tests/cli/build.gradle.kts
+++ b/integration-tests/cli/build.gradle.kts
@@ -12,10 +12,6 @@ evaluationDependsOn(":plugins:base")
 dependencies {
     implementation(kotlin("stdlib"))
     implementation(kotlin("test-junit"))
-
-    val coroutines_version: String by project
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")
-
 }
 
 /* Create a fat base plugin jar for cli tests */
@@ -35,6 +31,7 @@ val basePluginShadowJar by tasks.register("basePluginShadowJar", ShadowJar::clas
 }
 
 tasks.integrationTest {
+    inputs.dir((file("projects")))
     val cliJar = tasks.getByPath(":runners:cli:shadowJar") as ShadowJar
     environment("CLI_JAR_PATH", cliJar.archiveFile.get())
     environment("BASE_PLUGIN_JAR_PATH", basePluginShadowJar.archiveFile.get())
diff --git a/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt b/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt
index 49030c73..9f83c869 100644
--- a/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt
+++ b/integration-tests/cli/src/integrationTest/kotlin/org/jetbrains/dokka/it/cli/CliIntegrationTest.kt
@@ -1,5 +1,6 @@
 package org.jetbrains.dokka.it.cli
 
+import org.jetbrains.dokka.it.awaitProcessResult
 import java.io.File
 import kotlin.test.BeforeTest
 import kotlin.test.Test
diff --git a/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt b/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt
deleted file mode 100644
index d2fa3b31..00000000
--- a/integration-tests/cli/src/main/kotlin/org/jetbrains/dokka/it/cli/processUtils.kt
+++ /dev/null
@@ -1,51 +0,0 @@
-package org.jetbrains.dokka.it.cli
-
-import kotlinx.coroutines.CompletableDeferred
-import kotlinx.coroutines.async
-import kotlinx.coroutines.runBlocking
-import kotlin.concurrent.thread
-
-class ProcessResult(
-    val exitCode: Int,
-    val output: String
-)
-
-fun Process.awaitProcessResult() = runBlocking {
-    val exitCode = async { awaitExitCode() }
-    val output = async { awaitOutput() }
-    ProcessResult(
-        exitCode.await(),
-        output.await()
-    )
-}
-
-private suspend fun Process.awaitExitCode(): Int {
-    val deferred = CompletableDeferred<Int>()
-    thread {
-        try {
-            deferred.complete(this.waitFor())
-        } catch (e: Throwable) {
-            deferred.completeExceptionally(e)
-        }
-    }
-
-    return deferred.await()
-}
-
-private suspend fun Process.awaitOutput(): String {
-    val deferred = CompletableDeferred<String>()
-    thread {
-        try {
-            var string = ""
-            this.inputStream.bufferedReader().forEachLine { line ->
-                println(line)
-                string += line + System.lineSeparator()
-            }
-            deferred.complete(string)
-        } catch (e: Throwable) {
-            deferred.completeExceptionally(e)
-        }
-    }
-
-    return deferred.await()
-}
diff --git a/integration-tests/gradle/build.gradle.kts b/integration-tests/gradle/build.gradle.kts
index 28e20cf9..3da416bb 100644
--- a/integration-tests/gradle/build.gradle.kts
+++ b/integration-tests/gradle/build.gradle.kts
@@ -1,4 +1,4 @@
-import org.jetbrains.invokeWhenEvaluated
+import org.jetbrains.dependsOnMavenLocalPublication
 
 dependencies {
     implementation(kotlin("stdlib"))
@@ -8,13 +8,7 @@ dependencies {
 
 tasks.integrationTest {
     inputs.dir(file("projects"))
-    rootProject.allprojects.forEach { otherProject ->
-        otherProject.invokeWhenEvaluated { evaluatedProject ->
-            evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
-                this.dependsOn(publishingTask)
-            }
-        }
-    }
+    dependsOnMavenLocalPublication()
 }
 
 tasks.clean {
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
index e08dbca5..0a29555f 100644
--- a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
@@ -1,6 +1,8 @@
 package org.jetbrains.dokka.it.gradle
 
 import org.gradle.testkit.runner.TaskOutcome
+import org.jetbrains.dokka.it.isAndroidSdkInstalled
+import org.jetbrains.dokka.it.isCI
 import org.junit.Assume
 import org.junit.runners.Parameterized.Parameters
 import java.io.File
@@ -28,20 +30,10 @@ class Android0GradleIntegrationTest(override val versions: BuildVersions) : Abst
 
     @BeforeTest
     fun assumeAndroidInstallation() {
-        val isCI = System.getenv("CI") != null
         if (isCI) {
             return
         }
-
-        val androidSdkRoot = System.getenv("ANDROID_SDK_ROOT")
-        val androidHome = System.getenv("ANDROID_HOME")
-
-        val isAndroidSdkInstalled = androidSdkRoot != null || androidHome != null
-
-        Assume.assumeTrue(
-            "Missing ANDROID_SDK_ROOT",
-            isAndroidSdkInstalled
-        )
+        Assume.assumeTrue("Missing ANDROID_SDK_ROOT", isAndroidSdkInstalled)
     }
 
     @BeforeTest
diff --git a/integration-tests/maven/build.gradle.kts b/integration-tests/maven/build.gradle.kts
new file mode 100644
index 00000000..b0187b13
--- /dev/null
+++ b/integration-tests/maven/build.gradle.kts
@@ -0,0 +1,17 @@
+import org.jetbrains.dependsOnMavenLocalPublication
+
+evaluationDependsOn(":runners:maven-plugin")
+
+dependencies {
+    implementation(kotlin("stdlib"))
+    implementation(kotlin("test-junit"))
+}
+
+tasks.integrationTest {
+    dependsOnMavenLocalPublication()
+    dependsOn(":runners:maven-plugin:setupMaven")
+
+    val dokka_version: String by project
+    environment("DOKKA_VERSION", dokka_version)
+    environment("MVN_BINARY_PATH", project(":runners:maven-plugin").extra["MVN_BINARY_PATH"].toString())
+}
diff --git a/integration-tests/maven/projects/it-maven/pom.xml b/integration-tests/maven/projects/it-maven/pom.xml
new file mode 100644
index 00000000..47bd633c
--- /dev/null
+++ b/integration-tests/maven/projects/it-maven/pom.xml
@@ -0,0 +1,170 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>org.jetbrains.dokka</groupId>
+    <artifactId>it-maven</artifactId>
+    <version>1.0-SNAPSHOT</version>
+
+    <properties>
+        <kotlin.version>1.3.72</kotlin.version>
+    </properties>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.jetbrains.kotlin</groupId>
+                <artifactId>kotlin-maven-plugin</artifactId>
+                <version>${kotlin.version}</version>
+                <executions>
+                    <execution>
+                        <id>compile</id>
+                        <goals>
+                            <goal>compile</goal>
+                        </goals>
+                        <configuration>
+                            <sourceDirs>
+                                <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
+                                <sourceDir>${project.basedir}/src/main/java</sourceDir>
+                            </sourceDirs>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>test-compile</id>
+                        <goals>
+                            <goal>test-compile</goal>
+                        </goals>
+                        <configuration>
+                            <sourceDirs>
+                                <sourceDir>${project.basedir}/src/test/kotlin</sourceDir>
+                                <sourceDir>${project.basedir}/src/test/java</sourceDir>
+                            </sourceDirs>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.5.1</version>
+                <executions>
+                    <!-- Replacing default-compile as it is treated specially by maven -->
+                    <execution>
+                        <id>default-compile</id>
+                        <phase>none</phase>
+                    </execution>
+                    <!-- Replacing default-testCompile as it is treated specially by maven -->
+                    <execution>
+                        <id>default-testCompile</id>
+                        <phase>none</phase>
+                    </execution>
+                    <execution>
+                        <id>java-compile</id>
+                        <phase>compile</phase>
+                        <goals>
+                            <goal>compile</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>java-test-compile</id>
+                        <phase>test-compile</phase>
+                        <goals>
+                            <goal>testCompile</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.jetbrains.dokka</groupId>
+                <artifactId>dokka-maven-plugin</artifactId>
+                <version>$dokka_version</version>
+                <executions>
+                    <execution>
+                        <phase>pre-site</phase>
+                        <goals>
+                            <goal>dokka</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+
+                    <!-- Set to true to skip dokka task, default: false -->
+                    <skip>false</skip>
+
+                    <!-- Default: ${project.artifactId} -->
+                    <moduleDisplayName>Maven Integration Test Module</moduleDisplayName>
+
+                    <!-- See list of possible formats below -->
+                    <outputFormat>html</outputFormat>
+                    <!-- Default: ${project.basedir}/target/dokka -->
+                    <outputDir>${project.basedir}/output</outputDir>
+
+                    <!-- Use default or set to custom path to cache directory to enable package-list caching. -->
+                    <!-- When set to default, caches stored in $USER_HOME/.cache/dokka -->
+                    <cacheRoot>default</cacheRoot>
+
+
+                    <!-- Used for linking to JDK, default: 6 -->
+                    <jdkVersion>8</jdkVersion>
+
+                    <!-- Do not output deprecated members, applies globally, can be overridden by packageOptions -->
+                    <skipDeprecated>false</skipDeprecated>
+                    <!-- Emit warnings about not documented members, applies globally, also can be overridden by packageOptions -->
+                    <reportUndocumented>true</reportUndocumented>
+                    <!-- Do not create index pages for empty packages -->
+                    <skipEmptyPackages>true</skipEmptyPackages>
+
+                    <!-- Short form list of sourceRoots, by default, set to ${project.compileSourceRoots} -->
+                    <sourceDirectories>
+                        <dir>${project.basedir}/src/main/kotlin</dir>
+                        <dir>${project.basedir}/src/main/java</dir>
+                    </sourceDirectories>
+
+
+                    <!-- Disable linking to online kotlin-stdlib documentation  -->
+                    <noStdlibLink>false</noStdlibLink>
+
+                    <!-- Disable linking to online JDK documentation -->
+                    <noJdkLink>false</noJdkLink>
+
+                    <!-- Allows to customize documentation generation options on a per-package basis -->
+                    <perPackageOptions>
+                        <packageOptions>
+                            <!-- Will match kotlin and all sub-packages of it -->
+                            <prefix>kotlin</prefix>
+
+                            <!-- All options are optional, default values are below: -->
+                            <skipDeprecated>false</skipDeprecated>
+                            <!-- Emit warnings about not documented members  -->
+                            <reportUndocumented>true</reportUndocumented>
+                            <includeNonPublic>false</includeNonPublic>
+                        </packageOptions>
+                    </perPackageOptions>
+                </configuration>
+            </plugin>
+        </plugins>
+        <sourceDirectory>${project.basedir}/src/main/kotlin</sourceDirectory>
+        <testSourceDirectory>${project.basedir}/src/test/kotlin</testSourceDirectory>
+    </build>
+
+    <pluginRepositories>
+        <pluginRepository>
+            <id>kotlin-dev</id>
+            <url>https://dl.bintray.com/kotlin/kotlin-dev/</url>
+        </pluginRepository>
+        <pluginRepository>
+            <id>jcenter</id>
+            <name>JCenter</name>
+            <url>https://jcenter.bintray.com/</url>
+        </pluginRepository>
+    </pluginRepositories>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.jetbrains.kotlin</groupId>
+            <artifactId>kotlin-stdlib</artifactId>
+            <version>${kotlin.version}</version>
+        </dependency>
+    </dependencies>
+
+
+</project>
diff --git a/integration-tests/maven/projects/it-maven/src/main/java/it/basic/java/SampleJavaClass.java b/integration-tests/maven/projects/it-maven/src/main/java/it/basic/java/SampleJavaClass.java
new file mode 100644
index 00000000..e08bb66a
--- /dev/null
+++ b/integration-tests/maven/projects/it-maven/src/main/java/it/basic/java/SampleJavaClass.java
@@ -0,0 +1,22 @@
+package it.basic.java;
+
+import it.basic.PublicClass;
+
+/**
+ * This class is, unlike {@link PublicClass}, written in Java
+ */
+@SuppressWarnings("unused")
+public class SampleJavaClass {
+
+    /**
+     * @return Empty instance of {@link PublicClass}
+     */
+    public PublicClass publicDocumentedFunction() {
+        return new PublicClass();
+    }
+
+
+    public PublicClass publicUndocumentedFunction() {
+        return new PublicClass();
+    }
+}
diff --git a/integration-tests/maven/projects/it-maven/src/main/kotlin/it/basic/PublicClass.kt b/integration-tests/maven/projects/it-maven/src/main/kotlin/it/basic/PublicClass.kt
new file mode 100644
index 00000000..71bc7e63
--- /dev/null
+++ b/integration-tests/maven/projects/it-maven/src/main/kotlin/it/basic/PublicClass.kt
@@ -0,0 +1,48 @@
+@file:Suppress("unused")
+
+package it.basic
+
+class PublicClass {
+    /**
+     * This function is public and documented
+     */
+    fun publicDocumentedFunction(): String = ""
+
+    fun publicUndocumentedFunction(): String = ""
+
+    /**
+     * This function is internal and documented
+     */
+    internal fun internalDocumentedFunction(): String = ""
+
+    internal fun internalUndocumentedFunction(): String = ""
+
+    /**
+     * This function is private and documented
+     */
+    private fun privateDocumentedFunction(): String = ""
+
+    private fun privateUndocumentedFunction(): String = ""
+
+
+    /**
+     * This property is public and documented
+     */
+    val publicDocumentedProperty: Int = 0
+
+    val publicUndocumentedProperty: Int = 0
+
+    /**
+     * This property internal and documented
+     */
+    val internalDocumentedProperty: Int = 0
+
+    val internalUndocumentedProperty: Int = 0
+
+    /**
+     * This property private and documented
+     */
+    private val privateDocumentedProperty: Int = 0
+
+    private val privateUndocumentedProperty: Int = 0
+}
diff --git a/integration-tests/maven/src/integrationTest/kotlin/org/jetbrains/dokka/it/maven/MavenIntegrationTest.kt b/integration-tests/maven/src/integrationTest/kotlin/org/jetbrains/dokka/it/maven/MavenIntegrationTest.kt
new file mode 100644
index 00000000..e52debf4
--- /dev/null
+++ b/integration-tests/maven/src/integrationTest/kotlin/org/jetbrains/dokka/it/maven/MavenIntegrationTest.kt
@@ -0,0 +1,78 @@
+package org.jetbrains.dokka.it.maven
+
+import org.jetbrains.dokka.it.AbstractIntegrationTest
+import org.jetbrains.dokka.it.awaitProcessResult
+import java.io.File
+import kotlin.test.BeforeTest
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertTrue
+
+class MavenIntegrationTest : AbstractIntegrationTest() {
+
+    val currentDokkaVersion: String = checkNotNull(System.getenv("DOKKA_VERSION"))
+
+    val mavenBinaryFile: File = File(checkNotNull(System.getenv("MVN_BINARY_PATH")))
+
+    @BeforeTest
+    fun prepareProjectFiles() {
+        val templateProjectDir = File("projects", "it-maven")
+        templateProjectDir.copyRecursively(projectDir)
+        val pomXml = File(projectDir, "pom.xml")
+        assertTrue(pomXml.isFile)
+        pomXml.apply {
+            writeText(readText().replace("\$dokka_version", currentDokkaVersion))
+        }
+    }
+
+    @Test
+    fun run() {
+        val result = ProcessBuilder().directory(projectDir)
+            .command(mavenBinaryFile.absolutePath, "dokka:dokka", "-U", "-e").start().awaitProcessResult()
+
+        assertEquals(0, result.exitCode, "Expected exitCode 0 (Success)")
+
+        val extensionLoadedRegex = Regex("""Extension: org\.jetbrains\.dokka\.base\.DokkaBase""")
+        val amountOfExtensionsLoaded = extensionLoadedRegex.findAll(result.output).count()
+
+        assertTrue(
+            amountOfExtensionsLoaded > 10,
+            "Expected more than 10 extensions being present (found $amountOfExtensionsLoaded)"
+        )
+
+        val undocumentedReportRegex = Regex("""Undocumented:""")
+        val amountOfUndocumentedReports = undocumentedReportRegex.findAll(result.output).count()
+        assertTrue(
+            amountOfUndocumentedReports > 0,
+            "Expected at least one report of undocumented code (found $amountOfUndocumentedReports)"
+        )
+
+        val undocumentedJavaReportRegex = Regex("""Undocumented: it\.basic\.java""")
+        val amountOfUndocumentedJavaReports = undocumentedJavaReportRegex.findAll(result.output).count()
+        assertTrue(
+            amountOfUndocumentedJavaReports > 0,
+            "Expected at least one report of undocumented java code (found $amountOfUndocumentedJavaReports)"
+        )
+
+        val dokkaOutputDir = File(projectDir, "output")
+        assertTrue(dokkaOutputDir.isDirectory, "Missing dokka output directory")
+
+        val imagesDir = File(dokkaOutputDir, "images")
+        assertTrue(imagesDir.isDirectory, "Missing images directory")
+
+        val scriptsDir = File(dokkaOutputDir, "scripts")
+        assertTrue(scriptsDir.isDirectory, "Missing scripts directory")
+
+        val stylesDir = File(dokkaOutputDir, "styles")
+        assertTrue(stylesDir.isDirectory, "Missing styles directory")
+
+        val navigationHtml = File(dokkaOutputDir, "navigation.html")
+        assertTrue(navigationHtml.isFile, "Missing navigation.html")
+
+        projectDir.allHtmlFiles().forEach { file ->
+            assertContainsNoErrorClass(file)
+            assertNoUnresolvedLInks(file)
+        }
+
+    }
+}
diff --git a/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/environmentUtils.kt b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/environmentUtils.kt
new file mode 100644
index 00000000..eadf5a8c
--- /dev/null
+++ b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/environmentUtils.kt
@@ -0,0 +1,16 @@
+package org.jetbrains.dokka.it
+
+import java.io.File
+
+/**
+ * Indicating whether or not the current machine executing the test is a CI
+ */
+val isCI: Boolean get() = System.getenv("CI") == "true"
+
+val isAndroidSdkInstalled: Boolean = System.getenv("ANDROID_SDK_ROOT") != null ||
+        System.getenv("ANDROID_HOME") != null
+
+val isMavenInstalled: Boolean = System.getenv("PATH").orEmpty()
+    .split(File.pathSeparator)
+    .flatMap { pathElement -> File(pathElement).listFiles().orEmpty().toList() }
+    .any { pathElement -> "mvn" == pathElement.name }
diff --git a/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/processUtils.kt b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/processUtils.kt
new file mode 100644
index 00000000..d2c048ac
--- /dev/null
+++ b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/processUtils.kt
@@ -0,0 +1,51 @@
+package org.jetbrains.dokka.it
+
+import kotlinx.coroutines.CompletableDeferred
+import kotlinx.coroutines.async
+import kotlinx.coroutines.runBlocking
+import kotlin.concurrent.thread
+
+class ProcessResult(
+    val exitCode: Int,
+    val output: String
+)
+
+fun Process.awaitProcessResult() = runBlocking {
+    val exitCode = async { awaitExitCode() }
+    val output = async { awaitOutput() }
+    ProcessResult(
+        exitCode.await(),
+        output.await()
+    )
+}
+
+private suspend fun Process.awaitExitCode(): Int {
+    val deferred = CompletableDeferred<Int>()
+    thread {
+        try {
+            deferred.complete(this.waitFor())
+        } catch (e: Throwable) {
+            deferred.completeExceptionally(e)
+        }
+    }
+
+    return deferred.await()
+}
+
+private suspend fun Process.awaitOutput(): String {
+    val deferred = CompletableDeferred<String>()
+    thread {
+        try {
+            var string = ""
+            this.inputStream.bufferedReader().forEachLine { line ->
+                println(line)
+                string += line + System.lineSeparator()
+            }
+            deferred.complete(string)
+        } catch (e: Throwable) {
+            deferred.completeExceptionally(e)
+        }
+    }
+
+    return deferred.await()
+}
diff --git a/runners/maven-plugin/build.gradle.kts b/runners/maven-plugin/build.gradle.kts
index d9fc4f6f..8e412b43 100644
--- a/runners/maven-plugin/build.gradle.kts
+++ b/runners/maven-plugin/build.gradle.kts
@@ -1,5 +1,6 @@
 import org.jetbrains.configureBintrayPublication
 import org.jetbrains.CrossPlatformExec
+
 /**
  * [mavenBin] configuration is used to download Maven Plugin Plugin
  * for generating plugin-help.xml and plugin.xml files
@@ -30,6 +31,7 @@ dependencies {
 val mavenBinDir = "$buildDir/maven-bin"
 val mavenBuildDir = "$buildDir/maven"
 val mvn = File(mavenBinDir, "apache-maven-$mavenVersion/bin/mvn")
+extra.set("MVN_BINARY_PATH", mvn.absolutePath)
 
 tasks.named<Delete>("clean") {
     delete(mavenBinDir)
@@ -48,6 +50,7 @@ val setupMaven by tasks.registering(Sync::class) {
  */
 val generatePom by tasks.registering(Copy::class) {
     val dokka_version: String by project
+    inputs.property("dokka_version", dokka_version)
 
     from("$projectDir/pom.tpl.xml") {
         rename("(.*).tpl.xml", "$1.xml")
diff --git a/runners/maven-plugin/src/main/kotlin/DokkaMojo.kt b/runners/maven-plugin/src/main/kotlin/DokkaMojo.kt
index 8160ab87..aa92516f 100644
--- a/runners/maven-plugin/src/main/kotlin/DokkaMojo.kt
+++ b/runners/maven-plugin/src/main/kotlin/DokkaMojo.kt
@@ -87,9 +87,6 @@ abstract class AbstractDokkaMojo : AbstractMojo() {
     @Parameter(required = true, defaultValue = "\${project.compileSourceRoots}")
     var sourceDirectories: List<String> = emptyList()
 
-    @Parameter
-    var sourceRoots: List<SourceRoot> = emptyList()
-
     @Parameter
     var samples: List<String> = emptyList()
 
diff --git a/settings.gradle.kts b/settings.gradle.kts
index 409dca88..ecee8020 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -21,6 +21,7 @@ include("plugins:javadoc")
 include("integration-tests")
 include("integration-tests:gradle")
 include("integration-tests:cli")
+include("integration-tests:maven")
 
 pluginManagement {
     val kotlin_version: String by settings
-- 
cgit 


From 4ba7ec9facb26c5ae0b0dd434e07c4af728f277a Mon Sep 17 00:00:00 2001
From: "sebastian.sellmair" <sebastian.sellmair@jetbrains.com>
Date: Wed, 8 Jul 2020 18:17:46 +0200
Subject: maven-integration-test: Fix style issues

---
 buildSrc/src/main/kotlin/org/jetbrains/SetupMaven.kt |  1 -
 buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt  | 10 +++++-----
 integration-tests/build.gradle.kts                   |  2 +-
 integration-tests/cli/build.gradle.kts               |  2 +-
 4 files changed, 7 insertions(+), 8 deletions(-)

(limited to 'integration-tests/build.gradle.kts')

diff --git a/buildSrc/src/main/kotlin/org/jetbrains/SetupMaven.kt b/buildSrc/src/main/kotlin/org/jetbrains/SetupMaven.kt
index 519eea13..4ef26a73 100644
--- a/buildSrc/src/main/kotlin/org/jetbrains/SetupMaven.kt
+++ b/buildSrc/src/main/kotlin/org/jetbrains/SetupMaven.kt
@@ -1,6 +1,5 @@
 package org.jetbrains
 
-import org.gradle.api.DefaultTask
 import org.gradle.api.artifacts.Configuration
 import org.gradle.api.tasks.Input
 import org.gradle.api.tasks.Internal
diff --git a/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt b/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt
index b018ba13..ef9c5e6a 100644
--- a/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt
+++ b/buildSrc/src/main/kotlin/org/jetbrains/taskUtils.kt
@@ -3,11 +3,11 @@ package org.jetbrains
 import org.gradle.api.Task
 
 fun Task.dependsOnMavenLocalPublication() {
-        project.rootProject.allprojects.forEach { otherProject ->
-            otherProject.invokeWhenEvaluated { evaluatedProject ->
-                evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
-                    this.dependsOn(publishingTask)
-                }
+    project.rootProject.allprojects.forEach { otherProject ->
+        otherProject.invokeWhenEvaluated { evaluatedProject ->
+            evaluatedProject.tasks.findByName("publishToMavenLocal")?.let { publishingTask ->
+                this.dependsOn(publishingTask)
             }
         }
+    }
 }
diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
index 070091a0..8458f1fe 100644
--- a/integration-tests/build.gradle.kts
+++ b/integration-tests/build.gradle.kts
@@ -38,4 +38,4 @@ dependencies {
     implementation(kotlin("stdlib"))
     implementation(kotlin("test-junit"))
     val coroutines_version: String by project
-    api("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")}
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")}
diff --git a/integration-tests/cli/build.gradle.kts b/integration-tests/cli/build.gradle.kts
index 60d3a298..d9961f8f 100644
--- a/integration-tests/cli/build.gradle.kts
+++ b/integration-tests/cli/build.gradle.kts
@@ -31,7 +31,7 @@ val basePluginShadowJar by tasks.register("basePluginShadowJar", ShadowJar::clas
 }
 
 tasks.integrationTest {
-    inputs.dir((file("projects")))
+    inputs.dir(file("projects"))
     val cliJar = tasks.getByPath(":runners:cli:shadowJar") as ShadowJar
     environment("CLI_JAR_PATH", cliJar.archiveFile.get())
     environment("BASE_PLUGIN_JAR_PATH", basePluginShadowJar.archiveFile.get())
-- 
cgit 


From e940349980c40f87309c9ae80593519952d9dd7f Mon Sep 17 00:00:00 2001
From: "sebastian.sellmair" <sebastian.sellmair@jetbrains.com>
Date: Fri, 10 Jul 2020 12:34:15 +0200
Subject: Implement basic assertNoUnresolvedHref

---
 integration-tests/build.gradle.kts                 |  4 +++-
 .../it/gradle/Android0GradleIntegrationTest.kt     |  1 +
 .../dokka/it/gradle/BasicGradleIntegrationTest.kt  |  2 +-
 .../dokka/it/gradle/MultiModule0IntegrationTest.kt |  1 +
 .../gradle/Multiplatform0GradleIntegrationTest.kt  |  2 +-
 .../jetbrains/dokka/it/AbstractIntegrationTest.kt  | 28 ++++++++++++++++++++++
 6 files changed, 35 insertions(+), 3 deletions(-)

(limited to 'integration-tests/build.gradle.kts')

diff --git a/integration-tests/build.gradle.kts b/integration-tests/build.gradle.kts
index 8458f1fe..fb987c36 100644
--- a/integration-tests/build.gradle.kts
+++ b/integration-tests/build.gradle.kts
@@ -38,4 +38,6 @@ dependencies {
     implementation(kotlin("stdlib"))
     implementation(kotlin("test-junit"))
     val coroutines_version: String by project
-    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")}
+    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutines_version")
+    implementation("org.jsoup:jsoup:1.12.1")
+}
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
index 0a29555f..2b8ba45d 100644
--- a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Android0GradleIntegrationTest.kt
@@ -57,6 +57,7 @@ class Android0GradleIntegrationTest(override val versions: BuildVersions) : Abst
         projectDir.allHtmlFiles().forEach { file ->
             assertContainsNoErrorClass(file)
             assertNoUnresolvedLInks(file)
+            assertNoHrefToMissingLocalFileOrDirectory(file)
         }
 
         assertTrue(
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
index a15dc60a..87460080 100644
--- a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/BasicGradleIntegrationTest.kt
@@ -1,7 +1,6 @@
 package org.jetbrains.dokka.it.gradle
 
 import org.gradle.testkit.runner.TaskOutcome
-import org.junit.runners.Parameterized
 import org.junit.runners.Parameterized.Parameters
 import java.io.File
 import kotlin.test.*
@@ -76,6 +75,7 @@ class BasicGradleIntegrationTest(override val versions: BuildVersions) : Abstrac
         allHtmlFiles().forEach { file ->
             assertContainsNoErrorClass(file)
             assertNoUnresolvedLInks(file)
+            assertNoHrefToMissingLocalFileOrDirectory(file)
         }
     }
 
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/MultiModule0IntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/MultiModule0IntegrationTest.kt
index 36362552..e4f8b189 100644
--- a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/MultiModule0IntegrationTest.kt
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/MultiModule0IntegrationTest.kt
@@ -36,6 +36,7 @@ class MultiModule0IntegrationTest(override val versions: BuildVersions) : Abstra
         dokkaOutputDir.allHtmlFiles().forEach { file ->
             assertContainsNoErrorClass(file)
             assertNoUnresolvedLInks(file)
+            assertNoHrefToMissingLocalFileOrDirectory(file)
         }
     }
 }
diff --git a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
index b54eecb1..491f5610 100644
--- a/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
+++ b/integration-tests/gradle/src/integrationTest/kotlin/org/jetbrains/dokka/it/gradle/Multiplatform0GradleIntegrationTest.kt
@@ -1,7 +1,6 @@
 package org.jetbrains.dokka.it.gradle
 
 import org.gradle.testkit.runner.TaskOutcome
-import org.gradle.util.GradleVersion
 import org.junit.runners.Parameterized
 import java.io.File
 import kotlin.test.*
@@ -38,6 +37,7 @@ class Multiplatform0GradleIntegrationTest(override val versions: BuildVersions)
         dokkaOutputDir.allHtmlFiles().forEach { file ->
             assertContainsNoErrorClass(file)
             assertNoUnresolvedLInks(file)
+            assertNoHrefToMissingLocalFileOrDirectory(file)
         }
     }
 }
diff --git a/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt
index 4af523a2..0a83045e 100644
--- a/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt
+++ b/integration-tests/src/main/kotlin/org/jetbrains/dokka/it/AbstractIntegrationTest.kt
@@ -1,9 +1,11 @@
 package org.jetbrains.dokka.it
 
+import org.jsoup.Jsoup
 import org.junit.Rule
 import org.junit.rules.TemporaryFolder
 import java.io.File
 import kotlin.test.assertFalse
+import kotlin.test.assertTrue
 
 abstract class AbstractIntegrationTest {
 
@@ -36,4 +38,30 @@ abstract class AbstractIntegrationTest {
             "Unexpected unresolved link in ${file.path}\n" + fileText
         )
     }
+
+    protected fun assertNoHrefToMissingLocalFileOrDirectory(
+        file: File, fileExtensions: Set<String> = setOf("html")
+    ) {
+        val fileText = file.readText()
+        val html = Jsoup.parse(fileText)
+        html.allElements.toList().forEach { element ->
+            val href = element.attr("href") ?: return@forEach
+
+            if (href.startsWith("#")) return@forEach
+            if (href.startsWith("https")) return@forEach
+            if (href.startsWith("http")) return@forEach
+
+            val targetFile = File(file.parent, href)
+            if (targetFile.extension.isNotEmpty() && targetFile.extension !in fileExtensions) return@forEach
+
+            if (
+                targetFile.extension.isEmpty() || targetFile.extension == "html" && !href.startsWith("#")) {
+                assertTrue(
+                    targetFile.exists(),
+                    "${file.relativeTo(projectDir).path}: href=\"$href\"\n" +
+                            "file does not exist: ${targetFile.relativeTo(projectDir).path}"
+                )
+            }
+        }
+    }
 }
-- 
cgit