contributions 0.1.1

data/.gitignore

@@ -0,0 +1,20 @@
+.sass-cache
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+b/
+.rbenv-version

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in contributions.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Charlie Tanksley
+
+MIT License
+
+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,162 @@
+# Contributions
+
+Get the detailed information about all your OSS contributions in one 
+place.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'contributions'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install contributions
+
+## Fair Warning:
+
+Right now, Contributions doesn't know what to do if you have more than 
+100 public repositories.  I'll fix that later.  Consider yourself 
+warned.
+
+## Requirements
+
+[![Build Status](https://secure.travis-ci.org/charlietanksley/contributions.png)](http://travis-ci.org/charlietanksley/contributions)
+
+Contributions is known to work on:
+
+* MRI 1.9.2
+* MRI 1.9.3
+
+At present it does not work on:
+
+* Rubinius 1.2.4
+
+I don't know about any other Rubys.
+
+## Usage
+
+### Finding contributions
+
+The main idea behind contributions is to make it easy to add your open 
+source contributions to a resume or website.
+
+A Contributions object takes a hash as an argument.  The only required 
+key is `:username`.  This is the user's github username.  From here you 
+have a few options.  You can manually update the list of repositories 
+(see below).  When you are ready you can use the 
+`.contributions_as_hash` method to return the user's contributions.
+
+Finding all a user's contributions is very computationally intensive: we 
+actually create a clone (in a temporary directory :)) of every forked 
+repository and look for contributions via a `git log --author=username` 
+command.  The first time you call this method it may take a while to 
+return the hash (especially if you have forks of really big projects).  
+Since you might want to access this hash multiple times, the result is 
+cached.  If you want or need to update this for some reason, use the 
+`.reload_contributions` method and then `.contributions_as_hash` to get 
+the new results.
+
+### But which projects?
+
+By default, contributions assumes that a user has contributed to every 
+forked OSS project in his or her github account.  When you generate your 
+list of contributions, contributions will look for contributions in 
+every forked repository in your account.  (Note: it will look not for 
+additions you have made locally, but for additions that have been merged 
+into the forked project; it looks for commits in that project for which 
+you are either an author or committer.)
+
+Some people have lots of forks that they don't contribute to.  In that 
+case, you can pass an array of projects to ignore to contributions:
+
+    Contributions::Contributions.new(:username => 'u', :remove => ['homebrew'])
+
+If you have contributed to projects that you have not forked (perhaps 
+you keep a tidy github account :)), you can add those in by passing an 
+array of projects to contributions:
+
+    Contributions::Contributions.new(:username => 'u', :add => ['rubinius/rubinius'])
+
+Notice that you must pass both the repository name and the username in 
+this case.
+
+Finally, you might want to only get your contributions to a certain set 
+of repositories, ignoring any others (e.g., any others your forked).
+
+    Contributions::Contributions.new(:username => 'u', :only => ['rubinius/rubinius'])
+
+The envisioned use case for this command is when you have lots of forked 
+repositories, perhaps even ones you have contributed to, but only care 
+to get your contributions for one.
+
+### Adding or subtracting contributions
+
+Before you determine the contributions for a user, you might need to 
+alter the list of repositories you are looking at.  You can find out 
+which repositories are currently being considered with the 
+`repositories` method:
+
+    c = Contributions::Contributions.new(:username => 'u')
+    c.repositories
+    # ['rubinius/rubinius', 'mxcl/homebrew']
+
+You can find out just the project names with the `project_names` method
+
+    c = Contributions::Contributions.new(:username => 'u')
+    c.project_names
+    # ['rubinius', 'homebrew']
+
+You can subtract a repository using the `remove` method.  The `remove` 
+method takes either a string (in the case of a single repository) or an 
+array of strings as an argument.  The repositories should be specified 
+in the username/repository pattern.
+
+    c = Contributions::Contributions.new(:username => 'u')
+    c.repositories
+    # ['sinatra/sinatra', 'rubinius/rubinius', 'mxcl/homebrew']
+    c.remove('sinatra/sinatra')
+    # ['rubinius/rubinius', 'mxcl/homebrew']
+    c.remove(['rubinius/rubinius', 'mxcl/homebrew'])
+    # []
+
+You can add a repository using the `add` command.  It takes arguments 
+just like `remove`.
+
+    c = Contributions::Contributions.new(:username => 'u')
+    c.repositories
+    # []
+    c.add('sinatra/sinatra')
+    # ['sinatra/sinatra']
+    c.add(['rubinius/rubinius', 'mxcl/homebrew'])
+    # ['sinatra/sinatra', 'rubinius/rubinius', 'mxcl/homebrew']
+
+### Determining your contributions
+
+    c = Contributions::Contributions.new(:username => 'u')
+    # => # does not determine the contributions
+    c.contributions_as_hash
+    # => {:project1 => [...], :project2 => [...] ... }
+
+### Getting the information out
+
+You access commits via `contributions_as_hash`:
+
+    c = Contributions::Contributions.new(:username => 'u')
+    c.repositories
+    # ['sinatra/sinatra', 'rubinius/rubinius']
+    c.contributions_as_hash
+    # => {:'sinatra/sinatra' => ["commit data", "commit data"], :'rubinius/rubinius' => ["commit data"]}
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,16 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rake'
+require 'rake/testtask'
+
+desc "Run all our tests"
+task :test do
+  Rake::TestTask.new do |t|
+    t.libs << "test"
+    t.pattern = "test/**/*_test.rb"
+    t.verbose = false
+  end
+end
+
+task :default => :test

