octocat_herder 0.0.2

data/.document

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

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gem "httparty",    "~> 0.7.8"
+gem "link_header", "~> 0.0.5"
+
+group :development do
+  gem "rspec",   "~> 2.6.0"
+  gem "mocha",   "~> 0.9.12"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov",    ">= 0"
+  gem "rdoc",    ">= 2.4.2"
+end

data/Gemfile.lock

@@ -0,0 +1,38 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    httparty (0.7.8)
+      crack (= 0.1.8)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    link_header (0.0.5)
+    mocha (0.9.12)
+    rake (0.9.2)
+    rcov (0.9.9)
+    rdoc (3.8)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  httparty (~> 0.7.8)
+  jeweler (~> 1.6.4)
+  link_header (~> 0.0.5)
+  mocha (~> 0.9.12)
+  rcov
+  rdoc (>= 2.4.2)
+  rspec (~> 2.6.0)

data/LICENSE.txt

@@ -0,0 +1,26 @@
+Copyright (c) 2011, Jacob Helwig
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+ * Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the
+   distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.rdoc

@@ -0,0 +1,19 @@
+= octocat_herder
+
+Description goes here.
+
+== Contributing to octocat-herder
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Jacob Helwig. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = 'octocat_herder'
+  gem.homepage = 'http://github.com/jhelwig/octocat_herder'
+  gem.license = 'BSD'
+  gem.summary = 'An interface to the v3 GitHub API'
+  gem.description = 'This gem provides Ruby bindings to the v3 GitHub API'
+  gem.email = 'jacob@technosorcery.net'
+  gem.authors = ['Jacob Helwig']
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "octocat_herder #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/lib/octocat_herder/base.rb

