twigg 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f3e52b0f0bd210a32cf32644f0b9eb53c19b24c5
+  data.tar.gz: aa750f08ceb9795ef9e8d2f3b970470bf0c3e869
+SHA512:
+  metadata.gz: 2d2cda3048d6a225c48d0e62ac26b3dd012b2be379e45584c088381c3f4d5d901ae154e1565d5f0d4af74b8f11e3c99cc3025bb66196bdfe1f9c65705695e5e4
+  data.tar.gz: 66d36587d5b4e8339517cc1f78ade317a77f132cb634f409b689744ba932c85787f54350a6868b57fa0688ff12cfef82ad259ec3071834057db606c3ff72a756

data/bin/twigg

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'twigg'
+
+Twigg::Command.run(ARGV.shift, *ARGV)

data/files/github.pem

@@ -0,0 +1,97 @@
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
+ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3
+LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug
+RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm
++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW
+PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM
+xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB
+Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3
+hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg
+EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA
+FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec
+nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z
+eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF
+hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2
+Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe
+vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep
++OkuE6N36B9K
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIGWDCCBUCgAwIBAgIQCl8RTQNbF5EX0u/UA4w/OzANBgkqhkiG9w0BAQUFADBs
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
+ZSBFViBSb290IENBMB4XDTA4MDQwMjEyMDAwMFoXDTIyMDQwMzAwMDAwMFowZjEL
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3
+LmRpZ2ljZXJ0LmNvbTElMCMGA1UEAxMcRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug
+Q0EtMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9hCikQH17+NDdR
+CPge+yLtYb4LDXBMUGMmdRW5QYiXtvCgFbsIYOBC6AUpEIc2iihlqO8xB3RtNpcv
+KEZmBMcqeSZ6mdWOw21PoF6tvD2Rwll7XjZswFPPAAgyPhBkWBATaccM7pxCUQD5
+BUTuJM56H+2MEb0SqPMV9Bx6MWkBG6fmXcCabH4JnudSREoQOiPkm7YDr6ictFuf
+1EutkozOtREqqjcYjbTCuNhcBoz4/yO9NV7UfD5+gw6RlgWYw7If48hl66l7XaAs
+zPw82W3tzPpLQ4zJ1LilYRyyQLYoEt+5+F/+07LJ7z20Hkt8HEyZNp496+ynaF4d
+32duXvsCAwEAAaOCAvowggL2MA4GA1UdDwEB/wQEAwIBhjCCAcYGA1UdIASCAb0w
+ggG5MIIBtQYLYIZIAYb9bAEDAAIwggGkMDoGCCsGAQUFBwIBFi5odHRwOi8vd3d3
+LmRpZ2ljZXJ0LmNvbS9zc2wtY3BzLXJlcG9zaXRvcnkuaHRtMIIBZAYIKwYBBQUH
+AgIwggFWHoIBUgBBAG4AeQAgAHUAcwBlACAAbwBmACAAdABoAGkAcwAgAEMAZQBy
+AHQAaQBmAGkAYwBhAHQAZQAgAGMAbwBuAHMAdABpAHQAdQB0AGUAcwAgAGEAYwBj
+AGUAcAB0AGEAbgBjAGUAIABvAGYAIAB0AGgAZQAgAEQAaQBnAGkAQwBlAHIAdAAg
+AEMAUAAvAEMAUABTACAAYQBuAGQAIAB0AGgAZQAgAFIAZQBsAHkAaQBuAGcAIABQ
+AGEAcgB0AHkAIABBAGcAcgBlAGUAbQBlAG4AdAAgAHcAaABpAGMAaAAgAGwAaQBt
+AGkAdAAgAGwAaQBhAGIAaQBsAGkAdAB5ACAAYQBuAGQAIABhAHIAZQAgAGkAbgBj
+AG8AcgBwAG8AcgBhAHQAZQBkACAAaABlAHIAZQBpAG4AIABiAHkAIAByAGUAZgBl
+AHIAZQBuAGMAZQAuMBIGA1UdEwEB/wQIMAYBAf8CAQAwNAYIKwYBBQUHAQEEKDAm
+MCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wgY8GA1UdHwSB
+hzCBhDBAoD6gPIY6aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0SGln
+aEFzc3VyYW5jZUVWUm9vdENBLmNybDBAoD6gPIY6aHR0cDovL2NybDQuZGlnaWNl
+cnQuY29tL0RpZ2lDZXJ0SGlnaEFzc3VyYW5jZUVWUm9vdENBLmNybDAfBgNVHSME
+GDAWgBSxPsNpA/i/RwHUmCYaCALvY2QrwzAdBgNVHQ4EFgQUUOpzidsp+xCPnuUB
+INTeeZlIg/cwDQYJKoZIhvcNAQEFBQADggEBAB7ipUiebNtTOA/vphoqrOIDQ+2a
+vD6OdRvw/S4iWawTwGHi5/rpmc2HCXVUKL9GYNy+USyS8xuRfDEIcOI3ucFbqL2j
+CwD7GhX9A61YasXHJJlIR0YxHpLvtF9ONMeQvzHB+LGEhtCcAarfilYGzjrpDq6X
+dF3XcZpCdF/ejUN83ulV7WkAywXgemFhM9EZTfkI7qA5xSU1tyvED7Ld8aW3DiTE
+JiiNeXf1L/BXunwH1OH8zVowV36GEEfdMR/X/KLCvzB8XSSq6PmuX2p0ws5rs0bY
+Ib4p1I5eFdZCSucyb6Sxa1GDWL4/bcf72gMhy2oWGU4K8K2Eyl2Us1p292E=
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIGpjCCBY6gAwIBAgIQCc4q8gtIK3iiFj+bqb1z9jANBgkqhkiG9w0BAQUFADBm
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSUwIwYDVQQDExxEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
+ZSBDQS0zMB4XDTEyMDQzMDAwMDAwMFoXDTE0MDcwOTEyMDAwMFowaDELMAkGA1UE
+BhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lz
+Y28xFTATBgNVBAoTDEdpdEh1YiwgSW5jLjEVMBMGA1UEAwwMKi5naXRodWIuY29t
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA70XN+uwT7z4M04aFUwEJ
+ypo6Tlr5gMvBvVFQnJlEqM3rYeqVHU8wU8af1tNV7dE6OkPpbdQ3yYgT2kWOXJnw
+gR16Bzbqsd8OPGAFkKIS2zVm1uB3qKN5UaZTEE83vEbjjtwQE5OZDWqzEB2HFN14
+YHtUezSp8unjO19RtWqnYiC/neEqdX2UJFJKjc0tm1yWL9jf6P04vYCsEWBh57O3
+v4GugyHJ63SI8n0RZgNCX6dV9OwAq/Eju1qr+8p8E6sojA7BIvmUJMoGpNKoRtbU
+RhjlzyG2udbZUYY5UGYEqQZgDx1vqKCbgq9xQ2RVd6ZWsW017HyvSK0BLnYtFubX
+wQIDAQABo4IDTDCCA0gwHwYDVR0jBBgwFoAUUOpzidsp+xCPnuUBINTeeZlIg/cw
+HQYDVR0OBBYEFIFnymFWE2hKxPmD1vRNyJ+hiKP6MCMGA1UdEQQcMBqCDCouZ2l0
+aHViLmNvbYIKZ2l0aHViLmNvbTAOBgNVHQ8BAf8EBAMCBaAwHQYDVR0lBBYwFAYI
+KwYBBQUHAwEGCCsGAQUFBwMCMF8GA1UdHwRYMFYwKaAnoCWGI2h0dHA6Ly9jcmwz
+LmRpZ2ljZXJ0LmNvbS9jYTMtZzguY3JsMCmgJ6AlhiNodHRwOi8vY3JsNC5kaWdp
+Y2VydC5jb20vY2EzLWc4LmNybDCCAcQGA1UdIASCAbswggG3MIIBswYJYIZIAYb9
+bAEBMIIBpDA6BggrBgEFBQcCARYuaHR0cDovL3d3dy5kaWdpY2VydC5jb20vc3Ns
+LWNwcy1yZXBvc2l0b3J5Lmh0bTCCAWQGCCsGAQUFBwICMIIBVh6CAVIAQQBuAHkA
+IAB1AHMAZQAgAG8AZgAgAHQAaABpAHMAIABDAGUAcgB0AGkAZgBpAGMAYQB0AGUA
+IABjAG8AbgBzAHQAaQB0AHUAdABlAHMAIABhAGMAYwBlAHAAdABhAG4AYwBlACAA
+bwBmACAAdABoAGUAIABEAGkAZwBpAEMAZQByAHQAIABDAFAALwBDAFAAUwAgAGEA
+bgBkACAAdABoAGUAIABSAGUAbAB5AGkAbgBnACAAUABhAHIAdAB5ACAAQQBnAHIA
+ZQBlAG0AZQBuAHQAIAB3AGgAaQBjAGgAIABsAGkAbQBpAHQAIABsAGkAYQBiAGkA
+bABpAHQAeQAgAGEAbgBkACAAYQByAGUAIABpAG4AYwBvAHIAcABvAHIAYQB0AGUA
+ZAAgAGgAZQByAGUAaQBuACAAYgB5ACAAcgBlAGYAZQByAGUAbgBjAGUALjB7Bggr
+BgEFBQcBAQRvMG0wJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNv
+bTBFBggrBgEFBQcwAoY5aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lD
+ZXJ0SGlnaEFzc3VyYW5jZUNBLTMuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcN
+AQEFBQADggEBABArBePXElSsd5Ec5IIqfb7MBAafKK1jbFstNTyf175xDJAUPh3p
+5fsB72UOpm1rdfn5/aDc1rgTKiL3t+1ALcHvyIhaxkf2pe39W9zN2bAy0Yx+sSOf
+GEi0LHMfzeDkmaeHrQXUjWBQoE4QOIon7AoBsylNK6gbsLryiab0rJ565/BEhC16
+BfZt0XgSRJHF18enz5vjf2fK6CgtM1poVVEPdxfr9qxdJ7A9MBBw+OcB+JwWdE89
+IzV94FOVPClMm1G87wcFx0cIqYvA3j8g6UvIOeG63PWLmXhAeHCGmVEoIjQz96S/
+Ox6cL5JR0RfxxBvKCzONM8XS2pU1dvUlcpw=
+-----END CERTIFICATE-----