data/TODO.markdown

@@ -0,0 +1,6 @@
+# Things to add
+
+* Some sort of progress option for `.load_contributions`.  It takes 
+  forever.  It would be nice if you knew what it was working on.
+* Silence the 'unpacking objects: ...' output that comes from somewhere.  
+  Where is that comming from?

data/contributions.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/contributions/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Charlie Tanksley"]
+  gem.email         = ["charlie.tanksley@gmail.com"]
+  gem.description   = %q{Gather your contributions to OSS projects (hosted on github!).}
+  gem.summary       = %q{A gem to find all your contributions to OSS projects on github and make that information easy to access.}
+  gem.homepage      = ""
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "contributions"
+  gem.require_paths = ["lib"]
+  gem.version       = Contributions::VERSION
+
+  gem.add_dependency('json')
+
+  gem.add_development_dependency('riot')
+  gem.add_development_dependency('rake')
+end

data/lib/contributions/contributions.rb

@@ -0,0 +1,153 @@
+require 'json'
+
+module Contributions
+  class Contributions
+
+    # opts - a Hash with, at the very least, a username.  Optional
+    #        arguments include :remove (to ignore some repository),
+    #        :add (to add), and :only (to focus).
+    def initialize(opts={})
+      @username = opts.delete(:username)
+      setup_repositories(opts)
+    end
+
+    # Public: Add a repository (or array of repositories).
+    #
+    # repos - a 'username/repository' String or Array of such strings.
+    #
+    # Returns the updated array of repositories.
+    def add(repos)
+      @repositories.add(repos)
+
+      repositories
+    end
+
+    # Public: Return a user's OSS contributions as a hash.  If the hash
+    # hasn't already been determined, the contributions are all looked
+    # up and stashed in an ivar: @contributions.  If @contributions
+    # already exists, it is returned without the costly lookup being
+    # performed.
+    #
+    # Returns a Hash.
+    def contributions_as_hash
+      load_contributions unless @contributions
+      @contributions
+    end
+
+    # Public: Determine a user's contributions and load the
+    # @contributions ivar.
+    #
+    # Returns a Hash.
+    def load_contributions
+      @contributions = Hash.new
+      repositories.each do |f|
+        conts = get_contributions(f)
+        @contributions[f] = conts unless conts.empty?
+      end
+
+      @contributions
+    end
+
+    # Public: Replace the user's forked repositories with the specified
+    # repositories.
+    #
+    # repos - a 'username/repository_name' string, or an array of such
+    #         strings.
+    #
+    # Returns the updated array of repositories.
+    def only(repos)
+      @repositories.only repos
+
+      repositories
+    end
+
+    # Public: Provide the names for all the forked projects.
+    #
+    # Example:
+    #
+    #     user.repositories
+    #     # => ['r/r', 's/s']
+    #     user.project_names
+    #     # => ['r', 's']
+    #
+    # Returns an Array.
+    def project_names
+      repositories.map { |s| s.match(/[^\/]*$/)[0] }
+    end
+
+    # Public: Remove a repository (or array of repositories).
+    #
+    # repos - a 'username/repository' String or Array of such strings.
+    #
+    # Returns the updated array of repositories.
+    def remove(repos)
+      @repositories.remove(repos)
+
+      repositories
+    end
+
+    # Public: Accessor method for the @repositories ivar.
+    #
+    # array - an array of 'username/repository_name' strings.
+    #
+    # Returns nothing.
+    def repositories=(array)
+      @repositories = RepositoryList.new(array)
+    end
+
+    # Public: Accessor method for the @repositories ivar.
+    #
+    # Returns an Array of 'username/repository_name' strings.
+    def repositories
+      @repositories.list
+    end
+
+    # Internal: attr_accessor for @contributions.  This method really only
+    # exists for testing.
+    #
+    # hash - a hash.
+    #
+    # Returns a Hash.
+    def contributions=(hash)
+      @contributions = hash
+    end
+
+    # Internal: attr_reader for @contributions.  This method really only
+    # exists for testing.
+    #
+    # Returns a Hash.
+    def contributions
+      @contributions
+    end
+
+    # Internal: Generate an array of forked repositories for the user.
+    # This array is set as the @repositories variable.
+    #
+    # opts - an array with, possible, keys for :only, :remove, and :add.
+    #
+    # Returns an Array of repositories.
+    def setup_repositories(opts)
+      @repositories = RepositoryList.new(GithubAPI.forks(@username))
+      update(opts)
+    end
+
+    # Internal: Get the user's contributions to the repository.
+    #
+    # Returns a Hash.
+    def get_contributions(repository)
+      Git.contributions GithubAPI.name(@username), repository
+    end
+
+    # Internal: Combine the user's explicit preferences with an array of
+    # forks.
+    #
+    # Returns an Array.
+    def update(opts)
+      opts.each_pair do |k,v|
+        @repositories.send(k.to_sym, v)
+      end
+
+      repositories
+    end
+  end
+end

