pymobiledevice3 7.0.7__py3-none-any.whl → 7.1.0__py3-none-any.whl

pymobiledevice3/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '7.0.7'
-__version_tuple__ = version_tuple = (7, 0, 7)
+__version__ = version = '7.1.0'
+__version_tuple__ = version_tuple = (7, 1, 0)
 
 __commit_id__ = commit_id = None

pymobiledevice3/cli/developer/debugserver.py

@@ -6,7 +6,9 @@ import struct
 import subprocess
 import sys
 from pathlib import Path
+from tempfile import TemporaryDirectory
 from typing import Annotated, Optional
+from zipfile import ZipFile
 
 import typer
 from packaging.version import Version
@@ -80,9 +82,9 @@ def debugserver_start_server(service_provider: ServiceProviderDep, local_port: O
 @cli.command("lldb")
 def debugserver_lldb(
     service_provider: RSDServiceProviderDep,
-    xcodeproj_path: Annotated[
+    project_or_ipa_path: Annotated[
         Path,
-        typer.Argument(exists=True, file_okay=False, dir_okay=True),
+        typer.Argument(exists=True, file_okay=True, dir_okay=True),
     ],
     configuration: Annotated[
         str,
@@ -106,11 +108,12 @@ def debugserver_lldb(
     ] = None,
 ) -> None:
     """
-    Automate lldb launch for a given xcodeproj.
+    Automate lldb launch for a given xcodeproj or IPA.
 
     \b
     This will:
-    - Build the given xcodeproj
+    - Build the given xcodeproj (if provided)
+    - Extract the given IPA (if provided)
     - Install it
     - Start a debugserver attached to it
     - Place breakpoints if given any
@@ -123,122 +126,154 @@ def debugserver_lldb(
         return
 
     commands = []
-    with local.cwd(xcodeproj_path.parent):
-        logger.info(f"Building {xcodeproj_path} for {configuration} configuration")
-        local["xcodebuild"]["-configuration", configuration, "build"]()
-        local_app = next(iter(Path(f"build/{configuration}-iphoneos").glob("*.app")))
-        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}")
+    temp_dir = None
+    local_app = None
+    install_source = None
+
+    if project_or_ipa_path.suffix == ".xcodeproj":
+        with local.cwd(project_or_ipa_path.parent):
+            logger.info(f"Building {project_or_ipa_path} for {configuration} configuration")
+            local["xcodebuild"]["-project", str(project_or_ipa_path), "-configuration", configuration, "build"]()
+            app_candidates = [app for app in Path("build").rglob("*.app") if (app / "Info.plist").exists()]
+            if not app_candidates:
+                logger.error("No built .app with Info.plist found under build/.")
+                return
+            app_candidates.sort(key=lambda p: p.stat().st_mtime, reverse=True)
+            local_app = app_candidates[0].absolute()
+            install_source = local_app
+    elif project_or_ipa_path.suffix == ".ipa":
+        temp_dir = TemporaryDirectory()
+        with ZipFile(project_or_ipa_path, "r") as ipa_zip:
+            ipa_zip.extractall(temp_dir.name)
+        payload_dir = Path(temp_dir.name) / "Payload"
+        apps = list(payload_dir.glob("*.app"))
+        if not apps:
+            logger.error("No .app bundle found in IPA Payload.")
+            temp_dir.cleanup()
+            return
+        if len(apps) > 1:
+            logger.error("Multiple .app bundles found in IPA Payload; please provide a single-app IPA.")
+            temp_dir.cleanup()
+            return
+        local_app = apps[0].absolute()
+        install_source = project_or_ipa_path
+    else:
+        logger.error("Expected an .xcodeproj directory or an .ipa file.")
+        return
+
+    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(install_source)
+        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")
+    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}")
 
-        # Add connection and launch commands
-        commands.append(f"process connect connect://[{service_provider.service.address[0]}]:{debugserver_port}")
+    if breakpoints:
+        for bp in breakpoints:
+            commands.append(f'breakpoint set -n "{bp}"')
 
-        if breakpoints:
-            for bp in breakpoints:
-                commands.append(f'breakpoint set -n "{bp}"')
+    if launch:
+        commands.append("process launch")
 
-        if launch:
-            commands.append("process launch")
+    if user_commands:
+        # Add user commands
+        commands += user_commands
 
-        if user_commands:
-            # Add user commands
-            commands += user_commands
+    logger.info("Starting lldb with automated setup and connection")
 
-        logger.info("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
 
-        # 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()
 
-        master, slave = pty.openpty()
+    process = None  # Initialize process variable for signal handler
 
-        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)
 
-        # 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()
 
-        # Initial resize
+    # Set up signal handler for window resize
+    def handle_sigwinch(signum, frame):
         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)
 
-        old_sigwinch_handler = signal.signal(signal.SIGWINCH, handle_sigwinch)
+    # Save original terminal settings
+    old_tty = termios.tcgetattr(sys.stdin)
 
-        # 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")
 
-        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)
 
-            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())
 
-            # 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], [], [])
 
-            # 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 sys.stdin in rlist:
-                    # User typed something
-                    data = os.read(sys.stdin.fileno(), 1024)
+            if master in rlist:
+                # lldb has output
+                try:
+                    data = os.read(master, 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()
+                    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()
+        if temp_dir is not None:
+            temp_dir.cleanup()

{pymobiledevice3-7.0.7.dist-info → pymobiledevice3-7.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pymobiledevice3
-Version: 7.0.7
+Version: 7.1.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-7.0.7.dist-info → pymobiledevice3-7.1.0.dist-info}/RECORD

@@ -8,7 +8,7 @@ misc/understanding_idevice_protocol_layers.md,sha256=FMJQ-ik2j9kFLPS15JzDZg62uk1
 misc/usbmux_sniff.sh,sha256=iWtbucOEQ9_UEFXk9x-2VNt48Jg5zrPsnUbZ_LfZxwA,212
 pymobiledevice3/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pymobiledevice3/__main__.py,sha256=Ogsyro4MUVVSciEtg8kZufL81AHcjuphItnaL0BT10Q,16386
-pymobiledevice3/_version.py,sha256=0c2yrCNjkahQT4hAahQeRLH51KQrBSwCjA0jYBtvoiI,704
+pymobiledevice3/_version.py,sha256=hoQMYVAGxOg65i7V5PoVLpY46qxSMJVk6GEsfI-0lRI,704
 pymobiledevice3/bonjour.py,sha256=lmx3uCaiolF59AieftmTKqktNod5ZDyJ06oRZdYKHSE,13681
 pymobiledevice3/ca.py,sha256=5_Y4F-zDFX_KeDL-M_TRCKKyrRRb9h1lBE8MGTWv91o,10606
 pymobiledevice3/common.py,sha256=FZzF0BQYV5fCEUPbLo6jbt2Ig9s5YwR8AvX_iR124Ew,329
@@ -52,7 +52,7 @@ pymobiledevice3/cli/developer/__init__.py,sha256=idQOgVsitt3nfolyhZuA6KHN2j44JNV
 pymobiledevice3/cli/developer/arbitration.py,sha256=7Eod6-dlSjAMBljbsIGHL_QG9LFbOPIXqpS9Y_4-Q3Y,1576
 pymobiledevice3/cli/developer/condition.py,sha256=lb5BS8lVcgsb2yBgBsN2nK-j2u1_iVm_tBd1pSRHZB0,1294
 pymobiledevice3/cli/developer/core_device.py,sha256=QzMVfghq3fKLI2NQ2Kg7r_zyFIWGCBt7ZS-GTLWDZs4,10895
-pymobiledevice3/cli/developer/debugserver.py,sha256=4_BiZi69i31t6j7gpGEvt9m8Zo0yJsBQH7zQySyr68M,9315
+pymobiledevice3/cli/developer/debugserver.py,sha256=0hP6-x3xChcYCacxI7CuEWEsM8-u4i4GNYa1HeSMPXg,10464
 pymobiledevice3/cli/developer/fetch_symbols.py,sha256=57HzVyUJPXL_I8EiqWArJ2Fczb2yX9y6nDMgjZcADo0,4353
 pymobiledevice3/cli/developer/simulate_location.py,sha256=IVJQPYKUrQcsdpCxf2D2sgy6Nb3mUOFvK-Og_y5lfDM,1555
 pymobiledevice3/cli/developer/accessibility/__init__.py,sha256=VpJSdnkEZhUuJXWy08wqgqObXv1PgZ2Ht4qy-560QRk,2271
@@ -180,9 +180,9 @@ pymobiledevice3/services/web_protocol/switch_to.py,sha256=TCdVrMfsvd18o-vZ0owVrE
 pymobiledevice3/tunneld/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pymobiledevice3/tunneld/api.py,sha256=Lwl1OdhPTgX6Zqezy8T4dEcXRfaEPwyGNClioTx3fUc,2338
 pymobiledevice3/tunneld/server.py,sha256=dMEZAv_X-76l0vSalpq4x0IVkbE-MNGR77T-u1TiHuE,25752
-pymobiledevice3-7.0.7.dist-info/licenses/LICENSE,sha256=jOtLnuWt7d5Hsx6XXB2QxzrSe2sWWh3NgMfFRetluQM,35147
-pymobiledevice3-7.0.7.dist-info/METADATA,sha256=vRzzMNV_Ahuu1AO2zkZFm2oZRI2MpNBaxUirarK3dd8,17500
-pymobiledevice3-7.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pymobiledevice3-7.0.7.dist-info/entry_points.txt,sha256=jJMlOanHlVwUxcY__JwvKeWPrvBJr_wJyEq4oHIZNKE,66
-pymobiledevice3-7.0.7.dist-info/top_level.txt,sha256=MjZoRqcWPOh5banG-BbDOnKEfsS3kCxqV9cv-nzyg2Q,21
-pymobiledevice3-7.0.7.dist-info/RECORD,,
+pymobiledevice3-7.1.0.dist-info/licenses/LICENSE,sha256=jOtLnuWt7d5Hsx6XXB2QxzrSe2sWWh3NgMfFRetluQM,35147
+pymobiledevice3-7.1.0.dist-info/METADATA,sha256=p_l-eHzSpqafrRTx3bUX1_OZEK_Af0-Mtfm34H6RFcw,17500
+pymobiledevice3-7.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pymobiledevice3-7.1.0.dist-info/entry_points.txt,sha256=jJMlOanHlVwUxcY__JwvKeWPrvBJr_wJyEq4oHIZNKE,66
+pymobiledevice3-7.1.0.dist-info/top_level.txt,sha256=MjZoRqcWPOh5banG-BbDOnKEfsS3kCxqV9cv-nzyg2Q,21
+pymobiledevice3-7.1.0.dist-info/RECORD,,