{"id":152392,"date":"2021-06-11T14:18:41","date_gmt":"2021-06-11T13:18:41","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=go&p=152392"},"modified":"2021-06-11T14:18:43","modified_gmt":"2021-06-11T13:18:43","slug":"how-to-increment-the-major-version-of-a-go-module-using-goland","status":"publish","type":"go","link":"https:\/\/blog.jetbrains.com\/en\/go\/2021\/06\/11\/how-to-increment-the-major-version-of-a-go-module-using-goland","title":{"rendered":"How to increment the major version of a go module using GoLand"},"content":{"rendered":"\n

Let’s look at the workflow of incrementing the major version of a module using the module definition taken from our What’s New in GoLand repository<\/a>:<\/p>\n\n\n\n

module renameab.le\/module\n\ngo 1.11<\/pre>\n\n\n\n
Upgrading a module means bumping the version tag in version control. We also need to change our import paths<\/strong>. For example, if to bump the module version from `v1` to `v2`, we need our imports changed from:<\/p>\n\n\n\n
"renameab.le\/module\/pkg\/log"<\/pre>\n\n\n\n
to<\/p>\n\n\n\n
"renameab.le\/module\/v2\/pkg\/log"<\/pre>\n\n\n\n
Obviously, this can appear in lots of places in the code. Good news: the IDE can do this for you.<\/p>\n\n\n\n
With the 2021.1 version of GoLand, you can use the Rename<\/em> refactoring to complete this workflow. To do this, place the cursor on the module’s name in the go.mod<\/em> file, in our example renameab.le\/module<\/em>, and invoke the Rename<\/em> refactoring via Shift+F6<\/em>. (You can also invoke the Rename<\/em> refactoring using the Refactor This<\/em> feature via Ctrl+Alt+Shift+T<\/em> on Windows\/Linux or Ctrl+T <\/em>on macOS.)<\/p>\n\n\n\n
<\/figure>\n\n\n\n
Pro tip:<\/strong> This will also update all references to the current module name across all the Go files, test or not. Click on the Preview<\/em> button to see where the change will take place.<\/p>\n\n\n\n
<\/figure>\n\n\n\n
Sometimes, as soon as you click Refactor<\/em>, you change your mind. “Oh no, now I have to find all those imports, file name changes, etc., and put them back.” Good news: the IDE can undo that entire editor transaction, including file changes and VCS operations.<\/p>\n\n\n\n
<\/figure>\n\n\n\n
Another reason to use this operation: as with any IDE refactoring, the Local History<\/a> can save you. Here’s how the Rename<\/em> operation looks like in the Local History<\/em>.<\/p>\n\n\n\n
\"\"\/<\/figure>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
Our IDEs are great at automating routine work. Here we saw how we could use the Rename<\/em> refactoring to make sure that we can safely and efficiently rename our modules when incrementing their major version. The Rename refactoring<\/a> can also change the name of identifiers, files, and folders. GoLand contains other refactoring features too, and you can find out more about them in this series of articles<\/a>.

Please let us know your feedback in the comments section below, on our issue tracker<\/a>, in the #goland channel of Gophers Slack<\/a>, or via our social media such as Twitter @GoLandIDE<\/a>.<\/p>\n","protected":false},"author":828,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","categories":[2347],"tags":[3919,91,659],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/go\/152392"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/go"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/types\/go"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/users\/828"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/comments?post=152392"}],"version-history":[{"count":10,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/go\/152392\/revisions"}],"predecessor-version":[{"id":153501,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/go\/152392\/revisions\/153501"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/media?parent=152392"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/categories?post=152392"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/tags?post=152392"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/en\/wp-json\/wp\/v2\/cross-post-tag?post=152392"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}