data/lib/contributions/git.rb

@@ -0,0 +1,66 @@
+require 'tmpdir'
+require 'fileutils'
+require 'contributions/string_utils'
+
+module Contributions
+  class Git
+
+    ENDING    = " CONTRIBUTIONS_ENDING "
+    KEYS      = [:sha, :date, :subject, :body]
+    SEPARATOR = " CONTRIBUTIONS_SEPARATOR "
+
+    # Public: Get all the contributions in a repository by a user
+    # (contributions for which the user is the *author*).
+    #
+    # user       - a user's name (the name that shows up as the committer or
+    #              author---e.g., 'John Smith'
+    # repository - a 'username/repository_name' string.
+    #
+    # Returns an Array of Hashes with keys for :sha, :date, :subject, :body
+    def self.contributions(user, repository)
+      log = self.clone(repository) { self.read_log(user) }
+      StringUtils.string_to_hash(log, KEYS, SEPARATOR, ENDING)
+    end
+
+    # Public: Clone a repository and run the block passed inside the
+    # newly cloned repository.
+    #
+    # repository - a 'username/repository_name' string.
+    # block      - a block to be executed inside the newly cloned
+    #              directory.
+    #
+    # Returns the return value of the block.
+    def self.clone(repository, &block)
+      value = ''
+      repo_name = repository.match(/([^\/]*$)/)[1]
+      Dir.mktmpdir(repo_name) do |dir|
+        cloned_repo_name = dir + '/' + repo_name
+        system "git clone -q https://github.com/#{repository} #{cloned_repo_name}"
+        Dir.chdir(cloned_repo_name) do
+          value = yield
+        end
+
+        FileUtils.rm_rf(cloned_repo_name)
+      end
+
+      value
+    end
+
+    # Internal: The command to read the git log.
+    #
+    # user - the user's name.
+    #
+    # Returns nothing.
+    def self.read_log(user)
+      # We want a string returned (for parsing); so use read over
+      # readlines.
+      IO.popen("git log --author='#{user}' --format='#{self.log_format}' --no-color") { |io| io.read }
+    end
+
+    def self.log_format
+      ["%h", "%ci", "%s", "%b"].join(SEPARATOR) << ENDING
+    end
+
+
+  end
+end

data/lib/contributions/github_api.rb

@@ -0,0 +1,62 @@
+require 'open-uri'
+require 'json'
+
+module Contributions
+  class GithubAPI
+
+    # Public: Get just the user's repositories that are forks.
+    #
+    # Returns an Array.
+    def self.forks(username)
+      forks = self.repos(username).select { |r| r["fork"] == true }
+      repo_names = forks.map { |r| r["owner"]["login"] + '/' + r["name"] }
+      repo_names.map { |r| self.parent(r) }
+    end
+
+    # Public: Get the name of the user.
+    #
+    # username - github username.
+    #
+    # Returns a String.
+    def self.name(username)
+      self.user(username)["name"]
+    end
+
+    # Public: Get the name of the forked repository.
+    #
+    # repository - a 'username/repository_name' string.
+    #
+    # Returns a String.
+    def self.parent(repository)
+      username, repo_name = repository.split('/')
+      repo_info = self.repository(repository)
+      repo_info["parent"]["owner"]["login"] + '/' + repo_name
+    end
+
+    # Public: Get all the user's repositories.
+    #
+    # Returns an Array.
+    def self.repos(username)
+      JSON.parse(open("https://api.github.com/users/#{username}/repos?per_page=100") { |f| f.read } )
+    end
+
+    # Internal: Get the user info (all of it) from github.
+    #
+    # username - github username.
+    #
+    # Returns a Hash.
+    def self.user(username)
+      JSON.parse(open("https://api.github.com/users/#{username}") { |f| f.read } )
+    end
+
+    # Internal: Get the repository info (all of it) from github.
+    #
+    # repository - a 'username/repository_name' string.
+    #
+    # Returns a Hash.
+    def self.repository(repository)
+      JSON.parse(open("https://api.github.com/repos/#{repository}") { |f| f.read } )
+    end
+
+  end
+end

data/lib/contributions/repository_list.rb

