From 75cf5c10b43d2c8cbb1ad636a62d807bb1987e76 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Wed, 7 Apr 2021 18:10:57 -0400 Subject: update scripting console documentation to include search, completion, history info --- docs/getting-started.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/getting-started.md b/docs/getting-started.md index 5e659250..fa3f85b1 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -437,11 +437,17 @@ To trigger the console, either use `-`, or use the `View`/`Nativ Once loaded, the script console can be docked in different locations or popped out into a stand-alone window. Note that [at this time](https://github.com/Vector35/binaryninja-api/issues/226) window locations are not saved on restart. -Multi-line input is possible just by doing what you'd normally do in python. If you leave a trailing `:` at the end of a line, the box will automatically turn into a multi-line edit box, complete with a command-history. To submit that multi-line input, use `-` +Multi-line input is possible just by doing what you'd normally do in python. If you leave a trailing `:` at the end of a line, the box will automatically turn into a multi-line edit box, complete with a command-history. To submit that multi-line input, use `-`. You can also force multi-line input with `-`. -By default the interactive python prompt has a number of convenient helper functions and variables built in: +The scripting console is not a full IDE, but it has several convenience features that make it more pleasant to use: -- `here` / `current_address`: address of the current selection +- `` offers completion of variables, methods, anything in-scope +- `-R` allows for reverse-searching your console history +- `` and `` can be used to view the command-history + +The interactive python prompt also has several built-in functions and variables: + +- `here` / `current_address`: address of the current selection (it's settable too and will navigate the UI if changed) - `bv` / `current_view` / : the current [BinaryView](https://api.binary.ninja/binaryninja.BinaryView.html) - `current_function`: the current [Function](https://api.binary.ninja/binaryninja.Function.html) - `current_basic_block`: the current [BasicBlock](https://api.binary.ninja/binaryninja.BasicBlock.html) -- cgit v1.3.1