[lldb] Add Debugger & ScriptedMetadata reference to Platform::CreateInstance

This patch is preparatory work for Scripted Platform support and does
multiple things:

First, it introduces new options for the `platform select` command and
`SBPlatform::Create` API, to hold a reference to the debugger object,
the name of the python script managing the Scripted Platform and a
structured data dictionary that the user can use to pass arbitrary data.

Then, it updates the various `Create` and `GetOrCreate` methods for
the `Platform` and `PlatformList` classes to pass down the new parameter
to the `Platform::CreateInstance` callbacks.

Finally, it updates every callback to reflect these changes.

Differential Revision: https://reviews.llvm.org/D139249

Signed-off-by: Med Ismail Bennani <medismail.bennani@gmail.com>

1 files changed, 12 insertions, 0 deletions

diff --git a/lldb/bindings/interface/SBPlatform.i b/lldb/bindings/interface/SBPlatform.i
index 6413784e69e7..a57deca00e1d 100644
--- a/lldb/bindings/interface/SBPlatform.i
+++ b/lldb/bindings/interface/SBPlatform.i
@@ -126,6 +126,18 @@ public:
 
     SBPlatform (const char *);
 
+    %feature("docstring", "
+    Create a platform instance using a specific platform plugin name, debugger,
+    script name and user-provided dictionary.
+
+    :param platform_name: name of the platform plugin to use to create the platform
+    :param debugger: debugger instance owning the platform
+    :param script_name: name of the script class and module to use to create the platform
+    :param dict: user-provided dictionary that can be used when instanciating a platform
+    ")
+    SBPlatform (const char *, const SBDebugger&,
+                const char *, const SBStructuredData&);
+
     ~SBPlatform();
 
     static SBPlatform GetHostPlatform();