Vendor import of lldb trunk r256945:vendor/lldb/lldb-trunk-r256945

https://llvm.org/svn/llvm-project/lldb/trunk@256945

1 files changed, 310 insertions, 0 deletions

diff --git a/scripts/Python/finish-swig-Python-LLDB.sh b/scripts/Python/finish-swig-Python-LLDB.sh
new file mode 100755
index 000000000000..92b99181c7cc
--- /dev/null
+++ b/scripts/Python/finish-swig-Python-LLDB.sh
@@ -0,0 +1,310 @@
+#!/bin/sh
+
+# finish-swig-Python.sh
+#
+# For the Python script interpreter (external to liblldb) to be able to import
+# and use the lldb module, there must be two files, lldb.py and _lldb.so, that
+# it can find. lldb.py is generated by SWIG at the same time it generates the
+# C++ file.  _lldb.so is actually a symlink file that points to the
+# LLDB shared library/framework.
+#
+# The Python script interpreter needs to be able to automatically find
+# these two files. On Darwin systems it searches in the LLDB.framework, as
+# well as in all the normal Python search paths.  On non-Darwin systems
+# these files will need to be put someplace where Python will find them.
+#
+# This shell script creates the _lldb.so symlink in the appropriate place,
+# and copies the lldb.py (and embedded_interpreter.py) file to the correct
+# directory.
+#
+
+# SRC_ROOT is the root of the lldb source tree.
+# TARGET_DIR is where the lldb framework/shared library gets put.
+# CONFIG_BUILD_DIR is where the build-swig-Python-LLDB.sh  shell script
+#           put the lldb.py file it was generated from running SWIG.
+# PYTHON_INSTALL_DIR is where non-Darwin systems want to put the .py and .so
+#           files so that Python can find them automatically.
+# debug_flag (optional) determines whether or not this script outputs
+#           additional information when running.
+
+SRC_ROOT=$1
+TARGET_DIR=$2
+CONFIG_BUILD_DIR=$3
+PYTHON_INSTALL_DIR=$4
+debug_flag=$5
+makefile_flag=$6
+
+# If we don't want Python, then just do nothing here.
+# Note, at present iOS doesn't have Python, so if you're building for iOS be sure to
+# set LLDB_DISABLE_PYTHON to 1.
+
+if [ ! "$LLDB_DISABLE_PYTHON" = "1" ] ; then
+
+if [ -n "$debug_flag" -a "$debug_flag" = "-debug" ]
+then
+    Debug=1
+else
+    Debug=0
+fi
+
+if [ -n "$makefile_flag" -a "$makefile_flag" = "-m" ]
+then
+    MakefileCalled=1
+else
+    MakefileCalled=0
+fi
+
+OS_NAME=`uname -s`
+PYTHON=${PYTHON_EXECUTABLE:-/usr/bin/env python}
+PYTHON_VERSION=`${PYTHON} --version 2>&1 | sed -e 's,Python ,,' -e 's,[.][0-9],,2' -e 's,[a-z][a-z][0-9],,'`
+
+
+if [ $Debug -eq 1 ]
+then
+    echo "The current OS is $OS_NAME"
+    echo "The Python version is $PYTHON_VERSION"
+fi
+
+if [ ${OS_NAME} = "Darwin" ]
+then
+    SOEXT=".dylib"
+else
+    SOEXT=".so"
+fi
+
+#
+#  Determine where to put the files.
+
+if [ $MakefileCalled -eq 0 ]
+then
+    # We are being built by Xcode, so all the lldb Python files can go
+    # into the LLDB.framework/Resources/Python subdirectory.
+
+    if [ ! -d "${TARGET_DIR}/LLDB.framework" ]
+    then
+        echo "Error:  Unable to find LLDB.framework" >&2
+        exit 1
+    else
+        if [ $Debug -eq 1 ]
+        then
+            echo "Found ${TARGET_DIR}/LLDB.framework."
+        fi
+    fi
+
+    # Make the Python directory in the framework if it doesn't already exist
+
+    framework_python_dir="${TARGET_DIR}/LLDB.framework/Resources/Python/lldb"
+else
+    # We are being built by LLVM, so use the PYTHON_INSTALL_DIR argument,
+    # and append the python version directory to the end of it.  Depending on
+    # the system other stuff may need to be put here as well.
+
+    if [ -n "${PYTHON_INSTALL_DIR}" ]
+    then
+        framework_python_dir=`${PYTHON} -c "from distutils.sysconfig import get_python_lib; print get_python_lib(True, False, \"${PYTHON_INSTALL_DIR}\");"`/lldb
+    else
+        framework_python_dir=`${PYTHON} -c "from distutils.sysconfig import get_python_lib; print get_python_lib(True, False);"`/lldb
+    fi
+fi
+
+[ -n "${CONFIG_BUILD_DIR}" ] || CONFIG_BUILD_DIR=${framework_python_dir}
+
+#
+# Look for the directory in which to put the Python files;  if it does not
+# already exist, attempt to make it.
+#
+
+if [ $Debug -eq 1 ]
+then
+    echo "Python files will be put in ${framework_python_dir}"
+fi
+
+python_dirs="${framework_python_dir}"
+
+for python_dir in $python_dirs
+do
+    if [ ! -d "${python_dir}" ]
+    then
+        if [ $Debug -eq 1 ]
+        then
+            echo "Making directory ${python_dir}"
+        fi
+        mkdir -p "${python_dir}"
+    else
+        if [ $Debug -eq 1 ]
+        then
+            echo "${python_dir} already exists."
+        fi
+    fi
+
+    if [ ! -d "${python_dir}" ]
+    then
+        echo "Error: Unable to find or create ${python_dir}" >&2
+        exit 1
+    fi
+done
+
+# Make the symlink that the script bridge for Python will need in the
+# Python framework directory
+
+if [ ! -L "${framework_python_dir}/_lldb.so" ]
+then
+    if [ $Debug -eq 1 ]
+    then
+        echo "Creating symlink for _lldb.so"
+    fi
+    cd "${framework_python_dir}"
+    if [ $MakefileCalled -eq 0 ]
+    then
+        ln -s "../../../LLDB" _lldb.so
+	else
+        ln -s "../../../liblldb${SOEXT}" _lldb.so
+    fi
+else
+    if [ $Debug -eq 1 ]
+    then
+        echo "${framework_python_dir}/_lldb.so already exists."
+    fi
+fi
+
+# Make symlink for darwin-debug on Darwin
+if [ ${OS_NAME} = "Darwin" ] && [ $MakefileCalled -ne 0 ]
+then
+    # We are being built by CMake on Darwin
+
+    if [ ! -L "${framework_python_dir}/darwin-debug" ]
+    then
+        if [ $Debug -eq 1 ]
+        then
+            echo "Creating symlink for darwin-debug"
+        fi
+        cd "${framework_python_dir}"
+        ln -s "../../../../bin/lldb-launcher" darwin-debug
+    else
+        if [ $Debug -eq 1 ]
+        then
+            echo "${framework_python_dir}/darwin-debug already exists."
+        fi
+    fi
+fi
+
+# Make symlink for lldb-argdumper on any platform
+if [ $MakefileCalled -ne 0 ]
+then
+    # We are being built by CMake
+
+    if [ ! -L "${framework_python_dir}/lldb-argdumper" ]
+    then
+        if [ $Debug -eq 1 ]
+        then
+            echo "Creating symlink for lldb-argdumper"
+        fi
+        cd "${framework_python_dir}"
+        ln -s "../../../../bin/lldb-argdumper" lldb-argdumper
+    else
+        if [ $Debug -eq 1 ]
+        then
+            echo "${framework_python_dir}/lldb-argdumper already exists."
+        fi
+    fi
+fi
+
+create_python_package () {
+    package_dir="${framework_python_dir}$1"
+    package_files="$2"
+    package_name=`echo $1 | tr '/' '.'`
+    package_name="lldb${package_name}"
+
+    if [ ! -d "${package_dir}" ]
+    then
+        mkdir -p "${package_dir}"
+    fi
+
+    for package_file in $package_files
+    do
+        if [ -f "${package_file}" ]
+        then
+            cp "${package_file}" "${package_dir}"
+            package_file_basename=$(basename "${package_file}")
+        fi
+    done
+
+
+    # Create a packate init file if there wasn't one
+    package_init_file="${package_dir}/__init__.py"
+    if [ ! -f "${package_init_file}" ]
+    then
+        printf "__all__ = [" > "${package_init_file}"
+        python_module_separator=""
+        for package_file in $package_files
+        do
+            if [ -f "${package_file}" ]
+            then
+                package_file_basename=$(basename "${package_file}")
+                printf "${python_module_separator}\"${package_file_basename%.*}\"" >> "${package_init_file}"
+                python_module_separator=", "
+            fi
+        done
+        echo "]" >> "${package_init_file}"
+        echo "for x in __all__:" >> "${package_init_file}"
+        echo "    __import__('${package_name}.'+x)" >> "${package_init_file}"
+    fi
+
+
+}
+
+# Copy the lldb.py file into the lldb package directory and rename to __init_.py
+cp "${CONFIG_BUILD_DIR}/lldb.py" "${framework_python_dir}/__init__.py"
+
+# lldb
+package_files="${SRC_ROOT}/source/Interpreter/embedded_interpreter.py"
+create_python_package "" "${package_files}"
+
+# lldb/formatters/cpp
+package_files="${SRC_ROOT}/examples/synthetic/gnu_libstdcpp.py
+${SRC_ROOT}/examples/synthetic/libcxx.py"
+create_python_package "/formatters/cpp" "${package_files}"
+
+# make an empty __init__.py in lldb/runtime
+# this is required for Python to recognize lldb.runtime as a valid package
+# (and hence, lldb.runtime.objc as a valid contained package)
+create_python_package "/runtime" ""
+
+# lldb/formatters
+# having these files copied here ensures that lldb/formatters is a valid package itself
+package_files="${SRC_ROOT}/examples/summaries/cocoa/cache.py
+${SRC_ROOT}/examples/summaries/cocoa/metrics.py
+${SRC_ROOT}/examples/summaries/cocoa/attrib_fromdict.py
+${SRC_ROOT}/examples/summaries/cocoa/Logger.py"
+create_python_package "/formatters" "${package_files}"
+
+# lldb/utils
+package_files="${SRC_ROOT}/examples/python/symbolication.py"
+create_python_package "/utils" "${package_files}"
+
+if [ ${OS_NAME} = "Darwin" ]
+then
+    # lldb/macosx
+    package_files="${SRC_ROOT}/examples/python/crashlog.py
+    ${SRC_ROOT}/examples/darwin/heap_find/heap.py"
+    create_python_package "/macosx" "${package_files}"
+
+    # lldb/diagnose
+    package_files="${SRC_ROOT}/examples/python/diagnose_unwind.py
+    ${SRC_ROOT}/examples/python/diagnose_nsstring.py"
+    create_python_package "/diagnose" "${package_files}"
+
+    # Copy files needed by lldb/macosx/heap.py to build libheap.dylib
+    heap_dir="${framework_python_dir}/macosx/heap"
+    if [ ! -d "${heap_dir}" ]
+    then
+        mkdir -p "${heap_dir}"
+        cp "${SRC_ROOT}/examples/darwin/heap_find/heap/heap_find.cpp" "${heap_dir}"
+        cp "${SRC_ROOT}/examples/darwin/heap_find/heap/Makefile" "${heap_dir}"
+    fi
+fi
+
+fi
+
+exit 0
+