#include <ScriptInterpreterPythonImpl.h>

Inheritance diagram for lldb_private::ScriptInterpreterPythonImpl:

Classes
class	Locker
class	SessionIORedirect
	A Python sys.stdout/stderr file backed by a pipe whose read end is drained by a reader thread that writes to the debugger's terminal under the output lock (Debugger::PrintAsync). More...
class	SynchronicityHandler

Public Types
enum class	AddLocation { Beginning , End }
enum	ActiveIOHandler { eIOHandlerNone , eIOHandlerBreakpoint , eIOHandlerWatchpoint }
Public Types inherited from lldb_private::ScriptInterpreter
enum	ScriptReturnType { eScriptReturnTypeCharPtr , eScriptReturnTypeBool , eScriptReturnTypeShortInt , eScriptReturnTypeShortIntUnsigned , eScriptReturnTypeInt , eScriptReturnTypeIntUnsigned , eScriptReturnTypeLongInt , eScriptReturnTypeLongIntUnsigned , eScriptReturnTypeLongLong , eScriptReturnTypeLongLongUnsigned , eScriptReturnTypeFloat , eScriptReturnTypeDouble , eScriptReturnTypeChar , eScriptReturnTypeCharStrOrNone , eScriptReturnTypeOpaqueObject }
Public Types inherited from lldb_private::IOHandlerDelegate
enum class	Completion { None , LLDBCommand , Expression }

Public Member Functions
	ScriptInterpreterPythonImpl (Debugger &debugger)
	~ScriptInterpreterPythonImpl () override
bool	Interrupt () override
bool	ExecuteOneLine (llvm::StringRef command, CommandReturnObject *result, const ExecuteScriptOptions &options=ExecuteScriptOptions()) override
llvm::Error	ExecuteInterpreterLoop () override
bool	ExecuteOneLineWithReturn (llvm::StringRef in_string, ScriptInterpreter::ScriptReturnType return_type, void *ret_value, const ExecuteScriptOptions &options=ExecuteScriptOptions()) override
lldb_private::Status	ExecuteMultipleLines (const char *in_string, const ExecuteScriptOptions &options=ExecuteScriptOptions()) override
Status	ExportFunctionDefinitionToInterpreter (StringList &function_def) override
bool	GenerateTypeScriptFunction (StringList &input, std::string &output, const void *name_token=nullptr) override
bool	GenerateTypeSynthClass (StringList &input, std::string &output, const void *name_token=nullptr) override
bool	GenerateTypeSynthClass (const char oneliner, std::string &output, const void name_token=nullptr) override
bool	GenerateTypeScriptFunction (const char oneliner, std::string &output, const void name_token=nullptr) override
bool	GenerateScriptAliasFunction (StringList &input, std::string &output) override
StructuredData::ObjectSP	CreateStructuredDataFromScriptObject (ScriptObject obj) override
lldb::ScriptedProcessInterfaceUP	CreateScriptedProcessInterface () override
lldb::ScriptedHookInterfaceSP	CreateScriptedHookInterface () override
lldb::ScriptedBreakpointInterfaceSP	CreateScriptedBreakpointInterface () override
lldb::ScriptedStackFrameRecognizerInterfaceSP	CreateScriptedStackFrameRecognizerInterface () override
lldb::ScriptedCommandInterfaceSP	CreateScriptedCommandInterface () override
lldb::ScriptedStringSummaryInterfaceSP	CreateScriptedStringSummaryInterface () override
lldb::ScriptedSyntheticChildrenInterfaceSP	CreateScriptedSyntheticChildrenInterface () override
lldb::ScriptedThreadInterfaceSP	CreateScriptedThreadInterface () override
lldb::ScriptedFrameInterfaceSP	CreateScriptedFrameInterface () override
lldb::ScriptedFrameProviderInterfaceSP	CreateScriptedFrameProviderInterface () override
lldb::ScriptedThreadPlanInterfaceSP	CreateScriptedThreadPlanInterface () override
lldb::OperatingSystemInterfaceSP	CreateOperatingSystemInterface () override
StructuredData::ObjectSP	LoadPluginModule (const FileSpec &file_spec, lldb_private::Status &error) override
StructuredData::DictionarySP	GetDynamicSettings (StructuredData::ObjectSP plugin_module_sp, Target target, const char setting_name, lldb_private::Status &error) override
bool	RunScriptBasedCommand (const char *impl_function, llvm::StringRef args, ScriptedCommandSynchronicity synchronicity, lldb_private::CommandReturnObject &cmd_retobj, Status &error, const lldb_private::ExecutionContext &exe_ctx) override
Status	GenerateFunction (const char *signature, const StringList &input, bool is_callback) override
Status	GenerateBreakpointCommandCallbackData (StringList &input, std::string &output, bool has_extra_args, bool is_callback) override
bool	GenerateWatchpointCommandCallbackData (StringList &input, std::string &output, bool is_callback) override
bool	GetScriptedSummary (const char *function_name, lldb::ValueObjectSP valobj, StructuredData::ObjectSP &callee_wrapper_sp, const TypeSummaryOptions &options, std::string &retval) override
bool	FormatterCallbackFunction (const char *function_name, lldb::TypeImplSP type_impl_sp) override
bool	GetDocumentationForItem (const char *item, std::string &dest) override
	In Python, a special attribute doc contains the docstring for an object (function, method, class, ...) if any is defined Otherwise, the attribute's value is None.
