Skip to content

Add documentation for debugging Swift Testing tests with LLDB from the command line#1504

Merged
gottesmm merged 1 commit intomainfrom
pr-849a5ddba4414614623295a89cfb38ff3ec826d4
Jan 28, 2026
Merged

Add documentation for debugging Swift Testing tests with LLDB from the command line#1504
gottesmm merged 1 commit intomainfrom
pr-849a5ddba4414614623295a89cfb38ff3ec826d4

Conversation

@gottesmm
Copy link
Copy Markdown
Contributor

This document explains how to attach LLDB to debug test code directly when swift test alone is insufficient. It targets compiler engineers who need to debug Swift Testing executables.

This documentation lives in the swift-testing repository so Swift Testing engineers can update it as the project evolves. A subsequent commit to the swift repository will add a link from DebuggingTheCompiler.md to help Swift engineers discover it.

…from the command line

This document explains how to attach LLDB to debug test code directly when
`swift test` alone is insufficient. It targets compiler engineers who need to
debug Swift Testing executables.

This documentation lives in the swift-testing repository so Swift Testing
engineers can update it as the project evolves. A subsequent commit to the
swift repository will add a link from DebuggingTheCompiler.md to help Swift
engineers discover it.
@stmontgomery
Copy link
Copy Markdown
Contributor

Thanks! I'll review in depth, but first wanted to note that an anticipated SwiftPM feature will hopefully simplify this workflow and likely mean changes to this document once it lands. See swiftlang/swift-package-manager#9085. cc @plemarquand

This is still probably helpful in the interim though

@grynspan grynspan changed the title [docs] Add documentation for debugging Swift Testing tests with LLDB from the command line Add documentation for debugging Swift Testing tests with LLDB from the command line Jan 28, 2026
@grynspan grynspan added documentation 📚 Improvements or additions to documentation build 🧱 Affects the project's build configuration or process labels Jan 28, 2026
@grynspan grynspan added this to the Swift 6.4.0 (main) milestone Jan 28, 2026
@gottesmm gottesmm merged commit 8f62235 into main Jan 28, 2026
29 checks passed
@gottesmm gottesmm deleted the pr-849a5ddba4414614623295a89cfb38ff3ec826d4 branch January 28, 2026 17:14
@gottesmm
Copy link
Copy Markdown
Contributor Author

@stmontgomery Yes. Please change it when your change lands. I am trying to just start this so that compiler engineers have the tools needed to debug this stuff without needing to bug you all

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build 🧱 Affects the project's build configuration or process documentation 📚 Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants