Fix part of #4044: Add math tokenizer & parameterized test support

scripts/assets/file_content_validation_checks.textproto

@@ -137,6 +137,7 @@ file_content_checks {
   exempted_file_name: "domain/src/main/java/org/oppia/android/domain/util/WorkDataExtensions.kt"
   exempted_file_name: "domain/src/test/java/org/oppia/android/domain/onboarding/AppStartupStateControllerTest.kt"
   exempted_file_name: "testing/src/main/java/org/oppia/android/testing/OppiaTestRunner.kt"
+  exempted_file_name: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedMethod.kt"
   exempted_file_name: "testing/src/main/java/org/oppia/android/testing/time/FakeOppiaClock.kt"
   exempted_file_name: "utility/src/main/java/org/oppia/android/util/extensions/BundleExtensions.kt"
   exempted_file_name: "utility/src/main/java/org/oppia/android/util/locale/MachineLocaleImpl.kt"
@@ -260,6 +261,7 @@ file_content_checks {
   exempted_file_name: "app/src/sharedTest/java/org/oppia/android/app/splash/SplashActivityTest.kt"
   exempted_file_name: "app/src/test/java/org/oppia/android/app/player/state/StateFragmentLocalTest.kt"
   exempted_file_name: "testing/src/main/java/org/oppia/android/testing/junit/InitializeDefaultLocaleRule.kt"
+  exempted_file_name: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedMethod.kt"
   exempted_file_name: "testing/src/main/java/org/oppia/android/testing/robolectric/ShadowBidiFormatter.kt"
   exempted_file_name: "testing/src/test/java/org/oppia/android/testing/robolectric/ShadowBidiFormatterTest.kt"
   exempted_file_name: "utility/src/main/java/org/oppia/android/util/logging/firebase/FirebaseEventLogger.kt"
@@ -280,3 +282,11 @@ file_content_checks {
   prohibited_content_regex: "^proto_library\\("
   failure_message: "Don't use proto_library. Use oppia_proto_library instead."
 }
+file_content_checks {
+  file_path_regex: ".+?\\.kt"
+  prohibited_content_regex: "OppiaParameterizedTestRunner"
+  failure_message: "To use OppiaParameterizedTestRunner, please add an exemption to file_content_validation_checks.textproto and add an explanation for your use case in your PR description. Note that parameterized tests should only be used in special circumstances where a single behavior can be tested across multiple inputs, or for especially large test suites that can be trivially reduced."
+  exempted_file_name: "scripts/src/javatests/org/oppia/android/scripts/regex/RegexPatternValidationCheckTest.kt"
+  exempted_file_name: "utility/src/test/java/org/oppia/android/util/math/MathTokenizerTest.kt"
+  exempted_file_patterns: "testing/src/main/java/org/oppia/android/testing/junit/.+?\\.kt"
+}

scripts/assets/test_file_exemptions.textproto

@@ -648,12 +648,22 @@ exempted_file_path: "testing/src/main/java/org/oppia/android/testing/espresso/Ge
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/espresso/ImageViewMatcher.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/espresso/KonfettiViewMatcher.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/DefineAppLanguageLocaleContext.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/OppiaParameterizedBaseRunner.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/OppiaParameterizedTestRunner.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedAndroidJunit4TestRunner.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedJunitTestRunner.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedMethod.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedRobolectricTestRunner.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedRunnerDelegate.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterizedRunnerOverrideMethods.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/junit/ParameterValue.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/ComparableOperationSubject.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/FractionSubject.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/MathExpressionSubject.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/MathEquationSubject.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/PolynomialSubject.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/RealSubject.kt"
+exempted_file_path: "testing/src/main/java/org/oppia/android/testing/math/TokenSubject.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/mockito/MockitoKotlinHelper.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/network/ApiMockLoader.kt"
 exempted_file_path: "testing/src/main/java/org/oppia/android/testing/network/MockClassroomService.kt"

scripts/src/javatests/org/oppia/android/scripts/regex/RegexPatternValidationCheckTest.kt

@@ -125,6 +125,12 @@ class RegexPatternValidationCheckTest {
       " null, instead. Delegates uses reflection internally, have a non-trivial initialization" +
       " cost, and can cause breakages on KitKat devices. See #3939 for more context."
   private val doNotUseProtoLibrary = "Don't use proto_library. Use oppia_proto_library instead."
+  private val parameterizedTestRunnerRequiresException =
+    "To use OppiaParameterizedTestRunner, please add an exemption to" +
+      " file_content_validation_checks.textproto and add an explanation for your use case in your" +
+      " PR description. Note that parameterized tests should only be used in special" +
+      " circumstances where a single behavior can be tested across multiple inputs, or for" +
+      " especially large test suites that can be trivially reduced."
   private val wikiReferenceNote =
     "Refer to https://github.com/oppia/oppia-android/wiki/Static-Analysis-Checks" +
       "#regexpatternvalidation-check for more details on how to fix this."
@@ -1569,6 +1575,32 @@ class RegexPatternValidationCheckTest {
       )
   }
 
+  @Test
+  fun testFileContent_kotlinTestUsesParameterizedTestRunner_fileContentIsNotCorrect() {
+    val prohibitedContent =
+      """
+      import org.oppia.android.testing.junit.OppiaParameterizedTestRunner
+      @RunWith(OppiaParameterizedTestRunner::class)
+      """.trimIndent()
+    tempFolder.newFolder("testfiles", "domain", "src", "test")
+    val stringFilePath = "domain/src/test/SomeTest.kt"
+    tempFolder.newFile("testfiles/$stringFilePath").writeText(prohibitedContent)
+
+    val exception = assertThrows(Exception::class) {
+      runScript()
+    }
+
+    assertThat(exception).hasMessageThat().contains(REGEX_CHECK_FAILED_OUTPUT_INDICATOR)
+    assertThat(outContent.toString().trim())
+      .isEqualTo(
+        """
+        $stringFilePath:1: $parameterizedTestRunnerRequiresException
+        $stringFilePath:2: $parameterizedTestRunnerRequiresException
+        $wikiReferenceNote
+        """.trimIndent()
+      )
+  }
+
   @Test
   fun testFileContent_java8OptionalImport_fileContentIsNotCorrect() {
     val prohibitedContent = "import java.util.Optional"

testing/src/main/java/org/oppia/android/testing/junit/BUILD.bazel

@@ -30,3 +30,75 @@ kt_android_library(
         "//third_party:junit_junit",
     ],
 )
+
+kt_android_library(
+    name = "oppia_parameterized_test_runner",
+    testonly = True,
+    srcs = [
+        "OppiaParameterizedTestRunner.kt",
+    ],
+    visibility = ["//:oppia_testing_visibility"],
+    deps = [
+        ":parameterized_runner_delegate_impl",
+        "//third_party:androidx_test_runner",
+        "//third_party:junit_junit",
+        "//third_party:org_robolectric_robolectric",
+        "//third_party:robolectric_android-all",
+    ],
+)
+
+kt_android_library(
+    name = "parameterized_android_junit4_class_runner",
+    testonly = True,
+    srcs = [
+        "ParameterizedAndroidJunit4TestRunner.kt",
+    ],
+    visibility = ["//:oppia_testing_visibility"],
+    deps = [
+        ":parameterized_runner_delegate_impl",
+        "//third_party:androidx_test_runner",
+        "//third_party:junit_junit",
+    ],
+)
+
+kt_android_library(
+    name = "parameterized_junit_test_runner",
+    testonly = True,
+    srcs = [
+        "ParameterizedJunitTestRunner.kt",
+    ],
+    visibility = ["//:oppia_testing_visibility"],
+    deps = [
+        ":parameterized_runner_delegate_impl",
+        "//third_party:junit_junit",
+    ],
+)
+
+kt_android_library(
+    name = "parameterized_robolectric_test_runner",
+    testonly = True,
+    srcs = [
+        "ParameterizedRobolectricTestRunner.kt",
+    ],
+    visibility = ["//:oppia_testing_visibility"],
+    deps = [
+        ":parameterized_runner_delegate_impl",
+        "//third_party:junit_junit",
+        "//third_party:org_robolectric_robolectric",
+    ],
+)
+
+kt_android_library(
+    name = "parameterized_runner_delegate_impl",
+    testonly = True,
+    srcs = [
+        "OppiaParameterizedBaseRunner.kt",
+        "ParameterValue.kt",
+        "ParameterizedMethod.kt",
+        "ParameterizedRunnerDelegate.kt",
+        "ParameterizedRunnerOverrideMethods.kt",
+    ],
+    deps = [
+        "//third_party:junit_junit",
+    ],
+)

testing/src/main/java/org/oppia/android/testing/junit/OppiaParameterizedBaseRunner.kt

@@ -0,0 +1,9 @@
+package org.oppia.android.testing.junit
+
+/**
+ * This is a marker interface that's used to select a base runner to be used in conjunction with
+ * [OppiaParameterizedTestRunner].
+ *
+ * See the KDoc for the test runner for more details on how to use this.
+ */
+interface OppiaParameterizedBaseRunner