data/lib/twigg/command/git.rb

@@ -0,0 +1,23 @@
+module Twigg
+  class Command
+    class Git < GitHost
+    private
+
+      def sub_subcommands
+        %w[gc]
+      end
+
+      def projects
+        @projects ||= RepoSet.new(@repositories_directory).repos.map(&:name)
+      end
+
+      def gc
+        for_each_repo do |project|
+          Dir.chdir project do
+            git 'gc', '--quiet'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/twigg/command/git_host.rb

@@ -0,0 +1,98 @@
+module Twigg
+  class Command
+    # This is an abstract superclass the holds code common to the "gerrit" and
+    # "github" subcommands.
+    class GitHost < Command
+      def initialize(*args)
+        super
+        @sub_subcommand = @args.first
+
+        unless (1..2).cover?(@args.size) &&
+          sub_subcommands.include?(@sub_subcommand)
+          # eg. "Twigg::Command::{Gerrit,GitHub}" -> "gerrit/github"
+          Help.new(self.class.to_s.split('::').last.downcase).run!
+        end
+
+        @repositories_directory = @args[1] || Config.repositories_directory
+      end
+
+      def run
+        send @sub_subcommand
+      end
+
+    private
+
+      def sub_subcommands
+        %w[clone update]
+      end
+
+      def for_each_repo(&block)
+        Dir.chdir @repositories_directory do
+          projects.each do |project|
+            print @verbose ? "#{project}: " : '.'
+            block.call(project)
+            puts ' done' if @verbose
+          end
+          puts
+        end
+      end
+
+      def clone
+        for_each_repo do |project|
+          if File.directory?(project)
+            print 'skipping (already present);' if @verbose
+          else
+            print 'cloning...' if @verbose
+            git_clone(project)
+          end
+        end
+      end
+
+      def update
+        for_each_repo do |project|
+          if File.directory?(project)
+            Dir.chdir project do
+              print 'pulling...' if @verbose
+              git_pull
+            end
+          else
+            print 'skipping (not present);' if @verbose
+          end
+        end
+      end
+
+      # Convenience method for running a Git command that is expected to succeed
+      # (raises an error if a non-zero exit code is produced).
+      def git(*args)
+        Process.wait(IO.popen(%w[git] + args).pid)
+        raise unless $?.success?
+      end
+
+      # Runs `git clone` to obtain the specified `project`.
+      def git_clone(project)
+        git 'clone', '--quiet', address(project)
+      end
+
+      # Runs `git fetch --quiet` followed by `git merge --ff-only --quiet
+      # FETCH_HEAD`.
+      #
+      # We do this as two commands rather than a `git pull` because the latter
+      # is much fussier about tracking information being in place.
+      def git_pull
+        git 'fetch', '--quiet'
+        git 'merge', '--ff-only', '--quiet', 'FETCH_HEAD'
+      rescue => e
+        # could die here if remote doesn't contain any commits yet
+      end
+
+      def address(*args)
+        raise NotImplementedError # subclass responsibility
+      end
+
+      # Returns the list of all projects hosted within a Git host.
+      def projects
+        raise NotImplementedError # subclass responsibility
+      end
+    end
+  end
+end