bool	CheckObjectExists (const char *name) override
bool	RunScriptFormatKeyword (const char impl_function, Process process, std::string &output, Status &error) override
bool	RunScriptFormatKeyword (const char impl_function, Thread thread, std::string &output, Status &error) override
bool	RunScriptFormatKeyword (const char impl_function, Target target, std::string &output, Status &error) override
bool	RunScriptFormatKeyword (const char impl_function, StackFrame frame, std::string &output, Status &error) override
bool	RunScriptFormatKeyword (const char impl_function, ValueObject value, std::string &output, Status &error) override
bool	LoadScriptingModule (const char filename, const LoadScriptOptions &options, lldb_private::Status &error, StructuredData::ObjectSP module_sp=nullptr, FileSpec extra_search_dir={}, lldb::TargetSP loaded_into_target_sp={}) override
bool	IsReservedWord (const char *word) override
std::unique_ptr< ScriptInterpreterLocker >	AcquireInterpreterLock () override
void	CollectDataForBreakpointCommandCallback (std::vector< std::reference_wrapper< BreakpointOptions > > &bp_options_vec, CommandReturnObject &result) override
void	CollectDataForWatchpointCommandCallback (WatchpointOptions *wp_options, CommandReturnObject &result) override
llvm::Error	SetBreakpointCommandCallback (BreakpointOptions &bp_options, const char *callback_body, bool is_callback) override
	Set the callback body text into the callback for the breakpoint.
llvm::Error	SetBreakpointCommandCallbackFunction (BreakpointOptions &bp_options, const char *function_name, StructuredData::ObjectSP extra_args_sp) override
	Set a script function as the callback for the breakpoint.
llvm::Error	SetBreakpointCommandCallback (BreakpointOptions &bp_options, std::unique_ptr< BreakpointOptions::CommandData > &data_up) override
	This one is for deserialization:
llvm::Error	SetBreakpointCommandCallback (BreakpointOptions &bp_options, const char *command_body_text, StructuredData::ObjectSP extra_args_sp, bool uses_extra_args, bool is_callback)
llvm::Error	SetWatchpointCommandCallback (WatchpointOptions wp_options, const char user_input, bool is_callback) override
	Set a one-liner as the callback for the watchpoint.
const char *	GetDictionaryName ()
PyThreadState *	GetThreadState ()
void	SetThreadState (PyThreadState *s)
void	IOHandlerActivated (IOHandler &io_handler, bool interactive) override
void	IOHandlerInputComplete (IOHandler &io_handler, std::string &data) override
	Called when a line or lines have been retrieved.
llvm::StringRef	GetPluginName () override
bool	EnterSession (uint16_t on_entry_flags, lldb::FileSP in, lldb::FileSP out, lldb::FileSP err)
void	LeaveSession ()
uint32_t	IsExecutingPython ()
uint32_t	IncrementLockCount ()
uint32_t	DecrementLockCount ()
python::PythonModule &	GetMainModule ()
python::PythonDictionary &	GetSessionDictionary ()
python::PythonDictionary &	GetSysModuleDictionary ()
llvm::Expected< unsigned >	GetMaxPositionalArgumentsForCallable (const llvm::StringRef &callable_name) override
bool	GetEmbeddedInterpreterModuleObjects ()
bool	SetStdHandle (lldb::FileSP file, const char py_name, python::PythonObject &save_file, const char mode, bool serialize_terminal_output)
	Point sys.
bool	RedirectTerminalHandleThroughLock (const char py_name, python::PythonObject &save_file, const char mode, File &file)
	If `file` is the debugger's own terminal, point sys.
Public Member Functions inherited from lldb_private::ScriptInterpreterPython
	ScriptInterpreterPython (Debugger &debugger)
llvm::Expected< std::string >	ExtensionToImportPath (lldb::ScriptedExtension extension) override
StructuredData::DictionarySP	GetInterpreterInfo () override
llvm::Expected< FileSpec >	GenerateExtensionTemplate (const std::string &name, std::vector< ExtensionTemplateRequest > &extensions, bool generate_non_abstract_methods, std::string output_file) override
Public Member Functions inherited from lldb_private::ScriptInterpreter
	ScriptInterpreter (Debugger &debugger, lldb::ScriptLanguage script_lang)
	~ScriptInterpreter () override=default
