go-imports-rename

Tool to change import paths

Important case

• Important case is to append suffix to existing path, i.e. to grow gitlab.example.com/common/utils into gitlab.example.com/common/utils/v2

  use

  go-imports-rename 'gitlab.example.com/common/utils/ ++' 
  

  to grow gitlab.example.com/common/utils/package into gitlab.example.com/common/utils/v2/package

Usage examples

• Simple usage. Please do not use it for import paths upgrade from version below 2. Use ++ operator instead.

  go-imports-rename 'github.com/rsz/ => github.com/rs/' 
  

  will list all possible import path changes with given prefix github.com/rsz/ in Go files in current directory and all its subdirectories. No saves will be done.

• Use --save flag to commit these changes:

  go-imports-rename --save 'github.com/rsz/ => github.com/rs/' 
  

• Use --root flag to diagnose or make changes in specific directory:

  go-imports-rename --root $GOPATH/src 'github.com/rsz/ => github.com/rs/' 
  

  Will diagnose changes in $GOPATH/src

• There is a shortcut for the fresh v1.x.y ⇒ v2.α.β migrations:

  go-imports-rename 'github.com/user/project ++' 
  

  It is an equivalent for

  go-imports-rename 'github.com/user/project/ => github.com/user/project/v2/'
  

  In this case the utility takes care of paths and will not replace github.com/user/projectNext. Also, github.com/user/project/v2 won't change. You can also move from v2 to v3 in the same way

  go-imports-rename 'github.com/user/project/v2 ++'
  

• You can jump through several migrations:

  go-imports-rename 'github.com/user/project += 5'
  

  It is an equivalent for

  go-imports-rename 'github.com/user/project/ => github.com/user/project/v6'
  

• Use // operator to imports rename with regular expression

  go-imports-rename '^gen/(.*)$ // gitlab.example.com/common/schema/$1' 
  

  will diagnose possible gen/common and similar imports changes into gitlab.example.com/common/schema/common, etc