client: ios: add backlight control

src/rpcclient/rpcclient/ios/backlight.py

@@ -0,0 +1,25 @@
+import logging
+
+from rpcclient.exceptions import BadReturnValueError
+
+
+class Backlight:
+    def __init__(self, client):
+        self._client = client
+
+        BrightnessSystemClient = self._client.symbols.objc_getClass('BrightnessSystemClient')
+        if not BrightnessSystemClient:
+            logging.error('failed to load BrightnessSystemClient class')
+        self._brightness = BrightnessSystemClient.objc_call('new')
+
+    @property
+    def brighness(self) -> float:
+        """ get brightness value in range: 0.0 - 1.0 """
+        return self._brightness.objc_call('copyPropertyForKey:', self._client.cf('DisplayBrightness')).py['Brightness']
+
+    @brighness.setter
+    def brighness(self, value: float):
+        """ set brighness in range: 0.0 - 1.0 """
+        if not self._brightness.objc_call('setProperty:forKey:', self._client.cf(value),
+                                          self._client.cf('DisplayBrightness')):
+            raise BadReturnValueError('failed to set DisplayBrightness')

src/rpcclient/rpcclient/ios/client.py

@@ -1,9 +1,14 @@
 import typing
 
 from rpcclient.darwin.client import DarwinClient
+from rpcclient.ios.backlight import Backlight
 
 
 class IosClient(DarwinClient):
+    def __init__(self, sock, sysname: str, hostname: str, port: int = None):
+        super().__init__(sock, sysname, hostname, port)
+        self.backlight = Backlight(self)
+
     @property
     def roots(self) -> typing.List[str]:
         """ get a list of all accessible darwin roots when used for lookup of files/preferences/... """