llvm::Error	SetBreakpointCommandCallback (std::vector< std::reference_wrapper< BreakpointOptions > > &bp_options_vec, const char *callback_text)
	Set the specified text as the callback for the breakpoint.
llvm::Error	SetBreakpointCommandCallbackFunction (std::vector< std::reference_wrapper< BreakpointOptions > > &bp_options_vec, const char *function_name, StructuredData::ObjectSP extra_args_sp)
virtual void	Clear ()
const lldb::ScriptedInstanceRegistrySP &	GetScriptedInstanceRegistry () const
const char *	GetScriptInterpreterPtyName ()
lldb::ScriptLanguage	GetLanguage ()
virtual lldb::ScriptedPlatformInterfaceUP	GetScriptedPlatformInterface ()
virtual SanitizedScriptingModuleName	GetSanitizedScriptingModuleName (llvm::StringRef name)
Debugger &	GetDebugger ()
	Get the debugger associated with this script interpreter.
const Debugger &	GetDebugger () const
Public Member Functions inherited from lldb_private::PluginInterface
	PluginInterface ()=default
virtual	~PluginInterface ()=default
	PluginInterface (const PluginInterface &)=delete
PluginInterface &	operator= (const PluginInterface &)=delete
Public Member Functions inherited from lldb_private::IOHandlerDelegateMultiline
	IOHandlerDelegateMultiline (llvm::StringRef end_line, Completion completion=Completion::None)
	~IOHandlerDelegateMultiline () override=default
llvm::StringRef	IOHandlerGetControlSequence (char ch) override
bool	IOHandlerIsInputComplete (IOHandler &io_handler, StringList &lines) override
	Called to determine whether typing enter after the last line in lines should end input.
Public Member Functions inherited from lldb_private::IOHandlerDelegate
	IOHandlerDelegate (Completion completion=Completion::None)
virtual	~IOHandlerDelegate ()=default
virtual void	IOHandlerDeactivated (IOHandler &io_handler)
virtual std::optional< std::string >	IOHandlerSuggestion (IOHandler &io_handler, llvm::StringRef line)
virtual void	IOHandlerComplete (IOHandler &io_handler, CompletionRequest &request)
virtual const char *	IOHandlerGetFixIndentationCharacters ()
virtual int	IOHandlerFixIndentation (IOHandler &io_handler, const StringList &lines, int cursor_position)
	Called when a new line is created or one of an identified set of indentation characters is typed.
virtual void	IOHandlerInputInterrupted (IOHandler &io_handler, std::string &data)
virtual const char *	IOHandlerGetCommandPrefix ()
virtual const char *	IOHandlerGetHelpPrologue ()
virtual bool	IOHandlerInterrupt (IOHandler &io_handler)

Static Public Member Functions
static lldb::ScriptInterpreterSP	CreateInstance (Debugger &debugger, lldb::ScriptLanguage)
static bool	BreakpointCallbackFunction (void baton, StoppointCallbackContext context, lldb::user_id_t break_id, lldb::user_id_t break_loc_id)
static bool	WatchpointCallbackFunction (void baton, StoppointCallbackContext context, lldb::user_id_t watch_id)
static llvm::Error	Initialize ()
static void	AddToSysPath (AddLocation location, std::string path)
Static Public Member Functions inherited from lldb_private::ScriptInterpreterPython
static void	Initialize ()
static void	Terminate ()
static llvm::StringRef	GetPluginNameStatic ()
static llvm::StringRef	GetPluginDescriptionStatic ()
static FileSpec	GetPythonDir ()
static void	SharedLibraryDirectoryHelper (FileSpec &this_file)
Static Public Member Functions inherited from lldb_private::ScriptInterpreter
static std::string	LanguageToString (lldb::ScriptLanguage language)
static lldb::ScriptLanguage	StringToLanguage (const llvm::StringRef &string)
static llvm::StringLiteral	ExtensionToString (lldb::ScriptedExtension extension)
static lldb::ScriptedExtension	StringToExtension (llvm::StringRef string)

Public Attributes
python::PythonObject	m_saved_stdin
python::PythonObject	m_saved_stdout
python::PythonObject	m_saved_stderr
std::unique_ptr< SessionIORedirect >	m_stdout_redirect
std::unique_ptr< SessionIORedirect >	m_stderr_redirect
python::PythonModule	m_main_module
python::PythonDictionary	m_session_dict
python::PythonDictionary	m_sys_module_dict
python::PythonObject	m_run_one_line_function
python::PythonObject	m_run_one_line_str_global
std::string	m_dictionary_name
ActiveIOHandler	m_active_io_handler
bool	m_session_is_active
bool	m_pty_secondary_is_open
bool	m_valid_session
uint32_t	m_lock_count
std::mutex	m_mutex
PyThreadState *	m_command_thread_state