@@ -0,0 +1,88 @@
+require 'cgi'
+require 'link_header'
+require 'parsedate'
+require 'uri'
+
+require 'octocat_herder/connection'
+
+class OctocatHerder
+  class Base
+    attr_reader :raw, :connection
+
+    def initialize(raw_hash, conn = OctocatHerder::Connection.new)
+      @connection = conn
+      @raw = raw_hash
+    end
+
+    def method_missing(id, *args)
+      unless @raw and @raw.keys.include?(id.id2name)
+        raise NoMethodError.new("undefined method #{id.id2name} for #{self}:#{self.class}")
+      end
+
+      @raw[id.id2name]
+    end
+
+    def available_attributes
+      attrs = []
+      attrs += @raw.keys.reject do |k|
+        [
+          'id',
+          'type',
+        ].include? k
+      end if @raw
+
+      (attrs + additional_attributes).uniq
+    end
+
+    private
+
+    def self.raw_get(conn, end_point, options={})
+      paginated    = options.delete(:paginated)
+      query_params = options.delete(:params) || {}
+
+      query_params[:per_page] = 100 if paginated and query_params[:per_page].nil?
+      query_string = query_string_from_params(query_params)
+
+      result = conn.get(end_point + query_string, options)
+      raise "Unable to retrieve #{end_point}" unless result
+
+      full_result = result.parsed_response
+
+      if paginated
+        if next_page = page_from_headers(result.headers, 'next')
+          query_params[:page] = next_page
+
+          new_options = options.merge(query_params)
+          new_options[:paginated] = true
+
+          full_result += raw_get(conn, end_point, new_options)
+        end
+      end
+
+      full_result
+    end
+
+    def self.page_from_headers(headers, type)
+      link = LinkHeader.parse(headers['link']).find_link(['rel', type])
+      return unless link
+
+      CGI.parse(URI.parse(link.href).query)['page'].first
+    end
+
+    def self.query_string_from_params(params)
+      return '' if params.keys.empty?
+
+      '?' + params.map {|k,v| "#{URI.escape("#{k}")}=#{URI.escape("#{v}")}"}.join('&')
+    end
+
+    def additional_attributes
+      []
+    end
+
+    def parse_date_time(date_time)
+      return nil unless date_time
+
+      Time.utc(*ParseDate.parsedate(date_time))
+    end
+  end
+end

data/lib/octocat_herder/connection.rb

@@ -0,0 +1,55 @@
+require 'httparty'
+require 'link_header'
+
+class OctocatHerder
+  class Connection
+    include HTTParty
+    base_uri 'https://api.github.com'
+
+    attr_reader :user_name, :password, :oauth2_token
+
+    def httparty_options
+      @httparty_options || {}
+    end
+
+    def initialize(options={})
+      raise ArgumentError.new(
+        "OctocatHerder::Connection does not accept: #{options.class}"
+      ) unless options.is_a? Hash
+
+      options.keys.each do |k|
+        raise ArgumentError.new("Unknown option: '#{k}'") unless [
+          :user_name, :password, :oauth2_token
+        ].include? k
+      end
+
+      if options.keys.include?(:user_name) or options.keys.include?(:password)
+        raise ArgumentError.new("When providing :user_name or :password, both are required") unless
+          options.keys.include?(:user_name) and options.keys.include?(:password)
+      end
+
+      if options.keys.include?(:oauth2_token) and options.keys.include?(:user_name)
+        raise ArgumentError.new('Cannot provide both an OAuth2 Token, and a user name and password')
+      end
+
+      @user_name    = options[:user_name]
+      @password     = options[:password]
+      @oauth2_token = options[:oauth2_token]
+
+      if oauth2_token
+        @httparty_options = { :headers => { 'Authorization' => "token #{oauth2_token}" } }
+      elsif user_name
+        @httparty_options = { :basic_auth => { :username => user_name, :password => password } }
+      end
+    end
+
+    def get(end_point, options={})
+      request_options = options.merge(httparty_options)
+      if httparty_options.has_key?(:headers) and options.has_key(:headers)
+        request_options[:headers] = options[:headers].merge(httparty_options[:headers])
+      end
+
+      OctocatHerder::Connection.get(end_point, request_options)
+    end
+  end
+end

data/lib/octocat_herder/pull_request/repo.rb

@@ -0,0 +1,37 @@
+require 'octocat_herder/base'
+require 'octocat_herder/user'
+require 'octocat_herder/repository'
+
+class OctocatHerder
+  class PullRequest < Base
+    class Repo < ::OctocatHerder::Base
+      def user_login
+        @raw['user']['login']
+      end
+
+      def user_id
+        @raw['user']['id']
+      end
+
+      def user_avatar_url
+        @raw['user']['avatar_url']
+      end
+
+      def user_url
+        @raw['user']['url']
+      end
+
+      def user
+        @user = OctocatHerder::User.fetch(@raw['user'], connection)
+      end
+
+      def repo
+        @repo = OctocatHerder::Repository.new(@raw['repo'], connection)
+      end
+
+      def addtional_attributes
+        ['user_login', 'user_id', 'user_avatar_url', 'user_url']
+      end
+    end
+  end
+end

data/lib/octocat_herder/pull_request.rb

@@ -0,0 +1,171 @@
+require 'cgi'
+
+require 'octocat_herder/base'
+require 'octocat_herder/connection'
+require 'octocat_herder/user'
+require 'octocat_herder/pull_request/repo'
+
+class OctocatHerder
+  class PullRequest < Base
+    def self.find_for_repository(owner_login, repository_name, status = 'open', conn = OctocatHerder::Connection.new)
+      raise ArgumentError.new("Unknown PullRequest status '#{status}'.  Must be one of ['open', 'closed'].") unless
+        ['open', 'closed'].include? status
+
+      pull_requests = raw_get(
+        conn,
+        "/repos/#{CGI.escape(owner_login.to_s)}/#{CGI.escape(repository_name.to_s)}/pulls",
+        :paginated => true,
+        :params    => { :state => status },
+        :headers   => { 'Accept' => 'application/vnd.github-pull.full+json' }
+      )
+
+      pull_requests.map do |pull|
+        new(pull, nil, conn)
+      end
+    end
+
+    def self.find_open_for_repository(owner_login, repository_name, conn = OctocatHerder::Connection.new)
+      OctocatHerder::PullRequest.find_for_repository(owner_login, repository_name, 'open', conn)
+    end
+
+    def self.find_closed_for_repository(owner_login, repository_name, conn = OctocatHerder::Connection.new)
+      OctocatHerder::PullRequest.find_for_repository(owner_login, repository_name, 'closed', conn)
+    end
+
+    def self.fetch(owner_login, repository_name, pull_request_number, conn = OctocatHerder::Connection.new)
+      request = raw_get(
+        conn,
+        "/repos/#{CGI.escape(owner_login.to_s)}/#{CGI.escape(repository_name.to_s)}/pulls/#{CGI.escape(pull_request_number.to_s)}",
+        :headers   => { 'Accept' => 'application/vnd.github-pull.full+json' }
+      )
+
+      new(nil, request, conn)
+    end
+
+    def initialize(raw_hash, raw_detail_hash = nil, conn = OctocatHerder::Connection.new)
+      super raw_hash, conn
+      @raw_detail_hash = raw_detail_hash
+    end
+
+    def get_detail
+      return if @raw_detail_hash
+
+      @raw_detail_hash = raw_get(
+        url,
+        :headers => { 'Accept' => 'application/vnd.github-pull.full+json' }
+      )
+
+      self
+    end
+
+    def method_missing(id, *args)
+      super
+    rescue NoMethodError => e
+      get_detail
+      return @raw_detail_hash[id.id2name] if @raw_detail_hash and @raw_detail_hash.keys.include?(id.id2name)
+
+      raise e
+    end
+
+    # Nested data from the "overview" data.
+    def user_avatar_url
+      return @raw['user']['avatar_url'] if @raw
+      @raw_detail_hash['user']['avatar_url']
+    end
+
+    def user_url
+      return @raw['user']['url'] if @raw
+      @raw_detail_hash['user']['url']
+    end
+
+    def user_id
+      return @raw['user']['id'] if @raw
+      @raw_detail_hash['user']['id']
+    end
+
+    def user_login
+      return @raw['user']['login'] if @raw
+      @raw_detail_hash['user']['login']
+    end
+
+    # Return a real user, instead of a hash with the nested data.
+    def user
+      @user ||= OctocatHerder::User.fetch(user_login, connection)
+    end
+
+    # Nested data from the "detail" data.
+    def merged_by_login
+      get_detail
+
+      @raw_detail_hash['merged_by']['login']
+    end
+
+    def merged_by_id
+      get_detail
+
+      @raw_detail_hash['merged_by']['id']
+    end
+
+    def merged_by_avatar_url
+      get_detail
+
+      @raw_detail_hash['merged_by']['avatar_url']
+    end
+
+    def merged_by_url
+      get_detail
+
+      @raw_detail_hash['merged_by']['url']
+    end
+
+    # Return a real user, instead of a hash with the nested data.
+    def merged_by
+      get_detail
+
+      @merged_by ||= OctocatHerder::User.fetch(merged_by_login, connection)
+    end
+
+    # Convert a few things to more Ruby friendly Objects
+    def created_at
+      parse_date_time(@raw_detail_hash['created_at'])
+    end
+
+    def updated_at
+      parse_date_time(@raw_detail_hash['updated_at'])
+    end
+
+    def closed_at
+      parse_date_time(@raw_detail_hash['closed_at'])
+    end
+
+    def merged_at
+      parse_date_time(@raw_detail_hash['merged_at'])
+    end
+
+    def head
+      get_detail
+
+      @head_repo ||= OctocatHerder::PullRequest::Repo.new(@raw_detail_hash['head'], connection)
+    end
+
+    def base
+      get_detail
+
+      @base_repo ||= OctocatHerder::PullRequest::Repo.new(@raw_detail_hash['base'], connection)
+    end
+
+    def additional_attributes
+      attrs = ['user_avatar_url', 'user_url', 'user_id', 'user_login']
+
+      attrs += @raw_detail_hash.keys if @raw_detail_hash
+      attrs += ['merged_by_login', 'merged_by_id', 'merged_by_avatar_url', 'merged_by_url']
+    end
+
+    def to_hash
+      raw = @raw || {}
+      detail = @raw_detail_hash || {}
+
+      raw.merge(detail)
+    end
+  end
+end

data/lib/octocat_herder/repository.rb

@@ -0,0 +1,92 @@
+require 'cgi'
+
+require 'octocat_herder/base'
+require 'octocat_herder/connection'
+require 'octocat_herder/user'
+
+class OctocatHerder
+  class Repository < Base
+    def self.method_missing(id, *args)
+      if id.id2name =~ /list_(.+)/
+        repository_type = Regexp.last_match(1)
+        if ['all', 'private', 'public', 'member'].include? repository_type
+          arguments = [args[0], args[1], repository_type]
+          arguments << args[2] unless args[2].nil?
+
+          return self.list(*arguments)
+        end
+      end
+
+      raise NoMethodError.new("undefined method #{id.id2name} for #{self}:#{self.class}")
+    end
+
+    def owner_login
+      @raw['owner']['login']
+    end
+
+    def owner_id
+      @raw['owner']['id']
+    end
+
+    def owner_avatar_url
+      @raw['owner']['avatar_url']
+    end
+
+    def owner_url
+      @raw['owner']['url']
+    end
+
+    def owner
+      OctocatHerder::User.fetch(owner_login, connection)
+    end
+
+    def open_pull_requests
+      OctocatHerder::PullRequest.find_for_repository(owner_login, name, 'open')
+    end
+
+    def closed_pull_requests
+      OctocatHerder::PullRequest.find_for_repository(owner_login, name, 'closed')
+    end
+
+    def source
+      return unless @raw['source']
+
+      OctocatHerder::Repository.new(@raw['source'], connection)
+    end
+
+    private
+
+    def self.list(login, account_type, repository_type, conn = OctocatHerder::Connection.new)
+      url_base = case account_type
+                   when "User"         then "users"
+                   when "Organization" then "orgs"
+                 else
+                   raise ArgumentError.new("Unknown account type: #{account_type}")
+                 end
+
+      repositories = raw_get(
+        conn,
+        "/#{url_base}/#{CGI.escape(login)}/repos",
+        :paginated => true,
+        :params    => { :type => repository_type }
+      )
+
+      repositories.map do |repo|
+        new(repo, conn)
+      end
+    end
+
+    def self.fetch(login, repository_name, conn = OctocatHerder::Connection.new)
+      repo_data = raw_get(
+        conn,
+        "/repos/#{CGI.escape(login)}/#{CGI.escape(repository_name)}"
+      )
+
+      new(repo_data, conn)
+    end
+
+    def additional_attributes
+      ['owner_login', 'owner_id', 'owner_avatar_url', 'owner_url']
+    end
+  end
+end

data/lib/octocat_herder/user.rb

@@ -0,0 +1,36 @@
+require 'octocat_herder/base'
+require 'octocat_herder/connection'
+require 'octocat_herder/repository'
+
+class OctocatHerder
+  class User < Base
+    def self.fetch(user_name, conn = OctocatHerder::Connection.new)
+      user = raw_get(conn, "/users/#{user_name}")
+
+      OctocatHerder::User.new(user, conn)
+    end
+
+    def repositories
+      @repositories ||= OctocatHerder::Repository.list_all(login, user_type, connection)
+    end
+
+    # The user id can't be handled by the method_missing magic from
+    # OctocatHerder::Base, since the id method returns the object id.
+    def user_id
+      @raw['id']
+    end
+
+    # The user type can't be handled by the method_missing magic from
+    # OctocatHerder::Base, since 'type' is the deprecated form of the
+    # method 'class'.
+    def user_type
+      @raw['type']
+    end
+
+    private
+
+    def additional_attributes
+      ['user_id', 'user_type']
+    end
+  end
+end

data/lib/octocat_herder.rb

@@ -0,0 +1,14 @@
+require 'octocat_herder/connection'
+require 'octocat_herder/user'
+
+class OctocatHerder
+  attr_reader :connection
+
+  def initialize(options={})
+    @connection = OctocatHerder::Connection.new options
+  end
+
+  def user(user_name)
+    OctocatHerder::User.fetch(user_name, connection)
+  end
+end

data/octocat_herder.gemspec

@@ -0,0 +1,79 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{octocat_herder}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jacob Helwig"]
+  s.date = %q{2011-07-20}
+  s.description = %q{This gem provides Ruby bindings to the v3 GitHub API}
+  s.email = %q{jacob@technosorcery.net}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/octocat_herder.rb",
+    "lib/octocat_herder/base.rb",
+    "lib/octocat_herder/connection.rb",
+    "lib/octocat_herder/pull_request.rb",
+    "lib/octocat_herder/pull_request/repo.rb",
+    "lib/octocat_herder/repository.rb",
+    "lib/octocat_herder/user.rb",
+    "octocat_herder.gemspec",
+    "spec/octocat_herder/connection_spec.rb",
+    "spec/octocat_herder_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/jhelwig/octocat_herder}
+  s.licenses = ["BSD"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{An interface to the v3 GitHub API}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, ["~> 0.7.8"])
+      s.add_runtime_dependency(%q<link_header>, ["~> 0.0.5"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.6.0"])
+      s.add_development_dependency(%q<mocha>, ["~> 0.9.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 2.4.2"])
+    else
+      s.add_dependency(%q<httparty>, ["~> 0.7.8"])
+      s.add_dependency(%q<link_header>, ["~> 0.0.5"])
+      s.add_dependency(%q<rspec>, ["~> 2.6.0"])
+      s.add_dependency(%q<mocha>, ["~> 0.9.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 2.4.2"])
+    end
+  else
+    s.add_dependency(%q<httparty>, ["~> 0.7.8"])
+    s.add_dependency(%q<link_header>, ["~> 0.0.5"])
+    s.add_dependency(%q<rspec>, ["~> 2.6.0"])
+    s.add_dependency(%q<mocha>, ["~> 0.9.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 2.4.2"])
+  end
+end
+

data/spec/octocat_herder/connection_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe OctocatHerder::Connection do
+  it 'accepts an empty argument list (unauthenticated requests)' do
+    OctocatHerder::Connection.new
+  end
+
+  it 'accepts a user name and password' do
+    OctocatHerder::Connection.new :user_name => 'bob', :password => 'pass'
+  end
+
+  it 'accepts an OAuth2 Token' do
+    OctocatHerder::Connection.new :oauth2_token => 'token goes here'
+  end
+
+  it 'requires a user name when given a password' do
+    expect { OctocatHerder::Connection.new :password => 'pass' }.to raise_error(
+      ArgumentError, 'When providing :user_name or :password, both are required'
+    )
+  end
+
+  it 'requires a password when given a user name' do
+    expect { OctocatHerder::Connection.new :user_name => 'bob' }.to raise_error(
+      ArgumentError, 'When providing :user_name or :password, both are required'
+    )
+  end
+
+  it 'raises an ArgumentError if given an OAuth2 Token and anything else' do
+    expect do
+      OctocatHerder::Connection.new :oauth2_token => 'token goes here', :invalid => 'argument'
+    end.to raise_error(ArgumentError, "Unknown option: 'invalid'")
+  end
+
+  it 'raises an ArgumentError if given a user name, password, and anything else' do
+    expect do
+      OctocatHerder::Connection.new :user_name => 'bob', :password => 'pass', :also => 'invalid'
+    end.to raise_error(ArgumentError, "Unknown option: 'also'")
+  end
+
+  it 'raises an ArgumentError if given anything other than a user name, password, or OAuth2 Token' do
+    expect { OctocatHerder::Connection.new :still => 'bad' }.to raise_error(
+      ArgumentError, "Unknown option: 'still'"
+    )
+  end
+
+  it 'raises an ArgumentError if given anything other than a Hash' do
+    expect { OctocatHerder::Connection.new [] }.to raise_error(
+      ArgumentError, 'OctocatHerder::Connection does not accept: Array'
+    )
+  end
+
+  it 'raises an ArgumentError if given an OAuth2 Token and a user name and password' do
+    expect do
+      OctocatHerder::Connection.new :user_name => 'bob', :password => 'pass', :oauth2_token => 'token'
+    end.to raise_error(ArgumentError, 'Cannot provide both an OAuth2 Token, and a user name and password')
+  end
+
+  it 'sets the Authorization header when given an OAuth2 Token' do
+    conn = OctocatHerder::Connection.new :oauth2_token => 'my_token'
+
+    conn.httparty_options.should == { :headers => { 'Authorization' => 'token my_token' } }
+  end
+
+  it 'uses basic auth when given a user name and password' do
+    conn = OctocatHerder::Connection.new :user_name => 'user', :password => 'pass'
+
+    conn.httparty_options.should == { :basic_auth => { :username => 'user', :password => 'pass' } }
+  end
+
+  it 'should not set any additional options when making unauthenticated requests' do
+    conn = OctocatHerder::Connection.new
+
+    conn.httparty_options.should == {}
+  end
+end

data/spec/octocat_herder_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe OctocatHerder do
+  describe "without authentication information" do
+    it 'creates an unauthenticated connection' do
+      OctocatHerder::Connection.expects(:new).with({})
+
+      OctocatHerder.new
+    end
+  end
+
+  describe "when provided a user name and password to authenticate" do
+    it 'creates a connection using the user name and password' do
+      OctocatHerder::Connection.expects(:new).with(:user_name => 'user', :password => 'pass')
+
+      OctocatHerder.new :user_name => 'user', :password => 'pass'
+    end
+  end
+
+  describe "when provided an OAuth2 to authenticate" do
+    it 'creates a connection using the OAuth2 Token' do
+      OctocatHerder::Connection.expects(:new).with(:oauth2_token => 'token')
+
+      OctocatHerder.new :oauth2_token => 'token'
+    end
+  end
+
+  it 'fetches the specified user using the current connection' do
+    conn = OctocatHerder::Connection.new
+    OctocatHerder.any_instance.stubs(:connection).returns conn
+    OctocatHerder::User.expects(:fetch).with('bob', conn)
+
+    OctocatHerder.new.user('bob')
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'rspec'
+require 'rspec/autorun'
+require 'mocha'
+
+require 'octocat_herder'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.mock_with :mocha
+end

metadata

@@ -0,0 +1,210 @@
+--- !ruby/object:Gem::Specification 
+name: octocat_herder
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Jacob Helwig
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-20 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: httparty
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  requirement: *id001
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: link_header
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 0
+        - 0
+        - 5
+        version: 0.0.5
+  requirement: *id002
+  type: :runtime
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: rspec
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  requirement: *id003
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: mocha
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 35
+        segments: 
+        - 0
+        - 9
+        - 12
+        version: 0.9.12
+  requirement: *id004
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: bundler
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id005
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: jeweler
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  requirement: *id006
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: rcov
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id007
+  type: :development
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  name: rdoc
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 2
+        - 4
+        - 2
+        version: 2.4.2
+  requirement: *id008
+  type: :development
+description: This gem provides Ruby bindings to the v3 GitHub API
+email: jacob@technosorcery.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/octocat_herder.rb
+- lib/octocat_herder/base.rb
+- lib/octocat_herder/connection.rb
+- lib/octocat_herder/pull_request.rb
+- lib/octocat_herder/pull_request/repo.rb
+- lib/octocat_herder/repository.rb
+- lib/octocat_herder/user.rb
+- octocat_herder.gemspec
+- spec/octocat_herder/connection_spec.rb
+- spec/octocat_herder_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/jhelwig/octocat_herder
+licenses: 
+- BSD
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: An interface to the v3 GitHub API
+test_files: []
+