Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Golang plugin collection for the text editor SublimeText 2 providing code completion and other IDE-like features.
Go Python
branch: master
Failed to load latest commit information.
articles * misc cleanup
doc fix formatting
gosubl Merge branch 'master' of github.com:DisposaBoy/GoSublime
settings * add comment setting fixes #298
something_borrowed * miss-renamed
src/gosubli.me add support for the go1.4 src/pkg change
ss - add 2 screenshots
syntax * close #416
.no-sublime-package ?
9o.hidden-tmLanguage * misc tweaks; fixes #180
9o.hidden-tmLanguage.json * misc tweaks; fixes #180
9o.md * clarify the interaction between the pre-defined env vars and the us…
AUTHORS.md Update AUTHORS.md
CHANGELOG.md * ann
Default (Linux).sublime-keymap ...
Default (Linux).sublime-mousemap
Default (OSX).sublime-keymap ...
Default (OSX).sublime-mousemap * track mouse clicks globally
Default (Windows).sublime-keymap ...
Default (Windows).sublime-mousemap
GoSublime-next.tmLanguage * add fallbacks for the old syntax files
GoSublime.py * show the exception when exec fails to load about.py
GoSublime.sublime-build * make build_command configurable
GoSublime.sublime-commands * fix opening the wrong error log
GoSublime.sublime-settings * sync sh.py with gs-next
GoSublime.tmLanguage * add fallbacks for the old syntax files
GoSublime.tmLanguage.json Rename new tmLanguage file.
GsDoc.hidden-tmLanguage * rename tmlanguage files to remove them the menus
LICENSE.md - misc
Main.sublime-menu * fix opening the wrong error log
Preferences.sublime-settings - add global prefs... add dot(.) to trigger autocompletion
README.md Typos in README.md
THANKS.md Add Sander van Harmelen
USAGE.md Cleaning USAGE.md
gs9o.py tmp: add a command that opens 9o and runs each specified command
gscommands.py * fix missing callback arg
gscomplete.py * close #457: make caltips more like func decls
gsdoc.py fix python unicode length problem
gsev.py * close #340 . sync the settings in all files
gslint.py * handle <stdin> special-case
gspalette.py * use pkgpaths to implements the pkg list in m_import_paths
gssynforce.py :|
gstest.py close #459

README.md

GoSublime

Click here to lend your support to: GoSublime and make a donation at www.pledgie.com !

Intro

GoSublime is a Golang plugin collection for the text editor SublimeText providing code completion and other IDE-like features. Both Sublime Text versions 2 and 3 are supported.

Features

  • code completion from Gocode
  • context aware snippets via the code-completion popup to complement the existing SublimeText Go package.
  • sublime build system(ctrl+b) integrating with GoSublime 9o command prompt
  • lint/syntax check as you type
  • quickly jump to any syntax error reported (and jump back to where you were before (across files))
  • quickly fmt your source or automatically on save to conform with the Go standards
  • easily create a new go file and run it without needing to save it first (9o replay)
  • share your snippets (anything in the loaded file) on play.golang.org
  • list declarations in the current file
  • automatically add/remove package imports
  • quickly jump your import section(automatically goes to the last import) where you can easily edit the pkg alias and return to where you were before
  • go to definition of a package function or constant, etc.
  • show the source(and thus documentation) of a variable without needing to change views

Demo

Installation

Sublime Package Control allows you to easily install or remove GoSublime (and many other ST2 packages) from within the editor. It offers automatically updating packages as well so you no longer need to keep track of changes in GoSublime.

  1. Install Sublime Package Control (if you haven't done so already) from http://wbond.net/sublime_packages/package_control . Be sure to restart ST2 to complete the installation.

  2. Bring up the command palette (default ctrl+shift+p or cmd+shift+p) and start typing Package Control: Install Package then press return or click on that option to activate it. You will be presented with a new Quick Panel with the list of available packages. Type GoSublime and press return or on its entry to install GoSublime. If there is no entry for GoSublime, you most likely already have it installed.

Usage

Please see USAGE.md and 9o.md for general usage and other tips for effective usage of GoSublime

NOTE GoCode is entirely integrated into GoSublime/MarGo. If you see any bugs related to completion, assume they are GoSublime's bugs and I will forward bug reports as necessary.

Settings

You can customize the behaviour of GoSublime by creating a settings file in your User package. This can be accessed from within SublimeText by going to the menu Preferences > Browse Packages.... Create a file named GoSublime.sublime-settings or alternatively copy the default settings file Packages/GoSublime/GoSublime.sublime-settings to your User package and edit it to your liking.

Note: File names are case-sensitive on some platforms (e.g. Linux) so the file name should be exactly GoSublime.sublime-settings with capitalization preserved.

Completion Markers

The following letters are used as suffix for entries in the completion list.

  • ʂ - Snippets. These snippets are provided by GoSublime and should not be confused with SublimeText's snippets. Furthermore, they are context sensitive, therefore the snippets provided in the global scope will be different to those provided in function scope.

  • ν - Variables

  • ʈ - User-defined types, structs, maps, slices, etc.

  • Ɩ - Constants

  • ƒ - Functions

  • ρ - Packages

Copyright, License & Contributors

GoSublime and MarGo are released under the MIT license. See LICENSE.md

GoSublime is the copyrighted work of The GoSublime Authors i.e me (https://github.com/DisposaBoy/GoSublime) and all contributors. If you submit a change, be it documentation or code, so long as it's committed to GoSublime's history I consider you a contributor. See AUTHORS.md for a list of all the GoSublime authors/contributors.

GoSublime bundles several dependencies, these all reside under the directory tree something_borrowed/ and are the copyright of their respective authors.

Supporters

GoSublime has received support from many kind individuals and as a thank you I've added most to THANKS.md file as a way of saying Thank You. Some donors donated anonymously and so are not listed, however, if you donated and either I have not yet sent you an email personally thanking you or you would otherwise like to be added, please don't hesitate to contact me disposaboy@dby.me

Something went wrong with that request. Please try again.