https://github.com/oligot/go-mod-upgrade

Update outdated Go dependencies interactively
https://github.com/oligot/go-mod-upgrade

Last synced: about 2 months ago
JSON representation

Update outdated Go dependencies interactively

• Host: GitHub
• URL: https://github.com/oligot/go-mod-upgrade
• Owner: oligot
• License: mit
• Created: 2020-01-29T13:47:46.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-04-08T09:47:48.000Z (6 months ago)
• Last Synced: 2024-06-18T13:56:45.734Z (3 months ago)
• Language: Go
• Size: 2.35 MB
• Stars: 868
• Watchers: 12
• Forks: 42
• Open Issues: 5
• Metadata Files:
  • Readme: readme.md
  • License: License

Awesome Lists containing this project

README

        
# go-mod-upgrade

[![Build Status](https://travis-ci.com/oligot/go-mod-upgrade.svg?branch=master)](https://travis-ci.com/oligot/go-mod-upgrade)

[![License](https://img.shields.io/github/license/oligot/go-mod-upgrade)](/license)

[![Release](https://img.shields.io/github/v/release/oligot/go-mod-upgrade.svg)](https://github.com/oligot/go-mod-upgrade/releases/latest)

> Update outdated Go dependencies interactively 

![Screenshot](screenshot.png)

Note that only patch and minor updates are supported for now.

## Why

The Go wiki has a great section on [How to Upgrade and Downgrade Dependencies](https://go.dev/wiki/Modules#how-to-upgrade-and-downgrade-dependencies).

One can run the command

```bash

go list -u -f '{{if (and (not (or .Main .Indirect)) .Update)}}{{.Path}}: {{.Version}} -> {{.Update.Version}}{{end}}' -m all 2> /dev/null

```

to view available upgrades for direct dependencies.

Unfortunately, the output is not actionable, i.e. we can't easily use it to update multiple dependencies.

This tool is an attempt to make it easier to update multiple dependencies interactively.

This is similar to [yarn upgrade-interactive](https://legacy.yarnpkg.com/en/docs/cli/upgrade-interactive/), but for Go.

## Install

Pre-compiled binaries for Windows, OS X and Linux are available in the [releases page](https://github.com/oligot/go-mod-upgrade/releases).

Alternatively, with the Go toolchain, you can do

```

go install github.com/oligot/go-mod-upgrade@latest

```

## Usage

In a Go project which uses modules, you can now run

```

go-mod-upgrade

```

Colors in module names help identify the update type:

* green for a minor update

* yellow for a patch update

* red for a prerelease update

Additional options can be specified via the CLI global options:

``` 

GLOBAL OPTIONS:

   --pagesize value, -p value  Specify page size (default: 10)

   --force, -f                 Force update all modules in non-interactive mode (default: false)

   --verbose, -v               Verbose mode (default: false)

   --hook value                Hook to execute for each updated module

   --ignore value, -i value    Ignore modules matching the given regular expression

   --help, -h                  show help (default: false)

   --version                   print the version (default: false)

```