Muir Manders 09058ab085 internal/lsp/source/completion: add postfix snippet completions ... Postfix snippets are artificial methods that allow the user to compose common operations in an "argument oriented" fashion. For example, instead of "sort.Slice(someSlice, ...)" a user can expand "someSlice.sort!". The snippet labels end in "!" to make it clearer they do something potentially unexpected. The postfix snippets have low scores so they should not interfere with normal completions. The snippets are represented (almost) entirely as Go text/template templates. This way the user can create custom snippets to match their general preferences or to capture common patterns in their codebase. There is currently no way for the user to create snippets, but it could be accomplished with a configuration file, custom LSP command, or similar. I started by implementing a variety of snippets to help flesh out the various facilities needed by the templates. The most interesting template capabilities are: - The ability to import packages as necessary (e.g. "sort" must be imported to call sort.Slice()). - The ability to generate unique variable names to avoid accidental shadowing issues. - The ability to weave LSP snippets into the template. Currently, only {{.Cursor}} is exposed, which corresponds to the snippet's final tab stop. Briefly, these are the postfix snippets in this commit: - foo.sort => sort.Slice(foo, func(...){}) (slices) - foo.last => foo[len(foo)-1] (slices) - foo.reverse (slices) - foo.range => for i, v := range foo {} (slices/maps) - foo.append This snippet inserts a self-assignment append statement when appropriate, otherwise just an append expression. - foo.copy creates a copy of a slice - foo.clear empties out a map - foo.keys creates slice of keys - foo().var assigns result value(s) to variables - foo.print prints foo to stdout Some of these are probably not very useful in practice, and I'm sure there are lots of great ones I didn't think of. Updates golang/go#39507. Change-Id: I9ecc748aa79c0d47fa6ff72d4ea671e917a2d5d6 Reviewed-on: https://go-review.googlesource.com/c/tools/+/272586 Run-TryBot: Muir Manders <muir@mnd.rs> gopls-CI: kokoro <noreply+kokoro@google.com> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Heschi Kreinick <heschi@google.com> Reviewed-by: Rebecca Stambler <rstambler@golang.org>		2021-03-29 17:27:46 +00:00
..
snippet_builder.go	internal/lsp/source/completion: add postfix snippet completions	2021-03-29 17:27:46 +00:00
snippet_builder_test.go	internal/lsp: offer type converted completion candidates	2020-11-30 20:04:59 +00:00