gigest 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4c72d8d8cb527ede3b858a34ef086ff08923c5ce
+  data.tar.gz: b9b44d3380cad5990be22693ec8d9a893710a344
+SHA512:
+  metadata.gz: b7dabb8214a7b0be3ca9bb2046e373168ed07a3fdec12dbdd0b6f46fc1d9f44e8c3328b17bf037f142752d60a2ad85f1bf845f1fb38dd4354090cf17bca7a92f
+  data.tar.gz: 2609a9e2aae72c0d82fb8d187077858986da0fd1781b9f52e05ecebfed27cb9cf7662b88f697b97154f510aa9590a4cbcd03e7c07162baf2706a93065d5a4b3f

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.DS_Store
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.env

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.ruby-gemset

@@ -0,0 +1 @@
+gigest

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p247

data/Gemfile

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

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2013 Winston Teo Yong Wei
+
+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.markdown

@@ -0,0 +1,70 @@
+# GIGEST
+
+**GI**tHub **GE**m **ST**ats. Discover Gems usage for a GitHub user or org!
+
+Do you want to know which are the most/least frequently used Gems for a GitHub user or organization?
+GIGEST gives you the ability to do that by inspecting the Gemfiles across all repos for a GitHub account.
+
+
+## Installation
+
+    gem install 'gigest'
+
+
+## Usage
+
+1) Authenticate. You have [4 ways to do it](http://octokit.github.io/octokit.rb/#Authentication).
+
+    analytics = Gigest::Analytics.new(login: "winston", password: "secret")
+
+Authenticating with your username and password will give GIGEST access to public and private repos within your GitHub account and organization/s.
+
+Authenticating with an OAuth access token will give GIGEST access to repos depending on the [scopes
+which the OAuth access token was granted](http://developer.github.com/v3/oauth/#scopes).
+
+2) Process for a GitHub user or GitHub Organization.
+
+    analytics.process_for("winston")
+
+This can take a while if the GitHub account contains A LOT of repos. Sit back and relax.
+
+3) Get summary.
+
+    analytics.summary
+
+Returns you a Hash in the format:
+
+    {
+      gem1: [repo1, repo2],
+      gem2: [repo1, repo2, repo3, repo4]
+    }
+
+4) Get statistics.
+
+    analytics.statistics
+
+Returns you a Hash in the format:
+
+    {
+      gem1: 2, # number of times seen
+      gem2: 4
+    }
+
+
+## Contributing
+
+Pull Requests are very welcomed (with specs, of course)!
+
+To run all specs, just execute `rake` or `rspec`.
+
+
+## Author
+
+GIGEST is maintained by [Winston Teo](mailto:winstonyw+gigest@gmail.com).
+
+[You should follow Winston on Twitter](http://www.twitter.com/winstonyw), or find out more on [WinstonYW](http://www.winstonyw.com) and [LinkedIn](http://sg.linkedin.com/in/winstonyw).
+
+
+## License
+
+Copyright © 2013 Winston Teo Yong Wei. Free software, released under the MIT license.

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+
+# RSpec Tasks
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts 		= ['--options', '.rspec']
+  t.fail_on_error 	= false
+end
+
+task :default => :spec

data/gigest.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+# Maintain your gem's version:
+require 'gigest/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "gigest"
+  gem.version       = Gigest::VERSION
+  gem.authors       = ["Winston Teo"]
+  gem.email         = ["winston.yongwei+gigest@gmail.com"]
+  gem.homepage      = "https://github.com/winston/gigest"
+  gem.summary       = "GIthubGEmSTats. Discover Gems usage for a GitHub user or org."
+  gem.description   = "Inspects Gemfiles across all repos for a GitHub user or org and generates Gem usage statistics."
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "octokit", "~> 2.0"
+
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "vcr"
+  gem.add_development_dependency "webmock"
+  gem.add_development_dependency "multi_json"
+
+  gem.license = 'MIT'
+end

data/lib/gigest.rb

@@ -0,0 +1,9 @@
+require "base64"
+require "octokit"
+
+lib_path = File.dirname(__FILE__)
+require "#{lib_path}/gigest/version"
+
+require "#{lib_path}/gigest/analytics"
+require "#{lib_path}/gigest/github/github_connection"
+require "#{lib_path}/gigest/github/github_repo"

data/lib/gigest/analytics.rb

@@ -0,0 +1,45 @@
+module Gigest
+  class Analytics
+    attr_reader :repositories, :repositories_with_gemfile
+
+    def initialize(auth_params={})
+      @connection = GithubConnection.new(auth_params)
+    end
+
+    def process_for(account=nil, type=:user)
+      @repositories              = @connection.repositories_for(account, type)
+      @repositories_with_gemfile = @repositories.select(&:has_gemfile?)
+    end
+
+    # Returns summary
+    # {
+    #   gem1: [repo1, repo2],
+    #   gem2: [repo1, repo2]
+    # }
+    def summary
+      raise "Please specify GitHub account to analyse by invoking #process_for(account) method first!" if @repositories.nil?
+
+      @repositories_with_gemfile.inject({}) do |summary, repository|
+        repository.gems.each do |gem|
+          summary[gem] ||= []
+          summary[gem] << repository.name unless summary[gem].include?(repository.name)
+        end
+
+        summary
+      end
+    end
+
+    # Returns statistic (sorted desc)
+    # [
+    #   [gem1, 2],
+    #   [gem2, 1]
+    # ]
+    def statistics
+      summary.inject({}) do |summary, (gem, repos)|
+        summary[gem] = repos.count
+        summary
+      end
+      .sort_by { |gem, count| count }.reverse
+    end
+  end
+end

data/lib/gigest/github/github_connection.rb

@@ -0,0 +1,41 @@
+module Gigest
+  class GithubConnection
+    def initialize(auth_params)
+      @connection = Octokit::Client.new(auth_params)
+    end
+
+    def repositories_for(account=nil, type=:user)
+      all_repositories  = []
+
+      page = 0
+      loop do
+        repositories = @connection.send(repository_method(type), account, page: page+=1)
+        break if repositories.empty?
+
+        all_repositories += repositories.map { |repository| GithubRepo.new(repository, gemfile_for(repository.full_name)) }
+      end
+
+      all_repositories
+    end
+
+    def gemfile_for(repository_name)
+      decode(file_blob(repository_name, "Gemfile"))
+    rescue Octokit::NotFound
+      nil
+    end
+
+    private
+
+    def repository_method(type)
+      type == :user ? :repositories : :organization_repositories
+    end
+
+    def decode(blob)
+      Base64.decode64(blob)
+    end
+
+    def file_blob(repository_name, file)
+      @connection.contents(repository_name, path: file).content
+    end
+  end
+end

data/lib/gigest/github/github_repo.rb

@@ -0,0 +1,35 @@
+module Gigest
+  class GithubRepo
+    def initialize(repository, gemfile)
+      @repository = repository
+      @gemfile    = gemfile
+    end
+
+    def name
+      @repository.full_name
+    end
+
+    def has_gemfile?
+      !@gemfile.nil?
+    end
+
+    def gems
+      return [] if !has_gemfile?
+
+      @gems ||= process_gemfile
+    end
+
+    private
+
+    def process_gemfile
+      @gemfile.split("\n").map do |string|
+        string.start_with?("#") ? nil : find_gem_name(string)
+      end.compact
+    end
+
+    def find_gem_name(string)
+      regex_match = string.match(/gem\s+(?<sdq>['"])(?<name>[a-zA-Z0-9\-_]+)\k<sdq>/)
+      regex_match.nil? ? nil : regex_match[:name]
+    end
+  end
+end

data/lib/gigest/version.rb

@@ -0,0 +1,3 @@
+module Gigest
+  VERSION = "1.0.0"
+end

data/spec/fixtures/Gemfile

@@ -0,0 +1,15 @@
+source 'http://rubygems.org'
+
+gem 'rails', '3.2.14'
+
+gem 'google_visualr', '~> 2.1.9'
+
+group :assets do
+  gem 'compass-rails' , '~> 1.0.3'
+  gem 'sass-rails'    , '~> 3.2.5'
+  gem 'uglifier'
+end
+
+group :development do
+  gem 'heroku'
+end

data/spec/fixtures/statistics.json

@@ -0,0 +1,60 @@
+[
+  ["uglifier", 4],
+  ["sass-rails", 3],
+  ["jquery-rails", 3],
+  ["rails", 3],
+  ["heroku", 3],
+  ["rspec-rails", 2],
+  ["capybara", 2],
+  ["google_visualr", 2],
+  ["bourbon", 2],
+  ["mocha", 2],
+  ["nokogiri", 2],
+  ["haml", 2],
+  ["mysql", 1],
+  ["rdiscount", 1],
+  ["sass", 1],
+  ["jquery-ui-themes", 1],
+  ["sinatra", 1],
+  ["thin", 1],
+  ["ruby-debug", 1],
+  ["rspec", 1],
+  ["ibm_db", 1],
+  ["activerecord-oracle_enhanced-adapter", 1],
+  ["ruby-oci8", 1],
+  ["activerecord-jdbcpostgresql-adapter", 1],
+  ["activerecord-jdbcmysql-adapter", 1],
+  ["jruby-openssl", 1],
+  ["activerecord-jdbcsqlite3-adapter", 1],
+  ["mysql2", 1],
+  ["foreman", 1],
+  ["pg", 1],
+  ["sqlite3", 1],
+  ["rest-client", 1],
+  ["yajl-ruby", 1],
+  ["json", 1],
+  ["ruby-prof", 1],
+  ["memcache-client", 1],
+  ["w3c_validators", 1],
+  ["RedCloth", 1],
+  ["sdoc", 1],
+  ["pivotal_git_scripts", 1],
+  ["rake", 1],
+  ["journey", 1],
+  ["bcrypt-ruby", 1],
+  ["arel", 1],
+  ["awesome_print", 1],
+  ["compass-rails", 1],
+  ["turn", 1],
+  ["pry", 1],
+  ["cactus", 1],
+  ["webmock", 1],
+  ["evergreen", 1],
+  ["ruby-debug19", 1],
+  ["factory_girl_rails", 1],
+  ["coffee-rails", 1],
+  ["timecop", 1],
+  ["haml-rails", 1],
+  ["rcov", 1],
+  ["simplecov", 1]
+]

data/spec/fixtures/summary.json

@@ -0,0 +1,60 @@
+{
+  "activerecord-jdbcmysql-adapter": ["winston/rails"],
+  "activerecord-jdbcpostgresql-adapter": ["winston/rails"],
+  "activerecord-jdbcsqlite3-adapter": ["winston/rails"],
+  "activerecord-oracle_enhanced-adapter": ["winston/rails"],
+  "arel": ["winston/rails"],
+  "awesome_print": ["winston/trackerstats"],
+  "bcrypt-ruby": ["winston/rails"],
+  "bourbon": ["winston/cactus_app", "winston/soloistrc_builder"],
+  "cactus": ["winston/cactus_app"],
+  "capybara": ["winston/cactus_app", "winston/trackerstats"],
+  "coffee-rails": ["winston/cactus_app"],
+  "compass-rails": ["winston/google_visualr_app"],
+  "evergreen": ["winston/trackerstats"],
+  "factory_girl_rails": ["winston/trackerstats"],
+  "foreman": ["winston/soloistrc_builder"],
+  "google_visualr": ["winston/google_visualr_app", "winston/trackerstats"],
+  "haml": ["winston/soloistrc_builder", "winston/trackerstats"],
+  "haml-rails": ["winston/cactus_app"],
+  "heroku": ["winston/google_visualr_app", "winston/soloistrc_builder", "winston/trackerstats"],
+  "ibm_db": ["winston/rails"],
+  "journey": ["winston/rails"],
+  "jquery-rails": ["winston/cactus_app", "winston/rails", "winston/trackerstats"],
+  "jquery-ui-themes": ["winston/trackerstats"],
+  "jruby-openssl": ["winston/rails"],
+  "json": ["winston/rails"],
+  "memcache-client": ["winston/rails"],
+  "mocha": ["winston/rails", "winston/simple_form"],
+  "mysql": ["winston/rails"],
+  "mysql2": ["winston/rails"],
+  "nokogiri": ["winston/rails", "winston/trackerstats"],
+  "pg": ["winston/rails"],
+  "pivotal_git_scripts": ["winston/trackerstats"],
+  "pry": ["winston/evergreen"],
+  "rails": ["winston/cactus_app", "winston/google_visualr_app", "winston/trackerstats"],
+  "rake": ["winston/rails"],
+  "rcov": ["winston/vestal_versions"],
+  "rdiscount": ["winston/soloistrc_builder"],
+  "RedCloth": ["winston/rails"],
+  "rest-client": ["winston/trackerstats"],
+  "rspec": ["winston/set-interview-ruby"],
+  "rspec-rails": ["winston/cactus_app", "winston/trackerstats"],
+  "ruby-debug": ["winston/simple_form"],
+  "ruby-debug19": ["winston/trackerstats"],
+  "ruby-oci8": ["winston/rails"],
+  "ruby-prof": ["winston/rails"],
+  "sass": ["winston/soloistrc_builder"],
+  "sass-rails": ["winston/cactus_app", "winston/google_visualr_app", "winston/trackerstats"],
+  "sdoc": ["winston/rails"],
+  "simplecov": ["winston/vestal_versions"],
+  "sinatra": ["winston/soloistrc_builder"],
+  "sqlite3": ["winston/rails"],
+  "thin": ["winston/soloistrc_builder"],
+  "timecop": ["winston/trackerstats"],
+  "turn": ["winston/trackerstats"],
+  "uglifier": ["winston/cactus_app", "winston/google_visualr_app", "winston/rails", "winston/trackerstats"],
+  "w3c_validators": ["winston/rails"],
+  "webmock": ["winston/trackerstats"],
+  "yajl-ruby": ["winston/rails"]
+}