Method register_for_range

python/plugin.py:456–489

r""" ``register_for_range`` Register a plugin to be called with a range argument :param str name: name of the plugin (use 'Folder\\Name' to have the menu item nested in a folder) :param str description: description of the plugin :param callback action: function to call with the :class:`~bin

(
	    cls, name: str, description: str, action: Callable[['binaryview.BinaryView', int, int], None],
	    is_valid: Optional[Callable[['binaryview.BinaryView', int, int], bool]] = None
	)

	@classmethod
	def register_for_range(
	    cls, name: str, description: str, action: Callable[['binaryview.BinaryView', int, int], None],
	    is_valid: Optional[Callable[['binaryview.BinaryView', int, int], bool]] = None
	):
		r"""
		``register_for_range`` Register a plugin to be called with a range argument

		:param str name: name of the plugin (use 'Folder\\Name' to have the menu item nested in a folder)
		:param str description: description of the plugin
		:param callback action: function to call with the :class:`~binaryview.BinaryView`, start address, and length as arguments
		:param callback is_valid: optional argument of a function passed a :class:`~binaryview.BinaryView`, start address, and length to determine whether the plugin should be enabled for that view
		:rtype: None
		:Example:

			>>> def my_plugin(bv: BinaryView, start: int, length: int):
			>>> 	log_info(f"My plugin was called on bv: `{bv}` at {hex(start)} of length {hex(length)}")
			>>> PluginCommand.register_for_range("My Plugin", "My plugin description (not used)", my_plugin)
			True
			>>> def is_valid(bv: BinaryView, start: int, length: int) -> bool:
			>>> 	return False
			>>> PluginCommand.register_for_range("My Plugin (With Valid Function)", "My plugin description (not used)", my_plugin, is_valid)
			True

		.. warning:: Calling ``register_for_range`` with the same function name will replace the existing function but will leak the memory of the original plugin.
		"""
		binaryninja._init_plugins()
		action_obj = ctypes.CFUNCTYPE(
		    None, ctypes.c_void_p, ctypes.POINTER(core.BNBinaryView), ctypes.c_ulonglong, ctypes.c_ulonglong
		)(lambda ctxt, view, addr, length: cls._range_action(view, addr, length, action))
		is_valid_obj = ctypes.CFUNCTYPE(
		    ctypes.c_bool, ctypes.c_void_p, ctypes.POINTER(core.BNBinaryView), ctypes.c_ulonglong, ctypes.c_ulonglong
		)(lambda ctxt, view, addr, length: cls._range_is_valid(view, addr, length, is_valid))
		cls._registered_commands.append((action_obj, is_valid_obj))
		core.BNRegisterPluginCommandForRange(name, description, action_obj, is_valid_obj, None)

	@classmethod
	def register_for_function(