pymobiledevice3 4.27.0__py3-none-any.whl → 5.1.2__py3-none-any.whl

pymobiledevice3/services/restore_service.py

@@ -4,7 +4,7 @@ from pymobiledevice3.remote.remote_service_discovery import RemoteServiceDiscove
 
 
 class RestoreService(RemoteService):
-    SERVICE_NAME = 'com.apple.RestoreRemoteServices.restoreserviced'
+    SERVICE_NAME = "com.apple.RestoreRemoteServices.restoreserviced"
 
     def __init__(self, lockdown: RemoteServiceDiscoveryService):
         super().__init__(lockdown, self.SERVICE_NAME)
@@ -13,33 +13,33 @@ class RestoreService(RemoteService):
         """
         Set `delay-recovery-image` on devices of ProductType 0x1677b394. Otherwise, fail
         """
-        await self.validate_command('delayrecoveryimage')
+        await self.validate_command("delayrecoveryimage")
 
     async def enter_recovery(self) -> None:
-        """ Enter recovery """
-        await self.validate_command('recovery')
+        """Enter recovery"""
+        await self.validate_command("recovery")
 
     async def reboot(self) -> None:
-        """ Reboot device """
-        await self.validate_command('reboot')
+        """Reboot device"""
+        await self.validate_command("reboot")
 
     async def get_preflightinfo(self) -> dict:
-        """ Get preflight info """
-        return await self.service.send_receive_request({'command': 'getpreflightinfo'})
+        """Get preflight info"""
+        return await self.service.send_receive_request({"command": "getpreflightinfo"})
 
     async def get_nonces(self) -> dict:
-        """ Get ApNonce and SEPNonce """
-        return await self.service.send_receive_request({'command': 'getnonces'})
+        """Get ApNonce and SEPNonce"""
+        return await self.service.send_receive_request({"command": "getnonces"})
 
     async def get_app_parameters(self) -> dict:
-        return await self.validate_command('getappparameters')
+        return await self.validate_command("getappparameters")
 
     async def restore_lang(self, language: str) -> dict:
-        return await self.service.send_receive_request({'command': 'restorelang', 'argument': language})
+        return await self.service.send_receive_request({"command": "restorelang", "argument": language})
 
     async def validate_command(self, command: str) -> dict:
-        """ Execute command and validate result is `success` """
-        response = await self.service.send_receive_request({'command': command})
-        if response.get('result') != 'success':
-            raise PyMobileDevice3Exception(f'request command: {command} failed with error: {response}')
+        """Execute command and validate result is `success`"""
+        response = await self.service.send_receive_request({"command": command})
+        if response.get("result") != "success":
+            raise PyMobileDevice3Exception(f"request command: {command} failed with error: {response}")
         return response

pymobiledevice3/services/screenshot.py

@@ -4,26 +4,29 @@ from pymobiledevice3.services.lockdown_service import LockdownService
 
 
 class ScreenshotService(LockdownService):
-    SERVICE_NAME = 'com.apple.mobile.screenshotr'
+    SERVICE_NAME = "com.apple.mobile.screenshotr"
 
     def __init__(self, lockdown: LockdownClient):
         super().__init__(lockdown, self.SERVICE_NAME, is_developer_service=True)
 
         dl_message_version_exchange = self.service.recv_plist()
         version_major = dl_message_version_exchange[1]
-        dl_message_device_ready = self.service.send_recv_plist(
-            ['DLMessageVersionExchange', 'DLVersionsOk', version_major])
-        if dl_message_device_ready[0] != 'DLMessageDeviceReady':
-            raise PyMobileDevice3Exception('Screenshotr didn\'t return ready state')
+        dl_message_device_ready = self.service.send_recv_plist([
+            "DLMessageVersionExchange",
+            "DLVersionsOk",
+            version_major,
+        ])
+        if dl_message_device_ready[0] != "DLMessageDeviceReady":
+            raise PyMobileDevice3Exception("Screenshotr didn't return ready state")
 
     def take_screenshot(self) -> bytes:
