An implementation of libyear.com for go modules

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

alazyreader df61ab4d54 Merge pull request 'Update module golang.org/x/mod to v0.10.0' (#2 ) from renovate/golang.org-x-mod-0.x into master Reviewed-on: #2		2 months ago
pkg	add documentation	2 years ago
.gitignore	init	2 years ago
LICENSE	add BSD-3 license	2 years ago
go.mod	Update module golang.org/x/mod to v0.10.0	2 months ago
go.sum	Update module golang.org/x/mod to v0.10.0	2 months ago
main.go	correct mod name	2 years ago
readme.md	document default -h flag	2 years ago
renovate.json	Add renovate.json	2 months ago

readme.md

libyear

A simple measure of software dependency freshness. It is a single number telling you how up-to-date your dependencies are.

libyear.com

Usage

libyear only supports projects using go modules. It ignores dependencies that are replaced in a go.mod file.

-h: usage help text

-q: quiet mode; reduce logging and output only dependencies that are not at their latest version

-v: verbose mode; output diagnostic information

-indirect: include dependencies marked // indirect in go.mod in the calculation (excluded by default)

Example output

When run in a directory that contains a go.mod file:

$ libyear
github.com/pkg/errors: 1.03 year(s) (current: v0.8.1, newest: v0.9.1)
github.com/stretchr/testify: 1.51 year(s) (current: v1.4.0, newest: v1.7.0)
go.uber.org/atomic: 0.00 year(s) (up to date: v1.7.0)
go.uber.org/multierr: 0.00 year(s) (up to date: v1.6.0)
gopkg.in/yaml.v2: 2.01 year(s) (current: v2.2.2, newest: v2.4.0)
total libyear count: 4.55 year(s)

References

J. Cox, E. Bouwers, M. van Eekelen and J. Visser, Measuring Dependency Freshness in Software Systems. In Proceedings of the 37th International Conference on Software Engineering (ICSE 2015), May 2015 https://ericbouwers.github.io/papers/icse15.pdf