hilda 2.0.7__py3-none-any.whl → 2.0.9__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.7'
-__version_tuple__ = version_tuple = (2, 0, 7)
+__version__ = version = '2.0.9'
+__version_tuple__ = version_tuple = (2, 0, 9)

hilda/cli.py

@@ -53,7 +53,7 @@ def attach(name: Optional[str], pid: Optional[int], startup_files: List[str]) ->
     if name is not None:
         hilda_client = create_hilda_client_using_attach_by_name(name)
     elif pid is not None:
-        hilda_client = create_hilda_client_using_attach_by_pid(name)
+        hilda_client = create_hilda_client_using_attach_by_pid(pid)
     else:
         raise click.UsageError('You must specify a process name or pid')
     hilda_client.interact(startup_files=startup_files)

hilda/hilda_client.py

@@ -58,7 +58,8 @@ GREETING = f"""
 <b>Hilda has been successfully loaded! 😎
 Usage:
  <span style="color: magenta">p</span>   Global to access all features.
- <span style="color: magenta">F1</span>  UI Show.
+ <span style="color: magenta">F1</span>  Show UI.
+ <span style="color: magenta">F2</span>  Toggle enabling of stdout & stderr.
  <span style="color: magenta">F7</span>  Step Into.
  <span style="color: magenta">F8</span>  Step Over.
  <span style="color: magenta">F9</span>  Continue.
@@ -92,6 +93,8 @@ class Configs:
         'doc': 'Whether to exclude NSObject during evaluation - reduce ipython autocomplete results.'})
     objc_verbose_monitor: bool = field(default=False, metadata={
         'doc': 'When set to True, using monitor() will automatically print objc methods arguments.'})
+    enable_stdout_stderr: bool = field(default=True, metadata={
+        'doc': 'When set to True, will enable process stdout and stderr.'})
 
     def __repr__(self):
         return self.__str__()
@@ -1089,6 +1092,10 @@ class HildaClient:
         sys.argv = ['a']
         IPython.start_ipython(config=ipython_config, user_ns=namespace)
 
+    def toggle_enable_stdout_stderr(self, *args) -> None:
+        self.configs.enable_stdout_stderr = not self.configs.enable_stdout_stderr
+        self.logger.info(f'Changed stdout and stderr status to: {self.configs.enable_stdout_stderr}')
+
     def __enter__(self) -> 'HildaClient':
         return self
 
@@ -1185,6 +1192,11 @@ class HildaClient:
         else:
             return f'{value:x} (unsupported format)'
 
+    @cached_property
+    def _object_identifier(self) -> Symbol:
+        return self.symbols.objc_getClass('VMUObjectIdentifier').objc_call('alloc').objc_call(
+            'initWithTask:', self.symbols.mach_task_self())
+
     @cached_property
     def _ks(self) -> Optional['Ks']:
         if not lldb.KEYSTONE_SUPPORT:

hilda/ipython_extensions/keybindings.py

@@ -7,6 +7,7 @@ def load_ipython_extension(ipython):
     def register_keybindings():
         hilda = ipython.user_ns['p']
         keys_mapping = {Keys.F1: hilda.ui_manager.show,
+                        Keys.F2: hilda.toggle_enable_stdout_stderr,
                         Keys.F7: hilda.step_into,
                         Keys.F8: hilda.step_over,
                         Keys.F9: lambda _: (hilda.log_info('Sending continue'), hilda.cont()),

hilda/launch_lldb.py

@@ -1,5 +1,6 @@
 import logging
 import os
+import sys
 from abc import ABC, abstractmethod
 from threading import Thread
 from typing import List, Optional
@@ -46,6 +47,20 @@ class LLDBListenerThread(Thread, ABC):
             return
         raise LLDBError(self.error.description)
 
+    def _process_stdout(self) -> None:
+        stdout = self.process.GetSTDOUT(1024)
+        while stdout:
+            if lldb.hilda_client is not None and lldb.hilda_client.configs.enable_stdout_stderr:
+                sys.stdout.write(stdout)
+            stdout = self.process.GetSTDOUT(1024)
+
+    def _process_stderr(self) -> None:
+        stderr = self.process.GetSTDERR(1024)
+        while stderr:
+            if lldb.hilda_client is not None and lldb.hilda_client.configs.enable_stdout_stderr:
+                sys.stderr.write(stderr)
+            stderr = self.process.GetSTDERR(1024)
+
     def run(self):
         event = lldb.SBEvent()
         last_state = lldb.eStateStopped
@@ -54,6 +69,13 @@ class LLDBListenerThread(Thread, ABC):
                 continue
             if not lldb.SBProcess.EventIsProcessEvent(event):
                 continue
+
+            event_type = event.GetType()
+            if event_type & lldb.SBProcess.eBroadcastBitSTDOUT:
+                self._process_stdout()
+            if event_type & lldb.SBProcess.eBroadcastBitSTDERR:
+                self._process_stderr()
+
             state = self.process.GetStateFromEvent(event)
             if state == lldb.eStateDetached:
                 logger.debug('Process Detached')

hilda/symbol.py

@@ -104,6 +104,13 @@ class Symbol(int):
         """
         return self._client.symbols.CFCopyDescription(self).po()
 
