pymobiledevice3 4.14.6__py3-none-any.whl → 7.0.6__py3-none-any.whl

pymobiledevice3/common.py

@@ -2,9 +2,11 @@ from pathlib import Path
 
 from pymobiledevice3.osu.os_utils import get_os_utils
 
-_HOMEFOLDER = get_os_utils().get_homedir() / '.pymobiledevice3'
+_OS_UTILS = get_os_utils()
+_HOMEFOLDER = _OS_UTILS.get_homedir() / ".pymobiledevice3"
 
 
 def get_home_folder() -> Path:
     _HOMEFOLDER.mkdir(exist_ok=True, parents=True)
+    _OS_UTILS.chown_to_non_sudo_if_needed(_HOMEFOLDER)
     return _HOMEFOLDER

pymobiledevice3/exceptions.py

@@ -1,20 +1,74 @@
 __all__ = [
-    'PyMobileDevice3Exception', 'DeviceVersionNotSupportedError', 'IncorrectModeError',
-    'NotTrustedError', 'PairingError', 'NotPairedError', 'CannotStopSessionError',
-    'PasswordRequiredError', 'StartServiceError', 'FatalPairingError', 'NoDeviceConnectedError', 'DeviceNotFoundError',
-    'TunneldConnectionError', 'ConnectionFailedToUsbmuxdError', 'MuxException', 'InvalidConnectionError',
-    'MuxVersionError', 'ArgumentError', 'AfcException', 'AfcFileNotFoundError', 'DvtException', 'DvtDirListError',
-    'NotMountedError', 'AlreadyMountedError', 'UnsupportedCommandError', 'ExtractingStackshotError',
-    'ConnectionTerminatedError', 'WirError', 'WebInspectorNotEnabledError', 'RemoteAutomationNotEnabledError',
-    'ArbitrationError', 'InternalError', 'DeveloperModeIsNotEnabledError', 'DeviceAlreadyInUseError', 'LockdownError',
-    'PairingDialogResponsePendingError', 'UserDeniedPairingError', 'InvalidHostIDError', 'SetProhibitedError',
-    'MissingValueError', 'PasscodeRequiredError', 'AmfiError', 'DeviceHasPasscodeSetError', 'NotificationTimeoutError',
-    'DeveloperModeError', 'ProfileError', 'IRecvError', 'IRecvNoDeviceConnectedError', 'UnrecognizedSelectorError',
-    'MessageNotSupportedError', 'InvalidServiceError', 'InspectorEvaluateError',
-    'LaunchingApplicationError', 'BadCommandError', 'BadDevError', 'ConnectionFailedError', 'CoreDeviceError',
-    'AccessDeniedError', 'RSDRequiredError', 'SysdiagnoseTimeoutError', 'GetProhibitedError',
-    'FeatureNotSupportedError', 'OSNotSupportedError', 'DeprecationError', 'NotEnoughDiskSpaceError',
-    'CloudConfigurationAlreadyPresentError'
+    "AccessDeniedError",
+    "AfcException",
+    "AfcFileNotFoundError",
+    "AlreadyMountedError",
+    "AmfiError",
+    "ArbitrationError",
+    "ArgumentError",
+    "BadCommandError",
+    "BadDevError",
+    "CannotStopSessionError",
+    "CloudConfigurationAlreadyPresentError",
+    "ConnectionFailedError",
+    "ConnectionFailedToUsbmuxdError",
+    "ConnectionTerminatedError",
+    "CoreDeviceError",
+    "DeprecationError",
+    "DeveloperModeError",
+    "DeveloperModeIsNotEnabledError",
+    "DeviceAlreadyInUseError",
+    "DeviceHasPasscodeSetError",
+    "DeviceNotFoundError",
+    "DeviceVersionNotSupportedError",
+    "DisableMemoryLimitError",
+    "DvtDirListError",
+    "DvtException",
+    "ExtractingStackshotError",
+    "FatalPairingError",
+    "FeatureNotSupportedError",
+    "GetProhibitedError",
+    "IRecvError",
+    "IRecvNoDeviceConnectedError",
+    "IncorrectModeError",
+    "InspectorEvaluateError",
+    "InternalError",
+    "InvalidConnectionError",
+    "InvalidHostIDError",
+    "InvalidServiceError",
+    "LaunchingApplicationError",
+    "LockdownError",
+    "MessageNotSupportedError",
+    "MissingValueError",
+    "MuxException",
+    "MuxVersionError",
+    "NoDeviceConnectedError",
+    "NotEnoughDiskSpaceError",
+    "NotMountedError",
+    "NotPairedError",
+    "NotTrustedError",
+    "NotificationTimeoutError",
+    "OSNotSupportedError",
+    "PairingDialogResponsePendingError",
+    "PairingError",
+    "PasscodeRequiredError",
+    "PasswordRequiredError",
+    "ProfileError",
+    "PyMobileDevice3Exception",
+    "QuicProtocolNotSupportedError",
+    "RSDRequiredError",
+    "RemoteAutomationNotEnabledError",
+    "RemotePairingCompletedError",
+    "SetProhibitedError",
+    "StartServiceError",
+    "SysdiagnoseTimeoutError",
+    "TSSError",
+    "TunneldConnectionError",
+    "UnrecognizedSelectorError",
+    "UnsupportedCommandError",
+    "UserDeniedPairingError",
+    "WebInspectorNotEnabledError",
+    "WirError",
 ]
 
 from typing import Optional
@@ -53,7 +107,10 @@ class PasswordRequiredError(PairingError):
 
 
 class StartServiceError(PyMobileDevice3Exception):
-    pass
+    def __init__(self, service_name: str, message: str) -> None:
+        super().__init__()
+        self.service_name = service_name
+        self.message = message
 
 
 class FatalPairingError(PyMobileDevice3Exception):
@@ -109,9 +166,10 @@ class ArgumentError(PyMobileDevice3Exception):
 
 
 class AfcException(PyMobileDevice3Exception, OSError):
-    def __init__(self, message, status):
+    def __init__(self, message: str, status: str, filename: Optional[str] = None) -> None:
         OSError.__init__(self, status, message)
         self.status = status
+        self.filename = filename
 
 
 class AfcFileNotFoundError(AfcException):
@@ -119,113 +177,131 @@ class AfcFileNotFoundError(AfcException):
 
 
 class DvtException(PyMobileDevice3Exception):
-    """ Domain exception for DVT operations. """
+    """Domain exception for DVT operations."""
+
     pass
 
 
 class UnrecognizedSelectorError(DvtException):
-    """ Attempted to call an unrecognized selector from DVT. """
+    """Attempted to call an unrecognized selector from DVT."""
+
     pass
 
 
 class DvtDirListError(DvtException):
-    """ Raise when directory listing fails. """
+    """Raise when directory listing fails."""
+
     pass
 
 
 class NotMountedError(PyMobileDevice3Exception):
-    """ Given image for umount wasn't mounted in the first place """
+    """Given image for umount wasn't mounted in the first place"""
+
     pass
 
 
 class AlreadyMountedError(PyMobileDevice3Exception):
-    """ Given image for mount has already been mounted in the first place """
+    """Given image for mount has already been mounted in the first place"""
+
     pass
 
 
 class MissingManifestError(PyMobileDevice3Exception):
-    """ No manifest could be found """
+    """No manifest could be found"""
+
     pass
 
 
 class UnsupportedCommandError(PyMobileDevice3Exception):
-    """ Given command isn't supported for this iOS version """
+    """Given command isn't supported for this iOS version"""
+
     pass
 
 
 class ExtractingStackshotError(PyMobileDevice3Exception):
-    """ Raise when stackshot is not received in the core profile session. """
+    """Raise when stackshot is not received in the core profile session."""
+
     pass
 
 
 class ConnectionTerminatedError(PyMobileDevice3Exception):
-    """ Raise when a connection is terminated abruptly. """
+    """Raise when a connection is terminated abruptly."""
+
     pass
 
 
 class StreamClosedError(ConnectionTerminatedError):
-    """ Raise when trying to send a message on a closed stream. """
+    """Raise when trying to send a message on a closed stream."""
+
     pass
 
 
 class WebInspectorNotEnabledError(PyMobileDevice3Exception):
-    """ Raise when Web Inspector is not enabled. """
+    """Raise when Web Inspector is not enabled."""
+
     pass
 
 
 class RemoteAutomationNotEnabledError(PyMobileDevice3Exception):
-    """ Raise when Web Inspector remote automation is not enabled. """
+    """Raise when Web Inspector remote automation is not enabled."""
+
     pass
 
 
 class WirError(PyMobileDevice3Exception):
-    """ Raise when Webinspector WIR command fails. """
+    """Raise when Webinspector WIR command fails."""
+
     pass
 
 
 class InternalError(PyMobileDevice3Exception):
-    """ Some internal Apple error """
+    """Some internal Apple error"""
+
     pass
 
 
 class ArbitrationError(PyMobileDevice3Exception):
-    """ Arbitration failed """
+    """Arbitration failed"""
+
     pass
 
 
 class DeviceAlreadyInUseError(ArbitrationError):
-    """ Device is already checked-in by someone """
+    """Device is already checked-in by someone"""
 
     @property
     def message(self):
-        return self.args[0].get('message')
+        return self.args[0].get("message")
 
     @property
     def owner(self):
-        return self.args[0].get('owner')
+        return self.args[0].get("owner")
 
     @property
     def result(self):
-        return self.args[0].get('result')
+        return self.args[0].get("result")
 
 
 class DeveloperModeIsNotEnabledError(PyMobileDevice3Exception):
-    """ Raise when mounting failed because developer mode is not enabled. """
+    """Raise when mounting failed because developer mode is not enabled."""
+
     pass
 
 
 class DeveloperDiskImageNotFoundError(PyMobileDevice3Exception):
-    """ Failed to locate the correct DeveloperDiskImage.dmg """
+    """Failed to locate the correct DeveloperDiskImage.dmg"""
+
     pass
 
 
 class DeveloperModeError(PyMobileDevice3Exception):
-    """ Raise when amfid failed to enable developer mode. """
+    """Raise when amfid failed to enable developer mode."""
+
     pass
 
 
 class LockdownError(PyMobileDevice3Exception):
-    """ lockdown general error """
+    """lockdown general error"""
 
     def __init__(self, message: str, identifier: Optional[str] = None) -> None:
         super().__init__(message)
@@ -241,7 +317,8 @@ class SetProhibitedError(LockdownError):
 
 
 class PairingDialogResponsePendingError(PairingError):
-    """ User hasn't yet confirmed the device is trusted """
+    """User hasn't yet confirmed the device is trusted"""
+
     pass
 
 
@@ -254,7 +331,8 @@ class InvalidHostIDError(PairingError):
 
 
 class MissingValueError(LockdownError):
-    """ raised when attempting to query non-existent domain/key """
+    """raised when attempting to query non-existent domain/key"""
+
     pass
 
 
@@ -263,7 +341,8 @@ class InvalidConnectionError(LockdownError):
 
 
 class PasscodeRequiredError(LockdownError):
-    """ passcode must be present for this action """
+    """passcode must be present for this action"""
+
     pass
 
 
@@ -304,8 +383,14 @@ class InvalidServiceError(LockdownError):
 
 
 class InspectorEvaluateError(PyMobileDevice3Exception):
