Skip to content

Latest commit

 

History

History
176 lines (137 loc) · 12.9 KB

README.md

File metadata and controls

176 lines (137 loc) · 12.9 KB

coc-go

Go language server extension using gopls for coc.nvim.

Install

In your vim/neovim, run command:

:CocInstall coc-go

Features

See gopls

Commands

Additional to commands provided by gopls, this extensions provides these commands:

Key Description
go.impl.cursor Generate interface stubs
go.install.gomodifytags Install / update gomodifytags
go.install.goplay Install / update goplay
go.install.gopls Install / update gopls
go.install.gotests Install / update gotests
go.install.impl Install / update impl
go.playground Run on go playground
go.tags.add Add tags to struct fields
go.tags.add.line Add tags to struct field in current line
go.tags.add.prompt Add tags to struct fields (prompt)
go.tags.clear Remove all tags from struct fields
go.tags.clear.line Remove all tags from struct fields in current line
go.tags.remove Remove tags from struct fields
go.tags.remove.line Remove tags from struct field in current line
go.tags.remove.prompt Remove tags from struct fields (prompt)
go.test.generate.exported Generate unit tests for exported functions in file
go.test.generate.file Generate unit tests for file
go.test.toggle Toggle test file
go.version Print extension version

Examples

  • Add or Remove specific tags

    CocCommand go.tags.add yaml
    CocCommand go.tags.add yaml json xml
    CocCommand go.tags.remove xml
    
  • Add missing imports on save

    autocmd BufWritePre *.go :call CocAction('runCommand', 'editor.action.organizeImport')
    
  • Map Keys to command

    autocmd FileType go nmap gtj :CocCommand go.tags.add json<cr>
    autocmd FileType go nmap gty :CocCommand go.tags.add yaml<cr>
    autocmd FileType go nmap gtx :CocCommand go.tags.clear<cr>
    

Snippets

Snippets are imported from microsoft/vscode-go and require coc-snippets to be installed.

Configuration options

Key Description Default
go.checkForUpdates EXPERIMENTAL Check for gopls updates on start.
go.disable Disable gopls features
‣ completion Disable completion feature (Change requires :CocRestart) false
‣ diagnostics Disable handle diagnostics (Change requires :CocRestart) false
‣ workspaceFolders Disable workspaceFolders feature (Change requires :CocRestart) false
go.enable Enable Go extension
go.goplsArgs Arguments passed to gopls (Change requires :CocRestart)
go.goplsOptions See gopls documentation
‣ analyses EXPERIMENTAL Analyses specify analyses that the user would like to enable or disable.
‣ buildFlags This is the set of flags passed on to the build system when invoked. It is applied to queries like go list, which is used when discovering files. The most common use is to set -tags.
‣ codelens EXPERIMENTAL
‣ completeUnimported EXPERIMENTAL If true, the completion engine is allowed to make suggestions for packages that you do not currently import. false
‣ completionDocumentation EXPERIMENTAL If false, indicates that the user does not want documentation with completion results. true
‣ deepCompletion EXPERIMENTAL If true, this turns on the ability to return completions from deep inside relevant entities, rather than just the locally accessible ones. true
‣ env This can be used to add environment variables. These will not affect gopls itself, but will be used for any external commands it invokes.
‣ fuzzyMatching EXPERIMENTAL If true, this enables server side fuzzy matching of completion candidates. true
‣ hoverKind This controls the information that appears in the hover text. SynopsisDocumentation
‣ linkTarget This controls where points documentation for given package in textDocument/documentLink. pkg.go.dev
‣ local This is the equivalent of the goimports -local flag, which puts imports beginning with this string after 3rd-party packages.
‣ matcher EXPERIMENTAL caseInsensitive
‣ staticcheck EXPERIMENTAL If true, it enables the use of the staticcheck.io analyzers.
‣ symbolMatcher EXPERIMENTAL caseInsensitive
‣ usePlaceholders If true, then completion responses may contain placeholders for function parameters or struct fields. false
go.goplsPath Path to gopls bin (Change requires :CocRestart)
go.tags
‣ options Comma separated tag=options pairs to be used by go.tags.add command json=omitempty
‣ skipUnexported If true, skip unexported fields false
‣ tags Comma separated tags to be used by go.tags.add command json
‣ transform Transformation rule used by go.tags.add command to add tags snakecase
go.tests
‣ generateFlags Additional command line flags to pass to gotests for generating tests. []
go.trace.server Trace level of gopls

Trigger completion in coc-settings.json to get complete list.

Example Configuration

{
  "go.goplsOptions": {
    "completeUnimported": true
  }
}

Development

  1. Run yarn build or yarn build:watch
  2. Run yarn run link:add to link extension

TODO

  • Check for tool updates and prompt the the user

  • Add godoctor refactor commands

    {
      "command": "go.godoctor.extract",
      "title": "Extract to function"
    },
    {
      "command": "go.godoctor.variable",
      "title": "Extract to variable"
    }
    
  • Add fillstruct command

    {
      "command": "go.fill.struct",
      "title": "Fill struct"
    }
    

Tools

FAQ

How does coc-go compare to vim-go?**

With coc-go I do not aim to recreate the features of vim-go. For now, the main goal is to provide a convenient way to install gopls and use it with coc.nvim.

If you need more than the features provided by gopls, you are probably better of with vim-go or govim.

License

MIT © Josa Gesell