Libyear
A simple measure of dependency freshness for ruby apps.
$ libyear-bundler Gemfile
activesupport 4.2.7.1 2016-08-10 5.1.3 2017-08-03 1.0
i18n 0.8.0 2017-01-31 0.8.6 2017-07-10 0.4
json 1.8.6 2017-01-13 2.1.0 2017-04-18 0.3
System is 1.7 libyears behindlibyear-bundler tells you how out-of-date your Gemfile is, in a single
number.
Install
gem install libyear-bundlerUsage
Run libyear-bundler in a directory with a Gemfile.
--libyears (default)
Measures the time between your dependencies' installed and newest versions, in years.
$ libyear-bundler Gemfile
activesupport 4.2.7.1 2016-08-10 5.1.3 2017-08-03 1.0
i18n 0.8.0 2017-01-31 0.8.6 2017-07-10 0.4
json 1.8.6 2017-01-13 2.1.0 2017-04-18 0.3
minitest 5.10.1 2016-12-02 5.10.3 2017-07-21 0.6
minitest_to_rspec 0.6.0 2015-06-09 0.8.0 2017-01-02 1.6
ruby_parser 3.8.4 2017-01-13 3.10.1 2017-07-21 0.5
sexp_processor 4.8.0 2017-02-01 4.10.0 2017-07-17 0.5
thread_safe 0.3.5 2015-03-11 0.3.6 2017-02-22 2.0
tzinfo 1.2.2 2014-08-08 1.2.3 2017-03-25 2.6
System is 9.4 libyears behind
--releases
Measures the number of releases between your dependencies' installed and newest versions
$ libyear-bundler Gemfile --releases
activesupport 4.2.7.1 2016-08-10 5.1.3 2017-08-03 37
i18n 0.8.0 2017-01-31 0.8.6 2017-07-10 5
json 1.8.6 2017-01-13 2.1.0 2017-04-18 12
minitest 5.10.1 2016-12-02 5.10.3 2017-07-21 2
minitest_to_rspec 0.6.0 2015-06-09 0.8.0 2017-01-02 5
ruby_parser 3.8.4 2017-01-13 3.10.1 2017-07-21 3
sexp_processor 4.8.0 2017-02-01 4.10.0 2017-07-17 3
thread_safe 0.3.5 2015-03-11 0.3.6 2017-02-22 2
tzinfo 1.2.2 2014-08-08 1.2.3 2017-03-25 1
Total releases behind: 70
--versions
Measures the number of major, minor, and patch versions between your dependencies' installed and newest versions
$ libyear-bundler Gemfile --versions
activesupport 4.2.7.1 2016-08-10 5.1.3 2017-08-03 [1, 0, 0]
i18n 0.8.0 2017-01-31 0.8.6 2017-07-10 [0, 0, 6]
json 1.8.6 2017-01-13 2.1.0 2017-04-18 [1, 0, 0]
minitest 5.10.1 2016-12-02 5.10.3 2017-07-21 [0, 0, 2]
minitest_to_rspec 0.6.0 2015-06-09 0.8.0 2017-01-02 [0, 2, 0]
ruby_parser 3.8.4 2017-01-13 3.10.1 2017-07-21 [0, 2, 0]
sexp_processor 4.8.0 2017-02-01 4.10.0 2017-07-17 [0, 2, 0]
thread_safe 0.3.5 2015-03-11 0.3.6 2017-02-22 [0, 0, 1]
tzinfo 1.2.2 2014-08-08 1.2.3 2017-03-25 [0, 0, 1]
Major, minor, patch versions behind: 2, 6, 10
--all
Returns relevant data for each outdated gem, including 'libyears', 'releases', and 'versions' metrics
$ libyear-bundler Gemfile --all
activesupport 4.2.7.1 2016-08-10 5.1.3 2017-08-03 1.0 37 [1, 0, 0]
i18n 0.8.0 2017-01-31 0.8.6 2017-07-10 0.4 5 [0, 0, 6]
json 1.8.6 2017-01-13 2.1.0 2017-04-18 0.3 12 [1, 0, 0]
minitest 5.10.1 2016-12-02 5.10.3 2017-07-21 0.6 2 [0, 0, 2]
minitest_to_rspec 0.6.0 2015-06-09 0.8.0 2017-01-02 1.6 5 [0, 2, 0]
ruby_parser 3.8.4 2017-01-13 3.10.1 2017-07-21 0.5 3 [0, 2, 0]
sexp_processor 4.8.0 2017-02-01 4.10.0 2017-07-17 0.5 3 [0, 2, 0]
thread_safe 0.3.5 2015-03-11 0.3.6 2017-02-22 2.0 2 [0, 0, 1]
tzinfo 1.2.2 2014-08-08 1.2.3 2017-03-25 2.6 1 [0, 0, 1]
System is 9.4 libyears behind
Total releases behind: 70
Major, minor, patch versions behind: 2, 6, 10--grand-total
With no other options, returns the grand-total of libyears. Used with other flags, returns the associated grand-total.
$ libyear-bundler Gemfile --grand-total
9.4
$ libyear-bundler Gemfile --releases --grand-total
70
$ libyear-bundler Gemfile --versions --grand-total
[2, 6, 10]
$ libyear-bundler Gemfile --all --grand-total
9.4
70
[2, 6, 10]Contributing
See CONTRIBUTING.md
Acknowledgements
The inspiration for libyear comes from the technical report “Measuring Dependency Freshness in Software Systems”[1].
[1] 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