x/tools/gopls: Hover: display package-level constants for selected type

[soypat]

gopls version

$ gopls -v version
Build info

golang.org/x/tools/gopls v0.18.0
golang.org/x/tools/gopls@v0.18.0 h1:oBmnrmi0Uk7Ea+ZPK16BdcjnpEJX8ciBCSp9S90GULo=
github.com/BurntSushi/toml@v1.4.1-0.20240526193622-a339e1f7089c h1:pxW6RcqyfI9/kWtOwnv/G+AzdKuy2ZrqINhenH4HyNs=
github.com/google/go-cmp@v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
golang.org/x/exp/typeparams@v0.0.0-20241210194714-1829a127f884 h1:1xaZTydL5Gsg78QharTwKfA9FY9CZ1VQj6D/AZEvHR0=
golang.org/x/mod@v0.23.0 h1:Zb7khfcRGKk+kqfxFaP5tZqCnDZMjC5VtUBs87Hr6QM=
golang.org/x/sync@v0.11.0 h1:GGz8+XQP4FvTTrjZPzNKTMFtSXH80RAzG+5ghFPgK9w=
golang.org/x/telemetry@v0.0.0-20241220003058-cc96b6e0d3d9 h1:L2k9GUV2TpQKVRGMjN94qfUMgUwOFimSQ6gipyJIjKw=
golang.org/x/text@v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM=
golang.org/x/tools@v0.30.1-0.20250220174815-31e3bb2b8fd1 h1:4+it9JYqVd2wIAapscAb5mUAI1yHY0u4B4idYPigWeE=
golang.org/x/vuln@v1.1.3 h1:NPGnvPOTgnjBc9HTaUx+nj+EaUYxl5SJOWqaDYGaFYw=
honnef.co/go/tools@v0.5.1 h1:4bH5o3b5ZULQ4UrBmP+63W9r7qIkqJClEA9ko5YKx+I=
mvdan.cc/gofumpt@v0.7.0 h1:bg91ttqXmi9y2xawvkuMXyvAA/1ZGJqYAEGjXuP0JXU=
mvdan.cc/xurls/v2@v2.5.0 h1:lyBNOm8Wo71UknhUs4QTFUNNMyxy2JEIaKKo0RWOh+8=
go: go1.24.0

go env

N/A

What did you do?

Moused over the type time.Duration

What did you see happen?

Type declaration, type documentation comment, type method set displayed.

What did you expect to see?

See a list of time package defined constants of type time.Duration as well as what is already provided. Probably not of all constants, 6 or so would be already helpful to get an idea of the type's use.

Editor and settings

No response

Logs

No response

[gabyhelp]

Related Issues

• x/tools/gopls: add method documentation & jump to page source to hovered type. #66721 (closed)
• x/tools/gopls: Incorrect result of `unsafe.Sizeof` for time.Time type. #59757 (closed)
• x/tools/gopls: Wrong completion for int * time.Duration #58944 (closed)
• x/tools/gopls: broken hovering in the builtin file #68026 (closed)

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

[findleyr]

Thanks for the issue.

I'm not sure this would be universally useful. The way to find usage of a type is to find references, though in the case of time.Duration, that may be noisy.

It is important that hover information be succinct, and mixing in usage information seems counter to that goal.

[soypat]

Maybe it makes more sense for the special case of enum-like constants defined with = iota. So think of time.Weekday