About

Report available Go module updates, including major-version candidates.

Installation

$ go install github.com/crazy-max/gomod-updates/cmd/gomod-updates@latest

Usage

Run in a Go module:

$ gomod-updates --update --direct
+---------------------------+---------+-------------+--------+------------------+
| Module                    | Version | New Version | Direct | Valid Timestamps |
+---------------------------+---------+-------------+--------+------------------+
| github.com/example/module | v1.0.0  | v1.1.0      | true   | true             |
+---------------------------+---------+-------------+--------+------------------+

Check major-version module path candidates:

$ gomod-updates --update --direct --major
+---------------------------+---------+-------------------------------------+--------+------------------+
| Module                    | Version | New Version                         | Direct | Valid Timestamps |
+---------------------------+---------+-------------------------------------+--------+------------------+
| github.com/example/module | v1.0.0  | github.com/example/module/v2@v2.0.0 | true   | true             |
+---------------------------+---------+-------------------------------------+--------+------------------+

You can also pipe go list output, like go-mod-outdated:

$ go list -mod=mod -u -m -json all | gomod-updates --update --direct --major

To output a Markdown table:

$ gomod-updates --update --direct --major --format markdown

To fail when updates are found:

$ gomod-updates --update --direct --major --ci

Flags

  -h, --help
        Show context-sensitive help.
  --update
        List only modules with updates.
  --direct
        List only direct modules.
  --major
        Check for major-version module path candidates.
  --ci
        Non-zero exit code when at least one outdated dependency was found.
  --format string
        Output format (default,markdown). (default "default")
  --mod string
        Module download mode for go list calls. (default "mod")
  --version
        Print version information.

License

MIT. See LICENSE for more details.