@@ -0,0 +1,56 @@
+module Contributions
+  class RepositoryList
+
+    attr_reader :list
+
+    def initialize(*args)
+      @list = [args].flatten
+    end
+
+    # Public: Add a string or array of strings to the repository list.
+    #
+    # repos - a string or an array of strings (each of which is a
+    #         'username/repo')
+    #
+    # Returns a RepositoryList
+    def add(repos)
+      @list.push(repos).flatten!
+      self
+    end
+
+    # Public: Turn repositories into key value pairs.
+    #
+    # Returns an Array of Hashes {:username, :repository}
+    def key_value_pairs
+      results = []
+      @list.each do |e|
+        p = e.split('/')
+        results.push Hash[:username => p[0], :repository => p[1]]
+      end
+
+      results
+    end
+
+    # Public: Replace list of repositories with the list provided.
+    #
+    # repos - a string or an array of strings (each of which is a
+    #         'username/repo')
+    #
+    # Returns a RepositoryList
+    def only(repos)
+      @list = [repos].flatten
+      self
+    end
+
+    # Public: Remove a string or array of strings from the repository
+    # list.
+    # repos - a string or an array of strings (each of which is a
+    #         'username/repo')
+    #
+    # Returns a RepositoryList
+    def remove(repos)
+      @list.delete_if { |e| [repos].flatten.include? e }
+      self
+    end
+  end
+end

data/lib/contributions/string_utils.rb

@@ -0,0 +1,133 @@
+module Contributions
+  class StringUtils
+      
+    # Public: Read a long string of commit data and turn it into a
+    # hash.
+    #
+    # string    - a string of commit data.
+    # separator - the separator between values in an entry.
+    # ending    - the separator between entries.
+    # keys      - an Array of keys for the final hash.
+    #
+    # Returns a Hash.
+    def self.string_to_hash(string, keys, separator, *ending)
+      s = string.dup
+      s_as_array = ending.empty? ? [s] : self.split!(s, ending[0])
+
+      s_as_array.map! { |e| self.split!(e, separator) }
+      self.remove_empty(s_as_array)
+
+      s_as_array.map! do |e|
+        e.map! { |line| line.strip }
+        self.zip_to_hash(keys, e)
+      end
+
+      s_as_array.map do |e|
+        self.short_dates(e)
+      end
+
+      # s_as_array.map do |e|
+      #   self.zip_to_hash(keys, e)
+      # end
+
+
+      # self.split!(s, ending).each do |e|
+      #   self.remove_empty(self.split!(e, separator))
+      # end
+
+      # Now we need the zip move, then to a hash, then replace nils with
+      # ''
+
+      # s = string.dup
+      # array = string.split()
+      # small_arrays = array.map { |e| e.split(separator).map { |l| l.strip } }
+      # small_arrays.delete_if { |a| a[0] == "" and a[1] == nil }
+      # small_arrays.map! { |a| [:sha, :date, :subject, :body].zip a }
+      # small_arrays
+
+
+
+
+      # results = []
+      # s = string.dup
+      # s.gsub!(/(\d{4}-\d{2}-\d{2})/) { |f| " BREAK " + f }
+      # s = s.split(" BREAK ")
+      # s.delete_if { |l| l.empty? }
+      # s.each do |line|
+      #   m = /(?<date>\d{4}-\d{2}-\d{2})/.match line
+      #   results.push m["date"]
+      # end
+
+      # results
+    end
+
+    # Public: Split the string on the give separator.
+    #
+    # separator - the character(s) on which to split the string.
+    #
+    # Returns a modified version of the string.
+    def self.split!(string, separator)
+      string.split(separator)
+    end
+
+    # Internal: Remove any empty arrays after a split.
+    #
+    # array - an array of Strings.
+    #
+    # Returns an Array of Strings (modified)
+    def self.remove_empty(array)
+      array.delete_if { |a| self.practically_empty?(a[0]) && a[1].nil? }
+    end
+
+    # Internal: Determine whether a string has any content.
+    #
+    # Examples:
+    #
+    #    StringUtils.practically_empty?('')
+    #    # => true
+    #    StringUtils.practically_empty?("\n\n")
+    #    # => true
+    #    StringUtils.practically_empty?("a\n")
+    #    # => false
+    #
+    # Returns a Boolean.
+    def self.practically_empty?(arg)
+      if arg.empty?
+        return true
+      elsif !arg.match /\w/
+        return true
+      else
+        return false
+      end
+    end
+
+    # Internal: Convert a pair of arrays into a hash with the first as
+    # keys.
+    #
+    # keys   - an Array of keys.
+    # values - an Array of values.
+    #
+    # Returns a Hash.
+    def self.zip_to_hash(keys, values)
+      value = Hash.new
+      zipped = keys.zip values
+      zipped.each do |pair|
+        value[pair.first] = pair.last || ''
+      end
+
+      value
+    end
+
+    # Internal: Convert date format to a simpler one.
+    #
+    # hash - a hash with a :date key
+    #
+    # Returns a Hash.
+    def self.short_dates(hash)
+      old_date = hash[:date]
+      hash[:date] = old_date.match(/(\d{4}-\d{2}-\d{2})/)[1]
+
+      hash
+    end
+  end
+end