-    def __init__(self, class_name: str, message: str, line: Optional[int] = None, column: Optional[int] = None,
-                 stack: Optional[list[str]] = None):
+    def __init__(
+        self,
+        class_name: str,
+        message: str,
+        line: Optional[int] = None,
+        column: Optional[int] = None,
+        stack: Optional[list[str]] = None,
+    ):
         super().__init__()
         self.class_name = class_name
         self.message = message
@@ -314,10 +399,8 @@ class InspectorEvaluateError(PyMobileDevice3Exception):
         self.stack = stack
 
     def __str__(self) -> str:
-        stack_trace = '\n'.join([f'\t - {frame}' for frame in self.stack])
-        return (f'{self.class_name}: {self.message}.\n'
-                f'Line: {self.line} Column: {self.column}\n'
-                f'Stack: {stack_trace}')
+        stack_trace = "\n".join([f"\t - {frame}" for frame in self.stack])
+        return f"{self.class_name}: {self.message}.\nLine: {self.line} Column: {self.column}\nStack: {stack_trace}"
 
 
 class LaunchingApplicationError(PyMobileDevice3Exception):
@@ -337,7 +420,8 @@ class CoreDeviceError(PyMobileDevice3Exception):
 
 
 class AccessDeniedError(PyMobileDevice3Exception):
-    """ Need extra permissions to execute this command """
+    """Need extra permissions to execute this command"""
+
     pass
 
 
@@ -346,22 +430,25 @@ class NoSuchBuildIdentityError(PyMobileDevice3Exception):
 
 
 class MobileActivationException(PyMobileDevice3Exception):
-    """ Mobile activation can not be done """
+    """Mobile activation can not be done"""
+
     pass
 
 
 class NotEnoughDiskSpaceError(PyMobileDevice3Exception):
-    """ Computer does not have enough disk space for the intended operation """
+    """Computer does not have enough disk space for the intended operation"""
+
     pass
 
 
 class DeprecationError(PyMobileDevice3Exception):
-    """ The requested action/service/method is deprecated """
+    """The requested action/service/method is deprecated"""
+
     pass
 
 
 class RSDRequiredError(PyMobileDevice3Exception):
-    """ The requested action requires an RSD object """
+    """The requested action requires an RSD object"""
 
     def __init__(self, identifier: str) -> None:
         self.identifier = identifier
@@ -369,7 +456,8 @@ class RSDRequiredError(PyMobileDevice3Exception):
 
 
 class SysdiagnoseTimeoutError(PyMobileDevice3Exception, TimeoutError):
-    """ Timeout collecting new sysdiagnose archive """
+    """Timeout collecting new sysdiagnose archive"""
+
     pass
 
 
@@ -380,13 +468,49 @@ class SupportError(PyMobileDevice3Exception):
 
 
 class OSNotSupportedError(SupportError):
-    """ Operating system is not supported. """
+    """Operating system is not supported."""
+
     pass
 
 
 class FeatureNotSupportedError(SupportError):
-    """ Feature has not been implemented for OS. """
+    """Feature has not been implemented for OS."""
 
     def __init__(self, os_name, feature):
         super().__init__(os_name)
         self.feature = feature
+
+
+class QuicProtocolNotSupportedError(PyMobileDevice3Exception):
+    """QUIC tunnel support was removed on iOS 18.2+"""
+
+    pass
+
+
+class RemotePairingCompletedError(PyMobileDevice3Exception):
+    """
+    Raised upon pairing completion using the `remotepairingdeviced` service (RemoteXPC).
+
+    remotepairingdeviced closes connection after pairing, so client must re-establish it after pairing is
+    completed.
+    """
+
+    pass
+
+
+class DisableMemoryLimitError(PyMobileDevice3Exception):
+    """Disabling memory limit fails."""
+
+    pass
+
+
+class ProtocolError(PyMobileDevice3Exception):
+    """An unexpected protocol message was received"""
+
+    pass
+
+
+class TSSError(PyMobileDevice3Exception):
+    """An unexpected message was received from apple ticket server"""
+
+    pass