Awesome

Goldsmith

Go development environment for Neovim utilizing the builtin LSP and other features and plugins specific to Neovim.

Features

view all screencasts here

codelens support screencast
inlay hints support screenshots - you need to have gopls 0.9.0 or greater for this to work
flag and update out-of-date dependencies in your current Go module screencast
automatically run goimports on save screencast
auto-highlight the current symbol under the cursor throughout the current buffer screencast
treesitter navigation utilizing the nvim-treesitter-textobjects plugin
treesitter text objects utilizing the nvim-treesitter-textobjects plugin
convert JSON to Go structs directly in your code, or paste from outside the editor screencast
view Go documentation using the :GoDoc command and Go help with :GoHelp screencast
context sensitive help with either :GoContextHelp or via a keybinding
manually update imports using the :GoImports command screencast
use :checkhealth to see if your Goldsmith setup should work correctly screencast
format your code on demand using :GoFormat or have Goldsmith automatically format your code on save screencast
integration with Telescope for a number of file picking needs screencast
run extra linters and/or formatters using null-ls: currently has support for golines, gofmt, gofumpt, revive, golangci-lint, and staticcheck
see the source of the diagnostic when running extra linters
Goldsmith can completely configure everything for you, if you want (see the Configurations wiki for more)
generate test stubs automatically using gotests screencast
create implementation stubs for your interfaces using :GoImpl screencast
:GoFillStruct utilizes LSP to fill the current struct
switch to the 'alternate' file quickly screencast
struct tag editing: add / remove / update struct tags and options screencast
use common go subcommands from within Neovim with: :GoBuild, :GoInstall, :GoGet, :GoRun, and others screencast
coverage support: annotate the current buffer and store coverage data for all files affected screencast
statusline integration: see the status of running jobs and of coverage data for the current buffer screencast
edit the go.mod file from within Neovim with: :GoModTidy, :GoModCheck, :GoModRetract, :GoModReplace, and others
use the excellent builtin testing framework to run individual tests, package tests, or all your tests
all the great Neovim LSP functions are available as Vim commands
most commands are completely asynchronous
support for mason and nvim-lsp-installer

Keeping up-to-date / Releases

The main branch of Goldsmith attempts to keep up with the nightly releases of Neovim. It should always work with the most recent nightly release soon after its release. If you are always running the nightly version then you will probably want to use main at all times.

go versions should be either the most recent minor version or within one minor version of the most recent. So if the most recent go version is 1.18.3 this means Goldsmith should work with at least 1.17.0 and newer.

nvim-lspconfig should always be at or near the latest. A good faith effort will be made to help transition to versions of nvim-lspconfig that have major breakage, but cannot be guaranteed. Please ask a question or report a problem if you think that we can do a better job or if you are having a problem.

gopls should always be very recent if you wish to follow the main branch. It does not necessarily need to be the most recent but should be within one minor version of the most recent.

Other dependencies, such as null-ls, mason, or nvim-lsp-installer, will be handled as problems occur (which is rare).

Starting with Neovim 0.8.0, for every stable release of Neovim, there will be a branch and tag that are created, named after that release (e.g. Neovim 0.8.0 will have a branch named stable-nvim-0.8.0 and a tag named stable-0.8.0). This branch and tag will be known to work with that version of Neovim. Occasional updates may be made to this branch/tag but will not have the churn of main.

If you discover that any of the above is not the case, or you find it confusing, please consider asking a question or reporting a problem.

Requirements

Goldsmith will not work with Vim or versions of Neovim prior to 0.5.0.

There are a number of third-party programs required by Goldsmith:

go - you must have this installed for Goldsmith to function as expected
gopls - it is recommended to use mason to install and maintain gopls
various - run :GoInstallBinaries to install needed third-party programs

Run :checkhealth goldsmith after installing and running through the Quickstart to see if anything has been missed and what needs to be done to meet the minimal requirements.

Installation

Install using your favorite plugin manager.

If you use vim-plug:

Plug 'WhoIsSethDaniel/goldsmith.nvim'

Or if you use Vim 8 style packages:

cd <plugin dir>
git clone https://github.com/WhoIsSethDaniel/goldsmith.nvim

Quickstart

Install Go.
Install Goldsmith, lspconfig, treesitter and null-ls.
Install required external programs:
```
nvim +GoInstallBinaries
```
You may receive some warnings from Goldsmith about missing programs. These can be ignored since you are now installing those programs.

After the installation completes (usually within a minute or so) run
```
:checkhealth goldsmith
```
Make certain everything looks okay.
Restart Neovim.
Start editing Go code.
Currently you are running with Goldsmith defaults. So take a look at the documentation and tweak your configuration.

Configuration

See the configuration page on the wiki for examples demonstrating how to configure Goldsmith.

Also see the Goldsmith :help documentation or after installing Goldsmith by using :h goldsmith.

Reporting Problems / Asking Questions

Goldsmith is very new. It works for the author, but does it work for you? If not, please consider asking a question or reporting a problem.