octokit 0.4.0

data/.document

@@ -0,0 +1,4 @@
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+*.swp
+*.tmproj
+*~
+.DS_Store
+.\#*
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+\#*
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Wynn Netherland, Adam Stacoviak, Erik Michaels-Ober
+
+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,69 @@
+Octokit
+=======
+Simple Ruby wrapper for the GitHub v2 API. 
+
+Installation
+------------
+    gem install octokit
+    
+Some examples
+-------------
+
+### Show a user
+
+    Octokit.user('pengwynn')
+    => <#Hashie::Mash blog="http://wynnnetherland.com" company="Orrka" created_at="2008/02/25 10:24:19 -0800" email="wynn.netherland@gmail.com" followers_count=21 following_count=55 id=865 location="Dallas, TX" login="pengwynn" name="Wynn Netherland" public_gist_count=4 public_repo_count=16>
+    
+### Show who a user follows
+
+    Octokit.following('pengwynn')
+    => ["cglee", "bryansray", "rails", "zachinglis", "wycats", "obie", "mully", "squeejee", "jderrett", "Shopify", "ReinH", "technoweenie", "errfree", "defunkt", "joshsusser", "hashrocket", "newbamboo", "bigtiger", "github", "jamis", "jeresig", "thoughtbot", "therealadam", "jnunemaker", "seaofclouds", "choan", "llimllib", "kwhinnery", "marshall", "handcrafted", "adamstac", "jashkenas", "dan", "remy", "hayesdavis", "documentcloud", "imathis", "mdeiters", "njonsson", "asenchi", "mattsa", "marclove", "webiest", "brogers", "polomasta", "stephp", "mchelen", "piyush", "davidnorth", "rmetzler", "jferris", "madrobby", "zh", "erikvold", "desandro"]
+    
+Working with repositories
+-------------------------
+For convenience, methods that require a repo argument may be passed in any of the following forms
+
+* "pengwynn/linked"
+* {:username => 'pengwynn', :name => 'linkedin'}
+* {:username => 'pengwynn', :repo => 'linkedin'}
+* instance of Repository
+
+### Show a repo
+
+    Octokit.repo("pengwynn/linkedin")
+    => <#Hashie::Mash description="Ruby wrapper for the LinkedIn API" fork=false forks=1 homepage="http://bit.ly/ruby-linkedin" name="linkedin" open_issues=2 owner="pengwynn" private=false url="http://github.com/pengwynn/linkedin" watchers=36>
+    
+Authenticated requests
+----------------------
+Some methods require authentication so you'll need to pass a login and an api_token. You can find your GitHub API token on your [account page](https://github.com/account)
+
+    client = Octokit::Client.new(:login => 'pengwynn', :token => 'OU812')
+    client.follow!('adamstac')
+
+Read the full [docs](http://rdoc.info/projects/pengwynn/octokit)
+
+TODO
+----
+* Feed parsing
+* More examples
+
+Submitting a Pull Request
+-------------------------
+1. Fork the project.
+2. Create a topic branch.
+3. Implement your feature or bug fix.
+4. Add documentation for your feature or bug fix.
+5. Run <tt>bundle exec rake doc:yard</tt>. If your changes are not 100% documented, go back to step 4.
+6. Add specs for your feature or bug fix.
+7. Run <tt>bundle exec rake spec</tt>. If your changes are not 100% covered, go back to step 6.
+8. Commit and push your changes.
+9. Submit a pull request. Please do not include changes to the version or gemspec. (If you want to create your own version for some reason, please do so in a separate commit.)
+
+Credits
+-------
+Octokit is inspired by [Octopi](http://github.com/fcoury/octopi) and aims to be a lightweight, less active-resourcey alternative.
+
+Copyright
+---------
+Copyright (c) 2011 [Wynn Netherland](http://wynnnetherland.com), [Adam Stacoviak](http://adamstacoviak.com/), [Erik Michaels-Ober](https://github.com/sferik).
+See [LICENSE](https://github.com/pengwynn/octokit/blob/master/LICENSE) for details.

data/Rakefile

@@ -0,0 +1,14 @@
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'shoulda/tasks'
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.ruby_opts = ["-rubygems"] if defined? Gem
+  test.libs << "lib" << "test"
+  test.pattern = "test/**/*_test.rb"
+end
+
+task :default => :test

data/changelog.markdown

@@ -0,0 +1,34 @@
+# Changelog
+## 0.3.0
+  * Added set_repo_info patch from [Scott Bronson](http://github.com/bronson)
+## 0.2.4
+  * Rev'd HTTParty dependency, switched to Bundler
+## 0.2.3
+  * Patch from [Sutto](http://github.com/Sutto) to use authentication with list repos if available 
+## 0.2.2
+  * Patch from [abrader](http://github.com/abrader) to add auth_params query to the blob, tree, and repo class methods
+## 0.2.1
+  * Contributors API courtesy of @enricob
+## 0.2.0
+  * Commits API courtesy of @enricob
+
+## 0.1.4
+
+  * Preserved links array and content for events parsed from feeds
+
+## 0.1.3
+
+* Added Download event
+
+## 0.1.2
+
+* Added Delete event type
+* Added Public event type
+
+## 0.1.1 
+
+* Added Comment event type
+
+## 0.0.1 Initial version
+
+* GitHub v2 API complete

data/lib/faraday/raise_error.rb

@@ -0,0 +1,41 @@
+require 'faraday'
+
+# @api private
+module Faraday
+  class Response::RaiseError < Response::Middleware
+    def self.register_on_complete(env)
+      env[:response].on_complete do |response|
+        case response[:status].to_i
+        when 400
+          raise Octokit::BadRequest, error_message(response)
+        when 401
+          raise Octokit::Unauthorized, error_message(response)
+        when 403
+          raise Octokit::Forbidden, error_message(response)
+        when 404
+          raise Octokit::NotFound, error_message(response)
+        when 406
+          raise Octokit::NotAcceptable, error_message(response)
+        when 500
+          raise Octokit::InternalServerError, error_message(response)
+        when 501
+          raise Octokit::NotImplemented, error_message(response)
+        when 502
+          raise Octokit::BadGateway, error_message(response)
+        when 503
+          raise Octokit::ServiceUnavailable, error_message(response)
+        end
+      end
+    end
+
+    def initialize(app)
+      super
+    end
+
+    private
+
+    def self.error_message(response)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:status]}#{(': ' + response[:body]) if response[:body]}"
+    end
+  end
+end

data/lib/octokit.rb

@@ -0,0 +1,49 @@
+require File.expand_path('../octokit/configuration', __FILE__)
+require File.expand_path('../octokit/client', __FILE__)
+
+module Octokit
+  extend Configuration
+
+  # Alias for Octokit::Client.new
+  #
+  # @return [Octokit::Client]
+  def self.client(options={})
+    Octokit::Client.new(options)
+  end
+
+  # Delegate to Octokit::Client.new
+  def self.method_missing(method, *args, &block)
+    return super unless client.respond_to?(method)
+    client.send(method, *args, &block)
+  end
+
+  # Custom error class for rescuing from all GitHub errors
+  class Error < StandardError; end
+
+  # Raised when GitHub returns a 400 HTTP status code
+  class BadRequest < Error; end
+
+  # Raised when GitHub returns a 401 HTTP status code
+  class Unauthorized < Error; end
+
+  # Raised when GitHub returns a 403 HTTP status code
+  class Forbidden < Error; end
+
+  # Raised when GitHub returns a 404 HTTP status code
+  class NotFound < Error; end
+
+  # Raised when GitHub returns a 406 HTTP status code
+  class NotAcceptable < Error; end
+
+  # Raised when GitHub returns a 500 HTTP status code
+  class InternalServerError < Error; end
+
+  # Raised when GitHub returns a 501 HTTP status code
+  class NotImplemented < Error; end
+
+  # Raised when GitHub returns a 502 HTTP status code
+  class BadGateway < Error; end
+
+  # Raised when GitHub returns a 503 HTTP status code
+  class ServiceUnavailable < Error; end
+end

data/lib/octokit/client.rb

@@ -0,0 +1,30 @@
+require File.expand_path('../event', __FILE__)
+require File.expand_path('../repository', __FILE__)
+Dir[File.expand_path('../client/*.rb', __FILE__)].each{|file| require file}
+
+module Octokit
+  class Client
+    attr_accessor *Configuration::VALID_OPTIONS_KEYS
+
+    def initialize(options={})
+      options = Octokit.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    include Octokit::Client::Authentication
+    include Octokit::Client::Connection
+    include Octokit::Client::Request
+
+    include Octokit::Client::Commits
+    include Octokit::Client::Issues
+    include Octokit::Client::Network
+    include Octokit::Client::Objects
+    include Octokit::Client::Organizations
+    include Octokit::Client::Pulls
+    include Octokit::Client::Repositories
+    include Octokit::Client::Timelines
+    include Octokit::Client::Users
+  end
+end

data/lib/octokit/client/authentication.rb

@@ -0,0 +1,19 @@
+module Octokit
+  class Client
+    module Authentication
+      def authentication
+        if login && token
+          {:login => "#{login}/token", :password => token}
+        elsif login && password
+          {:login => login, :password => password}
+        else
+          {}
+        end
+      end
+
+      def authenticated?
+        !authentication.empty?
+      end
+    end
+  end
+end

data/lib/octokit/client/commits.rb

@@ -0,0 +1,16 @@
+module Octokit
+  class Client
+    module Commits
+
+      def commits(repo, branch="master", options={})
+        get("commits/list/#{Repository.new(repo)}/#{branch}", options)['commits']
+      end
+      alias :list_commits :commits
+
+      def commit(repo, sha, options={})
+        get("commits/show/#{Repository.new(repo)}/#{sha}", options)['commit']
+      end
+
+    end
+  end
+end

data/lib/octokit/client/connection.rb

@@ -0,0 +1,32 @@
+require 'faraday_middleware'
+Dir[File.expand_path('../../../faraday/*.rb', __FILE__)].each{|file| require file}
+
+module Octokit
+  class Client
+    # @private
+    module Connection
+      private
+
+      def connection(raw=false)
+        options = {
+          :proxy => proxy,
+          :ssl => {:verify => false},
+          :url => endpoint,
+        }
+
+        Faraday::Connection.new(options) do |connection|
+          connection.adapter(adapter)
+          connection.basic_auth authentication[:login], authentication[:password] if authenticated?
+          connection.use Faraday::Response::RaiseError
+          unless raw
+            case format.to_s.downcase
+            when 'json' then connection.use Faraday::Response::ParseJson
+            when 'xml' then connection.use Faraday::Response::ParseXml
+            end
+            connection.use Faraday::Response::Mashify
+          end
+        end
+      end
+    end
+  end
+end

data/lib/octokit/client/issues.rb

@@ -0,0 +1,60 @@
+module Octokit
+  class Client
+    module Issues
+
+      def search_issues(repo, search_term, state='open', options={})
+        get("issues/search/#{Repository.new(repo)}/#{state}/#{search_term}", options)['issues']
+      end
+
+      def issues(repo, state='open', options={})
+        get("issues/list/#{Repository.new(repo)}/#{state}", options)['issues']
+      end
+      alias :list_issues :issues
+
+      def issues_labeled(repo, label, options={})
+        get("issues/list/#{Repository.new(repo)}/label/#{label}", options)['issues']
+      end
+
+      def issue(repo, number, options={})
+        get("issues/show/#{Repository.new(repo)}/#{number}", options)['issue']
+      end
+
+      def issue_comments(repo, number, options={})
+        post("issues/comments/#{Repository.new(repo)}/#{number}", options)['comments']
+      end
+
+      def create_issue(repo, title, body, options={})
+        post("issues/open/#{Repository.new(repo)}", options.merge({:title => title, :body => body}))['issue']
+      end
+      alias :open_issue :create_issue
+
+      def close_issue(repo, number, options={})
+        post("issues/close/#{Repository.new(repo)}/#{number}", options)['issue']
+      end
+
+      def reopen_issue(repo, number, options={})
+        post("issues/reopen/#{Repository.new(repo)}/#{number}", options)['issue']
+      end
+
+      def update_issue(repo, number, title, body, options={})
+        post("issues/edit/#{Repository.new(repo)}/#{number}", options.merge({:title => title, :body => body}))['issue']
+      end
+
+      def labels(repo, options={})
+        get("issues/labels/#{Repository.new(repo)}", options)['labels']
+      end
+  
+      def add_label(repo, number, label, options={})
+        post("issues/label/add/#{Repository.new(repo)}/#{label}/#{number}", options)['labels']
+      end
+  
+      def remove_label(repo, number, label, options={})
+        post("issues/label/remove/#{Repository.new(repo)}/#{label}/#{number}")['labels']
+      end
+  
+      def add_comment(repo, number, comment, options={})
+        post("issues/comment/#{Repository.new(repo)}/#{number}", options.merge({:comment => comment}))['comment']
+      end
+    end
+  end
+end

data/lib/octokit/client/network.rb

@@ -0,0 +1,15 @@
+module Octokit
+  class Client
+    module Network
+
+      def network_meta(repo, options={})
+        get("#{Repository.new(repo)}/network_meta", options, false, false)
+      end
+  
+      def network_data(repo, nethash, options={})
+        get("#{Repository.new(repo)}/network_data_chunk", options.merge({:nethash => nethash}), false, false)['commits']
+      end
+
+    end
+  end
+end