data/lib/contributions/version.rb

@@ -0,0 +1,3 @@
+module Contributions
+  VERSION = "0.1.1"
+end

data/lib/contributions.rb

@@ -0,0 +1,9 @@
+require "contributions/version"
+require 'contributions/contributions'
+require 'contributions/git'
+require 'contributions/github_api'
+require 'contributions/repository_list'
+require 'contributions/string_utils'
+
+module Contributions
+end

data/test/contributions_integration_test.rb

@@ -0,0 +1,78 @@
+require 'teststrap'
+require 'contributions'
+
+context "Contributions::Contributions" do
+  hookup { RR.reset }
+  helper(:full) { Contributions::Contributions.new(:username => 'charlietanksley') }
+
+  context ".new finds out about all forks" do
+    setup { full }
+    asserts(:repositories).includes "msanders/snipmate.vim"
+    asserts(:repositories).includes "thumblemonks/riot"
+  end
+
+  context ".new with an :only modifies the forks" do
+    setup { Contributions::Contributions.new(:username => 'charlietanksley', :only => 'thumblemonks/riot') }
+    asserts(:repositories).equals ['thumblemonks/riot']
+  end
+
+  context ".new with a :remove subtracts a fork" do
+    setup { Contributions::Contributions.new(:username => 'charlietanksley', :remove => 'thumblemonks/riot') }
+    denies(:repositories).includes 'thumblemonks/riot'
+    asserts("we have subtracted 1") { full.repositories.count - topic.repositories.count == 1 }.equals true
+  end
+
+  context ".new will :remove with an array as an argument" do
+    setup { Contributions::Contributions.new(:username => 'charlietanksley', :remove => ['thumblemonks/riot', 'rubinius/rubinius']) }
+    denies(:repositories).includes 'thumblemonks/riot'
+    denies(:repositories).includes 'rubinius/rubinius'
+  end
+
+  context ".new with an :add adds a fork" do
+    setup { Contributions::Contributions.new(:username => 'charlietanksley', :add => 'thumblemonks/chicago') }
+    asserts(:repositories).includes 'thumblemonks/chicago'
+    asserts("we have added 1") { topic.repositories.count - full.repositories.count == 1 }.equals true
+  end
+
+  context ".new will :add with an array as an argument" do
+    setup { Contributions::Contributions.new(:username => 'charlietanksley', :add => ['t/r', 'r/r']) }
+    asserts(:repositories).includes 't/r'
+    asserts(:repositories).includes 'r/r'
+  end
+end
+
+context "a full run of Contributions::Contributions" do
+  setup { Contributions::Contributions.new(:username => 'charlietanksley',
+                                           :only => ['thumblemonks/riot', 'msanders/snipmate.vim', 'davetron5000/methadone']) }
+
+  context "starts with a list of repositories" do
+    asserts(:repositories).equals ['thumblemonks/riot', 'msanders/snipmate.vim', 'davetron5000/methadone']
+  end
+
+  context "does not start with any contributions" do
+    asserts(:contributions).nil
+  end
+
+  context "grabs the contributions when asked" do
+
+    context "with the right keys" do
+      setup { topic.contributions_as_hash.keys }
+      asserts_topic.includes 'thumblemonks/riot'
+      asserts_topic.includes 'davetron5000/methadone'
+    end
+
+    context "and saves them off" do
+      hookup { topic.contributions_as_hash }
+      setup { topic.contributions.keys }
+      asserts_topic.includes 'thumblemonks/riot'
+      asserts_topic.includes 'davetron5000/methadone'
+    end
+  end
+
+  context "when the list is updated" do
+    hookup { topic.remove ['thumblemonks/riot', 'davetron5000/methadone'] }
+    hookup { topic.load_contributions }
+    asserts { topic.contributions_as_hash.keys }.equals []
+    asserts(:contributions_as_hash).equals Hash[]
+  end
+end

data/test/contributions_test.rb