Friends
class	IOHandlerPythonInterpreter

Additional Inherited Members
Protected Member Functions inherited from lldb_private::ScriptInterpreterPython
llvm::Error	ParseExtensionSchema (Stream &s, llvm::StringRef output_script_prefix, const llvm::SmallVector< llvm::StringRef > &extension_path, bool generate_non_abstract_methods, std::set< std::string > &typing_imports)
llvm::Expected< StructuredData::ObjectSP >	GetExtensionSchema (const llvm::SmallVector< llvm::StringRef > &extension_path)
Static Protected Member Functions inherited from lldb_private::ScriptInterpreterPython
static void	ComputePythonDirForApple (llvm::SmallVectorImpl< char > &path)
static void	ComputePythonDir (llvm::SmallVectorImpl< char > &path)
Protected Attributes inherited from lldb_private::ScriptInterpreter
Debugger &	m_debugger
lldb::ScriptLanguage	m_script_lang
Protected Attributes inherited from lldb_private::IOHandlerDelegateMultiline
const std::string	m_end_line
Protected Attributes inherited from lldb_private::IOHandlerDelegate
Completion	m_completion

Detailed Description

Definition at line 25 of file ScriptInterpreterPythonImpl.h.

Member Enumeration Documentation

◆ ActiveIOHandler

enum lldb_private::ScriptInterpreterPythonImpl::ActiveIOHandler

Enumerator
eIOHandlerNone
eIOHandlerBreakpoint
eIOHandlerWatchpoint

Definition at line 318 of file ScriptInterpreterPythonImpl.h.

◆ AddLocation

enum class lldb_private::ScriptInterpreterPythonImpl::AddLocation

strong

Enumerator
Beginning
End

Definition at line 292 of file ScriptInterpreterPythonImpl.h.

Constructor & Destructor Documentation

◆ ScriptInterpreterPythonImpl()

ScriptInterpreterPythonImpl::ScriptInterpreterPythonImpl ( Debugger & debugger )

Definition at line 801 of file ScriptInterpreterPython.cpp.

References lldb_private::ScriptInterpreterPythonImpl::Locker::AcquireLock, lldb_private::StreamString::Clear(), eIOHandlerNone, lldb_private::ScriptInterpreterPythonImpl::Locker::FreeAcquiredLock, lldb_private::StreamString::GetData(), lldb_private::Invalid, m_active_io_handler, m_command_thread_state, lldb_private::ScriptInterpreter::m_debugger, m_dictionary_name, m_lock_count, m_main_module, m_pty_secondary_is_open, m_run_one_line_function, m_run_one_line_str_global, m_saved_stderr, m_saved_stdin, m_saved_stdout, m_session_dict, m_session_is_active, m_sys_module_dict, m_valid_session, lldb_private::Stream::Printf(), lldb_private::python::RunSimpleString(), and lldb_private::ScriptInterpreterPython::ScriptInterpreterPython().

Referenced by lldb_private::ScriptInterpreterPythonImpl::Locker::Locker().

◆ ~ScriptInterpreterPythonImpl()

ScriptInterpreterPythonImpl::~ScriptInterpreterPythonImpl ( )

override

Definition at line 939 of file ScriptInterpreterPython.cpp.

References m_session_dict.

Member Function Documentation

◆ AcquireInterpreterLock()

std::unique_ptr< ScriptInterpreterLocker > ScriptInterpreterPythonImpl::AcquireInterpreterLock ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2830 of file ScriptInterpreterPython.cpp.

◆ AddToSysPath()

void ScriptInterpreterPythonImpl::AddToSysPath	(	AddLocation	location,
		std::string	path )

static

Definition at line 2891 of file ScriptInterpreterPython.cpp.

◆ BreakpointCallbackFunction()

bool ScriptInterpreterPythonImpl::BreakpointCallbackFunction	(	void *	baton,
		StoppointCallbackContext *	context,
		lldb::user_id_t	break_id,
		lldb::user_id_t	break_loc_id )

static

Definition at line 2273 of file ScriptInterpreterPython.cpp.

References lldb_private::ScriptInterpreterPythonImpl::Locker::AcquireLock, lldb_private::ScriptInterpreterPythonImpl::Locker::InitSession, m_dictionary_name, and lldb_private::ScriptInterpreterPythonImpl::Locker::NoSTDIN.

Referenced by SetBreakpointCommandCallback(), and SetWatchpointCommandCallback().

◆ CheckObjectExists()

bool lldb_private::ScriptInterpreterPythonImpl::CheckObjectExists ( const char * name )

inlineoverridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 140 of file ScriptInterpreterPythonImpl.h.

References GetDocumentationForItem().

◆ CollectDataForBreakpointCommandCallback()

void ScriptInterpreterPythonImpl::CollectDataForBreakpointCommandCallback	(	std::vector< std::reference_wrapper< BreakpointOptions > > &	bp_options_vec,
		CommandReturnObject &	result )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1719 of file ScriptInterpreterPython.cpp.

◆ CollectDataForWatchpointCommandCallback()

void ScriptInterpreterPythonImpl::CollectDataForWatchpointCommandCallback	(	WatchpointOptions *	wp_options,
		CommandReturnObject &	result )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1727 of file ScriptInterpreterPython.cpp.

References eIOHandlerBreakpoint, m_active_io_handler, and lldb_private::ScriptInterpreter::m_debugger.

◆ CreateInstance()

lldb::ScriptInterpreterSP ScriptInterpreterPythonImpl::CreateInstance	(	Debugger &	debugger,
		lldb::ScriptLanguage	)

static

Definition at line 1036 of file ScriptInterpreterPython.cpp.

Referenced by lldb_private::ScriptInterpreterPython::Initialize(), and lldb_private::ScriptInterpreterPython::Terminate().

◆ CreateOperatingSystemInterface()

OperatingSystemInterfaceSP ScriptInterpreterPythonImpl::CreateOperatingSystemInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2086 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedBreakpointInterface()

ScriptedBreakpointInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedBreakpointInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2041 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedCommandInterface()

ScriptedCommandInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedCommandInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2051 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedFrameInterface()

ScriptedFrameInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedFrameInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2071 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedFrameProviderInterface()

ScriptedFrameProviderInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedFrameProviderInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2076 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedHookInterface()

ScriptedHookInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedHookInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2036 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedProcessInterface()

ScriptedProcessInterfaceUP ScriptInterpreterPythonImpl::CreateScriptedProcessInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2031 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedStackFrameRecognizerInterface()

ScriptedStackFrameRecognizerInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedStackFrameRecognizerInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2046 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedStringSummaryInterface()

ScriptedStringSummaryInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedStringSummaryInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2056 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedSyntheticChildrenInterface()

ScriptedSyntheticChildrenInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedSyntheticChildrenInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2061 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedThreadInterface()

ScriptedThreadInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedThreadInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2066 of file ScriptInterpreterPython.cpp.

◆ CreateScriptedThreadPlanInterface()

ScriptedThreadPlanInterfaceSP ScriptInterpreterPythonImpl::CreateScriptedThreadPlanInterface ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2081 of file ScriptInterpreterPython.cpp.

◆ CreateStructuredDataFromScriptObject()

StructuredData::ObjectSP ScriptInterpreterPythonImpl::CreateStructuredDataFromScriptObject ( ScriptObject obj )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2091 of file ScriptInterpreterPython.cpp.

◆ DecrementLockCount()

uint32_t lldb_private::ScriptInterpreterPythonImpl::DecrementLockCount ( )

inline

Definition at line 311 of file ScriptInterpreterPythonImpl.h.

References m_lock_count, and m_mutex.

◆ EnterSession()

bool ScriptInterpreterPythonImpl::EnterSession	(	uint16_t	on_entry_flags,
		lldb::FileSP	in,
		lldb::FileSP	out,
		lldb::FileSP	err )

Definition at line 1195 of file ScriptInterpreterPython.cpp.

◆ ExecuteInterpreterLoop()

llvm::Error ScriptInterpreterPythonImpl::ExecuteInterpreterLoop ( )

overridevirtual

Implements lldb_private::ScriptInterpreter.

Definition at line 1482 of file ScriptInterpreterPython.cpp.

◆ ExecuteMultipleLines()

Status ScriptInterpreterPythonImpl::ExecuteMultipleLines	(	const char *	in_string,
		const ExecuteScriptOptions &	options = ExecuteScriptOptions() )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1668 of file ScriptInterpreterPython.cpp.

◆ ExecuteOneLine()

bool ScriptInterpreterPythonImpl::ExecuteOneLine	(	llvm::StringRef	command,
		CommandReturnObject *	result,
		const ExecuteScriptOptions &	options = ExecuteScriptOptions() )

overridevirtual

Implements lldb_private::ScriptInterpreter.

Definition at line 1390 of file ScriptInterpreterPython.cpp.

References m_run_one_line_function, and m_run_one_line_str_global.

◆ ExecuteOneLineWithReturn()

bool ScriptInterpreterPythonImpl::ExecuteOneLineWithReturn	(	llvm::StringRef	in_string,
		ScriptInterpreter::ScriptReturnType	return_type,
		void *	ret_value,
		const ExecuteScriptOptions &	options = ExecuteScriptOptions() )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1544 of file ScriptInterpreterPython.cpp.