data/lib/twigg/command/git_hub.rb

@@ -0,0 +1,67 @@
+require 'net/http'
+require 'net/https'
+require 'json'
+
+module Twigg
+  class Command
+    # The "github" subcommand can be used to conveniently initialize a set of
+    # repos and keep them up-to-date.
+    class GitHub < GitHost
+    private
+
+      def address(project)
+        "git@github.com:#{Config.github.organization}/#{project}.git"
+      end
+
+      API_HOST           = 'api.github.com'
+      API_PORT           = 443
+      ORG_REPOS_ENDPOINT = '/orgs/%s/repos'
+
+      # Returns the list of all projects hosted within a GitHub organization.
+      def projects
+        @projects ||= begin
+          http             = Net::HTTP.new(API_HOST, API_PORT)
+          http.use_ssl     = true
+          http.ca_file     = (Twigg.root + 'files' + 'github.pem').to_s
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+          uri              = ORG_REPOS_ENDPOINT % Config.github.organization
+          headers          = { 'Authorization' => "token #{Config.github.token}" }
+
+          [].tap do |names|
+            begin # loop: page through project list
+              request  = Net::HTTP::Get.new(uri, headers)
+              response = http.request(request)
+              raise "Bad response #{response.inspect}" unless response.is_a?(Net::HTTPOK)
+              names.concat JSON[response.body].map { |repo| repo['name'] }
+              uri = parse_link(response['Link'])
+            end until uri.nil?
+          end
+        end
+      end
+
+      # Parse the next page's URI out of a Link header, which will be of the
+      # form:
+      #
+      #     <https://api.github.com/organizations/1234/repos?page=2>; rel="next",
+      #     <https://api.github.com/organizations/1234/repos?page=N>; rel="last"
+      #
+      # (Linebreak included for readability; in the real headers there are no
+      # linebreaks.)
+      #
+      # We split on "," to get a list of links, find the first link labeled as
+      # `rel="next'`, and then extract the URI from inside the corresponding
+      # angle brackets.
+      #
+      # Returns a `URI` object on success, and `nil` if no suitable link was
+      # present.
+      def parse_link(header)
+        link = header.split(',').find do |link|
+          rel = link.split(';').last
+          rel && rel =~ /rel="next"/
+        end
+
+        URI(link.split(';').first.gsub(/\A<|>\z/, '')) if link
+      end
+    end
+  end
+end

data/lib/twigg/command/help.rb

@@ -0,0 +1,113 @@
+require 'shellwords'
+
+module Twigg
+  class Command
+    class Help < Command
+      PUBLIC_HELP_TOPICS = PUBLIC_SUBCOMMANDS + %w[commands usage]
+      HELP_TOPICS        = PUBLIC_HELP_TOPICS + EASTER_EGGS
+
+      def initialize(*args)
+        super
+        @topic = @args.shift
+        ignore @args
+      end
+
+      def run
+        if HELP_TOPICS.include?(@topic)
+          show_help(@topic)
+        else
+          PUBLIC_HELP_TOPICS.each { |topic| show_help(topic) }
+        end
+      end
+
+    private
+
+      def executable
+        Shellwords.escape($0)
+      end
+
+      TOPIC_HEADERS = Hash.new { |h, k| h[k] = k.capitalize }.merge(
+        # header = subcommand with first letter capitalized; exceptions:
+        'app'    => 'Web application',
+        'github' => 'GitHub',
+      )
+
+      def show_help(topic)
+        puts TOPIC_HEADERS[topic] + ':'
+        stderr strip_heredoc(send(topic)) + "\n"
+      end
+
+      def app
+        <<-DOC
+          #{executable} app
+        DOC
+      end
+
+      def commands
+        <<-DOC
+          #{executable} app    # run the Twigg web app
+          #{executable} gerrit # clone/update/report from Gerrit
+          #{executable} git    # perform operations on Git repos
+          #{executable} github # clone/update from GitHub
+          #{executable} init   # generate a .twiggrc file
+          #{executable} help   # this help information
+          #{executable} stats  # show statistics about repos
+        DOC
+      end
+
+      def gerrit
+        <<-DOC
+          #{executable} gerrit clone [repos dir]  # clone repos into repos dir
+          #{executable} gerrit update [repos dir] # update repos in repos dir
+          #{executable} gerrit stats [repos dir]  # show stats for repos in dir
+        DOC
+      end
+
+      def git
+        <<-DOC
+          #{executable} git gc [repos dir] # garbage collect repos in repos dir
+        DOC
+      end
+
+      def github
+        <<-DOC
+          #{executable} github clone [repos dir]  # clone repos into repos dir
+          #{executable} github update [repos dir] # update repos in repos dir
+        DOC
+      end
+
+      def help
+        <<-DOC
+          #{executable} help              # this help information
+          #{executable} help <subcommand> # help for a specific subcommand
+          #{executable} help commands     # list all subcommands
+        DOC
+      end
+
+      def init
+        <<-DOC
+          #{executable} init # emit a sample .twiggrc file to standard out
+        DOC
+      end
+
+      def russian
+        <<-DOC
+          #{executable} russian <repos dir> <number of days> # easter egg
+        DOC
+      end
+
+      def stats
+        <<-DOC
+          #{executable} stats [--verbose|-v] <repos dir> <number of days>
+        DOC
+      end
+
+      def usage
+        <<-DOC
+          #{executable} <subcommand> [options] <arguments...>
+          #{executable} help
+        DOC
+      end
+    end
+  end
+end

