Skip to content

[Debug] Rename DebugDescription fallback property to lldbDescription #75305

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Conversation

kastiglione
Copy link
Contributor

@kastiglione kastiglione commented Jul 17, 2024

From feedback, replace the name _debugDescription, which was confusing because of the underscore, with lldbDescription. This new name also indicates that this property may contain LLDB Summary Strings.

@kastiglione kastiglione requested a review from a team as a code owner July 17, 2024 20:54
@kastiglione
Copy link
Contributor Author

@swift-ci test

@kastiglione
Copy link
Contributor Author

@swift-ci test

kastiglione added a commit that referenced this pull request Jul 25, 2024
…75289)

  - **Explanation**:
From feedback, replace the name `_debugDescription`, which was confusing because of the 
underscore, with `lldbDescription`.
  - **Scope**:
This will not break existing code. Any existing uses of `_debugDescription` would see 
that the debugger does not produce a summary string, but would still display all 
fields/children of a value.
  - **Original PRs**:
#75305
  - **Risk**:
Early adopters of `_debugDescription` will not see their summary string shown.
  - **Testing**:
Swift tests, CI.
  - **Reviewers**:
@hborla, @stephentyrone, @DougGregor
@kastiglione kastiglione merged commit abe697f into main Jul 29, 2024
5 checks passed
@kastiglione kastiglione deleted the dl/main/Debug-Rename-DebugDescription-fallback-property-to-lldbDescription branch July 29, 2024 18:10
kastiglione added a commit that referenced this pull request Jul 30, 2024
When using `@DebugDescription`, only allow use of [LLDB Summary 
Strings](https://lldb.llvm.org/use/variable.html#summary-strings) syntax from 
`lldbDescription` properties. When `@DebugDescription` is applied to existing 
`debugDescription` properties, escape any `$`, as the output of `debugDescription` is 
never interpreted by LLDB.

Depends on #75305
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants