hilda 2.0.0__py3-none-any.whl → 2.0.2__py3-none-any.whl

hilda/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.0.0'
-__version_tuple__ = version_tuple = (2, 0, 0)
+__version__ = version = '2.0.2'
+__version_tuple__ = version_tuple = (2, 0, 2)

hilda/cli.py

@@ -54,10 +54,10 @@ def attach(name: str, pid: int, startup_files: Optional[List[str]] = None) -> No
 @click.argument('exec_path')
 @click.option('--argv', multiple=True, help='Command line arguments to pass to the process')
 @click.option('--envp', multiple=True, callback=parse_envp, help='Environment variables in the form KEY=VALUE')
-@click.option('--stdin', type=Path, help='Redirect stdin from this file path')
-@click.option('--stdout', type=Path, help='Redirect stdout to this file path')
-@click.option('--stderr', type=Path, help='Redirect stderr to this file path')
-@click.option('--cwd', type=Path, help='Set the working directory for the process')
+@click.option('--stdin', type=str, help='Redirect stdin from this file path')
+@click.option('--stdout', type=str, help='Redirect stdout to this file path')
+@click.option('--stderr', type=str, help='Redirect stderr to this file path')
+@click.option('--cwd', type=str, help='Set the working directory for the process')
 @click.option('--flags', type=click.INT, default=0, help='Launch flags (bitmask)')
 @click.option('--stop-at-entry', is_flag=True, help='Stop the process at the entry point')
 @startup_files_option

hilda/common.py

@@ -1,5 +1,14 @@
 from datetime import datetime
 from typing import Any, List, Mapping, Tuple, Union
 
+import inquirer3
+from inquirer3.themes import GreenPassion
+
 CfSerializable = Union[
     Mapping[str, Any], List, Tuple[Any, ...], str, bool, float, bytes, datetime, None]
+
+
+def selection_prompt(options_list: List):
+    question = [inquirer3.List('choice', message='choose device', choices=options_list, carousel=True)]
+    result = inquirer3.prompt(question, theme=GreenPassion(), raise_keyboard_interrupt=True)
+    return result['choice']

hilda/exceptions.py

@@ -1,7 +1,7 @@
 __all__ = ['HildaException', 'SymbolAbsentError', 'EvaluatingExpressionError', 'CreatingObjectiveCSymbolError',
            'ConvertingToNsObjectError', 'ConvertingFromNSObjectError', 'DisableJetsamMemoryChecksError',
            'GettingObjectiveCClassError', 'AccessingRegisterError', 'AccessingMemoryError',
-           'BrokenLocalSymbolsJarError', 'AddingLldbSymbolError', 'LLDBException']
+           'BrokenLocalSymbolsJarError', 'AddingLldbSymbolError', 'LLDBException', 'InvalidThreadIndexError']
 
 
 class HildaException(Exception):
@@ -70,3 +70,8 @@ class BrokenLocalSymbolsJarError(HildaException):
 class AddingLldbSymbolError(HildaException):
     """ Raise when failing to convert a LLDB symbol to Hilda's symbol. """
     pass
+
+
+class InvalidThreadIndexError(HildaException):
+    """ Raise when thread idx invalid """
+    pass

hilda/hilda_client.py

@@ -30,10 +30,11 @@ from tqdm import tqdm
 from traitlets.config import Config
 
 from hilda import objective_c_class
-from hilda.common import CfSerializable
+from hilda.common import CfSerializable, selection_prompt
 from hilda.exceptions import AccessingMemoryError, AccessingRegisterError, AddingLldbSymbolError, \
     BrokenLocalSymbolsJarError, ConvertingFromNSObjectError, ConvertingToNsObjectError, CreatingObjectiveCSymbolError, \
-    DisableJetsamMemoryChecksError, EvaluatingExpressionError, HildaException, SymbolAbsentError
+    DisableJetsamMemoryChecksError, EvaluatingExpressionError, HildaException, InvalidThreadIndexError, \
+    SymbolAbsentError
 from hilda.lldb_importer import lldb
 from hilda.objective_c_symbol import ObjectiveCSymbol
 from hilda.registers import Registers
@@ -340,8 +341,6 @@ class HildaClient:
 
         if not self.process.Stop().Success():
             self.log_critical('failed to stop process')
-        else:
-            self.log_info('Process Stopped')
 
     def cont(self, *args) -> None:
         """ Continue process. """
@@ -357,8 +356,6 @@ class HildaClient:
 
         if not self.process.Continue().Success():
             self.log_critical('failed to continue process')
-        else:
-            self.log_info('Process Continued')
 
     def detach(self):
         """
@@ -514,7 +511,7 @@ class HildaClient:
             if options.get('name', False):
                 name = options['name']
 
-            log_message = f'🚨 #{bp.id} 0x{symbol:x} {name}'
+            log_message = f'🚨 #{bp.id} 0x{symbol:x} {name} - Thread #{self.thread.idx}:{hex(self.thread.id)}'
 
             if 'regs' in options:
                 log_message += '\nregs:'
@@ -528,7 +525,7 @@ class HildaClient:
                     value = hilda.symbol(hilda.evaluate_expression(name))
                     log_message += f'\n\t{name} = {hilda._monitor_format_value(fmt, value)}'
 
-            if options.get('force_return', False):
+            if options.get('force_return', None) is not None:
                 hilda.force_return(options['force_return'])
                 log_message += f'\nforced return: {options["force_return"]}'
 
@@ -537,7 +534,7 @@ class HildaClient:
                 hilda.finish()
                 hilda.bt()
 
-            if options.get('retval', False):
+            if options.get('retval', None) is not None:
                 # return from function
                 hilda.finish()
                 value = hilda.evaluate_expression('$arg1')
@@ -884,6 +881,16 @@ class HildaClient:
         spec.loader.exec_module(m)
         return m
 
+    def set_selected_thread(self, idx: Optional[int] = None) -> None:
+        if idx is None:
+            thread = selection_prompt(self.process.threads)
+        else:
+            try:
+                thread = [t for t in self.process.threads if t.idx == idx][0]
+            except IndexError:
+                raise InvalidThreadIndexError()
+        self.process.SetSelectedThread(thread)
+
     def unwind(self) -> bool:
         """ Unwind the stack (useful when get_evaluation_unwind() == False) """
         return self.thread.UnwindInnermostExpression().Success()

hilda/ipython_extensions/keybindings.py

@@ -8,8 +8,8 @@ def load_ipython_extension(ipython):
         hilda = ipython.user_ns['p']
         keys_mapping = {Keys.F7: hilda.step_into,
                         Keys.F8: hilda.step_over,
-                        Keys.F9: hilda.cont,
-                        Keys.F10: hilda.stop}
+                        Keys.F9: lambda _: (hilda.log_info('Sending continue'), hilda.cont()),
+                        Keys.F10: lambda _: (hilda.log_info('Sending stop'), hilda.stop())}
 
         insert_mode = ViInsertMode() | EmacsInsertMode()
         registry = ipython.pt_app.key_bindings

hilda/launch_lldb.py

@@ -70,9 +70,22 @@ class LLDBListenerThread(Thread, ABC):
                 logger.debug(f'Process Exited with status {self.process.GetExitStatus()}')
                 self.should_quit = True
             elif state == lldb.eStateRunning and last_state == lldb.eStateStopped:
-                logger.debug("Process Continued")
+                logger.debug('Process Continued')
             elif state == lldb.eStateStopped and last_state == lldb.eStateRunning:
                 logger.debug('Process Stopped')
+                for thread in self.process:
+                    frame = thread.GetFrameAtIndex(0)
+                    stop_reason = thread.GetStopReason()
+                    logger.debug(f'tid = {hex(thread.GetThreadID())} pc = {frame.GetPC()}')
+                    if stop_reason not in [lldb.eStopReasonSignal, lldb.eStopReasonException,
+                                           lldb.eStopReasonBreakpoint,
+                                           lldb.eStopReasonWatchpoint, lldb.eStopReasonPlanComplete,
+                                           lldb.eStopReasonTrace,
+                                           lldb.eStopReasonSignal]:
+                        continue
+                    self.process.SetSelectedThread(thread)
+                    break
+
             last_state = state
 
 
@@ -114,7 +127,7 @@ class LLDBAttachName(LLDBListenerThread):
         return self.debugger.CreateTargetWithFileAndArch(None, None)
 
     def _create_process(self) -> lldb.SBProcess:
-        logger.debug(f'Attaching to {self.name}')
+        logger.debug(f'Attaching to {self.proc_name}')
         return self.target.AttachToProcessWithName(self.listener, self.proc_name, self.wait_for, self.error)
 
 

{hilda-2.0.0.dist-info → hilda-2.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hilda
-Version: 2.0.0
+Version: 2.0.2
 Summary: LLDB wrapped and empowered by iPython's features
 Author-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>, netanel cohen <netanelc305@protonmail.com>
 Maintainer-email: doronz88 <doron88@gmail.com>, matan <matan1008@gmail.com>, netanel cohen <netanelc305@protonmail.com>
@@ -51,6 +51,7 @@ Requires-Dist: construct
 Requires-Dist: pymobiledevice3
 Requires-Dist: keystone-engine
 Requires-Dist: tabulate
+Requires-Dist: inquirer3
 Provides-Extra: test
 Requires-Dist: pytest ; extra == 'test'
 
@@ -370,6 +371,10 @@ Here is a gist of methods you can access from `p`:
     - Import & reload given python module (intended mainly for external snippets)
 - `unwind`
     - Unwind the stack (useful when get_evaluation_unwind() == False)
+- `set_selected_thread`
+    - sets the currently selected thread, which is used in other parts of the program, such as displaying disassembly or
+      checking registers.
+      This ensures the application focuses on the specified thread for these operations.
 
 ## Magic functions
 

{hilda-2.0.0.dist-info → hilda-2.0.2.dist-info}/RECORD

@@ -3,13 +3,13 @@ gifs/ui.png,sha256=iaRwNZ9qVWUkUe2TJb_6VPsTu--7HrElA2duWiyZ-Oc,131
 gifs/xpc_print_message.gif,sha256=i5S8Y9bJm9n-NtOipFTAC8_jUR4uZCM4sOap_ccJX0k,939935
 hilda/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hilda/__main__.py,sha256=KWRqvukK4wraxCMtvH5nO25mFXLO5aWXa7z_VfAtbO8,90
-hilda/_version.py,sha256=o9XMlNC6GoiUn7mwoOOgJdijgp3B_2fLdgizcKs1i2o,411
-hilda/cli.py,sha256=0keoM7FLQXiF-J65ftRUtLnYtyyRpGez6xNZ3tZIXZA,3329
-hilda/common.py,sha256=fxlVTyRP2AmKCnE6FdgnGJVoG-OBq7Tw6TrBQ_xgszI,194
-hilda/exceptions.py,sha256=spH9i27nLm71-SR5Nb028cBVD81qAS6qRfoC2XVoGls,2014
+hilda/_version.py,sha256=ld-j3TUpFlKQqUdd5gCrvB3csNXi_lXdKFr5cuIfSdk,411
+hilda/cli.py,sha256=XCL9vD4zWkK2GHnkeBXZ5AC08iC4rtHYBydgi6SzGJI,3325
+hilda/common.py,sha256=VFtpOH9IRqbu6lONM6Hz-PxcdJfktgS3akJv5UCHO0s,523
+hilda/exceptions.py,sha256=a2EGckJ66ArG2LZJVnUz91gRkqQyc9AEtbS_mfZuI3s,2141
 hilda/hilda_ascii_art.html,sha256=-9YCjAKdGbjtdd6uoKrxkkcJq7j16r4dGka2bZ27b4o,120119
-hilda/hilda_client.py,sha256=FhGjKQr4aT9Ixe_O999pXZM_ZTFUSwTpri_txqb0JtE,43606
-hilda/launch_lldb.py,sha256=SIBv-uGbp1mgJU96H9gBNU5ahiTwzRwpCiR5RGJ1xVE,7149
+hilda/hilda_client.py,sha256=QQowZuvTu0Z9heGaBmLoKqjRa7BdjezEnkx15Jt-y7Y,43997
+hilda/launch_lldb.py,sha256=OeZjIILxt6lVQdZnD67E2QHfEK2XU_B-HTa5ZI0NTkw,7920
 hilda/lldb_entrypoint.py,sha256=vTiClzfiTtjorlxEfIsI-W657KEGobx74qDhaZ8nPhM,1007
 hilda/lldb_importer.py,sha256=LrIQnigDG3wgmIPXya67oBlWubkDgV-rEpzfWNEYCoc,553
 hilda/objective_c_class.py,sha256=Xyw7FucNVcu8NqhB0Gy-OjaN_2DmCywn6pjUEwyd1Hk,11760
@@ -18,7 +18,7 @@ hilda/registers.py,sha256=moGS9MXrfm8vmnqDKWZSg4wmZNydGUadui9uwEwzhsI,856
 hilda/symbol.py,sha256=_TSQqFysRs82BFNGX9o_ZbkrwzSsWq3FiMbX92VKoPo,7200
 hilda/symbols_jar.py,sha256=1GPgrbXdsxiirMufrWqVi-DHF9qDXgy_HMtWJD4dJuE,6447
 hilda/ipython_extensions/events.py,sha256=uV30ZJMwpRw9YwGnQ40uAOh9Mtr8QGJFB7cZeY-pCow,1960
-hilda/ipython_extensions/keybindings.py,sha256=7VV6qMxEmgB_7fMi3nxutVHJ-csKirc2C2AwFiXyU30,861
+hilda/ipython_extensions/keybindings.py,sha256=2NiTwfakowCj1VT6eEDvMeMiFx_pBvkhVDaQPuX69uM,957
 hilda/ipython_extensions/magics.py,sha256=ULb63-OyIaWwvSfwRvEG_65ibaI2RTxeX8yPJK8pbc0,1300
 hilda/objective_c/from_ns_to_json.m,sha256=5Ddl0UJLQXlDYwR_yjE4yZk1aOsJGxoy1oRnhZHPrTw,2847
 hilda/objective_c/get_objectivec_class_by_module.m,sha256=DC8S8XaWsQSOJZWVWhATr98SZQobA3MmclLsBJGZTcU,704
@@ -46,9 +46,9 @@ hilda/snippets/macho/macho_load_commands.py,sha256=OsajG2xWuRwhYhj9f-lnUiNe43Yum
 hilda/ui/colors.json,sha256=f-ITquY3IInQreviTy23JfmxfJrGM1_MivACf1GKGqM,262
 hilda/ui/ui_manager.py,sha256=BmzI1sBx0PYCQDlB9Al7wsTEAMJxaJ7NW0DS4C7g5-0,2265
 hilda/ui/views.py,sha256=1u_eZzw7wAEP1bm_-9nkqgGhMSX__woiUuoBgnsAKVM,7843
-hilda-2.0.0.dist-info/LICENSE,sha256=M-LVJ0AFAYB82eueyl8brh-QLPe-iLNVgbCi79-3TDo,1078
-hilda-2.0.0.dist-info/METADATA,sha256=acXo2_sgMhNmJ7jb8XBBzoCmbHfOPL7ZCYpbv5Px2HE,23606
-hilda-2.0.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-hilda-2.0.0.dist-info/entry_points.txt,sha256=9n3O3j6V3XnVR_GcFqCWNgRAbalfukTSW2WvghsLVmA,46
-hilda-2.0.0.dist-info/top_level.txt,sha256=TVD7l1WkE1noT866YqPFhiQnjYCYZM5Xz54v_3EYpnI,11
-hilda-2.0.0.dist-info/RECORD,,
+hilda-2.0.2.dist-info/LICENSE,sha256=M-LVJ0AFAYB82eueyl8brh-QLPe-iLNVgbCi79-3TDo,1078
+hilda-2.0.2.dist-info/METADATA,sha256=agMwzWcpALitue6mJodwdAa3VHvhvfNdlOAKd3GIukk,23891
+hilda-2.0.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+hilda-2.0.2.dist-info/entry_points.txt,sha256=9n3O3j6V3XnVR_GcFqCWNgRAbalfukTSW2WvghsLVmA,46
+hilda-2.0.2.dist-info/top_level.txt,sha256=TVD7l1WkE1noT866YqPFhiQnjYCYZM5Xz54v_3EYpnI,11
+hilda-2.0.2.dist-info/RECORD,,