-        self.service.send_plist(['DLMessageProcessMessage', {'MessageType': 'ScreenShotRequest'}])
+        self.service.send_plist(["DLMessageProcessMessage", {"MessageType": "ScreenShotRequest"}])
         response = self.service.recv_plist()
 
         assert len(response) == 2
-        assert response[0] == 'DLMessageProcessMessage'
+        assert response[0] == "DLMessageProcessMessage"
 
-        if response[1].get('MessageType') == 'ScreenShotReply':
-            return response[1]['ScreenShotData']
+        if response[1].get("MessageType") == "ScreenShotReply":
+            return response[1]["ScreenShotData"]
 
-        raise PyMobileDevice3Exception(f'invalid response: {response}')
+        raise PyMobileDevice3Exception(f"invalid response: {response}")

pymobiledevice3/services/simulate_location.py

@@ -6,22 +6,22 @@ from pymobiledevice3.services.lockdown_service import LockdownService
 
 
 class DtSimulateLocation(LockdownService, LocationSimulationBase):
-    SERVICE_NAME = 'com.apple.dt.simulatelocation'
+    SERVICE_NAME = "com.apple.dt.simulatelocation"
 
     def __init__(self, lockdown: LockdownClient):
         LockdownService.__init__(self, lockdown, self.SERVICE_NAME)
         LocationSimulationBase.__init__(self)
 
     def clear(self) -> None:
-        """ stop simulation """
+        """stop simulation"""
         service = self.lockdown.start_lockdown_developer_service(self.SERVICE_NAME)
-        service.sendall(struct.pack('>I', 1))
+        service.sendall(struct.pack(">I", 1))
 
     def set(self, latitude: float, longitude: float) -> None:
-        """ stop simulation """
+        """stop simulation"""
         service = self.lockdown.start_lockdown_developer_service(self.SERVICE_NAME)
-        service.sendall(struct.pack('>I', 0))
+        service.sendall(struct.pack(">I", 0))
         latitude = str(latitude).encode()
         longitude = str(longitude).encode()
-        service.sendall(struct.pack('>I', len(latitude)) + latitude)
-        service.sendall(struct.pack('>I', len(longitude)) + longitude)
+        service.sendall(struct.pack(">I", len(latitude)) + latitude)
+        service.sendall(struct.pack(">I", len(longitude)) + longitude)

pymobiledevice3/services/springboard.py

@@ -14,8 +14,8 @@ class InterfaceOrientation(IntEnum):
 
 
 class SpringBoardServicesService(LockdownService):
-    RSD_SERVICE_NAME = 'com.apple.springboardservices.shim.remote'
-    SERVICE_NAME = 'com.apple.springboardservices'
+    RSD_SERVICE_NAME = "com.apple.springboardservices.shim.remote"
+    SERVICE_NAME = "com.apple.springboardservices"
 
     def __init__(self, lockdown: LockdownServiceProvider) -> None:
         if isinstance(lockdown, LockdownClient):
@@ -23,38 +23,38 @@ class SpringBoardServicesService(LockdownService):
         else:
             super().__init__(lockdown, self.RSD_SERVICE_NAME)
 
-    def get_icon_state(self, format_version: str = '2') -> list:
-        cmd = {'command': 'getIconState'}
+    def get_icon_state(self, format_version: str = "2") -> list:
+        cmd = {"command": "getIconState"}
         if format_version:
-            cmd['formatVersion'] = format_version
+            cmd["formatVersion"] = format_version
         return self.service.send_recv_plist(cmd)
 
     def set_icon_state(self, newstate: Optional[list] = None) -> None:
         if newstate is None:
             newstate = {}
-        self.service.send_plist({'command': 'setIconState', 'iconState': newstate})
+        self.service.send_plist({"command": "setIconState", "iconState": newstate})
         self.service.recv_prefixed()
 
     def get_icon_pngdata(self, bundle_id: str) -> bytes:
