feat: D-Bus method & signal to edit configuration properties

WARNING: There is no validation! Incorrect modifications will break the configuration.

Usage examples:
specific panel: qdbus luisbocanegra.panel.colorizer.c337.w2346 /preset luisbocanegra.panel.colorizer.c337.w2346.property 'stockPanelSettings.visible.value true'
all panels: dbus-send --session --type=signal /preset luisbocanegra.panel.colorizer.all.property string:'stockPanelSettings.visible.value true'

refs: #126

Author: luisbocanegra

package/contents/ui/DBusServiceModel.qml

@@ -7,6 +7,7 @@ Item {
     id: root
     property bool enabled: false
     property string preset: ""
+    property string propertyToApply: ""
     property bool switchIsPending: false
     property int poolingRate: 250
 
@@ -19,14 +20,19 @@ Item {
     property string pendingSwitchCmd: gdbusPartial +".pending_switch"
     property string switchDoneCmd: gdbusPartial +".switch_done"
     property string getPresetCmd: gdbusPartial +".preset"
+    property string getPropertyToApplyCmd: gdbusPartial + ".property"
     property string quitServiceCmd: gdbusPartial +".quit"
 
     RunCommand {
         id: runCommand
         onExited: (cmd, exitCode, exitStatus, stdout, stderr) => {
             // console.error(cmd, exitCode, exitStatus, stdout, stderr)
             if (exitCode!==0) return
-            stdout = stdout.trim().replace(/[()',]/g, "")
+            stdout = stdout
+            .trim()
+            .replace(/^\(\s*'/, '') // starting "('"
+            .replace(/',?\s*\)$/, '') // ending "',)" or ")"
+            .trim();
             // console.log("stdout parsed:", stdout)
             if(cmd === pendingSwitchCmd) {
                 switchIsPending = stdout === "true"
@@ -35,6 +41,9 @@ Item {
                 preset = stdout
                 switchIsPending = false
             }
+            if (cmd === getPropertyToApplyCmd) {
+                propertyToApply = stdout
+            }
         }
     }
 
@@ -65,6 +74,7 @@ Item {
         running: enabled
         repeat: true
         onTriggered: {
+            runCommand.run(getPropertyToApplyCmd)
             if (switchIsPending) return
             runCommand.run(pendingSwitchCmd)
         }

package/contents/ui/code/utils.js

@@ -494,4 +494,77 @@ function getWidgetConfigIdx(id, name, config) {
 
 function makeEven(n) {
   return n - n % 2
-}
+}
+
+function parseValue(rawValue) {
+  try {
+      return JSON.parse(rawValue)
+  } catch (e) {
+      if (rawValue.toLowerCase() === "true") {
+          return true
+      }
+      if (rawValue.toLowerCase() === "false") {
+          return false
+      }
+      if (!isNaN(rawValue)) {
+          return Number(rawValue)
+      }
+
+      return rawValue
+  }
+}
+
+/**
+* Edit an existing object property using dot and square brackets notation
+* Overrides objects if the new value is also an object
+* For array allows setting per index (appending if not consecutive) or replacing with a new array
+* @param {Object} object - The object to set the property on.
+* @param {string} path - The path to the property.
+* @param {string} value - The value to set.
+*/
+function editProperty(object, path, value) {
+  console.log(`editing property path: ${path}, value: ${value}`)
+  value = parseValue(value)
+  const keys = path.replace(/\[/g, ".").replace(/\]/g, "").split(".")
+  let current = object
+
+  for (let i = 0; i < keys.length - 1; i++) {
+      const key = keys[i]
+      if (!current.hasOwnProperty(key)) return
+      current = current[key]
+      if (typeof current !== "object" || current === null) return
+  }
+
+  const lastKey = keys[keys.length - 1]
+
+  // no new keys unless it's an array
+  if (!current.hasOwnProperty(lastKey) && !Array.isArray(current)) return
+
+  console.log(lastKey)
+
+  if (Array.isArray(current)) {
+    const index = parseInt(lastKey, 10)
+    // add to array if it's the next index
+    if (index === current.length) {
+        current.push(value)
+    } else if (index < current.length) {
+        current[index] = value
+    } else if (Array.isArray(value)) {
+        current[lastKey] = value
+    } else {
+        return
+    }
+  } else if (
+    typeof current[lastKey] === "object" &&
+    current[lastKey] !== null
+  ) {
+    // override only if the new value is an object
+    if (typeof value === "object" && value !== null) {
+        current[lastKey] = value
+    } else {
+        return
+    }
+  } else {
+      current[lastKey] = value
+  }
+}

package/contents/ui/configStockPanelSettings.qml

@@ -327,7 +327,7 @@ KCM.SimpleKCM {
 
             Kirigami.Separator {
                 Kirigami.FormData.isSection: true
-                Kirigami.FormData.label: i18n("Show/Hide AKA Toggle panel")
+                Kirigami.FormData.label: i18n("Show/Hide")
             }
 
             CheckBox {
@@ -341,7 +341,7 @@ KCM.SimpleKCM {
             }
 
             CheckBox {
-                Kirigami.FormData.label: i18n("Visible:")
+                Kirigami.FormData.label: i18n("Show:")
                 id: visible
                 checked: config.visible.value
                 onCheckedChanged: {

package/contents/ui/main.qml

@@ -1632,5 +1632,10 @@ PlasmoidItem {
         onPresetChanged: {
             applyPreset(preset)
         }
+        onPropertyToApplyChanged: {
+            const [path, ...value] = propertyToApply.split(" ")
+            Utils.editProperty(main.cfg, path, value.join(" "))
+            plasmoid.configuration.globalSettings = JSON.stringify(main.cfg)
+        }
     }
 }

package/contents/ui/tools/service.py

@@ -28,6 +28,7 @@ def __init__(self, bus: dbus.Bus):
         self._loop = GLib.MainLoop()
         self._last_preset = ""
         self._pending_witch = False
+        self._property = ""
         self._bus = bus
         super().__init__()
 
@@ -39,6 +40,11 @@ def run(self):
             dbus_interface=SHARED_INTERFACE,
             signal_name="preset",
         )
+        self._bus.add_signal_receiver(
+            self.on_shared_property_signal,
+            dbus_interface=SHARED_INTERFACE,
+            signal_name="property",
+        )
         bus_name = dbus.service.BusName(SERVICE_NAME, dbus.SessionBus())
         dbus.service.Object.__init__(self, bus_name, PATH)
 
@@ -63,6 +69,16 @@ def preset(self, m="") -> str:
             return "saved"
         return self._last_preset
 
+    @dbus.service.method(SERVICE_NAME, in_signature="s", out_signature="s")
+    def property(self, m=""):
+        """Set a specific property using dot notation
+        e.g `'stockPanelSettings.visible {"enabled": true, "value": false}'`
+        """
+        if m:
+            if m != self._property:
+                self._property = m
+        return self._property
+
     def on_shared_preset_signal(self, preset_name: str):
         """Handle the shared signal to set the preset
 
@@ -71,6 +87,14 @@ def on_shared_preset_signal(self, preset_name: str):
         """
         self.preset(preset_name)
 
+    def on_shared_property_signal(self, edited_property: str):
+        """Handle the shared signal to set the preset
+
+        Args:
+            edited_property (str): The property from the signal
+        """
+        self.property(edited_property)
+
     @dbus.service.method(SERVICE_NAME, in_signature="", out_signature="b")
     def pending_switch(self) -> bool:
         """Wether there is a pending preset switch