+    @property
+    def name(self) -> str:
+        symbol_info = int(self._client.po(f'[{self._client._object_identifier} symbolForAddress:{self}]', '__int128'))
+        arg1 = symbol_info & 0xffffffffffffffff
+        arg2 = symbol_info >> 64
+        return self._client.symbols.CSSymbolGetName(arg1, arg2).peek_str()
+
     @contextmanager
     def change_item_size(self, new_item_size: int) -> None:
         """

{hilda-2.0.7.dist-info → hilda-2.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hilda
-Version: 2.0.7
+Version: 2.0.9
 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>
@@ -207,38 +207,39 @@ Here is a gist of methods you can access from `p`:
   - Call function at given address with given parameters
 - `monitor`
   - Monitor every time a given address is called
+
       The following options are available:
 
       ```
       regs={reg1: format}
-      will print register values
+          will print register values
   
-               Available formats:
-                   x: hex
-                   s: string
-                   cf: use CFCopyDescription() to get more informative description of the object
-                   po: use LLDB po command
-                   User defined function, will be called like `format_function(hilda_client, value)`.
+          Available formats:
+              x: hex
+              s: string
+              cf: use CFCopyDescription() to get more informative description of the object
+              po: use LLDB po command
+              User defined function, will be called like `format_function(hilda_client, value)`.
   
-               For example:
-                   regs={'x0': 'x'} -> x0 will be printed in HEX format
-           expr={lldb_expression: format}
-               lldb_expression can be for example '$x0' or '$arg1'
-               format behaves just like 'regs' option
-           retval=format
-               Print function's return value. The format is the same as regs format.
-           stop=True
-               force a stop at every hit
-           bt=True
-               print backtrace
-           cmd=[cmd1, cmd2]
-               run several LLDB commands, one by another
-           force_return=value
-               force a return from function with the specified value
-           name=some_value
-               use `some_name` instead of the symbol name automatically extracted from the calling frame
-           override=True
-               override previous break point at same location
+              For example:
+                  regs={'x0': 'x'} -> x0 will be printed in HEX format
+      expr={lldb_expression: format}
+          lldb_expression can be for example '$x0' or '$arg1'
+          format behaves just like 'regs' option
+      retval=format
+          Print function's return value. The format is the same as regs format.
+      stop=True
+          force a stop at every hit
+      bt=True
+          print backtrace
+      cmd=[cmd1, cmd2]
+          run several LLDB commands, one by another
+      force_return=value
+          force a return from function with the specified value
+      name=some_value
+          use `some_name` instead of the symbol name automatically extracted from the calling frame
+      override=True
+          override previous break point at same location
       ```
 
 - `show_current_source`

{hilda-2.0.7.dist-info → hilda-2.0.9.dist-info}/RECORD

@@ -3,22 +3,22 @@ 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=XF5cViFsh9DDqYgZRLDN3oAuRKMj1sXUbBqJ4rzLL7E,411
-hilda/cli.py,sha256=FQtOg1iFRtNdVVes_SchIoidOWAENhsLItwXBWCgWgc,3625
+hilda/_version.py,sha256=rF4QVJXh5PVN4TNvtStp2GIbnRo15dNx_feVf-c471k,411
+hilda/cli.py,sha256=1-COYHseHcWPhuNXaf-SbAOum_iW4WkAp3K_YGa2Ero,3624
 hilda/common.py,sha256=VFtpOH9IRqbu6lONM6Hz-PxcdJfktgS3akJv5UCHO0s,523
 hilda/exceptions.py,sha256=8L1OvOqns4O4ieiH4YlrMbZkk_PvuyCq4UyqFAodkF8,2042
 hilda/hilda_ascii_art.html,sha256=-9YCjAKdGbjtdd6uoKrxkkcJq7j16r4dGka2bZ27b4o,120119
-hilda/hilda_client.py,sha256=iDFOzjqdenTvD1qI98kn93_xT6nn9Tp3yC0TnNDh6Bg,46221
-hilda/launch_lldb.py,sha256=sD-02HERIFQEYoPM9JrRfFOTjHE2QUt3L0pNgFsyAEQ,7186
+hilda/hilda_client.py,sha256=q18etn3_zYbrCncZp60N2otQyb8mNOJ3fMxgGmeyIcQ,46902
+hilda/launch_lldb.py,sha256=ziRQd1LUz8URcJdV1mjjUs09Uo6NeO4TZfENPhan-3g,8038
 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
 hilda/objective_c_symbol.py,sha256=VpNzVcfvbvZxX3x-7zh_20GZ_17akr1WsdpI4KRNgt4,8400
 hilda/registers.py,sha256=moGS9MXrfm8vmnqDKWZSg4wmZNydGUadui9uwEwzhsI,856
-hilda/symbol.py,sha256=_TSQqFysRs82BFNGX9o_ZbkrwzSsWq3FiMbX92VKoPo,7200
+hilda/symbol.py,sha256=_A-ivRttf7f1Fxclj23pC807r08GQ1KwHvEXnyw7FT4,7517
 hilda/symbols_jar.py,sha256=1GPgrbXdsxiirMufrWqVi-DHF9qDXgy_HMtWJD4dJuE,6447
 hilda/ipython_extensions/events.py,sha256=w_4V8FoJJMarWArEE8uzb2UXk1mqfslmI7XCyVb_XuE,1976
-hilda/ipython_extensions/keybindings.py,sha256=kKArfRWyJ261ieUot4CVTGRmwbnixYtrpgiFCnBfDag,1013
+hilda/ipython_extensions/keybindings.py,sha256=Ai9wHCla6HhgZGGxc0UEOCYODcavyef_zzUC9A9GcTE,1081
 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.7.dist-info/LICENSE,sha256=M-LVJ0AFAYB82eueyl8brh-QLPe-iLNVgbCi79-3TDo,1078
-hilda-2.0.7.dist-info/METADATA,sha256=bWBcBXGtsujCQQ7dhgRsssUKF54NAnfKjt9cyvRFNuk,23437
-hilda-2.0.7.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
-hilda-2.0.7.dist-info/entry_points.txt,sha256=9n3O3j6V3XnVR_GcFqCWNgRAbalfukTSW2WvghsLVmA,46
-hilda-2.0.7.dist-info/top_level.txt,sha256=TVD7l1WkE1noT866YqPFhiQnjYCYZM5Xz54v_3EYpnI,11
-hilda-2.0.7.dist-info/RECORD,,
+hilda-2.0.9.dist-info/LICENSE,sha256=M-LVJ0AFAYB82eueyl8brh-QLPe-iLNVgbCi79-3TDo,1078
+hilda-2.0.9.dist-info/METADATA,sha256=VgAJ0HIioD35ZJX5ch0bhpzUHNlp_57WeZWhs0FWQK0,23325
+hilda-2.0.9.dist-info/WHEEL,sha256=Z4pYXqR_rTB7OWNDYFOm1qRk0RX6GFP2o8LgvP453Hk,91
+hilda-2.0.9.dist-info/entry_points.txt,sha256=9n3O3j6V3XnVR_GcFqCWNgRAbalfukTSW2WvghsLVmA,46
+hilda-2.0.9.dist-info/top_level.txt,sha256=TVD7l1WkE1noT866YqPFhiQnjYCYZM5Xz54v_3EYpnI,11
+hilda-2.0.9.dist-info/RECORD,,

{hilda-2.0.7.dist-info → hilda-2.0.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.2.0)
+Generator: setuptools (70.3.0)
 Root-Is-Purelib: true
 Tag: py3-none-any