libyear-bundler 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2bc00352e31430c9a27e420073d5284a343a840a
-  data.tar.gz: 10d60b3b473df24f7a7a6140a22d4ed8bfe7f8a8
+  metadata.gz: 8ab149dc302594c069829c10cc93253a4a9165d2
+  data.tar.gz: 8f6a974c411bc9b72d799b137f715cd7c35260a1
 SHA512:
-  metadata.gz: ec414ad1bb5b06517e6fa39fd7ebf1265a8ea42c36f1a9bf225d16bac46fcb61df3f97506725204bd3563b5425f02e28ff5e847bbfbdf8fcc0eaf1a06373be92
-  data.tar.gz: 0e3f53fc0fa0a497abd545e4e91eaa1d82e399d54401cf982393c6db3ff3b28c248a20f4e9d68e8b08d68d3f27e6b4daff1e88ac9bb7e5e82c240eb00d8d2ca9
+  metadata.gz: 424dad3f3c7ef8e6f42cb406714ec080193ca59f4c3d55b7e38d631d0d0ac97a670e9db076c993a9a1c976e31dd47cbe08f3ccf32dc7466c20379fcdda6d1acd
+  data.tar.gz: aad230cd11ee0313b1d1bce97fa489b020c92fd15686deb9ecefa4ac96a9a2393cd27aa998edfd9983c66f4dd168c131752aae1d5c53fc4e273d8757c10beec2

data/.rubocop.yml

@@ -1,11 +1,30 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  TargetRubyVersion: 2.1.10
+
 Metrics/AbcSize:
   Max: 27
 
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+
+Metrics/ModuleLength:
+  Exclude:
+    - 'spec/**/*'
+
 Metrics/LineLength:
   Max: 100
 
 Metrics/MethodLength:
   Enabled: false
 
+Style/IndentArray:
+  EnforcedStyle: consistent
+
+Style/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
 Style/StringLiterals:
   Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,97 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2017-11-29 16:15:16 -0500 using RuboCop version 0.51.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: Include, TreatCommentsAsGroupSeparators.
+# Include: **/*.gemspec
+Gemspec/OrderedDependencies:
+  Exclude:
+    - 'libyear-bundler.gemspec'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+# SupportedStyles: leading, trailing
+Layout/DotPosition:
+  Exclude:
+    - 'spec/calculators/libyear_spec.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Layout/EmptyLines:
+  Exclude:
+    - 'lib/libyear_bundler/cli.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+# SupportedStyles: auto_detection, squiggly, active_support, powerpack, unindent
+Layout/IndentHeredoc:
+  Exclude:
+    - 'lib/libyear_bundler/options.rb'
+
+# Offense count: 3
+# Configuration parameters: CountComments, ExcludedMethods.
+Metrics/BlockLength:
+  Max: 40
+
+# Offense count: 1
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/libyear_bundler/report.rb'
+
+# Offense count: 3
+# Configuration parameters: ExpectMatchingDefinition, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'spec/gemfiles/Gemfile.bundler-1.14.rb'
+    - 'spec/gemfiles/Gemfile.bundler-1.15.rb'
+    - 'spec/gemfiles/Gemfile.bundler-1.16.rb'
+
+# Offense count: 1
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/Encoding:
+  Exclude:
+    - 'libyear-bundler.gemspec'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/MutableConstant:
+  Exclude:
+    - 'lib/libyear_bundler/options.rb'
+
+# Offense count: 9
+# Cop supports --auto-correct.
+Style/StderrPuts:
+  Exclude:
+    - 'lib/libyear_bundler/bundle_outdated.rb'
+    - 'lib/libyear_bundler/cli.rb'
+    - 'lib/libyear_bundler/models/gem.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: MinSize, SupportedStyles.
+# SupportedStyles: percent, brackets
+Style/SymbolArray:
+  EnforcedStyle: brackets
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: ExactNameMatch, AllowPredicates, AllowDSLWriters, IgnoreClassMethods, Whitelist.
+# Whitelist: to_ary, to_a, to_c, to_enum, to_h, to_hash, to_i, to_int, to_io, to_open, to_path, to_proc, to_r, to_regexp, to_str, to_s, to_sym
+Style/TrivialAccessors:
+  Exclude:
+    - 'lib/libyear_bundler/models/gem.rb'

data/.travis.yml

@@ -0,0 +1,11 @@
+cache: bundler
+language: ruby
+rvm:
+  - 2.4.2
+  - 2.3.5
+  - 2.2.8
+  - 2.1.10
+script:
+  - bundle exec rubocop
+  - bundle exec rspec
+sudo: false

data/CHANGELOG.md

@@ -17,6 +17,21 @@ Fixed:
 
 - None
 
