chore(release): 4.4.0-dev.2 [skip ci]

# [4.4.0-dev.2](https://github.com/ReVanced/revanced-cli/compare/v4.4.0-dev.1...v4.4.0-dev.2) (2023-12-18)

### Bug Fixes

* Add missing punctuation in command description ([8210351](821035107d))

CHANGELOG.md

@@ -1,3 +1,31 @@
+# [4.4.0-dev.2](https://github.com/ReVanced/revanced-cli/compare/v4.4.0-dev.1...v4.4.0-dev.2) (2023-12-18)
+
+
+### Bug Fixes
+
+* Add missing punctuation in command description ([8210351](https://github.com/ReVanced/revanced-cli/commit/821035107d7264580275f395e9e3fcef91394afd))
+
+# [4.4.0-dev.1](https://github.com/ReVanced/revanced-cli/compare/v4.3.0...v4.4.0-dev.1) (2023-12-01)
+
+
+### Features
+
+* Log saved patched APK file path ([16109bd](https://github.com/ReVanced/revanced-cli/commit/16109bd8bc6236debf71cbc8db78fe452b2ed00d))
+
+# [4.3.0](https://github.com/ReVanced/revanced-cli/compare/v4.2.0...v4.3.0) (2023-12-01)
+
+
+### Features
+
+* Add `list-versions` command ([a974b8e](https://github.com/ReVanced/revanced-cli/commit/a974b8ea80acd85f8dc472a3f93b8fd7bea08007))
+
+# [4.3.0-dev.1](https://github.com/ReVanced/revanced-cli/compare/v4.2.0...v4.3.0-dev.1) (2023-11-27)
+
+
+### Features
+
+* Add `list-versions` command ([a974b8e](https://github.com/ReVanced/revanced-cli/commit/a974b8ea80acd85f8dc472a3f93b8fd7bea08007))
+
 # [4.2.0](https://github.com/ReVanced/revanced-cli/compare/v4.1.0...v4.2.0) (2023-11-26)
 
 

docs/1_usage.md

@@ -35,7 +35,7 @@ ReVanced CLI is divided into the following fundamental commands:
   ```
 
 > [!NOTE]  
-  > A default `options.json` file will be automatically created, if it does not exist 
+> A default `options.json` file will be automatically created if it does not exist 
 without any need for intervention when using the `patch` command.
 
 - ### 💉 Patch an app
@@ -80,7 +80,7 @@ ReVanced CLI is divided into the following fundamental commands:
   - #### 👾 Patch an app and mount it on top of the un-patched app with root permissions
   
   > [!IMPORTANT]  
-    > Ensure sure the same app you are patching and mounting over is installed on your device:
+  > Ensure that the same app you are patching and mounting over is installed on your device:
   > 
   > ```bash
   > adb install app.apk
@@ -91,14 +91,14 @@ ReVanced CLI is divided into the following fundamental commands:
   > patches by their index in relation to supplied patch bundles,
   > similarly to the option `--include` and `--exclude`.
   > 
-    > This is useful in case two patches have the same name, and you need to include or exclude one of them.  
-    > The index of a patch is calculated by the position of the patch in the list of patches
+  > This is useful in case two patches have the same name, and you must include or exclude one.  
+  > The patch index is calculated by the position of the patch in the list of patches
   > from patch bundles supplied using the option `--patch-bundle`.
   > 
   > You can list all patches with their indices using the command `list-patches`.
   > 
-    > Keep in mind, that the indices can change based on the order of the patch bundles supplied,
-    > as well if the patch bundles are updated, because patches can be added or removed.
+  > Keep in mind that the indices can change based on the order of the patch bundles supplied,
+  > as well if the patch bundles are updated because patches can be added or removed.
 
     ```bash
     java -jar revanced-cli.jar patch \
@@ -133,4 +133,4 @@ ReVanced CLI is divided into the following fundamental commands:
 
 > [!NOTE]  
 > You can mount an APK file 
-  > by supplying the package name of the app to mount the supplied APK file to over the option `--mount`.
+> by supplying the package name of the app to mount the supplied APK file over the option `--mount`.

gradle.properties

@@ -1,4 +1,4 @@
 org.gradle.parallel = true
 org.gradle.caching = true
 kotlin.code.style = official
-version = 4.2.0
+version = 4.4.0-dev.2

gradle/libs.versions.toml

@@ -3,8 +3,8 @@ shadow = "8.1.1"
 kotlin-test = "1.9.20"
 kotlinx-coroutines-core = "1.7.3"
 picocli = "4.7.3"
-revanced-patcher = "19.0.0"
-revanced-library = "1.3.0"
+revanced-patcher = "19.1.0"
+revanced-library = "1.4.0"
 
 [libraries]
 kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin-test" }

settings.gradle.kts

@@ -2,6 +2,6 @@ rootProject.name = "revanced-cli"
 
 buildCache {
     local {
-        isEnabled = !System.getenv().containsKey("CI")
+        isEnabled = "CI" !in System.getenv()
     }
 }

src/main/kotlin/app/revanced/cli/command/ListCompatibleVersions.kt

@@ -0,0 +1,67 @@
+package app.revanced.cli.command
+
+import app.revanced.library.PackageName
+import app.revanced.library.PatchUtils
+import app.revanced.library.VersionMap
+import app.revanced.patcher.PatchBundleLoader
+import picocli.CommandLine
+import java.io.File
+import java.util.logging.Logger
+
+@CommandLine.Command(
+    name = "list-versions",
+    description = [
+        "List the most common compatible versions of apps that are compatible " +
+            "with the patches in the supplied patch bundles.",
+    ],
+)
+internal class ListCompatibleVersions : Runnable {
+    private val logger = Logger.getLogger(ListCompatibleVersions::class.java.name)
+
+    @CommandLine.Parameters(
+        description = ["Paths to patch bundles."],
+        arity = "1..*",
+    )
+    private lateinit var patchBundles: Array<File>
+
+    @CommandLine.Option(
+        names = ["-f", "--filter-package-names"],
+        description = ["Filter patches by package name."],
+    )
+    private var packageNames: Set<String>? = null
+
+    @CommandLine.Option(
+        names = ["-u", "--count-unused-patches"],
+        description = ["Count patches that are not used by default."],
+        showDefaultValue = CommandLine.Help.Visibility.ALWAYS,
+    )
+    private var countUnusedPatches: Boolean = false
+
+    override fun run() {
+        val patches = PatchBundleLoader.Jar(*patchBundles)
+
+        fun VersionMap.buildVersionsString(): String {
+            if (isEmpty()) return "Any"
+
+            fun buildPatchesCountString(count: Int) = if (count == 1) "1 patch" else "$count patches"
+
+            return entries.joinToString("\n") { (version, count) ->
+                "$version (${buildPatchesCountString(count)})"
+            }
+        }
+
+        fun buildString(entry: Map.Entry<PackageName, VersionMap>) =
+            buildString {
+                val (name, versions) = entry
+                appendLine("Package name: $name")
+                appendLine("Most common compatible versions:")
+                appendLine(versions.buildVersionsString().prependIndent("\t"))
+            }
+
+        PatchUtils.getMostCommonCompatibleVersions(
+            patches,
+            packageNames,
+            countUnusedPatches,
+        ).entries.joinToString("\n", transform = ::buildString).let(logger::info)
+    }
+}

src/main/kotlin/app/revanced/cli/command/MainCommand.kt

@@ -33,9 +33,10 @@ private object CLIVersionProvider : IVersionProvider {
     mixinStandardHelpOptions = true,
     versionProvider = CLIVersionProvider::class,
     subcommands = [
-        ListPatchesCommand::class,
         PatchCommand::class,
         OptionsCommand::class,
+        ListPatchesCommand::class,
+        ListCompatibleVersions::class,
         UtilityCommand::class,
     ],
 )

src/main/kotlin/app/revanced/cli/command/PatchCommand.kt

@@ -325,6 +325,8 @@ internal object PatchCommand : Runnable {
                 alignedFile.renameTo(outputFilePath)
             }
 
+            logger.info("Saved to $outputFilePath")
+
             // endregion
 
             // region Install

src/main/kotlin/app/revanced/cli/command/utility/UtilityCommand.kt

@@ -4,7 +4,7 @@ import picocli.CommandLine
 
 @CommandLine.Command(
     name = "utility",
-    description = ["Commands for utility purposes"],
+    description = ["Commands for utility purposes."],
     subcommands = [InstallCommand::class, UninstallCommand::class],
 )
 internal object UtilityCommand