refactor: abstract settings patch away from YouTube (#1103)

Co-authored-by: oSumAtrIX <johan.melkonyan1@web.de>
2022-11-25 00:05:54 +01:00
parent e79ad750d4
commit 5afd49a111
84 changed files with 554 additions and 336 deletions
@@ -0,0 +1,31 @@
+package app.revanced.patches.shared.settings
+
+import app.revanced.patches.shared.settings.impl.StringResource
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Base preference class for all preferences.
+ *
+ * @param key The key of the preference.
+ * @param title The title of the preference.
+ */
+internal abstract class BasePreference(
+    override val key: String,
+    override val title: StringResource,
+) : IPreference {
+
+    /**
+     * Serialize preference element to XML.
+     * Overriding methods should invoke super and operate on its return value.
+     * @param ownerDocument Target document to create elements from.
+     * @param resourceCallback Called when a resource has been processed.
+     */
+    open fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)? = null): Element {
+        return ownerDocument.createElement(tag).apply {
+            if(key.isNotEmpty())
+                setAttribute("android:key", key)
+            setAttribute("android:title", "@string/${title.also { resourceCallback?.invoke(it) }.name}")
+        }
+    }
+}
@@ -0,0 +1,26 @@
+package app.revanced.patches.shared.settings
+
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Base resource class for all resources.
+ *
+ * @param name The name of the resource.
+ */
+internal abstract class BaseResource(
+    override val name: String
+) : IResource {
+
+    /**
+     * Serialize resource element to XML.
+     * Overriding methods should invoke super and operate on its return value.
+     * @param ownerDocument Target document to create elements from.
+     * @param resourceCallback Called when a resource has been processed.
+     */
+    open fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)? = null): Element {
+        return ownerDocument.createElement(tag).apply {
+            setAttribute("name", name)
+        }
+    }
+}
@@ -0,0 +1,42 @@
+package app.revanced.patches.shared.settings
+
+import app.revanced.patches.shared.settings.impl.StringResource
+import org.w3c.dom.Element
+import org.w3c.dom.Node
+
+/**
+ * Add a resource node child
+ *
+ * @param resource The resource to add.
+ * @param resourceCallback Called when a resource has been processed.
+ */
+internal fun Node.addResource(resource: BaseResource, resourceCallback: ((IResource) -> Unit)? = null) {
+    appendChild(resource.serialize(ownerDocument, resourceCallback))
+}
+
+/**
+ * Add a preference node child to the settings.
+ *
+ * @param preference The preference to add.
+ * @param resourceCallback Called when a resource has been processed.
+ */
+internal fun Node.addPreference(preference: BasePreference, resourceCallback: ((IResource) -> Unit)? = null) {
+    appendChild(preference.serialize(ownerDocument, resourceCallback))
+}
+
+internal fun Element.addSummary(summaryResource: StringResource?, summaryType: SummaryType = SummaryType.DEFAULT) =
+    summaryResource?.let { summary ->
+        setAttribute("android:${summaryType.type}", "@string/${summary.name}")
+    }
+
+internal fun <T> Element.addDefault(default: T) {
+    default?.let {
+        setAttribute(
+            "android:defaultValue", when (it) {
+                is Boolean -> if (it) "true" else "false"
+                is String -> it
+                else -> throw IllegalArgumentException("Unsupported default value type: ${it::class.java.name}")
+            }
+        )
+    }
+}
@@ -0,0 +1,23 @@
+package app.revanced.patches.shared.settings
+
+import app.revanced.patches.shared.settings.impl.StringResource
+
+/**
+ * Preference
+ */
+internal interface IPreference {
+    /**
+     * Key of the preference.
+     */
+    val key: String
+
+    /**
+     * Title of the preference.
+     */
+    val title: StringResource
+
+    /**
+     * Tag name of the preference.
+     */
+    val tag: String
+}
@@ -0,0 +1,16 @@
+package app.revanced.patches.shared.settings
+
+/**
+ * Resource
+ */
+internal interface IResource {
+    /**
+     * Name of the resource.
+     */
+    val name: String
+
+    /**
+     * Tag name of the resource.
+     */
+    val tag: String
+}
@@ -0,0 +1,5 @@
+package app.revanced.patches.shared.settings
+
+enum class SummaryType(val type: String) {
+    DEFAULT("summary"), ON("summaryOn"), OFF("summaryOff")
+}
@@ -0,0 +1,31 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BaseResource
+import app.revanced.patches.shared.settings.IResource
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ *  Represents an array resource.
+ *
+ *  @param name The name of the array resource.
+ *  @param items The items of the array resource.
+ */
+internal data class ArrayResource(
+    override val name: String,
+    val items: List<StringResource>
+) : BaseResource(name) {
+    override val tag = "string-array"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            items.forEach { item ->
+                setAttribute("name", item.also { resourceCallback?.invoke(it) }.name)
+
+                this.appendChild(ownerDocument.createElement("item").also { itemNode ->
+                    itemNode.textContent = item.value
+                })
+            }
+        }
+    }
+}
@@ -0,0 +1,6 @@
+package app.revanced.patches.shared.settings.impl
+
+enum class InputType(val type: String) {
+    STRING("text"),
+    NUMBER("number"),
+}
@@ -0,0 +1,38 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BasePreference
+import app.revanced.patches.shared.settings.IResource
+import app.revanced.patches.shared.settings.addDefault
+import app.revanced.patches.shared.settings.addSummary
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * List preference.
+ *
+ * @param key The key of the list preference.
+ * @param title The title of the list preference.
+ * @param entries The human-readable entries of the list preference.
+ * @param entryValues The entry values of the list preference.
+ * @param default The default entry value of the list preference.
+ * @param summary The summary of the list preference.
+ */
+internal class ListPreference(
+    key: String,
+    title: StringResource,
+    val entries: ArrayResource,
+    val entryValues: ArrayResource,
+    val default: String? = null,
+    val summary: StringResource? = null
+) : BasePreference(key, title) {
+    override val tag: String = "ListPreference"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            setAttribute("android:entries", "@array/${entries.also { resourceCallback?.invoke(it) }.name}")
+            setAttribute("android:entryValues", "@array/${entryValues.also { resourceCallback?.invoke(it) }.name}")
+            addDefault(default)
+            addSummary(summary)
+        }
+    }
+}
@@ -0,0 +1,44 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BasePreference
+import app.revanced.patches.shared.settings.IResource
+import app.revanced.patches.shared.settings.addSummary
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * A Preference object.
+ *
+ * @param title The title of the preference.
+ * @param intent The intent of the preference.
+ * @param summary The summary of the text preference.
+ */
+internal class Preference(
+    key: String,
+    title: StringResource,
+    val intent: Intent,
+    val summary: StringResource? = null
+) : BasePreference(key, title) {
+    override val tag: String = "Preference"
+
+    /* Key-less constructor */
+    constructor(
+        title: StringResource,
+        intent: Intent,
+        summary: StringResource? = null
+    ) : this("", title, intent, summary)
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            addSummary(summary?.also { resourceCallback?.invoke(it) })
+
+            this.appendChild(ownerDocument.createElement("intent").also { intentNode ->
+                intentNode.setAttribute("android:targetPackage", intent.targetPackage)
+                intentNode.setAttribute("android:data", intent.data)
+                intentNode.setAttribute("android:targetClass", intent.targetClass)
+            })
+        }
+    }
+
+    data class Intent(val targetPackage: String, val data: String, val targetClass: String)
+}
@@ -0,0 +1,29 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BasePreference
+import app.revanced.patches.shared.settings.IResource
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Preference category.
+ *
+ * @param key The key of the preference.
+ * @param title The title of the preference.
+ * @param preferences Child preferences of this category.
+ */
+internal open class PreferenceCategory(
+    key: String,
+    title: StringResource,
+    val preferences: List<BasePreference>
+) : BasePreference(key, title) {
+    override val tag: String = "PreferenceCategory"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            for (childPreference in preferences) {
+                this.appendChild(childPreference.serialize(ownerDocument, resourceCallback))
+            }
+        }
+    }
+}
@@ -0,0 +1,34 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BasePreference
+import app.revanced.patches.shared.settings.IResource
+import app.revanced.patches.shared.settings.addSummary
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Preference screen.
+ *
+ * @param key The key of the preference.
+ * @param title The title of the preference.
+ * @param preferences Child preferences of this screen.
+ * @param summary The summary of the text preference.
+ */
+internal open class PreferenceScreen(
+    key: String,
+    title: StringResource,
+    val preferences: List<BasePreference>,
+    val summary: StringResource? = null
+) : BasePreference(key, title) {
+    override val tag: String = "PreferenceScreen"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            addSummary(summary?.also { resourceCallback?.invoke(it) })
+
+            for (childPreference in preferences) {
+                this.appendChild(childPreference.serialize(ownerDocument, resourceCallback))
+            }
+        }
+    }
+}
@@ -0,0 +1,31 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BaseResource
+import app.revanced.patches.shared.settings.IResource
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Represents a string value in the strings.xml file
+ *
+ * @param name The name of the string
+ * @param value The value of the string
+ * @param formatted If the string is formatted. If false, the attribute will be set
+ */
+internal data class StringResource(
+    override val name: String,
+    val value: String,
+    val formatted: Boolean = true
+) : BaseResource(name) {
+    override val tag = "string"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            // if the string is un-formatted, explicitly add the formatted attribute
+            if (!formatted)
+                setAttribute("formatted", "false")
+
+            textContent = value
+        }
+    }
+}
@@ -0,0 +1,35 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.*
+import app.revanced.patches.shared.settings.BasePreference
+import app.revanced.patches.shared.settings.IResource
+import app.revanced.patches.shared.settings.addDefault
+import app.revanced.patches.shared.settings.addSummary
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Switch preference.
+ *
+ * @param key The key of the switch.
+ * @param title The title of the switch.
+ * @param default The default value of the switch.
+ * @param summaryOn The summary to show when the preference is enabled.
+ * @param summaryOff The summary to show when the preference is disabled.
+ */
+internal class SwitchPreference(
+    key: String, title: StringResource,
+    val default: Boolean = false,
+    val summaryOn: StringResource? = null,
+    val summaryOff: StringResource? = null
+) : BasePreference(key, title) {
+    override val tag: String = "SwitchPreference"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            addDefault(default)
+            addSummary(summaryOn?.also { resourceCallback?.invoke(it) }, SummaryType.ON)
+            addSummary(summaryOff?.also { resourceCallback?.invoke(it) }, SummaryType.OFF)
+        }
+    }
+}
@@ -0,0 +1,35 @@
+package app.revanced.patches.shared.settings.impl
+
+import app.revanced.patches.shared.settings.BasePreference
+import app.revanced.patches.shared.settings.IResource
+import app.revanced.patches.shared.settings.addDefault
+import app.revanced.patches.shared.settings.addSummary
+import org.w3c.dom.Document
+import org.w3c.dom.Element
+
+/**
+ * Text preference.
+ *
+ * @param key The key of the text preference.
+ * @param title The title of the text preference.
+ * @param inputType The input type of the text preference.
+ * @param default The default value of the text preference.
+ * @param summary The summary of the text preference.
+ */
+internal class TextPreference(
+    key: String,
+    title: StringResource,
+    var inputType: InputType = InputType.STRING,
+    val default: String? = null,
+    val summary: StringResource? = null
+) : BasePreference(key, title) {
+    override val tag: String = "EditTextPreference"
+
+    override fun serialize(ownerDocument: Document, resourceCallback: ((IResource) -> Unit)?): Element {
+        return super.serialize(ownerDocument, resourceCallback).apply {
+            setAttribute("android:inputType", inputType.type)
+            addDefault(default)
+            addSummary(summary?.also { resourceCallback?.invoke(it) })
+        }
+    }
+}