classicvalues / swift-lldb

This is the version of LLDB that supports the Swift programming language & REPL.

Disclaimer

The swift-lldb repository is frozen and is preserved for historical purposes only. Active development is now happening in the following repository: https://github.com/apple/llvm-project

Swift Debugger and REPL

Welcome to the Swift Debugger and REPL!

Swift is a new, high performance systems programming language. It has a clean and modern syntax, offers seamless access to existing C and Objective-C code and frameworks, and is memory safe (by default).

This repository covers the Swift Debugger and REPL support, built on top of the LLDB Debugger.

Building LLDB for Swift

To build LLDB for Swift, check out the swift repository and follow the instruction listed there. You can build lldb passing the --lldb flag to it. Example invocation:

mkdir myswift
cd myswift
git clone https://github.com/apple/swift.git swift
./swift/utils/update-checkout
./swift/utils/build-script -r --lldb

Contribution Subtleties

The swift-lldb project enhances the core LLDB project developed under the LLVM Project. Swift support in the debugger is added via the existing source-level plugin infrastructure, isolated to files that are newly introduced in the lldb-swift repository.

Files that come from the core LLDB project can be readily identified by their use of the LLVM comment header. As no local changes should be made to any of these files, follow the standard guidance for upstream changes.