An open API service indexing awesome lists of open source software.

https://github.com/crazy-max/gomod-updates

Report available Go module updates, including major-version candidates
https://github.com/crazy-max/gomod-updates

Last synced: about 1 month ago
JSON representation

Report available Go module updates, including major-version candidates

Awesome Lists containing this project

README

          


PkgGoDev
GitHub release
Total downloads
Build Status
Docker Stars
Docker Pulls

Go Report
Codecov
Become a sponsor
Donate Paypal

## About

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

## Installation

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

## Usage

Run in a Go module:

```console
$ 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:

```console
$ 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`:

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

To output a Markdown table:

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

To fail when updates are found:

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

### Flags

```console
-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.