GoTools
Golang integration for Sublime Text 3
Details
Installs
- Total 13K
- Win 5K
- Mac 5K
- Linux 3K
Oct 12 | Oct 11 | Oct 10 | Oct 9 | Oct 8 | Oct 7 | Oct 6 | Oct 5 | Oct 4 | Oct 3 | Oct 2 | Oct 1 | Sep 30 | Sep 29 | Sep 28 | Sep 27 | Sep 26 | Sep 25 | Sep 24 | Sep 23 | Sep 22 | Sep 21 | Sep 20 | Sep 19 | Sep 18 | Sep 17 | Sep 16 | Sep 15 | Sep 14 | Sep 13 | Sep 12 | Sep 11 | Sep 10 | Sep 9 | Sep 8 | Sep 7 | Sep 6 | Sep 5 | Sep 4 | Sep 3 | Sep 2 | Sep 1 | Aug 31 | Aug 30 | Aug 29 | Aug 28 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 2 | 1 | 0 | 1 | 0 | 0 | 1 | 0 | 2 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 2 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 1 |
Mac | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 4 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
:warning: This project is no longer maintained. :warning:
I recommend Visual Studio Code with the vscode-go extension for a nicer Go programming experience.
GoTools
GoTools is a Go programming language plugin for Sublime Text 3 inspired by vim-go. Rather than attempting to reinvent various supporting IDE components, it provides integration with existing community-supported tools.
Features
- Jump to symbol/declaration (using your choice of oracle or godef)
- Format and syntax check on save, including gutter marks (using gofmt)
- Autocompletion (using gocode)
- Build and test integration
- Source analysis (using oracle)
- Identifier renaming (using gorename)
- Improved syntax support (borrowed from GoSublime)
Prerequisites
GoTools will attempt to find all external Go tools (oracle
, gofmt
, gocode
, etc.) using GOPATH
and GOROOT
(not PATH
). If you don't have these binaries, use go get
to install them:
go get -u -v github.com/nsf/gocode
go get -u -v github.com/rogpeppe/godef
go get -u -v golang.org/x/tools/cmd/goimports
go get -u -v golang.org/x/tools/cmd/oracle
go get -u -v golang.org/x/tools/cmd/gorename
GoTools is only tested with Go 1.4. Note that gofmt
is now included with the Go distribution, and any gofmt
installed to GOPATH
is likely from an old Go version and should probably be removed.
Installing
The easiest way to install GoTools is to use Package Control. Simply install Package Control, and then install the “GoTools” package using Package Control: Install Package
from the command palette.
If you want to install GoTools manually, download the latest release and extract it to ~/.config/sublime-text-3/Packages/GoTools
on Linux, or ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/GoTools
on OSX.
Configuring GoTools
Create a GoTools settings file through the Sublime Text preferences menu at Package Settings -> GoTools -> Settings -> User
.
Default settings are provided and can be accessed through the Sublime Text preferences menu at Package Settings -> GoTools -> Settings - Default
. Each option is documented in the settings file itself.
Configuring Your Project
Create a GoTools
settings key in a Sublime Text .sublime-project
file (through the menu at Project -> Edit Project
).
A documented example project file is provided.
Using GoTools
NOTE: Most GoTools commands are available via the Sublime Text command palette. Open the palette when viewing a Go source file and search for “GoTools” to see what's available.
Many of the build commands are also available via the context menu.
Format on Save
GoTools will format Go source buffers each time they're saved. To disable automatic formatting, set format_on_save
in your GoTools settings.
Here's an example key binding which formats a source file when <ctrl>+<alt>+f
is pressed:
{"keys": ["ctrl+alt+f"], "command": "gotools_format"}
By default gofmt is used for formatting. To change the backend, set format_backend
in your GoTools settings. goimports is also available, as well as the option to first run goimports, then gofmt. This third option is useful when you want the automatic import resolution as well as the simplification (-s
) feature from gofmt at the same time.
Go to Definition
GoTools provides a gotools_goto_def
Sublime Text command which will jump to the symbol definition at the cursor.
Here's an example key binding which will go to a definition when <ctrl+g>
is pressed:
{"keys": ["ctrl+g"], "command": "gotools_goto_def"}
Here's an example sublime-mousemap
entry which will go to a definition using <ctrl>+<left mouse>
:
{"button": "button1", "count": 1, "modifiers": ["ctrl"], "command": "gotools_goto_def"}
By default godef is used for definition support. To change the backend, set goto_def_backend
in your GoTools settings.
Autocomplete
GoTools integrates the Sublime Text autocompletion engine with gocode.
Here's an example key binding which autocompletes when <ctrl>+<space>
is pressed:
{"keys": ["ctrl+space"], "command": "auto_complete"}
When suggestions are available, a specially formatted suggestion list will appear, including type information for each suggestion.
To disable autocompletion integration, set autocomplete
in your GoTools settings.
Builds
GoTools integrates the Sublime Text build system with go build
.
Activate the GoTools build system from the Sublime Text menu by selecting it from Tools -> Build System
. If the build system is set to Automatic
, GoTools will be automatically used for builds when editing Go source files.
There are several ways to perform a build:
- From the Sublime Text menu at
Tools -> Build
- A key bound to the
build
command - The command palette, as
Build: Build
A “Clean Build” command variant is also provided which recursively deletes all GOPATH/pkg
directory contents prior to executing the build as usual.
Build results are placed in the Sublime Text build output panel which can be toggled with a command such as:
{ "keys" : ["ctrl+m"], "command" : "show_panel" , "args" : {"panel": "output.exec", "toggle": true}},
Here's an example key binding which runs a build when <ctrl>+b
is pressed:
{ "keys": ["ctrl+b"], "command": "build" },
Here's an example key binding which runs “Clean Build” when <ctrl>+<alt>+b
is pressed:
{ "keys": ["ctrl+alt+b"], "command": "build", "args": {"variant": "Clean Build"}},
Tests
GoTools integrates the Sublime Text build system with go test
.
GoTools attempts to “do what you mean” depending on context. For instance, when using “Run Test at Cursor” in a test file which requires an integration
Go build tag, GoTools will notice this and automatically add -tags integration
to the test execution.
The following GoTools build variants are available:
Variant | Description |
---|---|
Run Tests | Discovers test packages based on the project_package and test_packages settings relative to the project gopath and executes them. |
Run Test at Cursor | Runs a single test method at or surrounding the cursor. |
Run Current Package Tests | Runs tests for the package containing the current file. |
Run Tagged Tests | Like “Run Tests” but for the packages specified in the tagged_packages setting. |
Run Last Test | Runs the last test variant that was executed. |
Test results are placed in the built-in Sublime Text build output panel which can be toggled with a command such as:
{ "keys" : ["ctrl+m"], "command" : "show_panel" , "args" : {"panel": "output.exec", "toggle": true}},
Here's an example key binding which runs the test at the cursor when <ctrl>+<alt>+t
is pressed:
{ "keys": ["ctrl+alt+t"], "command": "build", "args": {"variant": "Run Test at Cursor"}},
Replace variant
in the command with any variant name from the preceding table for other bindings.
Oracle Analysis (experimental)
GoTools integrates Sublime Text with oracle. Oracle is invoked with the gotools_oracle
Sublime Text command.
Here's an example which runs the oracle “implements” command when <ctrl+alt+i>
is pressed:
{ "keys" : ["ctrl+alt+i"], "command" : "gotools_oracle" , "args" : {"command": "implements"}},
The following oracle operations are supported as arguments to the gotools_oracle
command:
Command | Notes |
---|---|
callers | Slow on large codebases. |
callees | Slow on large codebases. |
callstack | Slow on large codebases. |
describe | |
freevars | Requires a selection. |
implements | |
peers | |
referrers |
Oracle results are placed in a Sublime Text output panel which can be toggled with a command such as:
{ "keys" : ["ctrl+m"], "command" : "show_panel" , "args" : {"panel": "output.gotools_oracle", "toggle": true}},
Rename (experimental)
GoTools provides a gotools_rename
command supported by gorename which supports type-safe renaming of identifiers.
When the gotools_rename
command is executed, an input panel labeled Go rename:
will appear. Rename results are placed in a Sublime Text output panel which can be toggled with a command such as:
{ "keys" : ["ctrl+m"], "command" : "show_panel" , "args" : {"panel": "output.gotools_rename", "toggle": true}},
Important: The gorename
tool writes files in-place with no option for a dry-run. Changes might be destructive, and the tool is known to have bugs.
Gocode Caveats
Important: Using gocode support will modify the lib-path
setting in the gocode daemon. The change will affect all clients, including other Sublime Text sessions, Vim instances, etc. Don't use this setting if you're concerned about interoperability with other tools which integrate with gocode.
Some projects make use of a dependency isolation tool such as Godep, and many projects use some sort of custom build script. Additionally, gocode uses a client/server architecture, and at present relies on a global server-side setting to resolve Go package paths for suggestion computation. By default, gocode will only search GOROOT
and GOPATH/pkg
for packages, which may be insufficient if the project compiles source to multiple GOPATH
entries (such as Godeps/_workspace/pkg
).
With such a project, to get the best suggestions from gocode, it's necessary to configure the gocode daemon prior to client suggestion requests to inform gocode about the locations of compiled packages for the project.
GoTools will infer the correct gocode lib-path
by constructing a path which incorporates all project GOPATH
entries.
GoSublime Caveats
Installing GoTools alongside GoSublime isn't tested or supported, so YMMV.