rawlingsj / gobump

Go tool to declaratively bump dependencies.

GoBump

GoBump is a simple command-line tool written in Go that allows you to update the versions of your Go dependencies.

Usage

gobump --packages=<package@version> ... --modroot=<path to go.mod>

Flags

• --packages: A space-separated list of packages to update. Each package should be in the format package@version.
• --modroot: Path to the go.mod root. If not specified, it defaults to the current directory.
• --replaces: A space-separated list of packages to replace. Each entry should be in the format old=new@version.
• --go-version: set the go-version for 'go mod tidy' command.
• --show-diff: Show the difference between the original and 'go.mod' files.
• --tidy: Run 'go mod tidy' command.

Example

gobump --packages="github.com/pkg/errors@v0.9.1 golang.org/x/mod@v0.4.2" --modroot=/path/to/your/project

This will update the versions of github.com/pkg/errors and golang.org/x/mod in your go.mod file.

Requirements

Go 1.20 or later

Installation

To install gobump, you can use go install:

go install github.com/chainguard-dev/gobump@latest

Contributing

Contributions are welcome! Please submit a pull request on GitHub.