◆ ExportFunctionDefinitionToInterpreter()

Status ScriptInterpreterPythonImpl::ExportFunctionDefinitionToInterpreter ( StringList & function_def )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1839 of file ScriptInterpreterPython.cpp.

References WatchpointCallbackFunction().

◆ FormatterCallbackFunction()

bool ScriptInterpreterPythonImpl::FormatterCallbackFunction	(	const char *	function_name,
		lldb::TypeImplSP	type_impl_sp )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2265 of file ScriptInterpreterPython.cpp.

◆ GenerateBreakpointCommandCallbackData()

Status ScriptInterpreterPythonImpl::GenerateBreakpointCommandCallbackData	(	StringList &	input,
		std::string &	output,
		bool	has_extra_args,
		bool	is_callback )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2162 of file ScriptInterpreterPython.cpp.

◆ GenerateFunction()

Status ScriptInterpreterPythonImpl::GenerateFunction	(	const char *	signature,
		const StringList &	input,
		bool	is_callback )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1851 of file ScriptInterpreterPython.cpp.

References error().

◆ GenerateScriptAliasFunction()

bool ScriptInterpreterPythonImpl::GenerateScriptAliasFunction	(	StringList &	input,
		std::string &	output )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1961 of file ScriptInterpreterPython.cpp.

◆ GenerateTypeScriptFunction() [1/2]

bool ScriptInterpreterPythonImpl::GenerateTypeScriptFunction	(	const char *	oneliner,
		std::string &	output,
		const void *	name_token = nullptr )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2148 of file ScriptInterpreterPython.cpp.

◆ GenerateTypeScriptFunction() [2/2]

bool ScriptInterpreterPythonImpl::GenerateTypeScriptFunction	(	StringList &	input,
		std::string &	output,
		const void *	name_token = nullptr )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1933 of file ScriptInterpreterPython.cpp.

References error().

◆ GenerateTypeSynthClass() [1/2]

bool ScriptInterpreterPythonImpl::GenerateTypeSynthClass	(	const char *	oneliner,
		std::string &	output,
		const void *	name_token = nullptr )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2155 of file ScriptInterpreterPython.cpp.

◆ GenerateTypeSynthClass() [2/2]

bool ScriptInterpreterPythonImpl::GenerateTypeSynthClass	(	StringList &	input,
		std::string &	output,
		const void *	name_token = nullptr )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1986 of file ScriptInterpreterPython.cpp.

◆ GenerateWatchpointCommandCallbackData()

bool ScriptInterpreterPythonImpl::GenerateWatchpointCommandCallbackData	(	StringList &	input,
		std::string &	output,
		bool	is_callback )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2192 of file ScriptInterpreterPython.cpp.

References error().

◆ GetDictionaryName()

const char * lldb_private::ScriptInterpreterPythonImpl::GetDictionaryName ( )

inline

Definition at line 206 of file ScriptInterpreterPythonImpl.h.

References m_dictionary_name.

◆ GetDocumentationForItem()

bool ScriptInterpreterPythonImpl::GetDocumentationForItem	(	const char *	item,
		std::string &	dest )

overridevirtual

In Python, a special attribute doc contains the docstring for an object (function, method, class, ...) if any is defined Otherwise, the attribute's value is None.

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2799 of file ScriptInterpreterPython.cpp.

Referenced by CheckObjectExists().

◆ GetDynamicSettings()