+## 0.5.0 (2017-12-12)
+
+Breaking changes:
+
+- None
+
+Added:
+
+- [#10](https://github.com/jaredbeck/libyear-bundler/pull/10)
+  Include Ruby version in metrics calculations
+
+Fixed:
+
+- None
+
 ## 0.4.0 (2017-07-07)
 
 Breaking changes:

data/CONTRIBUTING.md

@@ -0,0 +1,24 @@
+# Contributing Guide
+
+## Development
+
+Pull requests are welcome.
+
+```bash
+bundle install
+bundle exec rspec
+```
+
+## Releases
+
+1. Set the version in `lib/libyear_bundler/version.rb`
+   - Follow SEMVER
+   - Only use integer-dot-integer-dot-integer format, never "pre-releases"
+1. In the changelog,
+   - Replace "Unreleased" with the date in ISO-8601 format
+   - Add a new "Unreleased" section
+1. Commit
+1. git tag -a -m "v0.5.0" "v0.5.0" # or whatever number
+1. git push --tags origin master
+1. gem build libyear-bundler.gemspec
+1. gem push libyear-bundler-0.5.0.gem

data/README.md

@@ -2,29 +2,133 @@
 
 A simple measure of dependency freshness for ruby apps.
 
-A libyear (library year) is a measure of how old a software dependency is.
+Applied to a whole Gemfile, `libyear-bundler` provides a single number for
+determining the maintenance burden of an app’s dependencies. It is a simple
+measure of the time between the release date of the installed dependency and the
+release date of the newest version of the dependency.
 
-If your system has two dependencies, the first one year old, the second three,
-then your system is four libyears out-of-date.
+The inspiration for libyear comes from the technical report “Measuring
+Dependency Freshness in Software Systems”[1]. Other metrics for determining
+dependency freshness outlined in the paper are available in libyear-bundler. See
+the Usage section for details.
 
-A dependency is one year old when the version you are using is one year older
-than its latest version.
+# Install
+
+```bash
+gem install libyear-bundler
+```
 
 ## Usage
 
-Early access. Output and usage subject to change.
+Run `libyear-bundler` in a directory with a Gemfile. Verbosity is on by default.
+For simpler output, see the `--grand-total` option.
+
+### Options
+
+#### `--libyears` (default)
+Measures the time between your dependencies' installed and newest versions, in
+years.
+
+```bash
+$ 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
 
 ```
-gem install libyear-bundler
-libyear-bundler Gemfile
-       activesupport   4.2.7.1     2016-08-10     5.0.1     2016-12-21       0.4
-                json     1.8.6     2017-01-13     2.0.3     2017-01-12       0.0
-   minitest_to_rspec     0.6.0     2015-06-09     0.8.0     2017-01-02       1.6
-System is 1.9 libyears behind
+
+#### `--releases`
+Measures the number of releases between your dependencies' installed and newest
+versions
+
+```bash
+$ 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
+
 ```
 
-## Development
+
+#### `--versions`
+Measures the number of major, minor, and patch versions between your
+dependencies' installed and newest versions
+
+```bash
+$ 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
 
 ```
-ruby -I lib bin/libyear-bundler spec/fixtures/01/Gemfile
+
+#### `--all`
+Returns relevant data for each outdated gem, including 'libyears', 'releases',
+and 'versions' metrics
+
+```bash
+$ 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.
+
+```bash
+$ 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
+
+---
+[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

data/lib/libyear_bundler/{query.rb → bundle_outdated.rb}

@@ -3,41 +3,29 @@ require "open3"
 require 'libyear_bundler/calculators/libyear'
 require 'libyear_bundler/calculators/version_number_delta'
 require 'libyear_bundler/calculators/version_sequence_delta'
+require 'libyear_bundler/models/gem'
 
 module LibyearBundler
   # Responsible for getting all the data that goes into the `Report`.
-  class Query
+  class BundleOutdated
     # Format of `bundle outdated --parseable` (BOP)
     BOP_FMT = /\A(?<name>[^ ]+) \(newest (?<newest>[^,]+), installed (?<installed>[^,)]+)/
 
-    def initialize(gemfile_path, argv)
+    def initialize(gemfile_path)
       @gemfile_path = gemfile_path
-      @argv = argv
     end
 
     def execute
-      gems = []
-      bundle_outdated.lines.each do |line|
+      bundle_outdated.lines.each_with_object([]) do |line, gems|
         match = BOP_FMT.match(line)
         next if match.nil?
-        gems.push(
-          installed: { version: match["installed"] },
-          name: match["name"],
-          newest: { version: match["newest"] }
+        gem = ::LibyearBundler::Models::Gem.new(
+          match['name'],
+          match['installed'],
+          match['newest']
         )
+        gems.push(gem)
       end
-      gems.each do |gem|
-        if @argv.include?("--versions") || @argv.include?("--all")
-          gem[:version_number_delta] = ::Calculators::VersionNumberDelta.calculate(gem)
-        end
-
-        if @argv.include?("--releases") || @argv.include?("--all")
-          gem[:version_sequence_delta] = ::Calculators::VersionSequenceDelta.calculate(gem)
-        end
-
-        gem[:libyears] = ::Calculators::Libyear.calculate(gem)
-      end
-      gems
     end
 
     private

data/lib/libyear_bundler/calculators/libyear.rb

@@ -1,49 +1,22 @@
-module Calculators
-  # A libyear is the difference in time between releases of the newest and
-  # installed versions of the gem in years
-  class Libyear
-    class << self
-      def calculate(gem)
-        di = release_date(gem[:name], gem[:installed][:version])
-        dn = release_date(gem[:name], gem[:newest][:version])
-        gem[:installed][:date] = di
-        gem[:newest][:date] = dn
-        if di.nil? || dn.nil? || dn <= di
-          # Known issue: Backports and maintenance releases of older minor versions.
-          # Example: json 1.8.6 (2017-01-13) was released *after* 2.0.3 (2017-01-12)
-          years = 0.0
-        else
-          days = (dn - di).to_f
-          years = days / 365.0
+module LibyearBundler
+  module Calculators
+    # A libyear is the difference in time between releases of the newest and
+    # installed versions of the gem in years
+    class Libyear
+      class << self
+        def calculate(installed_version_release_date, newest_version_release_date)
+          di = installed_version_release_date
+          dn = newest_version_release_date
+          if di.nil? || dn.nil? || dn <= di
+            # Known issue: Backports and maintenance releases of older minor versions.
+            # Example: json 1.8.6 (2017-01-13) was released *after* 2.0.3 (2017-01-12)
+            years = 0.0
+          else
+            days = (dn - di).to_f
+            years = days / 365.0
+          end
+          years
         end
-        years
-      end
-
-      private
-
-      # Known issue: Probably performs a network request every time, unless
-      # there's some kind of caching.
-      def release_date(gem_name, gem_version)
-        dep = nil
-        begin
-          dep = ::Bundler::Dependency.new(gem_name, gem_version)
-        rescue ::Gem::Requirement::BadRequirementError => e
-          $stderr.puts "Could not find release date for: #{gem_name}"
-          $stderr.puts(e)
-          $stderr.puts(
-            "Maybe you used git in your Gemfile, which libyear doesn't support " \
-            "yet. Contributions welcome."
-          )
-          return nil
-        end
-        tuples, _errors = ::Gem::SpecFetcher.fetcher.search_for_dependency(dep)
-        if tuples.empty?
-          $stderr.puts "Could not find release date for: #{gem_name}"
-          return nil
-        end
-        tup, source = tuples.first # Gem::NameTuple
-        spec = source.fetch_spec(tup) # raises Gem::RemoteFetcher::FetchError
-        spec.date.to_date
       end
     end
   end

data/lib/libyear_bundler/calculators/version_number_delta.rb

@@ -1,43 +1,45 @@
-module Calculators
-  # The version number delta is the absolute difference between the highest-
-  # order version number of the installed and newest releases
-  class VersionNumberDelta
-    class << self
-      def calculate(gem)
-        newest_version_tuple = version_tuple(gem[:newest][:version].split('.'))
-        installed_version_tuple = version_tuple(gem[:installed][:version].split('.'))
-        major_version_delta = version_delta(
-          newest_version_tuple.major, installed_version_tuple.major
-        )
-        minor_version_delta = version_delta(
-          newest_version_tuple.minor, installed_version_tuple.minor
-        )
-        patch_version_delta = version_delta(
-          newest_version_tuple.patch, installed_version_tuple.patch
-        )
-        highest_order([major_version_delta, minor_version_delta, patch_version_delta])
-      end
+module LibyearBundler
+  module Calculators
+    # The version number delta is the absolute difference between the highest-
+    # order version number of the installed and newest releases
+    class VersionNumberDelta
+      class << self
+        def calculate(installed_version, newest_version)
+          installed_version_tuple = version_tuple(installed_version.to_s.split('.'))
+          newest_version_tuple = version_tuple(newest_version.to_s.split('.'))
+          major_version_delta = version_delta(
+            newest_version_tuple.major, installed_version_tuple.major
+          )
+          minor_version_delta = version_delta(
+            newest_version_tuple.minor, installed_version_tuple.minor
+          )
+          patch_version_delta = version_delta(
+            newest_version_tuple.patch, installed_version_tuple.patch
+          )
+          highest_order([major_version_delta, minor_version_delta, patch_version_delta])
+        end
 
-      private
+        private
 
-      def highest_order(arr)
-        arr[1] = arr[2] = 0 if arr[0] > 0
-        arr[2] = 0 if arr[1] > 0
-        arr
-      end
+        def highest_order(arr)
+          arr[1] = arr[2] = 0 if arr[0] > 0
+          arr[2] = 0 if arr[1] > 0
+          arr
+        end
 
-      def version_delta(newest_version, installed_version)
-        delta = newest_version - installed_version
-        delta < 0 ? 0 : delta
-      end
+        def version_delta(newest_version, installed_version)
+          delta = newest_version - installed_version
+          delta < 0 ? 0 : delta
+        end
 
-      def version_tuple(version_array)
-        version_struct = Struct.new(:major, :minor, :patch)
-        version_struct.new(
-          version_array[0].to_i,
-          version_array[1].to_i,
-          version_array[2].to_i
-        )
+        def version_tuple(version_array)
+          version_struct = Struct.new(:major, :minor, :patch)
+          version_struct.new(
+            version_array[0].to_i,
+            version_array[1].to_i,
+            version_array[2].to_i
+          )
+        end
       end
     end
   end

data/lib/libyear_bundler/calculators/version_sequence_delta.rb

@@ -1,19 +1,12 @@
-require 'net/http'
-require 'uri'
-require 'json'
-
-module Calculators
-  # The version sequence delta is the number of releases between the newest and
-  # installed versions of the gem
-  class VersionSequenceDelta
-    class << self
-      def calculate(gem)
-        uri = URI.parse("https://rubygems.org/api/v1/versions/#{gem[:name]}.json")
-        response = Net::HTTP.get_response(uri)
-        versions = JSON.parse(response.body).map { |version| version["number"] }
-        newest_seq = versions.index(gem[:newest][:version])
-        installed_seq = versions.index(gem[:installed][:version])
-        installed_seq - newest_seq
+module LibyearBundler
+  module Calculators
+    # The version sequence delta is the number of releases between the newest and
+    # installed versions of the gem
+    class VersionSequenceDelta
+      class << self
+        def calculate(installed_seq_index, newest_seq_index)
+          installed_seq_index - newest_seq_index
+        end
       end
     end
   end

data/lib/libyear_bundler/cli.rb

@@ -1,30 +1,28 @@
 require "bundler/cli"
 require "bundler/cli/outdated"
+require "libyear_bundler/bundle_outdated"
+require "libyear_bundler/options"
 require "libyear_bundler/report"
-require "libyear_bundler/query"
+require 'libyear_bundler/models/ruby'
 
 module LibyearBundler
   # The `libyear-bundler` command line program
   class CLI
-    OPTIONS = %w[
-      --all
-      --grand-total
-      --libyears
-      --releases
-      --versions
-    ].freeze
-
     E_BUNDLE_OUTDATED_FAILED = 1
     E_NO_GEMFILE = 2
+    E_INVALID_CLI_ARG = 3
 
     def initialize(argv)
+      @options = ::LibyearBundler::Options.new(argv).parse
+      # Command line flags are removed form `argv` in `Options` by
+      # `OptionParser`, leaving non-flag command line arguments,
+      # such as a Gemfile path
       @argv = argv
       @gemfile_path = load_gemfile_path
-      validate_arguments
     end
 
     def run
-      if @argv.include?("--grand-total")
+      if @options.grand_total?
         grand_total
       else
         print report.to_s
@@ -51,32 +49,21 @@ module LibyearBundler
         '' # `bundle outdated` will default to local Gemfile
       else
         $stderr.puts "Gemfile not found"
-        exit
+        exit E_NO_GEMFILE
       end
     end
 
-    def query
-      Query.new(@gemfile_path, @argv).execute
+    def bundle_outdated
+      BundleOutdated.new(@gemfile_path).execute
     end
 
     def report
-      @_report ||= Report.new(query)
-    end
-
-    def unexpected_options
-      @_unexpected_options ||= begin
-        options = @argv.select { |arg| arg.start_with?("--") }
-        options.each_with_object([]) do |arg, memo|
-          memo << arg unless OPTIONS.include?(arg)
-        end
-      end
+      @_report ||= Report.new(bundle_outdated, ruby, @options)
     end
 
-    def validate_arguments
-      return if unexpected_options.empty?
-      puts "Unexpected args: #{unexpected_options.join(', ')}"
-      puts "Allowed args: #{OPTIONS.join(', ')}"
-      exit E_NO_GEMFILE
+    def ruby
+      lockfile = @gemfile_path + '.lock'
+      ::LibyearBundler::Models::Ruby.new(lockfile)
     end
 
     def grand_total
@@ -84,15 +71,15 @@ module LibyearBundler
     end
 
     def calculate_grand_total
-      if report.to_h.key?(:sum_seq_delta) && report.to_h.key?(:sum_major_version)
+      if [:libyears?, :releases?, :versions?].all? { |opt| @options[opt] }
         [
           libyears_grand_total,
           releases_grand_total,
           versions_grand_total
         ].join("\n")
-      elsif report.to_h.key?(:sum_seq_delta)
+      elsif @options.releases?
         releases_grand_total
-      elsif report.to_h.key?(:sum_major_version)
+      elsif @options.versions?
         versions_grand_total
       else
         libyears_grand_total
@@ -100,7 +87,7 @@ module LibyearBundler
     end
 
     def libyears_grand_total
-      report.to_h[:sum_years].truncate(1)
+      report.to_h[:sum_libyears].truncate(1)
     end
 
     def releases_grand_total

data/lib/libyear_bundler/models/gem.rb

@@ -0,0 +1,104 @@
+require 'net/http'
+require 'uri'
+require 'json'
+
+module LibyearBundler
+  module Models
+    # Logic and information pertaining to the installed and newest versions of
+    # a gem
+    class Gem
+      def initialize(name, installed_version, newest_version)
+        @name = name
+        @installed_version = installed_version
+        @newest_version = newest_version
+      end
+
+      def installed_version
+        ::Gem::Version.new(@installed_version)
+      end
+
+      def installed_version_release_date
+        release_date(name, installed_version)
+      end
+
+      def installed_version_sequence_index
+        versions_sequence.index(installed_version.to_s)
+      end
+
+      def libyears
+        ::LibyearBundler::Calculators::Libyear.calculate(
+          installed_version_release_date,
+          newest_version_release_date
+        )
+      end
+
+      def name
+        @name
+      end
+
+      def newest_version
+        ::Gem::Version.new(@newest_version)
+      end
+
+      def newest_version_sequence_index
+        versions_sequence.index(newest_version.to_s)
+      end
+
+      def newest_version_release_date
+        release_date(name, newest_version)
+      end
+
+      def version_number_delta
+        ::LibyearBundler::Calculators::VersionNumberDelta.calculate(
+          installed_version,
+          newest_version
+        )
+      end
+
+      def version_sequence_delta
+        ::LibyearBundler::Calculators::VersionSequenceDelta.calculate(
+          installed_version_sequence_index,
+          newest_version_sequence_index
+        )
+      end
+
+      private
+
+      # docs: http://guides.rubygems.org/rubygems-org-api/#gem-version-methods
+      # Versions are returned ordered by version number, descending
+      def versions_sequence
+        @_versions_sequence ||= begin
+          uri = URI.parse("https://rubygems.org/api/v1/versions/#{name}.json")
+          response = Net::HTTP.get_response(uri)
+          parsed_response = JSON.parse(response.body)
+          parsed_response.map { |version| version['number'] }
+        end
+      end
+
+      # Known issue: Probably performs a network request every time, unless
+      # there's some kind of caching.
+      def release_date(gem_name, gem_version)
+        dep = nil
+        begin
+          dep = ::Bundler::Dependency.new(gem_name, gem_version)
+        rescue ::Gem::Requirement::BadRequirementError => e
+          $stderr.puts "Could not find release date for: #{gem_name}"
+          $stderr.puts(e)
+          $stderr.puts(
+            "Maybe you used git in your Gemfile, which libyear doesn't support " \
+              "yet. Contributions welcome."
+          )
+          return nil
+        end
+        tuples, _errors = ::Gem::SpecFetcher.fetcher.search_for_dependency(dep)
+        if tuples.empty?
+          $stderr.puts "Could not find release date for: #{gem_name}"
+          return nil
+        end
+        tup, source = tuples.first # Gem::NameTuple
+        spec = source.fetch_spec(tup) # raises Gem::RemoteFetcher::FetchError
+        spec.date.to_date
+      end
+    end
+  end
+end

data/lib/libyear_bundler/models/ruby.rb

@@ -0,0 +1,139 @@
+require 'bundler/lockfile_parser'
+require 'bundler/ruby_version'
+require 'date'
+require 'net/http'
+require 'yaml'
+
+require 'libyear_bundler/calculators/libyear'
+require 'libyear_bundler/calculators/version_number_delta'
+require 'libyear_bundler/calculators/version_sequence_delta'
+
+module LibyearBundler
+  module Models
+    # Logic and information pertaining to the installed and newest Ruby versions
+    class Ruby
+      RUBY_VERSION_DATA_URL = "https://raw.githubusercontent.com/ruby/" \
+        "www.ruby-lang.org/master/_data/releases.yml".freeze
+
+      def initialize(lockfile)
+        @lockfile = lockfile
+      end
+
+      def installed_version
+        @_installed_version ||= begin
+          version_from_bundler ||
+            version_from_ruby_version_file ||
+            version_from_ruby
+        end
+      end
+
+      def installed_version_release_date
+        release_date(installed_version.to_s)
+      end
+
+      def libyears
+        ::LibyearBundler::Calculators::Libyear.calculate(
+          release_date(installed_version.to_s),
+          release_date(newest_version.to_s)
+        )
+      end
+
+      def name
+        'ruby'
+      end
+
+      def newest_version
+        ::Gem::Version.new(all_versions.first['version'])
+      end
+
+      def newest_version_release_date
+        release_date(newest_version.to_s)
+      end
+
+      def outdated?
+        installed_version < newest_version
+      end
+
+      def version_number_delta
+        ::LibyearBundler::Calculators::VersionNumberDelta.calculate(
+          installed_version,
+          newest_version
+        )
+      end
+
+      def version_sequence_delta
+        ::LibyearBundler::Calculators::VersionSequenceDelta.calculate(
+          installed_version_sequence_index,
+          newest_version_sequence_index
+        )
+      end
+
+      private
+
+      # We'll only consider non-prerelease versions when determining the
+      # newest version
+      #
+      # The following URL is the only official, easily-parseable document with
+      # Ruby version information that I'm aware of, but is not supported as such
+      # (https://github.com/ruby/www.ruby-lang.org/pull/1637#issuecomment-344934173).
+      # It's been recommend that ruby-lang.org provide a supported document:
+      # https://github.com/ruby/www.ruby-lang.org/pull/1637#issuecomment-344934173
+      # TODO: Use supported document with version information if it becomes
+      # available.
+      def all_versions
+        @_all_versions ||= begin
+          uri = ::URI.parse(RUBY_VERSION_DATA_URL)
+          response = ::Net::HTTP.get_response(uri)
+          # The Date object is passed through here due to a bug in
+          # YAML#safe_load
+          # https://github.com/ruby/psych/issues/262
+          ::YAML.safe_load(response.body, [Date]).reject do |version|
+            ::Gem::Version.new(version['version']).prerelease?
+          end
+        end
+      end
+
+      def installed_version_sequence_index
+        versions_sequence.index(installed_version.to_s)
+      end
+
+      def newest_version_sequence_index
+        versions_sequence.index(newest_version.to_s)
+      end
+
+      def release_date(version)
+        v = all_versions.detect { |ver| ver['version'] == version }
+        # YAML#safe_load provides an already-parsed Date object, so the following
+        # is a Date object
+        v['date']
+      end
+
+      def shell_out_to_ruby
+        `ruby --version`.split[1]
+      end
+
+      def version_from_bundler
+        return unless File.exist?(@lockfile)
+        ruby_version_string = ::Bundler::LockfileParser
+          .new(@lockfile)
+          .ruby_version
+        return if ruby_version_string.nil?
+
+        ::Bundler::RubyVersion.from_string(ruby_version_string).gem_version
+      end
+
+      def version_from_ruby_version_file
+        return unless ::File.exist?('.ruby-version')
+        ::Gem::Version.new(::File.read('.ruby-version').strip)
+      end
+
+      def version_from_ruby
+        ::Gem::Version.new(shell_out_to_ruby)
+      end
+
+      def versions_sequence
+        all_versions.map { |version| version['version'] }
+      end
+    end
+  end
+end

data/lib/libyear_bundler/options.rb

@@ -0,0 +1,63 @@
+require 'optparse'
+require 'libyear_bundler/version'
+require "libyear_bundler/cli"
+require 'ostruct'
+
+module LibyearBundler
+  # Uses OptionParser from Ruby's stdlib to hand command-line arguments
+  class Options
+    BANNER = <<-BANNER.freeze
+Usage: libyear-bundler [Gemfile ...] [options]
+https://github.com/jaredbeck/libyear-bundler/
+    BANNER
+
+    def initialize(argv)
+      @argv = argv
+      @options = ::OpenStruct.new
+      @optparser = OptionParser.new do |opts|
+        opts.banner = BANNER
+        opts.program_name = 'libyear-bundler'
+        opts.version = ::LibyearBundler::VERSION
+        @options.send('libyears?=', true)
+
+        opts.on_head('-h', '--help', 'Prints this help') do
+          puts opts
+          exit
+        end
+
+        opts.on('--all', 'Calculate all metrics') do
+          @options.send('libyears?=', true)
+          @options.send('releases?=', true)
+          @options.send('versions?=', true)
+        end
+
+        opts.on('--libyears', '[default] Calculate libyears out-of-date') do
+          @options.send('libyears?=', true)
+        end
+
+        opts.on('--releases', 'Calculate number of releases out-of-date') do
+          @options.send('libyears?=', false)
+          @options.send('releases?=', true)
+        end
+
+        opts.on('--versions', 'Calculate major, minor, and patch versions out-of-date') do
+          @options.send('libyears?=', false)
+          @options.send('versions?=', true)
+        end
+
+        opts.on('--grand-total', 'Return value for given metric(s)') do
+          @options.send('grand_total?=', true)
+        end
+      end
+    end
+
+    def parse
+      @optparser.parse!(@argv)
+      @options
+    rescue OptionParser::InvalidOption => e
+      warn e
+      warn @optparser.help
+      exit ::LibyearBundler::CLI::E_INVALID_CLI_ARG
+    end
+  end
+end

data/lib/libyear_bundler/report.rb

@@ -1,17 +1,23 @@
 module LibyearBundler
-  # Responsible presenting data from the `Query`. Should only be concerned
-  # with presentation, nothing else.
+  # Responsible presenting data from the `::LibyearBundler::Models`. Should only
+  # be concerned with presentation, nothing else.
   class Report
+    FMT_LIBYEARS_COLUMN = "%10.1f".freeze
     FMT_RELEASES_COLUMN = "%10d".freeze
     FMT_VERSIONS_COLUMN = "%15s".freeze
+    FMT_SUMMARY_COLUMNS = "%30s%15s%15s%15s%15s".freeze
 
-    # `gems` - Array of hashes.
-    def initialize(gems)
+    # `gems` - Array of `::LibyearBundler::Models::Gem` instances
+    # `options` - Instance of `::LibyearBundler::Options`
+    def initialize(gems, ruby, options)
       @gems = gems
+      @ruby = ruby
+      @options = options
     end
 
     def to_s
-      to_h[:gems].each { |gem| put_gem_summary(gem) }
+      to_h[:gems].each { |gem| put_line_summary(gem) }
+      put_line_summary(@ruby) if @ruby.outdated?
       put_summary(to_h)
     end
 
@@ -20,62 +26,58 @@ module LibyearBundler
         begin
           summary = {
             gems: @gems,
-            sum_years: 0.0
+            sum_libyears: 0.0
           }
-          @gems.each_with_object(summary) do |gem, memo|
-            memo[:sum_years] += gem[:libyears]
-
-            if gem.key?(:version_number_delta)
-              memo[:sum_major_version] ||= 0
-              memo[:sum_major_version] += gem[:version_number_delta][0]
-              memo[:sum_minor_version] ||= 0
-              memo[:sum_minor_version] += gem[:version_number_delta][1]
-              memo[:sum_patch_version] ||= 0
-              memo[:sum_patch_version] += gem[:version_number_delta][2]
-            end
-
-            if gem.key?(:version_sequence_delta)
-              memo[:sum_seq_delta] ||= 0
-              memo[:sum_seq_delta] += gem[:version_sequence_delta]
-            end
-          end
+          @gems.each { |gem| increment_metrics_summary(gem, summary) }
+
+          increment_metrics_summary(@ruby, summary) if @ruby.outdated?
+
+          summary
         end
     end
 
     private
 
-    def put_gem_summary(gem)
-      meta = meta_gem_summary(gem)
-      libyear = format("%10.1f", gem[:libyears])
-
-      if gem.key?(:version_sequence_delta) && gem.key?(:version_number_delta)
-        releases = format(FMT_RELEASES_COLUMN, gem[:version_sequence_delta])
-        versions = format(FMT_VERSIONS_COLUMN, gem[:version_number_delta])
-        puts meta << libyear << releases << versions
-      elsif gem.key?(:version_sequence_delta)
-        releases = format(FMT_RELEASES_COLUMN, gem[:version_sequence_delta])
-        puts meta << releases
-      elsif gem.key?(:version_number_delta)
-        versions = format(FMT_VERSIONS_COLUMN, gem[:version_number_delta])
-        puts meta << versions
-      else
-        puts meta << libyear
+    def increment_metrics_summary(model, summary)
+      increment_libyears(model, summary) if @options.libyears?
+      increment_version_deltas(model, summary) if @options.versions?
+      increment_seq_deltas(model, summary) if @options.releases?
+    end
+
+    def put_line_summary(gem_or_ruby)
+      meta = meta_line_summary(gem_or_ruby)
+
+      if @options.releases?
+        releases = format(FMT_RELEASES_COLUMN, gem_or_ruby.version_sequence_delta)
+        meta << releases
+      end
+
+      if @options.versions?
+        versions = format(FMT_VERSIONS_COLUMN, gem_or_ruby.version_number_delta)
+        meta << versions
+      end
+
+      if @options.libyears?
+        libyears = format(FMT_LIBYEARS_COLUMN, gem_or_ruby.libyears)
+        meta << libyears
       end
+
+      puts meta
     end
 
-    def meta_gem_summary(gem)
+    def meta_line_summary(gem_or_ruby)
       format(
-        "%30s%15s%15s%15s%15s",
-        gem[:name],
-        gem[:installed][:version],
-        gem[:installed][:date],
-        gem[:newest][:version],
-        gem[:newest][:date]
+        FMT_SUMMARY_COLUMNS,
+        gem_or_ruby.name,
+        gem_or_ruby.installed_version.to_s,
+        gem_or_ruby.installed_version_release_date,
+        gem_or_ruby.newest_version.to_s,
+        gem_or_ruby.newest_version_release_date
       )
     end
 
-    def put_libyear_summary(sum_years)
-      puts format("System is %.1f libyears behind", sum_years)
+    def put_libyear_summary(sum_libyears)
+      puts format("System is %.1f libyears behind", sum_libyears)
     end
 
     def put_version_delta_summary(sum_major_version, sum_minor_version, sum_patch_version)
@@ -92,7 +94,7 @@ module LibyearBundler
     end
 
     def put_summary(summary)
-      if summary.key?(:sum_seq_delta) && summary.key?(:sum_major_version)
+      if [:libyears?, :releases?, :versions?].all? { |opt| @options.send(opt) }
         put_libyear_summary(summary[:sum_years])
         put_sum_seq_delta_summary(summary[:sum_seq_delta])
         put_version_delta_summary(
@@ -100,17 +102,35 @@ module LibyearBundler
           summary[:sum_minor_version],
           summary[:sum_patch_version]
         )
-      elsif summary.key?(:sum_major_version)
+      elsif @options.versions?
         put_version_delta_summary(
           summary[:sum_major_version],
           summary[:sum_minor_version],
           summary[:sum_patch_version]
         )
-      elsif summary.key?(:sum_seq_delta)
+      elsif @options.releases?
         put_sum_seq_delta_summary(summary[:sum_seq_delta])
-      else
-        put_libyear_summary(summary[:sum_years])
+      elsif @options.libyears?
+        put_libyear_summary(summary[:sum_libyears])
       end
     end
+
+    def increment_libyears(model, memo)
+      memo[:sum_libyears] += model.libyears
+    end
+
+    def increment_seq_deltas(model, memo)
+      memo[:sum_seq_delta] ||= 0
+      memo[:sum_seq_delta] += model.version_sequence_delta
+    end
+
+    def increment_version_deltas(model, memo)
+      memo[:sum_major_version] ||= 0
+      memo[:sum_major_version] += model.version_number_delta[0]
+      memo[:sum_minor_version] ||= 0
+      memo[:sum_minor_version] += model.version_number_delta[1]
+      memo[:sum_patch_version] ||= 0
+      memo[:sum_patch_version] += model.version_number_delta[2]
+    end
   end
 end

data/lib/libyear_bundler/version.rb

@@ -1,3 +1,3 @@
 module LibyearBundler
-  VERSION = "0.4.0".freeze
+  VERSION = "0.5.0".freeze
 end

data/libyear-bundler.gemspec

@@ -21,4 +21,5 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = ">= 2.1"
   spec.add_dependency "bundler", "~> 1.14"
   spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rspec"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libyear-bundler
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Jared Beck
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-07-07 00:00:00.000000000 Z
+date: 2017-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - jared@jaredbeck.com
@@ -48,18 +62,23 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
 - CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
 - README.md
-- asd
 - bin/libyear-bundler
 - lib/libyear_bundler.rb
+- lib/libyear_bundler/bundle_outdated.rb
 - lib/libyear_bundler/calculators/libyear.rb
 - lib/libyear_bundler/calculators/version_number_delta.rb
 - lib/libyear_bundler/calculators/version_sequence_delta.rb
 - lib/libyear_bundler/cli.rb
-- lib/libyear_bundler/query.rb
+- lib/libyear_bundler/models/gem.rb
+- lib/libyear_bundler/models/ruby.rb
+- lib/libyear_bundler/options.rb
 - lib/libyear_bundler/report.rb
 - lib/libyear_bundler/version.rb
 - libyear-bundler.gemspec
@@ -83,7 +102,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.12
+rubygems_version: 2.6.13
 signing_key: 
 specification_version: 4
 summary: A simple measure of dependency freshness