Skip to content
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

Show diagnostics popup when hovering over gutter icons #2349

Merged
merged 4 commits into from
Nov 9, 2023

Conversation

jwortmann
Copy link
Member

This will show a popup with all diagnostics from the line (except hint severity), sorted by severity, when you hover over a gutter icon. It is compatible with the code actions popup if applicable for the current caret position and using the "bulb" setting.

@jwortmann jwortmann force-pushed the diagnostics-icons-hover branch from 83f3faa to 6ab2241 Compare October 31, 2023 15:56
@jwortmann jwortmann force-pushed the diagnostics-icons-hover branch from 6ab2241 to c38f287 Compare October 31, 2023 16:00
content = ''
if self._lightbulb_line == self.view.rowcol(point)[0]:
content += code_actions_content(self._actions_by_config)
if userprefs().diagnostics_gutter_marker and userprefs().show_diagnostics_severity_level:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this the expected behavior?

1
"diagnostics_gutter_marker": "circle",
Screenshot 2023-10-31 at 22 59 16

If there are 2 diagnostics,
and diagnostics_gutter_marker is set to "circle"
display the diagnostics on gutter hover.

2
"diagnostics_gutter_marker": "",
Screenshot 2023-10-31 at 22 58 53

If there are 2 diagnostics,
and diagnostics_gutter_marker is set to ""
don't display the diagnostics on gutter hover.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In case 2 it doesn't show the diagnostics in addition to the code actions, because in general they can be unrelated to each other. But I'm not sure, maybe would be better to also see the diagnostics, what do you think? In that case it should probably only filter for the diagnostics which are overlapping the current caret position or selection.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I did it correctly, then the popup in your example 2 should show only the first diagnostic with small "d" now (where the caret is).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I did it correctly, then the popup in your example 2 should show only the first diagnostic with small "d" now (where the caret is).

That is correct.
I will see the diagnotics where the cursor is if I hover the gutter.

Screenshot 2023-11-04 at 22 37 35

But I am not sure I think that behavior is the best choice,
because I can already hover with the cursor over the diagnostics and see the diagnostic.
So it is kind of redudant.

it should probably only filter for the diagnostics which are overlapping the current caret position or selection.

For me it would be more intuitive
if hovering the gutter should show all diagnostics that just exist on the line. (not based on cursor or selection)

So my expected behavior would be the following:
if "diagnostics_gutter_marker": ""
If there are 2 diagnostics,
display the 2 diagnostics on gutter hover.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But I am not sure I think that behavior is the best choice,
because I can already hover with the cursor over the diagnostics and see the diagnostic.
So it is kind of redudant.

In this case with the diagnostic icons disabled it will show only the diagnostic(s) which is/are sent as part of the code action request (CodeActionContext). So there is a good chance that the code actions are related to the diagnostics at the cursor position, especially because we only show Quick Fix actions here. And the code actions request is sent for a particular range, so the actions should also be only applicable for the current cursor position.

You could consider the diagnostic from this screenshot to be part of the lightbulb hover, and the other diagnostics on the line or on different lines are not shown because the diagnostics gutter icons are disabled. I think it makes sense.

And I would not say that it is redundant, it's rather just a different way to see the diagnostic message. For example I have the code actions in the regular hover popup disabled, so I will never see them if I hover over the error underline.

plugin/documents.py Outdated Show resolved Hide resolved
@rchl rchl merged commit 0ef280f into sublimelsp:main Nov 9, 2023
4 checks passed
@jwortmann jwortmann deleted the diagnostics-icons-hover branch November 10, 2023 07:19
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.

3 participants