@@ -0,0 +1,112 @@
+require 'teststrap'
+require 'contributions'
+
+context "Contributions public api with mocked .new" do
+  hookup do
+    stub(Contributions::GithubAPI).forks(anything) { ['r/r', 's/s'] }
+  end
+
+  setup { Contributions::Contributions.new(:username => 'charlietanksley') }
+
+  context ".new" do
+    context "assignments" do
+      asserts_topic.assigns :username
+      asserts_topic.assigns :repositories
+    end
+
+    asserts(:repositories).equals ['r/r', 's/s']
+  end
+
+  context ".add will add repositories" do
+    context "if given a string" do
+      setup { topic.add 'added/added' }
+      asserts_topic.includes 'added/added'
+    end
+
+    context "if given an array" do
+      setup { topic.add ['added/first', 'added/second'] }
+      asserts_topic.includes 'added/first'
+      asserts_topic.includes 'added/second'
+    end
+  end
+
+  context ".contributions_as_hash" do
+    context "does not reload hash if it already exists" do
+      hookup do
+        topic.contributions = Hash[:k => 'v']
+        dont_allow(topic).load_contributions
+      end
+
+      asserts(:contributions_as_hash).equals Hash[:k => 'v']
+    end
+
+    context "calls #load_contributions if there aren't any contributions yet" do
+      hookup { mock(topic).load_contributions { topic.contributions = Hash[:k => 'v'] } }
+      asserts(:contributions_as_hash).equals Hash[:k => 'v']
+    end
+  end
+
+  context ".only will trade out repositories" do
+    context "if given a string" do
+      setup { topic.only 'added/added' }
+      asserts_topic.includes 'added/added'
+      denies_topic.includes 'r/r'
+      denies_topic.includes 's/s'
+    end
+
+    context "if given an array" do
+      setup { topic.only ['added/first', 'added/second'] }
+      asserts_topic.includes 'added/first'
+      asserts_topic.includes 'added/second'
+      denies_topic.includes 'r/r'
+      denies_topic.includes 's/s'
+    end
+  end
+
+  context ".project_names returns an array of project names" do
+    asserts(:project_names).equals { ['r', 's'] }
+  end
+
+  context ".load_contributions" do
+    context "actually calls out to get the contributions for each fork" do
+      hookup do
+        mock(Contributions::Git).contributions('Charlie Tanksley', 'r/r') { Hash[:sha => 1] }
+        mock(Contributions::Git).contributions('Charlie Tanksley', 's/s') { Hash[:sha => 2] }
+      end
+
+      denies(:load_contributions).nil
+    end
+
+    context "returns a hash with repository names as keys" do   
+      hookup do
+        stub(Contributions::Git).contributions('Charlie Tanksley', 'r/r') { Hash[:sha => 1] }
+        stub(Contributions::Git).contributions('Charlie Tanksley', 's/s') { Hash[:sha => 2] }
+      end                                                       
+
+      asserts(:load_contributions).equals Hash['r/r' => Hash[:sha => 1], 's/s' => Hash[:sha => 2]]
+    end
+
+    context "stashes the results in an instance variable" do
+      hookup do
+        stub(Contributions::Git).contributions('Charlie Tanksley', 'r/r') { Hash[:sha => 1] }
+        stub(Contributions::Git).contributions('Charlie Tanksley', 's/s') { Hash[:sha => 2] }
+        topic.load_contributions
+      end                                                       
+
+      asserts(:contributions).equals Hash['r/r' => Hash[:sha => 1], 's/s' => Hash[:sha => 2]]
+    end
+  end
+
+  context ".remove will drop repositories" do
+    context "if given a string" do
+      setup { topic.remove 'r/r' }
+      denies_topic.includes 'added/added'
+    end
+
+    context "if given an array" do
+      setup { topic.remove ['r/r', 's/s'] }
+      denies_topic.includes 'r/r'
+      denies_topic.includes 's/s'
+    end
+  end
+end

data/test/git_test.rb

@@ -0,0 +1,28 @@
+require 'teststrap'
+require 'contributions/git'
+
+context "Contributions::Git" do
+  context ".contributions" do
+    context 'determines all the user\'s contributions' do
+      setup { Contributions::Git.contributions('Charlie Tanksley', 'thumblemonks/riot') }
+
+      asserts_topic.size 6
+    end
+  end
+
+  context ".clone creates a clone and runs the block you pass it" do
+    helper(:command) { "git log --author='Charlie Tanksley' --format='%h %ci %s %b' --no-color" }
+    setup do
+      Contributions::Git.clone('thumblemonks/riot') { IO.popen(command) { |io| io.readlines } }
+    end
+
+    asserts_topic.size 6
+  end
+
+  context ".log_format" do
+    setup { Contributions::Git.log_format }
+
+    asserts_topic.equals "%h CONTRIBUTIONS_SEPARATOR %ci CONTRIBUTIONS_SEPARATOR %s CONTRIBUTIONS_SEPARATOR %b CONTRIBUTIONS_ENDING "
+  end
+
+end

data/test/github_api_test.rb

