"Main should return Unit" inspection: extend on JUnit test methods

So #KT-24509 Fixed
This commit is contained in:
Toshiaki Kameyama
2018-06-05 23:26:53 +03:00
committed by Mikhail Glukhikh
parent b5e3db1811
commit 69d2e8898a
15 changed files with 80 additions and 15 deletions
@@ -1,5 +1,5 @@
<html>
<body>
This inspection reports a main function with incorrect return type (should be <b>Unit</b>).
This inspection reports a entry point function with incorrect return type (should be <b>Unit</b>).
</body>
</html>
+1 -1
View File
@@ -2856,7 +2856,7 @@ The Kotlin plugin provides language support in IntelliJ IDEA and Android Studio.
/>
<localInspection implementationClass="org.jetbrains.kotlin.idea.inspections.MainFunctionReturnUnitInspection"
displayName="Main function should return Unit"
displayName="Entry point function should return Unit"
groupPath="Kotlin"
groupName="Probable bugs"
enabledByDefault="true"
+1 -1
View File
@@ -2854,7 +2854,7 @@ The Kotlin plugin provides language support in IntelliJ IDEA and Android Studio.
/>
<localInspection implementationClass="org.jetbrains.kotlin.idea.inspections.MainFunctionReturnUnitInspection"
displayName="Main function should return Unit"
displayName="Entry point function should return Unit"
groupPath="Kotlin"
groupName="Probable bugs"
enabledByDefault="true"
+1 -1
View File
@@ -2854,7 +2854,7 @@ The Kotlin plugin provides language support in IntelliJ IDEA and Android Studio.
/>
<localInspection implementationClass="org.jetbrains.kotlin.idea.inspections.MainFunctionReturnUnitInspection"
displayName="Main function should return Unit"
displayName="Entry point function should return Unit"
groupPath="Kotlin"
groupName="Probable bugs"
enabledByDefault="true"
+1 -1
View File
@@ -2855,7 +2855,7 @@ The Kotlin plugin provides language support in IntelliJ IDEA and Android Studio.
/>
<localInspection implementationClass="org.jetbrains.kotlin.idea.inspections.MainFunctionReturnUnitInspection"
displayName="Main function should return Unit"
displayName="Entry point function should return Unit"
groupPath="Kotlin"
groupName="Probable bugs"
enabledByDefault="true"
+1 -1
View File
@@ -2854,7 +2854,7 @@ The Kotlin plugin provides language support in IntelliJ IDEA and Android Studio.
/>
<localInspection implementationClass="org.jetbrains.kotlin.idea.inspections.MainFunctionReturnUnitInspection"
displayName="Main function should return Unit"
displayName="Entry point function should return Unit"
groupPath="Kotlin"
groupName="Probable bugs"
enabledByDefault="true"
+1 -1
View File
@@ -2854,7 +2854,7 @@ The Kotlin plugin provides language support in IntelliJ IDEA and Android Studio.
/>
<localInspection implementationClass="org.jetbrains.kotlin.idea.inspections.MainFunctionReturnUnitInspection"
displayName="Main function should return Unit"
displayName="Entry point function should return Unit"
groupPath="Kotlin"
groupName="Probable bugs"
enabledByDefault="true"
@@ -10,32 +10,41 @@ import com.intellij.codeInspection.ProblemDescriptor
import com.intellij.codeInspection.ProblemHighlightType
import com.intellij.codeInspection.ProblemsHolder
import com.intellij.openapi.project.Project
import com.intellij.openapi.util.TextRange
import com.intellij.psi.PsiElementVisitor
import org.jetbrains.kotlin.builtins.KotlinBuiltIns
import org.jetbrains.kotlin.descriptors.FunctionDescriptor
import org.jetbrains.kotlin.idea.MainFunctionDetector
import org.jetbrains.kotlin.idea.caches.resolve.analyze
import org.jetbrains.kotlin.idea.core.setType
import org.jetbrains.kotlin.idea.search.usagesSearch.descriptor
import org.jetbrains.kotlin.name.FqName
import org.jetbrains.kotlin.psi.KtAnnotationEntry
import org.jetbrains.kotlin.psi.KtNamedFunction
import org.jetbrains.kotlin.psi.namedFunctionVisitor
import org.jetbrains.kotlin.psi.psiUtil.endOffset
import org.jetbrains.kotlin.psi.psiUtil.getNonStrictParentOfType
import org.jetbrains.kotlin.psi.psiUtil.getParentOfType
import org.jetbrains.kotlin.psi.psiUtil.startOffset
import org.jetbrains.kotlin.resolve.BindingContext
import org.jetbrains.kotlin.resolve.descriptorUtil.fqNameSafe
import org.jetbrains.kotlin.resolve.lazy.BodyResolveMode
class MainFunctionReturnUnitInspection : AbstractKotlinInspection() {
override fun buildVisitor(holder: ProblemsHolder, isOnTheFly: Boolean): PsiElementVisitor {
return namedFunctionVisitor(fun(function: KtNamedFunction) {
if (function.name != "main") return
val isMain = function.name == "main"
val testAnnotations = function.annotationEntries.filter { "Test" in it.text }
if (!isMain && testAnnotations.isEmpty()) return
val descriptor = function.descriptor as? FunctionDescriptor ?: return
if (!MainFunctionDetector.isMain(descriptor, checkReturnType = false)) return
if (MainFunctionDetector.isMainReturnType(descriptor)) return
if (isMain) {
if (!MainFunctionDetector.isMain(descriptor, checkReturnType = false)) return
} else {
val junitTestFqNames = listOf(FqName("org.junit.Test"), FqName("org.junit.jupiter.api.Test"))
if (testAnnotations.none { it.fqName() in junitTestFqNames }) return
}
if (descriptor.returnType?.let { KotlinBuiltIns.isUnit(it) } == true) return
holder.registerProblem(
function.nameIdentifier ?: function,
"main should return Unit",
"${if (isMain) "main" else "JUnit test"} should return Unit",
ProblemHighlightType.GENERIC_ERROR_OR_WARNING,
ChangeMainFunctionReturnTypeToUnitFix(function.typeReference != null)
)
@@ -43,6 +52,12 @@ class MainFunctionReturnUnitInspection : AbstractKotlinInspection() {
}
}
private fun KtAnnotationEntry.fqName(): FqName? {
val typeReference = this.typeReference ?: return null
val context = typeReference.analyze(BodyResolveMode.PARTIAL)
return context[BindingContext.TYPE, typeReference]?.constructor?.declarationDescriptor?.fqNameSafe
}
private class ChangeMainFunctionReturnTypeToUnitFix(private val hasExplicitReturnType: Boolean) : LocalQuickFix {
override fun getName() = if (hasExplicitReturnType) "Change return type to Unit" else "Add explicit Unit return type"
@@ -0,0 +1,10 @@
// PROBLEM: JUnit test should return Unit
// FIX: Add explicit Unit return type
// DISABLE-ERRORS
package org.junit
annotation class Test
class A {
@Test fun foo<caret>() = 1
}
@@ -0,0 +1,10 @@
// PROBLEM: JUnit test should return Unit
// FIX: Add explicit Unit return type
// DISABLE-ERRORS
package org.junit
annotation class Test
class A {
@Test fun foo<caret>(): Unit = 1
}
@@ -0,0 +1,9 @@
// FIX: Add explicit Unit return type
// DISABLE-ERRORS
package org.junit.jupiter.api
annotation class Test
class A {
@Test fun foo<caret>() = 1
}
@@ -0,0 +1,9 @@
// FIX: Add explicit Unit return type
// DISABLE-ERRORS
package org.junit.jupiter.api
annotation class Test
class A {
@Test fun foo<caret>(): Unit = 1
}
@@ -1,3 +1,4 @@
// PROBLEM: main should return Unit
// FIX: Add explicit Unit return type
// DISABLE-ERRORS
fun <caret>main(args: Array<String>) = 1
@@ -1,3 +1,4 @@
// PROBLEM: main should return Unit
// FIX: Add explicit Unit return type
// DISABLE-ERRORS
fun main(args: Array<String>): Unit = 1
@@ -2383,6 +2383,16 @@ public class LocalInspectionTestGenerated extends AbstractLocalInspectionTest {
KotlinTestUtils.assertAllTestsPresentByMetadata(this.getClass(), new File("idea/testData/inspectionsLocal/mainFunctionReturnUnit"), Pattern.compile("^([\\w\\-_]+)\\.(kt|kts)$"), TargetBackend.ANY, true);
}
@TestMetadata("junit4Test.kt")
public void testJunit4Test() throws Exception {
runTest("idea/testData/inspectionsLocal/mainFunctionReturnUnit/junit4Test.kt");
}
@TestMetadata("junit5Test.kt")
public void testJunit5Test() throws Exception {
runTest("idea/testData/inspectionsLocal/mainFunctionReturnUnit/junit5Test.kt");
}
@TestMetadata("notMain.kt")
public void testNotMain() throws Exception {
runTest("idea/testData/inspectionsLocal/mainFunctionReturnUnit/notMain.kt");