hilda 3.0.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

{hilda-3.0.0.dist-info → hilda-3.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: hilda
-Version: 3.0.0
+Version: 3.1.0
 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>
@@ -55,6 +55,7 @@ Requires-Dist: inquirer3
 Requires-Dist: traitlets
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
 
 # Hilda
 
@@ -152,165 +153,94 @@ You can may start a Hilda interactive shell by invoking any of the subcommand:
 
 ### Inside a Hilda shell
 
-Upon starting Hilda shell, you are greeted with:
-
-```
-Hilda has been successfully loaded! 😎
-Use the p global to access all features.
-Have a nice flight ✈️! Starting an IPython shell...
-```
-
-Here is a gist of methods you can access from `p`:
-
-- `hd`
-  - Print a hexdump of given buffer
-- `lsof`
-  - Get dictionary of all open FDs
-- `bt`
-  - Print an improved backtrace.
-- `disable_jetsam_memory_checks`
-  - Disable jetsam memory checks, prevent raising:
-      `error: Execution was interrupted, reason: EXC_RESOURCE RESOURCE_TYPE_MEMORY (limit=15 MB, unused=0x0).`
-      when evaluating expression.
-- `symbol`
-  - Get symbol object for a given address
-- `objc_symbol`
-  - Get objc symbol wrapper for given address
-- `inject`
-  - Inject a single library into currently running process
-- `rebind_symbols`
-  - Reparse all loaded images symbols
-- `poke`
-  - Write data at given address
-- `peek`
-  - Read data at given address
-- `peek_str`
-  - Peek a buffer till null termination
-- `peek_std_str`
-  - Peek a `std::string`
-- `stop`
-  - 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
-      while you exit
-- `disass`
-  - Print disassembly from a given address
-- `file_symbol`
-  - Calculate symbol address without ASLR
-- `get_register`
-  - Get value for register by its name
-- `set_register`
-  - Set value for register by its name
-- `objc_call`
-  - Simulate a call to an objc selector
-- `call`
-  - Call function at given address with given parameters
-- `monitor` or `breakpoints.add_monitor`
-  - Monitor every time a given address is called
-
-      The following options are available:
-
-      ```
-      regs={reg1: format}
-          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)`.
-  
-              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`
-  - print current source code if possible
-- `finish`
-  - Run current frame till its end.
-- `step_into`
-  - Step into current instruction.
-- `step_over`
-  - Step over current instruction.
-- `breakpoints.clear`
-  - Remove all breakpoints
-- `breakpoints.remove`
-  - Remove a single breakpoint
-- `force_return`
-  - Prematurely return from a stack frame, short-circuiting exection of newer frames and optionally
-      yielding a specified value.
-- `proc_info`
-  - Print information about currently running mapped process.
-- `print_proc_entitlements`
-  - Get the plist embedded inside the process' __LINKEDIT section.
-- `bp` or `breakpoints.add`
-  - Add a breakpoint
-- `breakpoints.show`
-  - Show existing breakpoints
-- `po`
-  - Print given object using LLDB's po command
-      Can also run big chunks of native code:
-
-      po('NSMutableString *s = [NSMutableString string]; [s appendString:@"abc"]; [s description]')
-- `globalize_symbols`
-  - Make all symbols in python's global scope
-- `jump`
-  - jump to given symbol
-- `lldb_handle_command`
-  - Execute an LLDB command
-      For example:
-      lldb_handle_command('register read')
-- `objc_get_class`
-  - Get ObjC class object
-- `CFSTR`
-  - Create CFStringRef object from given string
-- `ns`
-  - Create NSObject from given data
-- `from_ns`
-  - Create python object from NS object.
-- `evaluate_expression`
-  - Wrapper for LLDB's EvaluateExpression.
-      Used for quick code snippets.
-
-      Feel free to use local variables inside the expression using format string.
-      For example:
-      currentDevice = objc_get_class('UIDevice').currentDevice
-      evaluate_expression(f'[[{currentDevice} systemName] hasPrefix:@"2"]')
-- `import_module`
-  - 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.
-- `wait_for_module`
-  - Wait for a module to be loaded (`dlopen`) by checking if given expression is contained within its filename
-
-All these methods are available from the global `p` within the newly created IPython shell. In addition, you may invoke any of the exported APIs described in the [Python API](#python-api)
+Upon starting Hilda, you are welcomed into an IPython shell.
+You can access following methods via the variable `p`.
+
+Basic flow control:
+
+- `stop` - Stop process
+- `cont` - Continue process
+- `finish` - Run current function until return
+- `step_into` - Step into current instruction
+- `step_over` - Step over current instruction.
+- `run_for` - Run the process for given interval
+- `force_return` - Prematurely return from a stack frame, short-circuiting exection of inner
+  frames and optionally yielding a specified value.
+- `jump` - Jump to given symbol
+- `wait_for_module` - Wait for a module to be loaded (`dlopen`) by checking if given expression is contained within its filename
+- `detach` - Detach from process (useful for exiting gracefully so the
+  process doesn't get killed when you exit)
+
+Breakpoints:
+- `bp` or `breakpoints.add` - Add a breakpoint
+- `breakpoints.show` - Show existing breakpoints
+- `breakpoints.remove` - Remove a single breakpoint
+- `breakpoints.clear` - Remove all breakpoints
+- `monitor` or `breakpoints.add_monitor` - Creates a breakpoint whose callback implements the requested features (print register vallues, execute commands, mock return value, etc.)
+
+Basic read/write:
+
+- `get_register` - Get register value
+- `set_register` - Set register value
+- `poke` - Write data at address
+- `peek[_str,_std_str]` - Read buffer/C-string/`std::string` at address
+- `po` - Print object using LLDB's `po` command
+  Can also run arbitrary native code:
+
+  ```python
+  p.po('NSMutableString *s = [NSMutableString string]; [s appendString:@"abc"]; [s description]')
+  ```
+- `disass` - Print disassembly at address
+- `show_current_source` - Print current source code (if possible)
+- `bt` - Get backtrace
+- `lsof` - Get all open FDs
+- `hd` - Hexdump a buffer
+- `proc_info` - Print information about currently running mapped process
+- `print_proc_entitlements` - Get the plist embedded inside the process' __LINKEDIT section.
+
+Execute code:
+
+- `call` - Call function at given address with given parameters
+- `objc_call` - Simulate a call to an objc selector
+- `inject` - Inject a single library into currently running process
+- `disable_jetsam_memory_checks` -
+   Disable jetsam memory checks (to prevent raising
+   `error: Execution was interrupted, reason: EXC_RESOURCE RESOURCE_TYPE_MEMORY (limit=15 MB, unused=0x0).`
+   when evaluating expressions).
+
+Hilda symbols:
+
+- `symbol` - Get symbol object for a given address
+- `objc_symbol` - Get objc symbol wrapper for given address
+- `rebind_symbols` - Reparse all loaded images symbols
+- `file_symbol` - Calculate symbol address without ASLR
+- `save` - Save loaded symbols map (for loading later using the load() command)
+- `load` - Load an existing symbols map (previously saved by the save() command)
+- `globalize_symbols` - Make all symbols in python's global scope
+
+Advanced:
+
+- `lldb_handle_command` - Execute an LLDB command (e.g., `p.lldb_handle_command('register read')`)
+- `evaluate_expression` - Use for quick code snippets (wrapper for LLDB's `EvaluateExpression`)
+
+  Take advantage of local variables inside the expression using format string, e.g.,
+
+  ```python
+  currentDevice = p.objc_get_class('UIDevice').currentDevice
+  p.evaluate_expression(f'[[{currentDevice} systemName] hasPrefix:@"2"]')
+  ```
+- `import_module` - 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.
+
+Objective-C related:
+
+- `objc_get_class` - Get ObjC class object
+- `CFSTR` - Create CFStringRef object from given string
+- `ns` - Create NSObject from given data
+- `from_ns` - Create python object from NS object.
 
 #### Magic functions
 
@@ -672,7 +602,7 @@ commands so you are able to use complicated types when parsing values and passin
 import datetime
 
 # using the `ns` command we can just pass a python-native dictionary
-function_requiring_a_specfic_dictionary(ns({
+function_requiring_a_specfic_dictionary(p.cf({
     'key1': 'string',  # will convert to NSString
     'key2': True,  # will convert to NSNumber
     'key3': b'1234',  # will convert to NSData

{hilda-3.0.0.dist-info → hilda-3.1.0.dist-info}/RECORD

@@ -3,21 +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=feOY2rjYM8_-oXmp5ErPlMe-6zWTpyiw538tUrvFyEA,511
-hilda/breakpoints.py,sha256=ZVszQf4WtRgjM2JAn8E-b-Ve6kzVg5VwvTHv5_wGjwQ,19198
+hilda/_version.py,sha256=KrVRMDzlLQ07c4N1d6-nDOLo4hWpD8cSSFcYXWlm64k,511
+hilda/breakpoints.py,sha256=WyUSTOJ-lQqki8ZpwAsAOCNazMFaJfd5p5HwdEZ84v8,20035
 hilda/cli.py,sha256=PCjrI7GrERIrZCODJYmPt6eyl-nPYZviTS8fBG3oIjM,3618
 hilda/common.py,sha256=El-ih7cvCv9PJ5OWb1jkCbh4GuaRD6gqlrFC5gyY-TE,498
+hilda/decorators.py,sha256=iNowrDoFHX0qsqqU5NfMMPpETbaU_-ga_bxvnOmsQHw,962
 hilda/exceptions.py,sha256=8L1OvOqns4O4ieiH4YlrMbZkk_PvuyCq4UyqFAodkF8,2042
-hilda/hilda_ascii_art.html,sha256=-9YCjAKdGbjtdd6uoKrxkkcJq7j16r4dGka2bZ27b4o,120119
-hilda/hilda_client.py,sha256=Uqp0N91gHJFkN9vZ9NN4YLkHGDXym4JGKjn-08HUZVE,38804
-hilda/launch_lldb.py,sha256=gU1iJmxuH7w5HV_cy1igv-JageyQn2dmqSxx8vkpY0k,8033
+hilda/hilda_client.py,sha256=phSwiI3XfuLzMXlUw7-irbZbEgi7sEpDz2w7EGUUhf0,38897
+hilda/launch_lldb.py,sha256=-lmxif-w53oeTCea6ZHLiYHChkMpdDDO_zgTFWpAU6E,8597
 hilda/lldb_entrypoint.py,sha256=vTiClzfiTtjorlxEfIsI-W657KEGobx74qDhaZ8nPhM,1007
 hilda/lldb_importer.py,sha256=TCGpAWwiBuyNRsbgcYawiqm35t8XQLCJwoOfEqyBeik,526
 hilda/objective_c_class.py,sha256=AFGXFDkYUoHf_LVS6GJSyvMsIIYIviLx0PCa-f4pCT8,11561
 hilda/objective_c_symbol.py,sha256=lIZHef5iZe3AeUsK0uIsDtFnzSM-Ad6i2wfdj9DwLUM,8269
 hilda/registers.py,sha256=-9kk1MuKnWlJ0Z8zZ2RPV9nGRDtX1GXhCSkEvfnCktA,848
-hilda/symbol.py,sha256=yv8s0vQ6Z0ZoROeVE4RVaW0LFCyACZnFgp0QC6j05nI,7535
+hilda/symbol.py,sha256=UIDmnNq1tx1uORqgRNaO_gfW2y17mhyy4cz83UVFhcc,7623
 hilda/symbols_jar.py,sha256=Vqdv6iH92P6aSfcz5XiR0FbNRqKuUu48mi-GxvPr32w,6504
+hilda/watchpoints.py,sha256=ea5rBYNFEwYsPyWdPXMsbL1aElK9yfouuJg32rNcii4,9011
 hilda/ipython_extensions/events.py,sha256=w_4V8FoJJMarWArEE8uzb2UXk1mqfslmI7XCyVb_XuE,1976
 hilda/ipython_extensions/keybindings.py,sha256=W_Cnh8lG5yVdK5x0A-4UeyBsoJBufbYl54Mqrbo8OwM,1922
 hilda/ipython_extensions/magics.py,sha256=ULb63-OyIaWwvSfwRvEG_65ibaI2RTxeX8yPJK8pbc0,1300
@@ -48,9 +49,9 @@ hilda/snippets/macho/macho_load_commands.py,sha256=vUWfFM2H6o8dMglXV7rHgh-EMTzS0
 hilda/ui/colors.json,sha256=f-ITquY3IInQreviTy23JfmxfJrGM1_MivACf1GKGqM,262
 hilda/ui/ui_manager.py,sha256=BmzI1sBx0PYCQDlB9Al7wsTEAMJxaJ7NW0DS4C7g5-0,2265
 hilda/ui/views.py,sha256=bzClOgKirKYs6nhsNRXpkGNIg3oIOmFb659GLWrlTdo,7792
-hilda-3.0.0.dist-info/LICENSE,sha256=M-LVJ0AFAYB82eueyl8brh-QLPe-iLNVgbCi79-3TDo,1078
-hilda-3.0.0.dist-info/METADATA,sha256=y0HMi2hFA-E3hr-kQL_5SBYqTxQdQBwvMLXUiSxklpo,23354
-hilda-3.0.0.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-hilda-3.0.0.dist-info/entry_points.txt,sha256=9n3O3j6V3XnVR_GcFqCWNgRAbalfukTSW2WvghsLVmA,46
-hilda-3.0.0.dist-info/top_level.txt,sha256=TVD7l1WkE1noT866YqPFhiQnjYCYZM5Xz54v_3EYpnI,11
-hilda-3.0.0.dist-info/RECORD,,
+hilda-3.1.0.dist-info/licenses/LICENSE,sha256=M-LVJ0AFAYB82eueyl8brh-QLPe-iLNVgbCi79-3TDo,1078
+hilda-3.1.0.dist-info/METADATA,sha256=ZWnTVzjqsJLwSRCY1g-uk4VDdMadXw1U5XmcgWrrgAI,21916
+hilda-3.1.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+hilda-3.1.0.dist-info/entry_points.txt,sha256=9n3O3j6V3XnVR_GcFqCWNgRAbalfukTSW2WvghsLVmA,46
+hilda-3.1.0.dist-info/top_level.txt,sha256=TVD7l1WkE1noT866YqPFhiQnjYCYZM5Xz54v_3EYpnI,11
+hilda-3.1.0.dist-info/RECORD,,

{hilda-3.0.0.dist-info → hilda-3.1.0.dist-info}/WHEEL

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