ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Go​Rename

by alvarolm ST3

GoRename is a Golang plugin for SublimeText 3 that integrates the Go gorename tool.

Labels go, gorename

Details

Installs

  • Total 1K
  • Win 444
  • OS X 528
  • Linux 311
Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 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
Windows 0 0 1 0 0 0 0 0 0 0 0 1 0 0 0 0 1 0 1 0 0 0 1 1 0 0 0 0 4 0 1 0 0 0 0 0 0 1 1 0 1 0 0 0 1 1
OS X 0 0 0 1 3 0 0 1 0 0 0 0 0 1 0 0 1 0 0 0 0 2 0 0 0 0 2 1 1 1 0 1 0 5 0 0 2 0 0 0 0 1 0 0 5 1
Linux 0 0 1 0 0 0 0 0 2 1 1 0 0 0 0 0 0 0 0 0 0 0 1 0 1 1 0 0 1 0 1 2 0 0 0 0 0 0 0 0 0 1 0 1 1 0

Readme

Source
raw.​githubusercontent.​com

donate

GoRename documentation

GoRename is a Golang plugin for SublimeText 3 that integrates the Go gorename tool.

The gorename command performs precise type-safe renaming of identifiers in Go source code.

useful for refactoring.

(based on previus work from waigani)

Usage

1) Place the cursor over the identifier you want to rename (could be a variable, method, etc.).

2) press CTRL+ALT+R, then using the up and down keys select the optional flags to be used with ENTER, once you're done press ESC or click away.

3) type the new name and press ENTER.

4) review the parameters and press ENTER again to confirm and execute the gorename tool.

(If by any chance the results panel disappears just press CTRL+SHIFT+ALT+R)

configurable flags: “ -force causes the renaming to proceed even if conflicts were reported. The resulting program may be ill-formed, or experience a change in behaviour.

WARNING: this flag may even cause the renaming tool to crash.
       (In due course this bug will be fixed by moving certain
       analyses into the type-checker.)

-d display diffs instead of rewriting files

-v enables verbose logging.

Install
-------

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

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 'GoRename' and press return or click on its entry to install GoRename. If there is no entry for 'GoRename', you most likely already have it installed.

GoOracle has several variables to be set in order to work. These are explained in the comments of the default settings `Preferences > Package Settings > GoOracle > Settings-Default`:

```javascript
{
  // rename files that had been modified after the 'go_rename' command has been executed.
  // (DO NOT set to true unless you want a renaming nightmare)
  "gorename_rename_modified_files": false,

  // use golangconfig, if false then shellenv will be used to get golang environment variables
  "gorename_use_golangconfig": false,

  // fill variable name text field by default
  "gorename_autofill": false,

  // The output can either be one of: 'buffer', 'output_panel'
  // Buffers can hold results from more than one invocation
  // Output panels sit underneath the editor area and are easily dismissed
  "gorename_output": "output_panel",

  // print debug info to the terminal
  "gorename_debug": false,

  // env overwrites the default shell environment vars
  // e.g "env": { "GOPATH": "$HOME/go/bin:$PATH" }
  // not used when gorename_use_golangconfig is set to true
  "gorename_env": {},
}

You set your own variables in Preferences > Package Settings > GoRename > Settings-User.

You can also make project specific settings. First save your current workspace as a project Project > Save as project ..., then edit your project Project > Edit Project. Below is an example which sets up GoOracle to be used on the github.com/juju/juju codebase:

{
    "folders":
    [
        {
            "follow_symlinks": true,
            "path": "/home/user/go/src/github.com/juju/juju"
        }
    ],
    "settings":
    {
        "GoRename": {
            "gorename_scope": ["github.com/juju/juju/cmd/juju", "github.com/juju/juju/cmd/jujud"],
            "output": "output_panel"
        }
    },
}

Default key binding:

[
    { "keys": ["ctrl+alt+r"], "command": "go_rename"},
    { "keys": ["ctrl+alt+shift+r"], "command": "go_rename_show_results"},

    { "keys": ["enter"], "command": "go_rename_confirm", "context": 
    [{ "key": "selector", "operator": "equal", "operand": "text.gorename-results" }]
    }
]

You can set your own key binding by copying the above into Preferences > Keybindings - User and replacing ctrl+shift+g with your preferred key(s).

Dependencies

GoRename relies on the gorename tool. You must install it in order for Gorename to work. Run the following on your command line:

go get -u golang.org/x/tools/cmd/gorename

Copyright, License & Contributors

GoRename is released under the MIT license. See LICENSE.md

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