StructuredData::DictionarySP ScriptInterpreterPythonImpl::GetDynamicSettings	(	StructuredData::ObjectSP	plugin_module_sp,
		Target *	target,
		const char *	setting_name,
		lldb_private::Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2120 of file ScriptInterpreterPython.cpp.

◆ GetEmbeddedInterpreterModuleObjects()

bool ScriptInterpreterPythonImpl::GetEmbeddedInterpreterModuleObjects ( )

Definition at line 1369 of file ScriptInterpreterPython.cpp.

◆ GetMainModule()

PythonModule & ScriptInterpreterPythonImpl::GetMainModule ( )

Definition at line 1289 of file ScriptInterpreterPython.cpp.

◆ GetMaxPositionalArgumentsForCallable()

llvm::Expected< unsigned > ScriptInterpreterPythonImpl::GetMaxPositionalArgumentsForCallable ( const llvm::StringRef & callable_name )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1322 of file ScriptInterpreterPython.cpp.

References m_sys_module_dict.

◆ GetPluginName()

llvm::StringRef lldb_private::ScriptInterpreterPythonImpl::GetPluginName ( )

inlineoverridevirtual

Implements lldb_private::PluginInterface.

Definition at line 225 of file ScriptInterpreterPythonImpl.h.

References lldb_private::ScriptInterpreterPython::GetPluginNameStatic().

◆ GetScriptedSummary()

bool ScriptInterpreterPythonImpl::GetScriptedSummary	(	const char *	function_name,
		lldb::ValueObjectSP	valobj,
		StructuredData::ObjectSP &	callee_wrapper_sp,
		const TypeSummaryOptions &	options,
		std::string &	retval )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2214 of file ScriptInterpreterPython.cpp.

◆ GetSessionDictionary()

PythonDictionary & ScriptInterpreterPythonImpl::GetSessionDictionary ( )

Definition at line 1295 of file ScriptInterpreterPython.cpp.

References lldb_private::python::PythonModule::Import(), and m_main_module.

◆ GetSysModuleDictionary()

PythonDictionary & ScriptInterpreterPythonImpl::GetSysModuleDictionary ( )

Definition at line 1313 of file ScriptInterpreterPython.cpp.

References lldb_private::python::As(), m_dictionary_name, and m_session_dict.

◆ GetThreadState()

PyThreadState * lldb_private::ScriptInterpreterPythonImpl::GetThreadState ( )

inline

Definition at line 208 of file ScriptInterpreterPythonImpl.h.

References m_command_thread_state.

◆ IncrementLockCount()

uint32_t lldb_private::ScriptInterpreterPythonImpl::IncrementLockCount ( )

inline

Definition at line 306 of file ScriptInterpreterPythonImpl.h.

References m_lock_count, and m_mutex.

◆ Initialize()

llvm::Error ScriptInterpreterPythonImpl::Initialize ( )

static

Definition at line 2837 of file ScriptInterpreterPython.cpp.

References lldb_private::ScriptInterpreterPythonImpl::Locker::AcquireLock, lldb_private::ScriptInterpreterPythonImpl::Locker::FreeLock, lldb_private::ScriptInterpreterPythonImpl::Locker::InitSession, lldb_private::ScriptInterpreterPythonImpl::Locker::NoSTDIN, and lldb_private::ScriptInterpreterPythonImpl::Locker::TearDownSession.

Referenced by lldb_private::ScriptInterpreterPython::Initialize().

◆ Interrupt()

bool ScriptInterpreterPythonImpl::Interrupt ( )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1503 of file ScriptInterpreterPython.cpp.

◆ IOHandlerActivated()

void ScriptInterpreterPythonImpl::IOHandlerActivated	(	IOHandler &	io_handler,
		bool	interactive )

overridevirtual

Reimplemented from lldb_private::IOHandlerDelegate.

Definition at line 950 of file ScriptInterpreterPython.cpp.

References eIOHandlerBreakpoint, eIOHandlerNone, eIOHandlerWatchpoint, lldb_private::IOHandler::GetOutputStreamFileSP(), m_active_io_handler, and lldb_private::Stream::PutCString().

◆ IOHandlerInputComplete()

void ScriptInterpreterPythonImpl::IOHandlerInputComplete	(	IOHandler &	io_handler,
		std::string &	data )

overridevirtual

Called when a line or lines have been retrieved.

This function can handle the current line and possibly call IOHandler::SetIsDone(true) when the IO handler is done like when "quit" is entered as a command, of when an empty line is received. It is up to the delegate to determine when a line should cause a IOHandler to exit.

Implements lldb_private::IOHandlerDelegate.

Definition at line 974 of file ScriptInterpreterPython.cpp.

◆ IsExecutingPython()

uint32_t lldb_private::ScriptInterpreterPythonImpl::IsExecutingPython ( )

inline

Definition at line 301 of file ScriptInterpreterPythonImpl.h.

References m_lock_count, and m_mutex.

◆ IsReservedWord()

bool ScriptInterpreterPythonImpl::IsReservedWord ( const char * word )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2710 of file ScriptInterpreterPython.cpp.

References m_dictionary_name.

◆ LeaveSession()

void ScriptInterpreterPythonImpl::LeaveSession ( )

Definition at line 1041 of file ScriptInterpreterPython.cpp.

◆ LoadPluginModule()

StructuredData::ObjectSP ScriptInterpreterPythonImpl::LoadPluginModule	(	const FileSpec &	file_spec,
		lldb_private::Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2102 of file ScriptInterpreterPython.cpp.

◆ LoadScriptingModule()

bool ScriptInterpreterPythonImpl::LoadScriptingModule	(	const char *	filename,
		const LoadScriptOptions &	options,
		lldb_private::Status &	error,
		StructuredData::ObjectSP *	module_sp = nullptr,
		FileSpec	extra_search_dir = {},
		lldb::TargetSP	loaded_into_target_sp = {} )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2520 of file ScriptInterpreterPython.cpp.

◆ RedirectTerminalHandleThroughLock()

bool ScriptInterpreterPythonImpl::RedirectTerminalHandleThroughLock	(	const char *	py_name,
		python::PythonObject &	save_file,
		const char *	mode,
		File &	file )

If file is the debugger's own terminal, point sys.

py_name at a pipe-backed file whose writes are serialized through the output lock (see SessionIORedirect) and return true. Return false to let SetStdHandle wrap file normally.

Definition at line 1101 of file ScriptInterpreterPython.cpp.

References m_session_is_active, and m_stderr_redirect.

◆ RunScriptBasedCommand()

bool ScriptInterpreterPythonImpl::RunScriptBasedCommand	(	const char *	impl_function,
		llvm::StringRef	args,
		ScriptedCommandSynchronicity	synchronicity,
		lldb_private::CommandReturnObject &	cmd_retobj,
		Status &	error,
		const lldb_private::ExecutionContext &	exe_ctx )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2751 of file ScriptInterpreterPython.cpp.

References lldb_private::eScriptedCommandSynchronicityCurrentValue.

◆ RunScriptFormatKeyword() [1/5]

bool ScriptInterpreterPythonImpl::RunScriptFormatKeyword	(	const char *	impl_function,
		Process *	process,
		std::string &	output,
		Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2384 of file ScriptInterpreterPython.cpp.

◆ RunScriptFormatKeyword() [2/5]

bool ScriptInterpreterPythonImpl::RunScriptFormatKeyword	(	const char *	impl_function,
		StackFrame *	frame,
		std::string &	output,
		Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2459 of file ScriptInterpreterPython.cpp.

References error().

◆ RunScriptFormatKeyword() [3/5]

bool ScriptInterpreterPythonImpl::RunScriptFormatKeyword	(	const char *	impl_function,
		Target *	target,
		std::string &	output,
		Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2434 of file ScriptInterpreterPython.cpp.

◆ RunScriptFormatKeyword() [4/5]

bool ScriptInterpreterPythonImpl::RunScriptFormatKeyword	(	const char *	impl_function,
		Thread *	thread,
		std::string &	output,
		Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2409 of file ScriptInterpreterPython.cpp.

References error().

◆ RunScriptFormatKeyword() [5/5]

bool ScriptInterpreterPythonImpl::RunScriptFormatKeyword	(	const char *	impl_function,
		ValueObject *	value,
		std::string &	output,
		Status &	error )

overridevirtual

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 2484 of file ScriptInterpreterPython.cpp.

◆ SetBreakpointCommandCallback() [1/3]

llvm::Error ScriptInterpreterPythonImpl::SetBreakpointCommandCallback	(	BreakpointOptions &	bp_options,
		const char *	callback_body,
		bool	is_callback )

overridevirtual

Set the callback body text into the callback for the breakpoint.

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1784 of file ScriptInterpreterPython.cpp.

References BreakpointCallbackFunction().

◆ SetBreakpointCommandCallback() [2/3]

llvm::Error ScriptInterpreterPythonImpl::SetBreakpointCommandCallback	(	BreakpointOptions &	bp_options,
		const char *	command_body_text,
		StructuredData::ObjectSP	extra_args_sp,
		bool	uses_extra_args,
		bool	is_callback )

Definition at line 1792 of file ScriptInterpreterPython.cpp.

◆ SetBreakpointCommandCallback() [3/3]

llvm::Error ScriptInterpreterPythonImpl::SetBreakpointCommandCallback	(	BreakpointOptions &	bp_options,
		std::unique_ptr< BreakpointOptions::CommandData > &	data_up )

overridevirtual

This one is for deserialization:

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1768 of file ScriptInterpreterPython.cpp.

◆ SetBreakpointCommandCallbackFunction()

llvm::Error ScriptInterpreterPythonImpl::SetBreakpointCommandCallbackFunction	(	BreakpointOptions &	bp_options,
		const char *	function_name,
		StructuredData::ObjectSP	extra_args_sp )

overridevirtual

Set a script function as the callback for the breakpoint.

Reimplemented from lldb_private::ScriptInterpreter.

Definition at line 1734 of file ScriptInterpreterPython.cpp.

References eIOHandlerWatchpoint, m_active_io_handler, and lldb_private::ScriptInterpreter::m_debugger.

◆ SetStdHandle()

bool ScriptInterpreterPythonImpl::SetStdHandle	(	lldb::FileSP	file,
		const char *	py_name,
		python::PythonObject &	save_file,
		const char *	mode,
		bool	serialize_terminal_output )

Point sys.

py_name at file. When serialize_terminal_output is true and file is the debugger's own terminal, the output is routed through a lock-synchronized pipe instead (see RedirectTerminalHandleThroughLock) so it cannot race the statusline redraw.

Definition at line 1157 of file ScriptInterpreterPython.cpp.