@@ -0,0 +1,41 @@
+require 'teststrap'
+require 'contributions/github_api'
+
+context "Contributions::GithubAPI" do
+  context ".forks" do
+    setup { Contributions::GithubAPI.forks('charlietanksley') }
+
+    context "gets a list of all the forks" do
+      setup { topic.count }
+      denies_topic.equals 0
+    end
+
+    context "gets the original names, not the name of the fork" do
+      denies_topic.includes 'charlietanksley/riot'
+      asserts_topic.includes 'thumblemonks/riot'
+    end
+  end
+
+  context ".repos gets all the repositories when there are less than 100" do
+    setup { Contributions::GithubAPI.repos('rubinius').count }
+    
+    asserts_topic.equals JSON.parse(open("https://api.github.com/users/rubinius") { |f| f.read })["public_repos"]
+  end
+
+  # Pending
+  context ".repos gets all the repositories when there are tons" do
+    # setup { Contributions::GithubAPI.repos('vim-scripts').count }
+    
+    # asserts_topic.equals JSON.parse(open("https://api.github.com/users/vim-scripts") { |f| f.read })["public_repos"]
+  end
+
+  context ".name returns the name of the user" do
+    setup { Contributions::GithubAPI.name('charlietanksley') }
+    asserts_topic.equals 'Charlie Tanksley'
+  end
+
+  context ".parent returns the name of the forked repository" do
+    setup { Contributions::GithubAPI.parent('charlietanksley/riot') }
+    asserts_topic.equals 'thumblemonks/riot'
+  end
+end

data/test/repository_list_test.rb

@@ -0,0 +1,73 @@
+require 'teststrap'
+require 'contributions/repository_list'
+
+context "RepositoryList" do
+  context "#add" do
+    context "with a blank canvas" do
+      setup { Contributions::RepositoryList.new }
+
+      context "adds a single string" do
+        hookup { topic.add('rubinius/rubinius') }
+        asserts(:list).equals ['rubinius/rubinius']
+      end
+
+      context "adds an array of strings" do
+        hookup { topic.add ['rubinius/rubinius', 'vim-scripts/test.vim'] }
+        asserts(:list).equals ['rubinius/rubinius', 'vim-scripts/test.vim']
+      end
+    end
+
+    context "with a starting array" do
+      setup { Contributions::RepositoryList.new(['s/s']) }
+
+      context "adds a single string" do
+        hookup { topic.add 'rubinius/rubinius' }
+        asserts(:list).equals ['s/s', 'rubinius/rubinius']
+      end
+
+      context "adds an array of strings" do
+        hookup { topic.add ['rubinius/rubinius', 'vim-scripts/test.vim'] }
+        asserts(:list).equals ['s/s', 'rubinius/rubinius', 'vim-scripts/test.vim']
+      end
+    end
+  end
+
+  context "#remove" do
+    setup { Contributions::RepositoryList.new(['s/s', 's/ss', 'o/other']) }
+
+    context "selectively removes a single repo" do
+      hookup { topic.remove 's/s' }
+      asserts(:list).equals ['s/ss', 'o/other']
+    end
+
+    context "selectively removes an array of repos" do
+      hookup { topic.remove ['s/s', 's/ss'] }
+      asserts(:list).equals ['o/other']
+    end
+  end
+
+  context "#only completely replaces the list" do
+    setup { Contributions::RepositoryList.new(['s/s', 's/ss', 'o/other']) }
+
+    context "when given a single repo" do
+      hookup { topic.only 'a/a' }
+      asserts(:list).equals ['a/a']
+    end
+
+    context "when given an array" do
+      hookup { topic.only ['a/a', 'b/b'] }
+      asserts(:list).equals ['a/a', 'b/b']
+    end
+  end
+
+  context "#key_value_pairs splits into key value pairs" do
+    setup { Contributions::RepositoryList.new(['s/s', 's/ss', 'o/other']) }
+    asserts(:key_value_pairs).equals [{:username => 's', :repository => 's'},
+                                      {:username => 's', :repository => 'ss'},
+                                      {:username => 'o', :repository => 'other'}]
+  end
+
+end
+
+
+

data/test/string_utils_test.rb

@@ -0,0 +1,62 @@
+require 'teststrap'
+require 'contributions/string_utils'
+
+context "StringUtils" do
+  helper(:string)    { "1b90c5e CONTRIBUTIONS_SEPARATOR 2011-09-13 07:49:43 -0500 CONTRIBUTIONS_SEPARATOR remove mention of deprecated exists from README CONTRIBUTIONS_SEPARATOR  CONTRIBUTIONS_ENDING \n1620141 CONTRIBUTIONS_SEPARATOR 2011-12-16 19:26:58 -0500 CONTRIBUTIONS_SEPARATOR adjust input boxes to be same height as buttons CONTRIBUTIONS_SEPARATOR There was this weird thing happening where the inline submit button on a\nform would be like twice as tall as the text input area (notably on the\nuser_search form, but in a few other places it looked weird).  This\nmakes all those a standard height (the same as the default Twitter\nbutton height). CONTRIBUTIONS_ENDING \n\n" }
+  helper(:ending)    { " CONTRIBUTIONS_ENDING " }
+  helper(:separator) { " CONTRIBUTIONS_SEPARATOR " }
+
+  context ".split!" do
+    context "splits the string in place" do
+      setup { Contributions::StringUtils.split!(string, ending) }
+
+      asserts_topic.size 3
+    end
+  end
+
+  context ".remove_empty throws out any 'blank' arrays" do
+    setup { Contributions::StringUtils.remove_empty([['s'], ['', 's'], [''], ["\n\n"]]) }
+    asserts_topic.size 2
+  end
+
+  context ".zip_to_hash" do
+    context "creates a hash with the first array as the key" do
+      setup { Contributions::StringUtils.zip_to_hash([:k, :v, :e], ['key', 'value', 'empty']) }
+      asserts_topic.equals Hash[:k => 'key', :v => 'value', :e => 'empty']
+    end
+
+    context "creates a hash with the first array as the key and '' for any empty values" do
+      setup { Contributions::StringUtils.zip_to_hash([:k, :v, :e], ['key']) }
+      asserts_topic.equals Hash[:k => 'key', :v => '', :e => '']
+    end
+  end
+
+  context ".string_to_hash turns a hash of commit info into a useful hash" do
+    setup do
+      one = "1b90c5e CONTRIBUTIONS_SEPARATOR 2011-09-13 07:49:43 -0500 CONTRIBUTIONS_SEPARATOR remove mention of deprecated exists from README CONTRIBUTIONS_SEPARATOR  CONTRIBUTIONS_ENDING \n"
+      two = "7201941 CONTRIBUTIONS_SEPARATOR 2011-09-13 07:48:53 -0500 CONTRIBUTIONS_SEPARATOR add deprecation warning to exists macro CONTRIBUTIONS_SEPARATOR  CONTRIBUTIONS_ENDING \n"
+      three = "1620141 CONTRIBUTIONS_SEPARATOR 2011-12-16 19:26:58 -0500 CONTRIBUTIONS_SEPARATOR adjust input boxes to be same height as buttons CONTRIBUTIONS_SEPARATOR There was this weird thing happening where the inline submit button on a\nform would be like twice as tall as the text input area (notably on the\nuser_search form, but in a few other places it looked weird).  This\nmakes all those a standard height (the same as the default Twitter\nbutton height). CONTRIBUTIONS_ENDING \n\n"
+      Contributions::StringUtils.string_to_hash([one, two, three].join, [:sha, :date, :subject, :body], separator, ending)
+    end
+
+    asserts_topic.equals [{:sha => "1b90c5e",
+                          :date => "2011-09-13",
+                          :subject =>  "remove mention of deprecated exists from README",
+                          :body => ''},
+                          {:sha=>"7201941",
+                           :date=>"2011-09-13",
+                           :subject=>"add deprecation warning to exists macro",
+                           :body=>""},
+                          {:sha=>"1620141",
+                           :date=>"2011-12-16",
+                           :subject=>"adjust input boxes to be same height as buttons",
+                           :body=>"There was this weird thing happening where the inline submit button on a\nform would be like twice as tall as the text input area (notably on the\nuser_search form, but in a few other places it looked weird).  This\nmakes all those a standard height (the same as the default Twitter\nbutton height)."}]
+  end
+
+  context ".short_dates gives you cleaner dates" do
+    setup { Contributions::StringUtils.short_dates(Hash[:sha=>"7201941", :date=>"2011-09-13 07:48:53 -0500", :subject=>"add deprecation warning to exists macro", :body=>""]) }
+
+    asserts_topic.equals Hash[:sha=>"7201941", :date=>"2011-09-13", :subject=>"add deprecation warning to exists macro", :body=>""]
+  end
+
+end

data/test/teststrap.rb

@@ -0,0 +1,2 @@
+require 'riot'
+require 'riot/rr'

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: contributions
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Charlie Tanksley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &70340630508160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70340630508160
+- !ruby/object:Gem::Dependency
+  name: riot
+  requirement: &70340630505820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70340630505820
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70340630514680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70340630514680
+description: Gather your contributions to OSS projects (hosted on github!).
+email:
+- charlie.tanksley@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- TODO.markdown
+- contributions.gemspec
+- lib/contributions.rb
+- lib/contributions/contributions.rb
+- lib/contributions/git.rb
+- lib/contributions/github_api.rb
+- lib/contributions/repository_list.rb
+- lib/contributions/string_utils.rb
+- lib/contributions/version.rb
+- test/contributions_integration_test.rb
+- test/contributions_test.rb
+- test/git_test.rb
+- test/github_api_test.rb
+- test/repository_list_test.rb
+- test/string_utils_test.rb
+- test/teststrap.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: A gem to find all your contributions to OSS projects on github and make that
+  information easy to access.
+test_files:
+- test/contributions_integration_test.rb
+- test/contributions_test.rb
+- test/git_test.rb
+- test/github_api_test.rb
+- test/repository_list_test.rb
+- test/string_utils_test.rb
+- test/teststrap.rb