hubtime 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+data
+.DS_Store
+hubtime_config.yml
+.rvmrc

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gem 'commander'
+gem 'active_support'
+gem 'i18n'
+gem 'tzinfo'
+
+gem 'octokit'
+gem 'terminal-table'
+gem 'erubis'
+gem 'hashie'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,56 @@
+PATH
+  remote: .
+  specs:
+    hubtime (0.0.1)
+      active_support (~> 3.0)
+      commander (~> 4.1)
+      erubis (~> 2.7)
+      hashie (~> 1.2)
+      i18n (~> 0.6)
+      octokit (~> 1.20)
+      terminal-table (~> 1.4)
+      tzinfo (~> 0.3)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    active_support (3.0.0)
+      activesupport (= 3.0.0)
+    activesupport (3.0.0)
+    addressable (2.3.2)
+    commander (4.1.3)
+      highline (~> 1.6.11)
+    erubis (2.7.0)
+    faraday (0.8.4)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.9.0)
+      faraday (>= 0.7.4, < 0.9)
+    hashie (1.2.0)
+    highline (1.6.15)
+    i18n (0.6.1)
+    multi_json (1.5.0)
+    multipart-post (1.1.5)
+    netrc (0.7.7)
+    octokit (1.20.0)
+      addressable (~> 2.2)
+      faraday (~> 0.8)
+      faraday_middleware (~> 0.9)
+      hashie (~> 1.2)
+      multi_json (~> 1.3)
+      netrc (~> 0.7.7)
+    terminal-table (1.4.5)
+    tzinfo (0.3.35)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  active_support
+  commander
+  erubis
+  hashie
+  hubtime!
+  i18n
+  octokit
+  terminal-table
+  tzinfo

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2012 Brian Leonard
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,109 @@
+## Hubtime
+
+I wanted to be able to see how things went this year, but Github didn't give a graph across all the repositories. I used their API to generate some graphs.
+
+### Commands
+
+First, you need to install the gem:
+
+    gem install hubtime
+
+Note: `hubtime` will add the file `hubtime_config.yml` and the directory `data` on the directory you run the command.
+
+To give auth (It will store your password encrypted on disk)
+
+    hubtime auth
+
+To see what repositiories it will pull from
+
+    hubtime repositories
+    
+To ignore some of those
+
+    hubtime ignore bleonard/rails
+    
+Caching is heavily used to not kill Github and speed things up. Caching is done at the sha, time window per repo, and the full history levels.
+Specifically, if you add another repo or something, you'll want to do this
+
+    hubtime clear activity
+
+If things are generally messed up and you want to start again, clear it all
+
+    hubtime clear all
+    
+#### To show table of commits and such
+
+    hubtime table
+    hubtime table --months 3
+    hubtime table --unit day
+    hubtime table --unit day --months 1
+    hubtime table --unit year
+    
+    hubtime table --unit month
+    +---------+---------+--------+-----------+-----------+
+    | Month   | Commits | Impact | Additions | Deletions |
+    +---------+---------+--------+-----------+-----------+
+    | 2012-01 | 241     | 29581  | 15324     | 14257     |
+    | 2012-02 | 250     | 15518  | 7844      | 7674      |
+    | 2012-03 | 181     | 16647  | 12036     | 4611      |
+    | 2012-04 | 130     | 14755  | 12213     | 2542      |
+    | 2012-05 | 178     | 40102  | 22883     | 17219     |
+    | 2012-06 | 91      | 9870   | 7279      | 2591      |
+    | 2012-07 | 50      | 5017   | 4677      | 340       |
+    | 2012-08 | 110     | 10124  | 5214      | 4910      |
+    | 2012-09 | 49      | 3632   | 2535      | 1097      |
+    | 2012-10 | 153     | 54326  | 34419     | 19907     |
+    | 2012-11 | 183     | 27958  | 22602     | 5356      |
+    | 2012-12 | 123     | 21099  | 13897     | 7202      |
+    +---------+---------+--------+-----------+-----------+
+
+#### Graph a piece of data
+
+    hubtime graph
+    hubtime graph impact
+    hubtime graph deletions
+    hubtime graph additions --user otherlogin
+    
+    hubtime graph commits --months 3
+
+![Commit Graph](https://raw.github.com/bleonard/hubtime/master/readme/graph.png)
+    
+#### All of those work with a stacked graph to see if broken up by repository
+
+    hubtime graph --stacked
+    
+    hubtime graph impact --stacked
+    
+![Stacked Graph](https://raw.github.com/bleonard/hubtime/master/readme/stacked.png)
+    
+#### Impact Graph like on Github
+
+    hubtime impact
+    
+    hubtime impact --months 12
+
+![Stacked Graph](https://raw.github.com/bleonard/hubtime/master/readme/impact.png)
+    
+#### Pie chart of repositories
+
+    hubtime pie
+    hubtime pie impact
+    
+    hubtime pie --months 3
+
+![Stacked Graph](https://raw.github.com/bleonard/hubtime/master/readme/pie.png)
+    
+#### Sparklines in the console
+
+    hubtime spark
+    hubtime spark commits
+    
+    hubtime spark impact
+    ▄▂▂▂▅▁▁▁▇▇▄▃
+    
+#### Development
+
+I use rvm and bundler. Check out this repo and `bundle install` to get started.
+All of the above commands would need `bundle exec` prepended to work in development.
+    
+

data/bin/hubtime

@@ -0,0 +1,199 @@
+#!/usr/bin/env ruby
+
+require 'commander/import'
+require 'hubtime'
+
+program :name, 'hubtime'
+program :version, Hubtime::VERSION
+program :description, 'See activity on Github.'
+ 
+command :impact do |c|
+  c.syntax = 'hubtime impact'
+  c.summary = ''
+  c.description = 'Graph your additions and deletions'
+  c.example 'description', 'command example'
+  c.option '--months INTEGER', 'How many months of history'
+  c.option '--user USERNAME', 'Which Github user'
+  c.action do |args, options|
+    options.default :months => 12
+    activity = Hubtime::Activity.new(self, options.user, options.months)
+    file = activity.impact
+    puts "saved: #{file}"
+    `open #{file}`
+  end
+end
+
+command :graph do |c|
+  c.syntax = 'hubtime graph [commits|impact|additions|deletions]'
+  c.summary = ''
+  c.description = 'Graph a single count'
+  c.example 'description', 'command example'
+  c.option '--months INTEGER', 'How many months of history'
+  c.option '--user USERNAME', 'Which Github user'
+  c.option '--stacked', 'To see data by repository'
+  c.action do |args, options|
+    options.default :months => 12
+    options.default :data => "count"
+    type = args.first
+    type ||= "commits"
+    type = "count" if type == "commits"
+    activity = Hubtime::Activity.new(self, options.user, options.months)
+    file = activity.graph(type, options.stacked.present?)
+    puts "saved: #{file}"
+    `open #{file}`
+  end
+end
+
+command :pie do |c|
+  c.syntax = 'hubtime pie [commits|impact|additions|deletions]'
+  c.summary = ''
+  c.description = 'Graph a pie chart by repository'
+  c.example 'description', 'command example'
+  c.option '--months INTEGER', 'How many months of history'
+  c.option '--user USERNAME', 'Which Github user'
+  c.action do |args, options|
+    options.default :months => 12
+    options.default :data => "count"
+    type = args.first
+    type ||= "commits"
+    type = "count" if type == "commits"
+    activity = Hubtime::Activity.new(self, options.user, options.months)
+    file = activity.pie(type)
+    puts "saved: #{file}"
+    `open #{file}`
+  end
+end
+
+command :table do |c|
+  c.syntax = 'hubtime table [options]'
+  c.summary = ''
+  c.description = 'Table your time'
+  c.example 'description', 'command example'
+  c.option '--months INTEGER', 'How many months of history'
+  c.option '--user USERNAME', 'How many months of history'
+  c.option '--unit (year|month|day)', 'Granularity of the results'
+  c.action do |args, options|
+    options.default :months => 12
+    options.default :unit => "month"
+    activity = Hubtime::Activity.new(self, options.user, options.months)
+    puts activity.table(options.unit)
+  end
+end
+
+command :spark do |c|
+  c.syntax = 'hubtime spark [options]'
+  c.summary = ''
+  c.description = 'Graph your time'
+  c.example 'description', 'command example'
+  c.option '--months INTEGER', 'How many months of history'
+  c.option '--user USERNAME', 'How many months of history'
+  c.option '--unit (year|month|day)', 'Granularity of the results'
+  c.option '--data (count|impact|additions|deletions)', 'Type of results'
+  c.action do |args, options|
+    options.default :months => 12
+    options.default :unit => "month"
+    type = args.first
+    type ||= "commits"
+    type = "count" if type == "commits"
+
+    activity = Hubtime::Activity.new(self, options.user, options.months)
+    puts activity.spark(options.unit, type)
+  end
+end
+
+command :config do |c|
+  c.syntax = 'hubtime config --user USERNAME --password PASSWORD'
+  c.summary = ''
+  c.description = 'Sets your details'
+  c.example 'description', 'command example'
+  c.option '--user USERNAME', 'Github user name'
+  c.option '--password PASSWORD', 'Github password'
+  c.action do |args, options|
+    if options.password || options.user
+      raise("Need password") unless options.password
+      raise("Need github user name") unless options.user
+      Hubtime::HubConfig.store(options.user, options.password)
+      puts "Set config..."
+    else
+      puts "Current config..."
+    end
+
+    puts "  Username: #{Hubtime::HubConfig.user}"
+    puts "  Password: #{Hubtime::HubConfig.display_password}"
+
+    unless options.password || options.user
+      puts "To set, use command: hubtime config --user USERNAME --password PASSWORD" 
+    end
+
+    puts ""
+  end
+end
+
+command :auth do |c|
+  c.syntax = 'hubtime auth'
+  c.summary = ''
+  c.description = 'Saves credentials'
+  c.action do |args, options|
+    username = ask("Github Username: ")
+    password = ask("Github Password: ") { |q| q.echo = "*" }
+
+    raise "Need a username" if username.blank?
+    raise "Need a password" if password.blank?
+
+    Hubtime::HubConfig.auth(username, password)
+
+    puts "Current auth..."
+
+    puts "  Username: #{Hubtime::HubConfig.user}"
+    puts "  Password: #{Hubtime::HubConfig.display_password}"
+
+    unless options.password || options.user
+      puts "To set directly, use command: hubtime config --user USERNAME --password PASSWORD" 
+    end
+
+    puts ""
+  end
+end
+
+command :ignore do |c|
+  c.syntax = 'hubtime ignore REPO_NAME'
+  c.summary = ''
+  c.description = 'Stop looking at this repo'
+  c.example 'description', 'hubtime ignore bleonard/rails'
+  c.action do |args, options|
+    if args.first
+      Hubtime::HubConfig.add_ignore(args.first)
+      Hubtime::Cacher.clear("activity")  # different repos
+      Hubtime::Cacher.clear("charts")
+    end
+
+    puts "Current ignore list: #{Hubtime::HubConfig.ignore.join(", ")}"
+    puts "This list can be edited in the config.yml"
+  end
+end
+
+command :clear do |c|
+  c.syntax = 'hubtime clear'
+  c.summary = ''
+  c.description = 'Removes items from the cache'
+  c.example 'description', 'hubtime clear activity'
+  c.action do |args, options|
+    args << "activity" if args.size == 0
+    args.each do |item|
+      Hubtime::Cacher.clear(item)
+    end
+  end
+end
+
+command :repositories do |c|
+  c.syntax = 'hubtime repositories'
+  c.description = 'Lists known repositories'
+  c.option '--user USERNAME', 'Github user name'
+  c.action do |args, options|
+    user = options.user
+    user ||= Hubtime::HubConfig.user
+    Hubtime::GithubService.owner.repositories(user).each do |name|
+      puts name
+    end
+  end
+end

data/hubtime.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "hubtime/version"
+
+Gem::Specification.new do |s|
+  s.name        = "hubtime"
+  s.version     = Hubtime::VERSION
+  s.summary     = "Visualization of your Github activity over the past year via Github API."
+  s.email       = "contact@plataformatec.com.br"
+  s.homepage    = "http://github.com/bleonard/hubtime"
+  s.description = "Visualization of your Github activity over the past year via Github API with visualizations like table, graph, stacked graph and pie chart."
+  s.authors     = ['Brian Leonard']
+
+  s.rubyforge_project = "hubtime"
+
+  s.executables << "hubtime"
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.add_dependency("active_support", "~> 3.0")
+  s.add_dependency("commander", "~> 4.1")
+  s.add_dependency("i18n", "~> 0.6")
+  s.add_dependency("tzinfo", "~> 0.3")
+  s.add_dependency("octokit", "~> 1.20")
+  s.add_dependency("terminal-table", "~> 1.4")
+  s.add_dependency("erubis", "~> 2.7")
+  s.add_dependency("hashie", "~> 1.2")
+end

data/lib/hubtime.rb

@@ -0,0 +1,16 @@
+require 'active_support'
+require 'active_support/all'
+require 'terminal-table'
+require 'fileutils'
+require 'yaml'
+require 'erubis'
+require 'hashie'
+require 'octokit'
+
+require 'hubtime/version'
+require 'hubtime/hub_config'
+require 'hubtime/cacher'
+require 'hubtime/commit'
+require 'hubtime/github'
+require 'hubtime/activity'
+require 'hubtime/repo'