An implementation of for go modules
Go to file
David 1941ddbbc2 Merge pull request 'Update module to v0.17.0' (#10) from renovate/ into master
Reviewed-on: #10
2024-04-13 14:00:23 +00:00
pkg add documentation 2021-05-09 17:25:23 -04:00
.gitignore init 2021-04-09 22:01:41 -04:00
LICENSE add BSD-3 license 2021-04-10 22:25:51 -04:00
go.mod Update module to v0.17.0 2024-04-04 16:01:48 +00:00
go.sum Update module to v0.17.0 2024-04-04 16:01:48 +00:00
main.go correct mod name 2021-04-10 22:22:06 -04:00 document default -h flag 2021-04-10 22:18:27 -04:00
renovate.json Add renovate.json 2023-04-07 00:01:18 +00:00


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


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 1.03 year(s) (current: v0.8.1, newest: v0.9.1) 1.51 year(s) (current: v1.4.0, newest: v1.7.0) 0.00 year(s) (up to date: v1.7.0) 0.00 year(s) (up to date: v1.6.0) 2.01 year(s) (current: v2.2.2, newest: v2.4.0)
total libyear count: 4.55 year(s)


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