hilda 2.0.11__tar.gz → 2.0.13__tar.gz

{hilda-2.0.11 → hilda-2.0.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hilda
-Version: 2.0.11
+Version: 2.0.13
 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>
@@ -189,6 +189,8 @@ Here is a gist of methods you can access from `p`:
   - Stop process.
 - `cont`
   - Continue process.
+- `run_for`
+  - Run the process for given interval.
 - `detach`
   - Detach from process.
       Useful in order to exit gracefully so process doesn't get killed

{hilda-2.0.11 → hilda-2.0.13}/README.md

@@ -132,6 +132,8 @@ Here is a gist of methods you can access from `p`:
   - Stop process.
 - `cont`
   - Continue process.
+- `run_for`
+  - Run the process for given interval.
 - `detach`
   - Detach from process.
       Useful in order to exit gracefully so process doesn't get killed

{hilda-2.0.11 → hilda-2.0.13}/hilda/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '2.0.11'
-__version_tuple__ = version_tuple = (2, 0, 11)
+__version__ = version = '2.0.13'
+__version_tuple__ = version_tuple = (2, 0, 13)

{hilda-2.0.11 → hilda-2.0.13}/hilda/hilda_client.py

@@ -125,9 +125,29 @@ def stop_is_needed(func: Callable):
     return wrapper
 
 
-class HildaClient:
-    Breakpoint = namedtuple('Breakpoint', 'address options forced callback')
+class HildaBreakpoint:
+    def __init__(self, hilda_client: 'HildaClient', lldb_breakpoint: lldb.SBBreakpoint,
+                 address: Union[str, int], forced: bool = False, options: Optional[typing.Mapping] = None,
+                 callback: Optional[Callable] = None) -> None:
+        self._hilda_client = hilda_client
+        self.address = address
+        self.forced = forced
+        self.options = options
+        self.callback = callback
+        self.lldb_breakpoint = lldb_breakpoint
+
+    def __repr__(self) -> str:
+        return (f'<{self.__class__.__name__} LLDB:{self.lldb_breakpoint} FORCED:{self.forced} OPTIONS:{self.options} '
+                f'CALLBACK:{self.callback}>')
+
+    def __str__(self) -> str:
+        return repr(self)
 
+    def remove(self) -> None:
+        self._hilda_client.remove_hilda_breakpoint(self.lldb_breakpoint.id)
+
+
+class HildaClient:
     RETVAL_BIT_COUNT = 64
 
     def __init__(self, debugger: lldb.SBDebugger):
@@ -146,6 +166,7 @@ class HildaClient:
         self._dynamic_env_loaded = False
         self._symbols_loaded = False
         self.globals: typing.MutableMapping[str, Any] = globals()
+        self._hilda_root = Path(__file__).parent
 
         # the frame called within the context of the hit BP
         self._bp_frame = None
@@ -168,7 +189,7 @@ class HildaClient:
         Get dictionary of all open FDs
         :return: Mapping between open FDs and their paths
         """
-        data = (Path(__file__).parent / 'objective_c' / 'lsof.m').read_text()
+        data = (self._hilda_root / 'objective_c' / 'lsof.m').read_text()
         result = json.loads(self.po(data))
         # convert FDs into int
         return {int(k): v for k, v in result.items()}
@@ -347,6 +368,16 @@ class HildaClient:
         if not self.process.Stop().Success():
             self.log_critical('failed to stop process')
 
+    def run_for(self, seconds: float) -> None:
+        """
+        Run the process for a given time
+        :return:
+        """
+        self.cont()
+        self.logger.info(f'Running for {seconds} seconds')
+        time.sleep(seconds)
+        self.stop()
+
     def cont(self, *args) -> None:
         """ Continue process. """
         is_running = self.process.GetState() == lldb.eStateRunning
@@ -462,7 +493,7 @@ class HildaClient:
         with self.stopped():
             return self.evaluate_expression(call_expression)
 
-    def monitor(self, address, condition: str = None, **options) -> lldb.SBBreakpoint:
+    def monitor(self, address, condition: str = None, **options) -> HildaBreakpoint:
         """
         Monitor every time a given address is called
 
@@ -602,7 +633,7 @@ class HildaClient:
             if remove_forced or not bp.forced:
                 self.remove_hilda_breakpoint(bp_id)
 
-    def remove_hilda_breakpoint(self, bp_id):
+    def remove_hilda_breakpoint(self, bp_id: int) -> None:
         """
         Remove a single breakpoint placed by Hilda
         :param bp_id: Breakpoint's ID
@@ -636,7 +667,7 @@ class HildaClient:
         print(highlight(entitlements, XmlLexer(), TerminalTrueColorFormatter()))
 
     def bp(self, address_or_name: Union[int, str], callback: Optional[Callable] = None, condition: str = None,
-           forced=False, module_name: Optional[str] = None, **options) -> lldb.SBBreakpoint:
+           forced=False, module_name: Optional[str] = None, **options) -> HildaBreakpoint:
         """
         Add a breakpoint
         :param address_or_name:
@@ -665,15 +696,14 @@ class HildaClient:
             bp.SetCondition(condition)
 
         # add into Hilda's internal list of breakpoints
-        self.breakpoints[bp.id] = HildaClient.Breakpoint(
-            address=address_or_name, options=options, forced=forced, callback=callback
-        )
+        self.breakpoints[bp.id] = HildaBreakpoint(self, bp, address=address_or_name, forced=forced, options=options,
+                                                  callback=callback)
 
         if callback is not None:
             bp.SetScriptCallbackFunction('lldb.hilda_client.bp_callback_router')
 
         self.log_info(f'Breakpoint #{bp.id} has been set')
-        return bp
+        return self.breakpoints[bp.id]
 
     def bp_callback_router(self, frame, bp_loc, *_):
         """
@@ -828,8 +858,7 @@ class HildaClient:
             json_data = json.dumps({'root': data}, default=self._to_ns_json_default)
         except TypeError as e:
             raise ConvertingToNsObjectError from e
-
-        obj_c_code = (Path(__file__).parent / 'objective_c' / 'to_ns_from_json.m').read_text()
+        obj_c_code = (self._hilda_root / 'objective_c' / 'to_ns_from_json.m').read_text()
         expression = obj_c_code.replace('__json_object_dump__', json_data.replace('"', r'\"'))
         try:
             return self.evaluate_expression(expression)
@@ -842,7 +871,7 @@ class HildaClient:
         :param address: NS object.
         :return: Python object.
         """
-        obj_c_code = (Path(__file__).parent / 'objective_c' / 'from_ns_to_json.m').read_text()
+        obj_c_code = (self._hilda_root / 'objective_c' / 'from_ns_to_json.m').read_text()
         address = f'0x{address:x}' if isinstance(address, int) else address
         expression = obj_c_code.replace('__ns_object_address__', address)
         try:
@@ -1212,7 +1241,7 @@ class HildaClient:
                 continue
             objc_classlist = m.FindSection('__DATA').FindSubSection('__objc_classlist')
             objc_classlist_addr = self.symbol(objc_classlist.GetLoadAddress(self.target))
-            obj_c_code = (Path(__file__).parent / 'objective_c' / 'get_objectivec_class_by_module.m').read_text()
+            obj_c_code = (self._hilda_root / 'objective_c' / 'get_objectivec_class_by_module.m').read_text()
             obj_c_code = obj_c_code.replace('__count_objc_class', f'{objc_classlist.size // 8}').replace(
                 '__objc_class_list',
                 f'{objc_classlist_addr}')

{hilda-2.0.11 → hilda-2.0.13}/hilda/objective_c_class.py

@@ -3,7 +3,6 @@ import time
 from collections import namedtuple
 from dataclasses import dataclass, field
 from functools import partial
-from pathlib import Path
 from typing import Any
 from uuid import uuid4
 
@@ -120,7 +119,7 @@ class Class(object):
         :param hilda.hilda_client.HildaClient client: Hilda client.
         :param class_name: Class name.
         """
-        obj_c_code = (Path(__file__).parent / 'objective_c' / 'get_objectivec_class_description.m').read_text()
+        obj_c_code = (client._hilda_root / 'objective_c' / 'get_objectivec_class_description.m').read_text()
         obj_c_code = obj_c_code.replace('__class_address__', '0').replace('__class_name__', class_name)
         class_symbol = Class(client, class_data=json.loads(client.po(obj_c_code)))
         if class_symbol.name != class_name:
@@ -143,7 +142,7 @@ class Class(object):
         Reload class object data.
         Should be used whenever the class layout changes (for example, during method swizzling)
         """
-        obj_c_code = (Path(__file__).parent / 'objective_c' / 'get_objectivec_class_description.m').read_text()
+        obj_c_code = (self._client._hilda_root / 'objective_c' / 'get_objectivec_class_description.m').read_text()
         obj_c_code = obj_c_code.replace('__class_address__', f'{self._class_object:d}')
         obj_c_code = obj_c_code.replace('__class_name__', self.name)
         self._load_class_data(json.loads(self._client.po(obj_c_code)))

{hilda-2.0.11 → hilda-2.0.13}/hilda/objective_c_symbol.py

@@ -2,7 +2,6 @@ import json
 from contextlib import suppress
 from dataclasses import dataclass
 from functools import partial
-from pathlib import Path
 
 from objc_types_decoder.decode import decode as decode_type
 from pygments import highlight
@@ -60,7 +59,7 @@ class ObjectiveCSymbol(Symbol):
         self.methods.clear()
         self.class_ = None
 
-        obj_c_code = (Path(__file__).parent / 'objective_c' / 'get_objectivec_symbol_data.m').read_text()
+        obj_c_code = (self._client._hilda_root / 'objective_c' / 'get_objectivec_symbol_data.m').read_text()
         obj_c_code = obj_c_code.replace('__symbol_address__', f'{self:d}')
         data = json.loads(self._client.po(obj_c_code))
 

{hilda-2.0.11 → hilda-2.0.13}/hilda/symbol.py

@@ -139,10 +139,10 @@ class Symbol(int):
     def peek_str(self) -> str:
         return self._client.peek_str(self)
 
-    def monitor(self, **args) -> lldb.SBBreakpoint:
+    def monitor(self, **args):
         return self._client.monitor(self, **args)
 
-    def bp(self, callback=None, **args) -> lldb.SBBreakpoint:
+    def bp(self, callback=None, **args):
         return self._client.bp(self, callback, **args)
 
     def disass(self, size, **args) -> lldb.SBInstructionList:

{hilda-2.0.11 → hilda-2.0.13}/hilda.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hilda
-Version: 2.0.11
+Version: 2.0.13
 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>
@@ -189,6 +189,8 @@ Here is a gist of methods you can access from `p`:
   - Stop process.
 - `cont`
   - Continue process.
+- `run_for`
+  - Run the process for given interval.
 - `detach`
   - Detach from process.
       Useful in order to exit gracefully so process doesn't get killed