Awesome

gopher.nvim

Minimalistic plugin for Go development in Neovim written in Lua.

It's NOT an LSP tool, the main goal of this plugin is to add go tooling support in Neovim.

If you want to use new and maybe undocumented, and unstable features you might use develop branch.

Install (using lazy.nvim)

Pre-dependency:

Go
go treesitter parser, install by :TSInstall go

{
  "olexsmir/gopher.nvim",
  ft = "go",
  -- branch = "develop", -- if you want develop branch
                         -- keep in mind, it might break everything
  dependencies = {
    "nvim-lua/plenary.nvim",
    "nvim-treesitter/nvim-treesitter",
    "mfussenegger/nvim-dap", -- (optional) only if you use `gopher.dap`
  },
  -- (optional) will update plugin's deps on every update
  build = function()
    vim.cmd.GoInstallDeps()
  end,
  ---@type gopher.Config
  opts = {},
}

Configuratoin

[!IMPORTANT]

If you need more info look :h gopher.nvim

Take a look at default options

require("gopher").setup {
  commands = {
    go = "go",
    gomodifytags = "gomodifytags",
    gotests = "gotests",
    impl = "impl",
    iferr = "iferr",
    dlv = "dlv",
  },
  gotests = {
    -- gotests doesn't have template named "default" so this plugin uses "default" to set the default template
    template = "default",
    -- path to a directory containing custom test code templates
    template_dir = nil,
    -- switch table tests from using slice to map (with test name for the key)
    -- works only with gotests installed from develop branch
    named = false,
  },
  gotag = {
    transform = "snakecase",
  },
}

Features

<details> <summary> Install plugin's go deps </summary>

:GoInstallDeps

This will install the following tools:

</details> <details> <summary> Add and remove tags for structs via <a href="https://github.com/fatih/gomodifytags">gomodifytags</a> </summary>

By default json tag will be added/removed, if not set:

" add json tag
:GoTagAdd json

" remove yaml tag
:GoTagRm yaml

-- or you can use lua api
require("gopher").tags.add "xml"
require("gopher").tags.rm "proto"

</details> <details> <summary> Generating tests via <a href="https://github.com/cweill/gotests">gotests</a> </summary>

" Generate one test for a specific function/method(one under cursor)
:GoTestAdd

" Generate all tests for all functions/methods in the current file
:GoTestsAll

" Generate tests for only  exported functions/methods in the current file
:GoTestsExp

-- or you can use lua api
require("gopher").test.add()
require("gopher").test.exported()
require("gopher").test.all()

For named tests see :h gopher.nvim-gotests-named

</details> <details> <summary> Run commands like <code>go mod/get/etc</code> inside of nvim </summary>

:GoGet github.com/gorilla/mux

" Link can have an `http` or `https` prefix.
:GoGet https://github.com/lib/pq

" You can provide more than one package url
:GoGet github.com/jackc/pgx/v5 github.com/google/uuid/

" go mod commands
:GoMod tidy
:GoMod init new-shiny-project

" go work commands
:GoWork sync

" run go generate in cwd
:GoGenerate

" run go generate for the current file
:GoGenerate %

</details> <details> <summary> Interface implementation via <a href="https://github.com/josharian/impl">impl<a> </summary>

Syntax of the command:

:GoImpl [receiver] [interface]

" also you can put a cursor on the struct and run
:GoImpl [interface]

Usage examples:

:GoImpl r Read io.Reader
:GoImpl Write io.Writer

" or you can simply put a cursor on the struct and run
:GoImpl io.Reader

</details> <details> <summary> Generate boilerplate for doc comments </summary>

First set a cursor on public package/function/interface/struct and execute:

:GoCmt

</details> <details> <summary> Generate <code>if err != nil {</code> via <a href="https://github.com/koron/iferr">iferr</a> </summary>

Set the cursor on the line with err and execute

:GoIfErr

</details> <details> <summary> Setup <a href="https://github.com/mfussenegger/nvim-dap">nvim-dap</a> for go in one line </summary>

THIS FEATURE WILL BE REMOVED IN 0.1.6

note nvim-dap has to be installed

require("gopher.dap").setup()

</details>

Contributing