data/lib/twigg/command/init.rb

@@ -0,0 +1,15 @@
+module Twigg
+  class Command
+    class Init < Command
+      def initialize(*args)
+        super
+        ignore @args
+      end
+
+      def run
+        path = Twigg.root + 'templates' + 'twiggrc.yml'
+        IO.copy_stream(path, STDOUT)
+      end
+    end
+  end
+end

data/lib/twigg/command/russian.rb

@@ -0,0 +1,18 @@
+module Twigg
+  class Command
+    class Russian < Command
+      def initialize(*args)
+        super
+        Help.new('russian').run! if @args.size > 2
+
+        @repositories_directory = @args[0] || Config.repositories_directory
+        @days                   = (@args[1] || Config.default_days).to_i
+      end
+
+      def run
+        commit_set = Gatherer.gather(@repositories_directory, @days)
+        puts RussianNovel.new(commit_set).data['children'].to_yaml
+      end
+    end
+  end
+end

data/lib/twigg/command/stats.rb

@@ -0,0 +1,75 @@
+module Twigg
+  class Command
+    class Stats < Command
+      include Util
+
+      def initialize(*args)
+        super
+        Help.new('stats').run! if @args.size > 2
+
+        @repositories_directory = @args[0] || Config.repositories_directory
+        @days                   = (@args[1] || Config.default_days).to_i
+      end
+
+      def run
+        master_set = Twigg::Gatherer.gather(@repositories_directory, @days)
+        w0, w1, w2 = stats_widths(master_set)
+
+        master_set.authors.each do |author_data|
+          author     = author_data[:author]
+          commit_set = author_data[:commit_set]
+          puts '%5s %-24s %s' % [
+            number_with_delimiter(commit_set.count),
+            author,
+            breakdown(commit_set, html: false),
+          ]
+
+          if @verbose
+            puts
+            commit_set.each do |commit|
+              puts (' ' * w0) + " %#{w1}s, %#{w2}s %s [%s]" % [
+                "+#{number_with_delimiter commit.stat[:additions]}",
+                "-#{number_with_delimiter commit.stat[:deletions]}",
+                commit.subject,
+                commit.repo.name,
+              ]
+            end
+
+            totals = (' ' * w0) + " %#{w1}s, %#{w2}s" % [
+              "+#{number_with_delimiter commit_set.additions}",
+              "-#{number_with_delimiter commit_set.deletions}",
+            ]
+            puts '-' * totals.length
+            puts totals
+            puts
+          end
+        end
+
+        if @verbose
+          totals = "%-#{w0}s %#{w1}s, %#{w2}s" % [
+            number_with_delimiter(master_set.count),
+            "+#{number_with_delimiter master_set.additions}",
+            "-#{number_with_delimiter master_set.deletions}",
+          ]
+          puts '=' * totals.length
+          puts totals
+        else
+          totals = "%#{w0}s" % number_with_delimiter(master_set.count)
+          puts '-' * totals.length
+          puts totals
+        end
+      end
+
+      # Returns a tuple of "column" widths with sufficient space to represent
+      # the commit count, addition count and deletion count for the given
+      # {CommitSet}, `master_set`.
+      def stats_widths(master_set)
+        [
+          number_with_delimiter(master_set.count).length,
+          number_with_delimiter(master_set.additions).length + 1, # room for sign
+          number_with_delimiter(master_set.deletions).length + 1, # room for sign
+        ]
+      end
+    end
+  end
+end

