new approach to creating custom command for impact analysis

Author: Evleaps

README.md

@@ -90,15 +90,14 @@ affectedModuleDetector {
  - `excludedModules`: A list of modules that will be excluded from the build process
  - `includeUncommitted`: If uncommitted files should be considered affected
  - `top`: The top of the git log to use. Must be used in combination with configuration `includeUncommitted = false`
-
-
+ - `customTasks`: set of enum fields which implemented [AffectedModuleTaskType]()
 
  By default, the Detector will look for `assembleAndroidDebugTest`, `connectedAndroidDebugTest`, and `testDebug`.  Modules can specify a configuration block to specify which variant tests to run:
  ```groovy
  affectedTestConfiguration {
-    assembleAndroidTestTask = "assembleAndroidReleaseTest"
-    runAndroidTestTask = "connectedAndroidReleaseTest"
-    jvmTestTask = "testRelease"
+      assembleAndroidTestTask = "assembleAndroidReleaseTest"
+      runAndroidTestTask = "connectedAndroidReleaseTest"
+      jvmTestTask = "testRelease"
 }
 ```
 
@@ -148,13 +147,50 @@ To run this on the sample app:
 ```
 
 2. Try running the following command:
-
 ```
  ./gradlew runAffectedUnitTests -Paffected_module_detector.enable
 ```
 
 You should see zero tests run. Make a change within one of the modules and commit it. Rerunning the command should execute tests in that module and its dependent modules.
 
+## Custom tasks 
+
+If you want to add a custom gradle command to execute with impact analysis 
+you must create enum which implementing [AffectedModuleTaskType](). 
+
+Example:
+```kotlin
+
+enum class CustomImpactAnalysisTaskType(
+    override val commandByImpact: String,
+    override val originalGradleCommand: String,
+    override val taskDescription: String
+): AffectedModuleTaskType {
+
+    DETEKT_TASK(
+        commandByImpact = "runDetektByImpact",
+        originalGradleCommand = "detekt",
+        taskDescription = "Run static analysis tool without auto-correction by Impact analysis"
+    )
+}
+```
+
+And then you must add your custom enum fields to configuration in `build.gradle` of your project: 
+
+```groovy
+affectedModuleDetector {
+     baseDir = "${project.rootDir}"
+     pathsAffectingAllModules = ["buildSrc/"]
+     specifiedBranch = "dev"
+     customTasks = [CustomImpactAnalysisTaskType.DETEKT_TASK] // <- list of enum fields
+     compareFrom = "SpecifiedBranchCommit"
+     includeUncommitted = false
+}
+```
+
+**NOTE:** Your task might be complex and doesn't work correctly, if it is true 
+you must create `buildSrc` module and write custom plugin manually like [AffectedModuleDetectorPlugin](https://github.com/RomanAimaletdinov/TestImpactAnalysisLib/blob/dev/buildSrc/src/main/java/AffectedModuleDetectorPlugin.kt)
+
 ## Notes
 
 Special thanks to the AndroidX for originally developing this project at https://android.googlesource.com/platform/frameworks/support/+/androidx-main/buildSrc/src/main/kotlin/androidx/build/dependencyTracker

affectedmoduledetector/src/main/kotlin/com/dropbox/affectedmoduledetector/AffectedModuleConfiguration.kt

@@ -1,8 +1,15 @@
 package com.dropbox.affectedmoduledetector
 
+import com.dropbox.affectedmoduledetector.plugin.AffectedModuleTaskType
 import java.io.File
 
 class AffectedModuleConfiguration {
+
+    companion object {
+
+        const val name = "affectedModuleDetector"
+    }
+
     /**
      * Folder to place the log in
      */
@@ -63,6 +70,27 @@ class AffectedModuleConfiguration {
      */
     var includeUncommitted: Boolean = true
 
+    /**
+     * If you want to add a custom task for impact analysis you must set the list of enum's fields
+     *
+     * Example:
+     * `build.gradle
+     *
+     *  affectedModuleDetector {
+     *       baseDir = "${project.rootDir}"
+     *       pathsAffectingAllModules = ["buildSrc/"]
+     *       specifiedBranch = "dev"
+     *       customTasks = [MyCustomTask.DETEKT_TASK] // <- list of enum fields
+     *       compareFrom = "SpecifiedBranchCommit"
+     *       includeUncommitted = false
+     *  }
+     * `
+     *
+     * @see AffectedModuleTaskType
+     * @see AffectedModuleDetectorPlugin
+     */
+    var customTasks = emptySet<AffectedModuleTaskType>()
+
     /**
      * The top of the git log to use, only used when [includeUncommitted] is false
      */
@@ -73,8 +101,4 @@ class AffectedModuleConfiguration {
             }
             field = value
         }
-
-    companion object {
-        const val name = "affectedModuleDetector"
-    }
 }