pymobiledevice3 4.26.6__tar.gz → 4.27.0__tar.gz

{pymobiledevice3-4.26.6 → pymobiledevice3-4.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymobiledevice3
-Version: 4.26.6
+Version: 4.27.0
 Summary: Pure python3 implementation for working with iDevices (iPhone, etc...)
 Author-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>
 Maintainer-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>

{pymobiledevice3-4.26.6 → pymobiledevice3-4.27.0}/pymobiledevice3/__main__.py

@@ -6,6 +6,7 @@ import re
 import sys
 import textwrap
 import traceback
+import warnings
 from typing import Union
 
 import click
@@ -38,7 +39,9 @@ logger = logging.getLogger(__name__)
 
 # For issue https://github.com/doronz88/pymobiledevice3/issues/1217, details: https://bugs.python.org/issue37373
 if sys.platform == 'win32':
-    asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+    with warnings.catch_warnings():
+        warnings.simplefilter('ignore', category=DeprecationWarning)
+        asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
 
 INVALID_SERVICE_MESSAGE = """Failed to start service. Possible reasons are:
 - If you were trying to access a developer service (developer subcommand):

{pymobiledevice3-4.26.6 → pymobiledevice3-4.27.0}/pymobiledevice3/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '4.26.6'
-__version_tuple__ = version_tuple = (4, 26, 6)
+__version__ = version = '4.27.0'
+__version_tuple__ = version_tuple = (4, 27, 0)
 
-__commit_id__ = commit_id = 'g7b7d9d8a3'
+__commit_id__ = commit_id = 'gf0804b1ec'

{pymobiledevice3-4.26.6 → pymobiledevice3-4.27.0}/pymobiledevice3/cli/developer.py

@@ -3,9 +3,12 @@ import asyncio
 import json
 import logging
 import os
+import plistlib
 import posixpath
 import shlex
 import signal
+import struct
+import subprocess
 import sys
 import time
 from collections import namedtuple
@@ -17,13 +20,14 @@ from typing import IO, Optional
 import click
 from click.exceptions import MissingParameter, UsageError
 from packaging.version import Version
+from plumbum import local
 from pykdebugparser.pykdebugparser import PyKdebugParser
 
 import pymobiledevice3
 from pymobiledevice3.cli.cli_common import BASED_INT, Command, RSDCommand, default_json_encoder, print_json, \
     user_requested_colored_output
-from pymobiledevice3.exceptions import CoreDeviceError, DeviceAlreadyInUseError, DvtDirListError, \
-    ExtractingStackshotError, RSDRequiredError, UnrecognizedSelectorError
+from pymobiledevice3.exceptions import DeviceAlreadyInUseError, DvtDirListError, ExtractingStackshotError, \
+    RSDRequiredError, UnrecognizedSelectorError
 from pymobiledevice3.lockdown import LockdownClient, create_using_usbmux
 from pymobiledevice3.lockdown_service_provider import LockdownServiceProvider
 from pymobiledevice3.osu.os_utils import get_os_utils
@@ -52,6 +56,7 @@ from pymobiledevice3.services.dvt.instruments.process_control import ProcessCont
 from pymobiledevice3.services.dvt.instruments.screenshot import Screenshot
 from pymobiledevice3.services.dvt.instruments.sysmontap import Sysmontap
 from pymobiledevice3.services.dvt.testmanaged.xcuitest import XCUITestService
+from pymobiledevice3.services.installation_proxy import InstallationProxyService
 from pymobiledevice3.services.remote_fetch_symbols import RemoteFetchSymbolsService
 from pymobiledevice3.services.remote_server import RemoteServer
 from pymobiledevice3.services.screenshot import ScreenshotService
@@ -126,6 +131,7 @@ def proclist(service_provider: LockdownClient) -> None:
 
         print_json(processes)
 
+
 @dvt.command('is-running-pid', cls=Command)
 @click.argument('pid', type=click.INT)
 def is_running_pid(service_provider: LockdownClient, pid: int) -> None:
@@ -133,6 +139,7 @@ def is_running_pid(service_provider: LockdownClient, pid: int) -> None:
     with DvtSecureSocketProxyService(lockdown=service_provider) as dvt:
         print_json(DeviceInfo(dvt).is_running_pid(pid))
 
+
 @dvt.command('memlimitoff', cls=Command)
 @click.argument('pid', type=click.INT)
 def memlimitoff(service_provider: LockdownServiceProvider, pid: int) -> None:
@@ -140,6 +147,7 @@ def memlimitoff(service_provider: LockdownServiceProvider, pid: int) -> None:
     with DvtSecureSocketProxyService(lockdown=service_provider) as dvt:
         ProcessControl(dvt).disable_memory_limit_for_pid(pid)
 
+
 @dvt.command('applist', cls=Command)
 def applist(service_provider: LockdownServiceProvider) -> None:
     """ Show application list """
@@ -412,7 +420,7 @@ def sysmon_system(service_provider: LockdownClient, fields):
                                 'EnabledCPUs': row['EnabledCPUs'],
                             }
                         }
-                    else: # Ignore the first occurrence because first occurrence always gives a incorrect value - 100 or 0
+                    else:  # Ignore the first occurrence because first occurrence always gives a incorrect value - 100 or 0
                         system_usage_seen = True
 
                 if system and system_usage:
@@ -990,6 +998,165 @@ def debugserver_start_server(service_provider: LockdownClient, local_port: Optio
         print("local_port is required for iOS < 17.0")
 
 
+@debugserver.command('lldb', cls=RSDCommand)
+@click.argument('xcodeproj_path', type=click.Path(exists=True, file_okay=False, dir_okay=True))
+@click.option('--configuration', default='Debug', help='Usually Release/Debug')
+@click.option('--lldb-command', default='lldb')
+@click.option('--launch', is_flag=True, default=False, help='Launch the app after connecting to lldb')
+@click.option('breakpoints', '-b', '--break', multiple=True, help='Add multiple startup breakpoints')
+@click.option('user_commands', '--command', '-c', multiple=True, help='Additional commands to run at startup')
+def debugserver_lldb(
+        service_provider: LockdownServiceProvider,
+        xcodeproj_path: str,
+        configuration: str,
+        lldb_command: str,
+        launch: bool,
+        breakpoints: tuple[str],
+        user_commands: tuple[str],
+) -> None:
+    """
+    Automate lldb launch for a given xcodeproj.
+
+    \b
+    This will:
+    - Build the given xcodeproj
+    - Install it
+    - Start a debugserver attached to it
+    - Place breakpoints if given any
+    - Launch the application if requested
+    - Execute any additional commands if requested
+    - Switch to lldb shell
+    """
+    if Version(service_provider.product_version) < Version('17.0'):
+        logger.error('lldb is only supported on iOS >= 17.0')
+        return
+
+    commands = []
+    xcodeproj_path = Path(xcodeproj_path)
+    with local.cwd(xcodeproj_path.parent):
+        logger.info(f'Building {xcodeproj_path} for {configuration} configuration')
+        local['xcodebuild']['-configuration', configuration, 'build']()
+        local_app = list(Path(f'build/{configuration}-iphoneos').glob('*.app'))[0]
+        logger.info(f'Using app: {local_app}')
+
+        info_plist_path = local_app / 'Info.plist'
+        info_plist = plistlib.loads(info_plist_path.read_bytes())
+        bundle_identifier = info_plist['CFBundleIdentifier']
+        logger.info(f'Bundle identifier: {bundle_identifier}')
+
+        commands.append('platform select remote-ios')
+        commands.append(f'target create "{local_app.absolute()}"')
+
+        with InstallationProxyService(create_using_usbmux()) as installation_proxy:
+            logger.info('Installing app')
+            installation_proxy.install_from_local(local_app)
+            remote_path = installation_proxy.get_apps(bundle_identifiers=[bundle_identifier])[bundle_identifier]['Path']
+            logger.info(f'Remote path: {remote_path}')
+
+        commands.append(f'script lldb.target.module[0].SetPlatformFileSpec(lldb.SBFileSpec("{remote_path}"))')
+
+        debugserver_port = service_provider.get_service_port('com.apple.internal.dt.remote.debugproxy')
+
+        # Add connection and launch commands
+        commands.append(f'process connect connect://[{service_provider.service.address[0]}]:{debugserver_port}')
+
+        for breakpoint in breakpoints:
+            commands.append(f'breakpoint set -n "{breakpoint}"')
+
+        if launch:
+            commands.append('process launch')
+
+        # Add user commands
+        commands += user_commands
+
+        logger.info(f'Starting lldb with automated setup and connection')
+
+        # Works only on unix-based systems, so keep these imports here
+        import fcntl
+        import pty
+        import select as select_module
+        import termios
+        import tty
+
+        master, slave = pty.openpty()
+
+        process = None  # Initialize process variable for signal handler
+
+        # Copy terminal size from the current terminal to PTY
+        def resize_pty() -> None:
+            """Update PTY size to match current terminal size"""
+            size = struct.unpack('HHHH',
+                                 fcntl.ioctl(sys.stdout.fileno(), termios.TIOCGWINSZ, struct.pack('HHHH', 0, 0, 0, 0)))
+            fcntl.ioctl(master, termios.TIOCSWINSZ, struct.pack('HHHH', *size))
+            # Send SIGWINCH to the child process to notify it of the resize
+            if process is not None and process.poll() is None:
+                process.send_signal(signal.SIGWINCH)
+
+        # Initial resize
+        resize_pty()
+
+        # Set up signal handler for window resize
+        def handle_sigwinch(signum, frame):
+            resize_pty()
+
+        old_sigwinch_handler = signal.signal(signal.SIGWINCH, handle_sigwinch)
+
+        # Save original terminal settings
+        old_tty = termios.tcgetattr(sys.stdin)
+
+        try:
+            # Set TERM environment variable to enable colors
+            env = os.environ.copy()
+            env['TERM'] = os.environ.get('TERM', 'xterm-256color')
+
+            process = subprocess.Popen(
+                [lldb_command],
+                stdin=slave,
+                stdout=slave,
+                stderr=slave,
+                env=env
+            )
+            os.close(slave)
+
+            # Put terminal in raw mode for proper interaction
+            tty.setraw(sys.stdin.fileno())
+            # Send all commands through stdin
+            for command in commands:
+                os.write(master, (command + '\n').encode())
+
+            # Now redirect stdin from the terminal to lldb so user can interact
+            while True:
+                rlist, _, _ = select_module.select([sys.stdin, master], [], [])
+
+                if sys.stdin in rlist:
+                    # User typed something
+                    data = os.read(sys.stdin.fileno(), 1024)
+                    if not data:
+                        break
+                    os.write(master, data)
+
+                if master in rlist:
+                    # lldb has output
+                    try:
+                        data = os.read(master, 1024)
+                        if not data:
+                            break
+                        os.write(sys.stdout.fileno(), data)
+                    except OSError:
+                        break
+        except (KeyboardInterrupt, OSError):
+            pass
+        finally:
+            # Restore terminal settings
+            termios.tcsetattr(sys.stdin, termios.TCSADRAIN, old_tty)
+            # Restore original SIGWINCH handler
+            signal.signal(signal.SIGWINCH, old_sigwinch_handler)
+            os.close(master)
+            if process is not None:
+                process.terminate()
+                process.wait()
+
+
 @developer.group('arbitration')
 def arbitration():
     """ Mark/Unmark device as "in-use" """
@@ -1101,7 +1268,8 @@ def core_device_list_directory(
 
 
 async def core_device_read_file_task(
-        service_provider: RemoteServiceDiscoveryService, domain: str, path: str, identifier: str, output: Optional[IO]) -> None:
+        service_provider: RemoteServiceDiscoveryService, domain: str, path: str, identifier: str,
+        output: Optional[IO]) -> None:
     async with FileServiceService(service_provider, APPLE_DOMAIN_DICT[domain], identifier) as file_service:
         buf = await file_service.retrieve_file(path)
         if output is not None:
@@ -1116,7 +1284,8 @@ async def core_device_read_file_task(
 @click.option('--identifier', default='')
 @click.option('-o', '--output', type=click.File('wb'))
 def core_device_read_file(
-        service_provider: RemoteServiceDiscoveryService, domain: str, path: str, identifier: str, output: Optional[IO]) -> None:
+        service_provider: RemoteServiceDiscoveryService, domain: str, path: str, identifier: str,
+        output: Optional[IO]) -> None:
     """ Read file from given domain-path """
     asyncio.run(core_device_read_file_task(service_provider, domain, path, identifier, output))
 

{pymobiledevice3-4.26.6 → pymobiledevice3-4.27.0}/pymobiledevice3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymobiledevice3
-Version: 4.26.6
+Version: 4.27.0
 Summary: Pure python3 implementation for working with iDevices (iPhone, etc...)
 Author-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>
 Maintainer-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>