data/lib/twigg/command.rb

@@ -0,0 +1,108 @@
+require 'forwardable'
+
+module Twigg
+  class Command
+    # Subcommands, in the order they should appear in the help output.
+    PUBLIC_SUBCOMMANDS = %w[help init app stats gerrit github git]
+
+    EASTER_EGGS        = %w[russian]
+    SUBCOMMANDS        = PUBLIC_SUBCOMMANDS + EASTER_EGGS
+
+    autoload :Git,     'twigg/command/git'
+    autoload :GitHost, 'twigg/command/git_host'
+    autoload :GitHub,  'twigg/command/git_hub'
+    autoload :Init,    'twigg/command/init'
+    autoload :Help,    'twigg/command/help'
+    autoload :Russian, 'twigg/command/russian'
+    autoload :Stats,   'twigg/command/stats'
+
+    extend Console
+    include Console
+
+    class << self
+      include Dependency # for with_dependency
+
+      def run(subcommand, *args)
+        Help.new('usage').run! unless SUBCOMMANDS.include?(subcommand)
+
+        if args.include?('-h') || args.include?('--help')
+          Help.new(subcommand).run
+          exit
+        end
+
+        begin
+          send(subcommand, *args)
+        rescue => e
+          raise if args.include?('-d') || args.include?('--debug')
+
+          error e.message
+          stderr '[run with -d or --debug flag to see full stack trace]'
+          die
+        end
+      end
+
+    private
+
+      def ignore(args)
+        warn "unsupported extra arguments #{args.inspect} ignored" if args.any?
+      end
+
+      def app(*args)
+        ignore args
+        with_dependency('twigg-app') { App::Server.run! }
+      end
+
+      def gerrit(*args)
+        with_dependency('twigg-gerrit') { Gerrit.new(*args).run }
+      end
+
+      def git(*args)
+        Git.new(*args).run
+      end
+
+      def github(*args)
+        GitHub.new(*args).run
+      end
+
+      def help(*args)
+        Help.new(*args).run
+      end
+
+      def init(*args)
+        Init.new(*args).run
+      end
+
+      def russian(*args)
+        Russian.new(*args).run
+      end
+
+      def stats(*args)
+        Stats.new(*args).run
+      end
+    end
+
+    extend Forwardable
+    def_delegators 'self.class', :ignore
+
+    def initialize(*args)
+      Config.config # ensure `-c`/`--config` option is applied
+      consume_option(%w[-c --config], args) # ensure consumed
+
+      @debug   = true if args.delete('-d') || args.delete('--debug')
+      @verbose = true if args.delete('-v') || args.delete('--verbose')
+      @args    = args
+    end
+
+    # Run and then die.
+    def run!
+      run
+      die
+    end
+
+    # Abstract implementation of a "run" method; subclasses are expected to
+    # override this method.
+    def run
+      raise NotImplementedError
+    end
+  end
+end

