feat: Add function to get the most common compatible version

This adds a function to get the version that is most common for a given package name in a supplied set of patches.

revanced-lib/src/test/kotlin/app/revanced/lib/PatchOptionsTest.kt

@@ -1,6 +1,5 @@
-package app.revanced.patcher.options
+package app.revanced.lib
 
-import app.revanced.lib.Options
 import app.revanced.lib.Options.setOptions
 import app.revanced.patcher.data.BytecodeContext
 import app.revanced.patcher.patch.BytecodePatch
@@ -11,16 +10,6 @@ import org.junit.jupiter.api.Order
 import org.junit.jupiter.api.Test
 import org.junit.jupiter.api.TestMethodOrder
 
-
-object PatchOptionsTestPatch : BytecodePatch(name = "PatchOptionsTestPatch") {
-    var key1 by stringPatchOption("key1", null, "title1", "description1")
-    var key2 by booleanPatchOption("key2", true, "title2", "description2")
-
-    override fun execute(context: BytecodeContext) {
-        // Do nothing
-    }
-}
-
 @TestMethodOrder(MethodOrderer.OrderAnnotation::class)
 internal object PatchOptionsTest {
     private var patches = setOf(PatchOptionsTestPatch)
@@ -36,8 +25,8 @@ internal object PatchOptionsTest {
     fun loadOptionsTest() {
         patches.setOptions(CHANGED_JSON)
 
-        assert(PatchOptionsTestPatch.key1 == "test")
-        assert(PatchOptionsTestPatch.key2 == false)
+        assert(PatchOptionsTestPatch.option1 == "test")
+        assert(PatchOptionsTestPatch.option2 == false)
     }
 
     private const val SERIALIZED_JSON =
@@ -45,4 +34,13 @@ internal object PatchOptionsTest {
 
     private const val CHANGED_JSON =
         "[{\"patchName\":\"PatchOptionsTestPatch\",\"options\":[{\"key\":\"key1\",\"value\":\"test\"},{\"key\":\"key2\",\"value\":false}]}]"
+
+    object PatchOptionsTestPatch : BytecodePatch(name = "PatchOptionsTestPatch") {
+        var option1 by stringPatchOption("key1", null, "title1", "description1")
+        var option2 by booleanPatchOption("key2", true, "title2", "description2")
+
+        override fun execute(context: BytecodeContext) {
+            // Do nothing
+        }
+    }
 }

revanced-lib/src/test/kotlin/app/revanced/lib/PatchUtilsTest.kt

@@ -0,0 +1,50 @@
+package app.revanced.lib
+
+import app.revanced.patcher.PatchSet
+import app.revanced.patcher.data.BytecodeContext
+import app.revanced.patcher.patch.BytecodePatch
+import org.junit.jupiter.api.Test
+import kotlin.test.assertEquals
+
+internal object PatchUtilsTest {
+    @Test
+    fun `return 'a' because it is the most common version`() {
+        val patches = arrayOf("a", "a", "c", "d", "a", "b", "c", "d", "a", "b", "c", "d")
+            .map { version -> newPatch("some.package", version) }
+            .toSet()
+
+        assertEqualsVersion("a", patches, "some.package")
+    }
+
+    @Test
+    fun `return null because no patches were supplied`() {
+        assertEqualsVersion(null, emptySet<BytecodePatch>(), "some.package")
+    }
+
+    @Test
+    fun `return null because no patch is compatible with the supplied package name`() {
+        val patches = setOf(newPatch("other.package", "a"))
+
+        assertEqualsVersion(null, patches, "other.package")
+    }
+
+    @Test
+    fun `return null because no patch compatible package is constrained to a version`() {
+        val patches = setOf(
+            newPatch("other.package"),
+            newPatch("other.package"),
+        )
+
+        assertEqualsVersion(null, patches, "other.package")
+    }
+
+    private fun assertEqualsVersion(
+        expected: String?, patches: PatchSet, compatiblePackageName: String
+    ) = assertEquals(expected, PatchUtils.getMostCommonCompatibleVersion(patches, compatiblePackageName))
+
+    private fun newPatch(packageName: String, vararg versions: String) = object : BytecodePatch(
+        compatiblePackages = setOf(CompatiblePackage(packageName, versions.toSet()))
+    ) {
+        override fun execute(context: BytecodeContext) {}
+    }
+}