-        return self.service.send_recv_plist({'command': 'getIconPNGData',
-                                             'bundleId': bundle_id}).get('pngData')
+        return self.service.send_recv_plist({"command": "getIconPNGData", "bundleId": bundle_id}).get("pngData")
 
     def get_interface_orientation(self) -> InterfaceOrientation:
-        res = self.service.send_recv_plist({'command': 'getInterfaceOrientation'})
-        return InterfaceOrientation(res.get('interfaceOrientation'))
+        res = self.service.send_recv_plist({"command": "getInterfaceOrientation"})
+        return InterfaceOrientation(res.get("interfaceOrientation"))
 
     def get_wallpaper_pngdata(self) -> bytes:
-        return self.service.send_recv_plist({'command': 'getHomeScreenWallpaperPNGData'}).get('pngData')
+        return self.service.send_recv_plist({"command": "getHomeScreenWallpaperPNGData"}).get("pngData")
 
     def get_homescreen_icon_metrics(self) -> dict[str, float]:
-        return self.service.send_recv_plist({'command': 'getHomeScreenIconMetrics'})
+        return self.service.send_recv_plist({"command": "getHomeScreenIconMetrics"})
 
     def get_wallpaper_info(self, wallpaper_name: str) -> dict:
-        return self.service.send_recv_plist({'command': 'getWallpaperInfo', 'wallpaperName': wallpaper_name})
+        return self.service.send_recv_plist({"command": "getWallpaperInfo", "wallpaperName": wallpaper_name})
 
     def reload_icon_state(self) -> None:
         self.set_icon_state(self.get_icon_state())
 
     def get_wallpaper_preview_image(self, wallpaper_name: str) -> bytes:
-        return self.service.send_recv_plist({
-            'command': 'getWallpaperPreviewImage', 'wallpaperName': wallpaper_name})['pngData']
+        return self.service.send_recv_plist({"command": "getWallpaperPreviewImage", "wallpaperName": wallpaper_name})[
+            "pngData"
+        ]

pymobiledevice3/services/syslog.py

@@ -4,8 +4,8 @@ from pymobiledevice3.services.lockdown_service import LockdownService
 from pymobiledevice3.utils import try_decode
 
 CHUNK_SIZE = 4096
-TIME_FORMAT = '%H:%M:%S'
-SYSLOG_LINE_SPLITTER = b'\n\x00'
+TIME_FORMAT = "%H:%M:%S"
+SYSLOG_LINE_SPLITTER = b"\n\x00"
 
 
 class SyslogService(LockdownService):
@@ -13,8 +13,8 @@ class SyslogService(LockdownService):
     View system logs
     """
 
-    SERVICE_NAME = 'com.apple.syslog_relay'
-    RSD_SERVICE_NAME = 'com.apple.syslog_relay.shim.remote'
+    SERVICE_NAME = "com.apple.syslog_relay"
+    RSD_SERVICE_NAME = "com.apple.syslog_relay.shim.remote"
 
     def __init__(self, service_provider: LockdownServiceProvider):
         if isinstance(service_provider, LockdownClient):
@@ -23,7 +23,7 @@ class SyslogService(LockdownService):
             super().__init__(service_provider, self.RSD_SERVICE_NAME)
 
     def watch(self):
-        buf = b''
+        buf = b""
         while True:
             # read in chunks till we have at least one syslog line
             chunk = self.service.recv(CHUNK_SIZE)

pymobiledevice3/services/web_protocol/alert.py

@@ -6,11 +6,11 @@ class Alert:
         self.session = session
 
     def accept(self):
-        """ Accepts the alert available. """
+        """Accepts the alert available."""
         self.session.accept_current_javascript_dialog()
 
     def dismiss(self):
-        """ Dismisses the alert available. """
+        """Dismisses the alert available."""
         self.session.dismiss_current_javascript_dialog()
 
     def send_keys(self, text: str):
@@ -22,5 +22,5 @@ class Alert:
 
     @property
     def text(self) -> str:
-        """ Gets the text of the Alert. """
+        """Gets the text of the Alert."""
         return self.session.message_of_current_javascript_dialog()