data/lib/twigg/commit.rb

@@ -0,0 +1,59 @@
+module Twigg
+  class Commit
+    attr_reader :repo, :commit, :subject, :body, :author, :date, :stat
+
+    def initialize(options)
+      raise ArgumentError unless @repo    = options[:repo]
+      raise ArgumentError unless @commit  = options[:commit]
+      raise ArgumentError unless @subject = options[:subject]
+      raise ArgumentError unless @body    = options[:body]
+      raise ArgumentError unless @author  = options[:author]
+      raise ArgumentError unless @date    = options[:date]
+      raise ArgumentError unless @stat    = options[:stat]
+    end
+
+    def link
+      if Config.github.organization
+        "https://github.com/#{Config.github.organization}/#{repo.name}/commit/#{commit}"
+      end
+    end
+
+    def author_names
+      @author.split(/\+|&|,|\band\b/).map(&:strip)
+    end
+
+    def eql?(other)
+      other.is_a?(Commit)         &&
+        other.repo    == @repo    &&
+        other.commit  == @commit  &&
+        other.subject == @subject &&
+        other.body    == @body    &&
+        other.author  == @author  &&
+        other.date    == @date    &&
+        other.stat    == @stat
+    end
+
+    def filtered_commit_message
+      @filtered_commit_message ||= @body.lines.reject do |line|
+        line =~ /^[a-z-]+: /i # filter out Change-Id:, Signed-off-by: etc
+      end.concat([@subject]).join("\n").chomp
+    end
+
+    def flesch_reading_ease
+      @flesch_reading_ease ||= Flesch.new(filtered_commit_message).reading_ease
+    end
+
+    # Return the length of the commit message in lines.
+    def russianness
+      filtered_commit_message.lines.count
+    end
+
+    def inspect
+      "repo: #{@repo.name}\n" +
+        "commit: #{@commit}\n" +
+        "subject: #{@subject}\n" +
+        "author: #{@author}\n" +
+        "stat: +#{@stat[:additions]}, -#{@stat[:deletions]}"
+    end
+  end
+end