octokit 1.14.0 → 1.17.0

data/CHANGELOG.md

@@ -1,8 +1,12 @@
 # CHANGELOG
 
+* [1.17.0 - October 8, 2012](https://github.com/pengwynn/octokit/compare/v1.16.0...v1.17.0)
+* [1.16.0 - September 25,2012](https://github.com/pengwynn/octokit/compare/v1.15.1...v1.16.0)
+* [1.15.1 - September 24,2012](https://github.com/pengwynn/octokit/compare/v1.15.0...v1.15.1)
+* [1.15.0 - September 24,2012](https://github.com/pengwynn/octokit/compare/v1.14.0...v1.15.0)
 * [1.14.0 - September 22,2012](https://github.com/pengwynn/octokit/compare/v1.13.0...v1.14.0)
-* [1.13.0 - September 5,2012](https://github.com/pengwynn/octokit/compare/v1.12.0...v1.13.0)
-* [1.12.0 - September 4,2012](https://github.com/pengwynn/octokit/compare/v1.11.0...v1.12.0)
+* [1.13.0 - September 5, 2012](https://github.com/pengwynn/octokit/compare/v1.12.0...v1.13.0)
+* [1.12.0 - September 4, 2012](https://github.com/pengwynn/octokit/compare/v1.11.0...v1.12.0)
 * [1.11.0 - August 29, 2012](https://github.com/pengwynn/octokit/compare/v1.10.0...v1.11.0)
 * [1.10.0 - August 8, 2012](https://github.com/pengwynn/octokit/compare/v1.9.4...v1.10.0)
 * [1.9.4 - August 6, 2012](https://github.com/pengwynn/octokit/compare/v1.9.3...v1.9.4)

data/lib/octokit/client/commits.rb

@@ -81,6 +81,62 @@ module Octokit
         get("repos/#{Repository.new(repo)}/comments/#{id}", options, 3)
       end
 
+      # Create a commit comment
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param sha [String] Sha of the commit to comment on
+      # @param body [String] Message
+      # @param path [String] Relative path of file to comment on
+      # @param line [Integer] Line number in the file to comment on
+      # @param position [Integer] Line index in the diff to comment on
+      # @return [Hashie::Mash] A hash representing the new commit comment
+      # @see http://developer.github.com/v3/repos/comments/
+      # @example Create a commit comment
+      #   commit = Octokit.create_commit_comment("octocat/Hello-World", "827efc6d56897b048c772eb4087f854f46256132", "My comment message", "README.md", 10, 1)
+      #   commit.commit_id # => "827efc6d56897b048c772eb4087f854f46256132"
+      #   commit.body # => "My comment message"
+      #   commit.path # => "README.md"
+      #   commit.line # => 10
+      #   commit.position # => 1
+      def create_commit_comment(repo, sha, body, path=nil, line=nil, position=nil, options={})
+        params = {
+          :body => body,
+          :commit_id => sha,
+          :path => path,
+          :line => line,
+          :position => position
+        }
+        post("repos/#{Repository.new(repo)}/commits/#{sha}/comments", options.merge(params), 3)
+      end
+
+      # Update a commit comment
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param id [String] The ID of the comment to update
+      # @param body [String] Message
+      # @return [Hashie::Mash] A hash representing the updated commit comment
+      # @see http://developer.github.com/v3/repos/comments/
+      # @example Update a commit comment
+      #   commit = Octokit.update_commit_comment("octocat/Hello-World", "860296", "Updated commit comment")
+      #   commit.id # => 860296
+      #   commit.body # => "Updated commit comment"
+      def update_commit_comment(repo, id, body, options={})
+        params = {
+          :body => body
+        }
+        patch("repos/#{Repository.new(repo)}/comments/#{id}", options.merge(params), 3)
+      end
+
+      # Delete a commit comment
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param id [String] The ID of the comment to delete
+      # @return [nil] nil
+      # @see http://developer.github.com/v3/repos/comments/
+      def delete_commit_comment(repo, id, options={})
+        delete("repos/#{Repository.new(repo)}/comments/#{id}", options, 3)
+      end
+
       # Compare two commits
       #
       # @param repo [String, Hash, Repository] A GitHub repository

data/lib/octokit/client/gists.rb

@@ -2,32 +2,108 @@ module Octokit
   class Client
     module Gists
 
-      def create_gist(options={})
-        post 'gists', options, 3
+      # List gists for a user or all public gists
+      #
+      # @param username [String] An optional user to filter listing 
+      # @return [Array<Hashie::Mash>] A list of gists
+      # @example Fetch all gists for defunkt
+      #   Octokit.gists('defunkt')
+      # @example Fetch all public gists
+      #   Octokit.gists
+      # @see http://developer.github.com/v3/gists/#list-gists
+      def gists(username=nil, options={})
+        if username.nil?
+          get 'gists', options, 3
+        else
+          get "users/#{username}/gists", options, 3
+        end
       end
+      alias :list_gists :gists
 
-      def delete_gist(gist, options={})
-        response = delete("gists/#{Gist.new gist}", options, 3, true, true)
-        response.status == 204
+      # List public gists
+      #
+      # @return [Array<Hashie::Mash>] A list of gists
+      # @example Fetch all public gists
+      #   Octokit.public_gists
+      # @see http://developer.github.com/v3/gists/#list-gists
+      def public_gists(options={})
+        get 'gists/public', options, 3
       end
 
-      def edit_gist(gist, options={})
-        patch "gists/#{Gist.new gist}", options, 3
+      # List the authenticated user’s starred gists
+      #
+      # @return [Array<Hashie::Mash>] A list of gists
+      def starred_gists(options={})
+        get 'gists/starred', options, 3
       end
 
+      # Get a single gist
+      #
+      # @param gist [String] ID of gist to fetch
+      # @return [Hash::Mash] Gist information
+      # @see http://developer.github.com/v3/gists/#get-a-single-gist
       def gist(gist, options={})
         get "gists/#{Gist.new gist}", options, 3
       end
 
-      def gists(username=nil, options={})
-        if username.nil?
-          get 'gists', options, 3
-        else
-          get "users/#{username}/gists", options, 3
-        end
+      # Create a gist
+      #
+      # @param options [Hash] Gist information.
+      # @option options [String] :description
+      # @option options [Boolean] :public Sets gist visibility
+      # @option options [Array<Hash>] :files Files that make up this gist. Keys
+      #   should be the filename, the value a Hash with a :content key with text
+      #   conent of the Gist.
+      # @return [Hashie::Mash] Newly created gist info
+      # @see http://developer.github.com/v3/gists/#create-a-gist
+      def create_gist(options={})
+        post 'gists', options, 3
       end
 
-      # Returns +true+ if +gist+ is starred, +false+ otherwise.
+      # Edit a gist
+      #
+      # @param options [Hash] Gist information.
+      # @option options [String] :description
+      # @option options [Boolean] :public Sets gist visibility
+      # @option options [Array<Hash>] :files Files that make up this gist. Keys
+      #   should be the filename, the value a Hash with a :content key with text
+      #   conent of the Gist. 
+      #
+      #   NOTE: All files from the previous version of the
+      #   gist are carried over by default if not included in the hash. Deletes
+      #   can be performed by including the filename with a null hash.  
+      # @return
+      #   [Hashie::Mash] Newly created gist info
+      # @see http://developer.github.com/v3/gists/#edit-a-gist
+      def edit_gist(gist, options={})
+        patch "gists/#{Gist.new gist}", options, 3
+      end
+      #
+      # Star a gist
+      #
+      # @param gist [String] Gist ID
+      # @return [Boolean] Indicates if gist is starred successfully
+      # @see http://developer.github.com/v3/gists/#star-a-gist
+      def star_gist(gist, options={})
+        response = put("gists/#{Gist.new gist}/star", options, 3, true, true)
+        response.status == 204
+      end
+
+      # Unstar a gist
+      #
+      # @param gist [String] Gist ID
+      # @return [Boolean] Indicates if gist is unstarred successfully
+      # @see http://developer.github.com/v3/gists/#unstar-a-gist
+      def unstar_gist(gist, options={})
+        response = delete("gists/#{Gist.new gist}/star", options, 3, true, true)
+        response.status == 204
+      end
+
+      # Check if a gist is starred
+      #
+      # @param gist [String] Gist ID
+      # @return [Boolean] Indicates if gist is starred
+      # @see http://developer.github.com/v3/gists/#check-if-a-gist-is-starred
       def gist_starred?(gist, options={})
         begin
           get("gists/#{Gist.new gist}/star", options, 3, true, true)
@@ -37,27 +113,22 @@ module Octokit
         end
       end
 
+      # Fork a gist
+      #
+      # @param gist [String] Gist ID
+      # @return [Hashie::Mash] Data for the new gist
+      # @see http://developer.github.com/v3/gists/#fork-a-gist
       def fork_gist(gist, options={})
         post "gists/#{Gist.new gist}/fork", options, 3
       end
 
-      def public_gists(options={})
-        get 'gists', options, 3
-      end
-
-      def starred_gists(options={})
-        get 'gists/starred', options, 3
-      end
-
-      # Returns +true+ or +false+ based on success.
-      def star_gist(gist, options={})
-        response = put("gists/#{Gist.new gist}/star", options, 3, true, true)
-        response.status == 204
-      end
-
-      # Returns +true+ or +false+ based on success.
-      def unstar_gist(gist, options={})
-        response = delete("gists/#{Gist.new gist}/star", options, 3, true, true)
+      # Delete a gist
+      #
+      # @param gist [String] Gist ID
+      # @return [Boolean] Indicating success of deletion
+      # @see http://developer.github.com/v3/gists/#delete-a-gist
+      def delete_gist(gist, options={})
+        response = delete("gists/#{Gist.new gist}", options, 3, true, true)
         response.status == 204
       end
 

data/lib/octokit/client/issues.rb

@@ -15,13 +15,14 @@ module Octokit
         get("legacy/issues/search/#{Repository.new(repo)}/#{state}/#{search_term}", options, 3)['issues']
       end
 
-      # List issues for a repository
+      # List issues for a the authenticated user or repository
       #
       # @param repository [String, Repository, Hash] A GitHub repository.
       # @param options [Hash] A customizable set of options.
       # @option options [Integer] :milestone Milestone number.
       # @option options [String] :state (open) State: <tt>open</tt> or <tt>closed</tt>.
       # @option options [String] :assignee User login.
+      # @option options [String] :creator User login.
       # @option options [String] :mentioned User login.
       # @option options [String] :labels List of comma separated Label names. Example: <tt>bug,ui,@high</tt>.
       # @option options [String] :sort (created) Sort: <tt>created</tt>, <tt>updated</tt>, or <tt>comments</tt>.
@@ -31,8 +32,14 @@ module Octokit
       # @see http://developer.github.com/v3/issues/#list-issues-for-this-repository
       # @example List issues for a repository
       #   Octokit.list_issues("sferik/rails_admin")
-      def list_issues(repository, options={})
-        get("repos/#{Repository.new(repository)}/issues", options, 3)
+      # @example List issues for the authenticted user across repositories
+      #   @client = Octokit::Client.new(:login => 'foo', :password => 'bar')
+      #   @client.list_issues
+      def list_issues(repository = nil, options={})
+        path = ''
+        path = "repos/#{Repository.new(repository)}" if repository
+        path += "/issues"
+        get(path, options, 3)
       end
       alias :issues :list_issues
 

data/lib/octokit/client/organizations.rb

@@ -22,7 +22,12 @@ module Octokit
       alias :list_orgs :organizations
       alias :orgs :organizations
 
-      def organization_repositories(org=nil, options={})
+      # List organization repositories
+      #
+      # @see http://developer.github.com/v3/repos/#list-organization-repositories
+      # @param org [String] Organization handle for which to list repos
+      # @return [Array<Hashie::Mash>] List of repositories
+      def organization_repositories(org, options={})
         get("orgs/#{org}/repos", options, 3)
       end
       alias :org_repositories :organization_repositories

data/lib/octokit/client/pulls.rb

@@ -1,6 +1,43 @@
 module Octokit
   class Client
     module Pulls
+      # List pull requests for a repository
+      #
+      # @see http://developer.github.com/v3/pulls/#list-pull-requests
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param options [Hash] Method options
+      # @option options [String] :state `open` or `closed`. Default is `open`.
+      # @return [Array<Hashie::Mash>] Array of pulls
+      # @example
+      #   Octokit.pull_requests('rails/rails')
+      def pull_requests(repo, state='open', options={})
+        get("repos/#{Repository.new(repo)}/pulls", options.merge({:state => state}), 3)
+      end
+      alias :pulls :pull_requests
+
+      # Get a pull request
+      #
+      # @see http://developer.github.com/v3/pulls/#get-a-single-pull-request
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param number [Integer] Number of the pull request to fetch
+      # @return [Hashie::Mash] Pull request info
+      def pull_request(repo, number, options={})
+        get("repos/#{Repository.new(repo)}/pulls/#{number}", options)
+      end
+      alias :pull :pull_request
+
+      # Create a pull request
+      #
+      # @see http://developer.github.com/v3/pulls/#create-a-pull-request
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param base [String] The branch (or git ref) you want your changes
+      #                      pulled into. This should be an existing branch on the current
+      #                      repository. You cannot submit a pull request to one repo that requests
+      #                      a merge to a base of another repo.
+      # @param head [String] The branch (or git ref) where your changes are implemented.
+      # @param title [String] Title for the pull request
+      # @param body [String] The body for the pull request. Supports GFM.
+      # @return [Hashie::Mash] The newly created pull request
       def create_pull_request(repo, base, head, title, body, options={})
         pull = {
           :base  => base,
@@ -11,6 +48,17 @@ module Octokit
         post("repos/#{Repository.new(repo)}/pulls", options.merge(pull))
       end
 
+      # Create a pull request from existing issue
+      #
+      # @see http://developer.github.com/v3/pulls/#alternative-input
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param base [String] The branch (or git ref) you want your changes
+      #                      pulled into. This should be an existing branch on the current
+      #                      repository. You cannot submit a pull request to one repo that requests
+      #                      a merge to a base of another repo.
+      # @param head [String] The branch (or git ref) where your changes are implemented.
+      # @param issue [Integer] Number of Issue on which to base this pull request
+      # @return [Hashie::Mash] The newly created pull request
       def create_pull_request_for_issue(repo, base, head, issue, options={})
         pull = {
           :base  => base,
@@ -20,24 +68,69 @@ module Octokit
         post("repos/#{Repository.new(repo)}/pulls", options.merge(pull))
       end
 
-      def pull_requests(repo, state='open', options={})
-        get("repos/#{Repository.new(repo)}/pulls", options.merge({:state => state}), 3)
-      end
-      alias :pulls :pull_requests
-
-      def pull_request(repo, number, options={})
-        get("repos/#{Repository.new(repo)}/pulls/#{number}", options)
-      end
-      alias :pull :pull_request
 
+      # List commits on a pull request
+      #
+      # @see http://developer.github.com/v3/pulls/#list-commits-on-a-pull-request
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param number [Integer] Number of pull request
+      # @return [Array<Hashie::Mash>] List of commits
       def pull_request_commits(repo, number, options={})
         get("repos/#{Repository.new(repo)}/pulls/#{number}/commits", options)
       end
       alias :pull_commits :pull_request_commits
 
+      # List comments on a pull request
+      #
+      # @see http://developer.github.com/v3/pulls/#list-comments-on-a-pull-request
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param number [Integer] Number of pull request
+      # @return [Array<Hashie::Mash>] List of comments
+      def pull_request_comments(repo, number, options={})
+        # return the comments for a pull request
+        get("repos/#{Repository.new(repo)}/pulls/#{number}/comments", options)
+      end
+      alias :pull_comments   :pull_request_comments
+      alias :review_comments :pull_request_comments
+
+      # List files on a pull request
+      #
+      # @see http://developer.github.com/v3/pulls/#list-files-on-a-pull-request
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param number [Integer] Number of pull request
+      # @return [Array<Hashie::Mash>] List of files
+      def pull_request_files(repo, number, options={})
+        get("repos/#{Repository.new(repo)}/pulls/#{number}/files", options)
+      end
+      alias :pull_files :pull_request_files
+
+      # Merge a pull request
+      #
+      # @see http://developer.github.com/v3/pulls/#merge-a-pull-request-merge-buttontrade
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param number [Integer] Number of pull request
+      # @param commit_message [String] Optional commit message for the merge commit
+      # @return [Array<Hashie::Mash>] Merge commit info if successful
       def merge_pull_request(repo, number, commit_message='', options={})
         put("repos/#{Repository.new(repo)}/pulls/#{number}/merge", options.merge({:commit_message => commit_message}))
       end
+
+      # Check pull request merge status
+      #
+      # @see http://developer.github.com/v3/pulls/#get-if-a-pull-request-has-been-merged
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param number [Integer] Number of pull request
+      # @return [Boolean] True if the pull request has been merged
+      def pull_merged?(repo, number, options={})
+        begin
+          get("repos/#{Repository.new(repo)}/pulls/#{number}/merged", options)
+          return true
+        rescue Octokit::NotFound
+          return false
+        end
+      end
+      alias :pull_request_merged? :pull_merged?
+
     end
   end
 end

data/lib/octokit/client/repositories.rb

@@ -1,16 +1,40 @@
 module Octokit
   class Client
     module Repositories
+
+      # Legacy repository search
+      #
+      # @see http://developer.github.com/v3/search/#search-repositories
+      # @param q [String] Search keyword
+      # @return [Array<Hashie::Mash>] List of repositories found
       def search_repositories(q, options={})
         get("legacy/repos/search/#{q}", options, 3)['repositories']
       end
       alias :search_repos :search_repositories
 
+      # Get a single repository
+      #
+      # @see http://developer.github.com/v3/repos/#get
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Hashie::Mash] Repository information
       def repository(repo, options={})
         get "repos/#{Repository.new repo}", options, 3
       end
       alias :repo :repository
 
+      # Edit a repository
+      #
+      # @see http://developer.github.com/v3/repos/#edit
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @param options [Hash] Repository information to update
+      # @option options [String] :name Name of the repo
+      # @option options [String] :description Description of the repo
+      # @option options [String] :homepage Home page of the repo
+      # @option options [String] :private `true` makes the repository private, and `false` makes it public.
+      # @option options [String] :has_issues `true` enables issues for this repo, `false` disables issues.
+      # @option options [String] :has_wiki `true` enables wiki for this repo, `false` disables wiki.
+      # @option options [String] :has_downloads `true` enables downloads for this repo, `false` disables downloads.
+      # @return [Hashie::Mash] Repository information
       def edit_repository(repo, options={})
         patch "repos/#{Repository.new repo}", options, 3
       end
@@ -18,6 +42,14 @@ module Octokit
       alias :update_repository :edit_repository
       alias :update :edit_repository
 
+      # List repositories
+      #
+      # If username is not supplied, repositories for the current
+      # authenticated user are returned
+      #
+      # @see http://developer.github.com/v3/repos/#list-your-repositories
+      # @param username [String] Optional username for which to list repos
+      # @return [Array<Hashie::Mash>] List of repositories
       def repositories(username=nil, options={})
         if username.nil?
           get 'user/repos', options, 3
@@ -29,18 +61,83 @@ module Octokit
       alias :list_repos :repositories
       alias :repos :repositories
 
+      # Star a repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Boolean] `true` if successfully starred
+      def star(repo, options={})
+        begin
+          put "user/starred/#{Repository.new repo}", options, 3
+          return true
+        rescue Octokit::NotFound
+          return false
+        end
+      end
+
+      # Unstar a repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Boolean] `true` if successfully unstarred
+      def unstar(repo, options={})
+        begin
+          delete "user/starred/#{Repository.new repo}", options, 3
+          return true
+        rescue Octokit::NotFound
+          return false
+        end
+      end
+
+      # Watch a repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Boolean] `true` if successfully watched
+      # @deprecated Use #star instead
       def watch(repo, options={})
-        put "user/watched/#{Repository.new repo}", options, 3
+        begin
+          put "user/watched/#{Repository.new repo}", options, 3
+          return true
+        rescue Octokit::NotFound
+          return false
+        end
       end
 
+      # Unwatch a repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Boolean] `true` if successfully unwatched
+      # @deprecated Use #unstar instead
       def unwatch(repo, options={})
-        delete "user/watched/#{Repository.new repo}", options, 3
+        begin
+          delete "user/watched/#{Repository.new repo}", options, 3
+          return true
+        rescue Octokit::NotFound
+          return false
+        end
       end
 
+      # Fork a repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Hashie::Mash] Repository info for the new fork
       def fork(repo, options={})
         post "repos/#{Repository.new repo}/forks", options, 3
       end
 
+      # Create a repository for a user or organization
+      #
+      # @param name [String] Name of the new repo
+      # @option options [String] :description Description of the repo
+      # @option options [String] :homepage Home page of the repo
+      # @option options [String] :private `true` makes the repository private, and `false` makes it public.
+      # @option options [String] :has_issues `true` enables issues for this repo, `false` disables issues.
+      # @option options [String] :has_wiki `true` enables wiki for this repo, `false` disables wiki.
+      # @option options [String] :has_downloads `true` enables downloads for this repo, `false` disables downloads.
+      # @option options [String] :organization Short name for the org under which to create the repo.
+      # @option options [Integer] :team_id The id of the team that will be granted access to this repository. This is only valid when creating a repo in an organization.
+      # @option options [Boolean] :auto_init `true` to create an initial commit with empty README. Default is `false`.
+      # @option options [String] :gitignore_template Desired language or platform .gitignore template to apply. Ignored if auto_init parameter is not provided.
+      # @return [Hashie::Mash] Repository info for the new repository
+      # @see http://developer.github.com/v3/repos/#create
       def create_repository(name, options={})
         organization = options.delete :organization
         options.merge! :name => name
@@ -54,16 +151,36 @@ module Octokit
       alias :create_repo :create_repository
       alias :create :create_repository
 
+      # Delete repository
+      #
+      # Note: If OAuth is used, 'delete_repo' scope is required
+      #
+      # @see http://developer.github.com/v3/repos/#delete-a-repository
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Boolean] `true` if repository was deleted
       def delete_repository(repo, options={})
-        delete "repos/#{Repository.new repo}", options, 3
+        begin
+          delete "repos/#{Repository.new repo}", options, 3
+          return true
+        rescue Octokit::NotFound
+          return false
+        end
       end
       alias :delete_repo :delete_repository
 
+      # Hide a public repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Hashie::Mash] Updated repository info
       def set_private(repo, options={})
         # GitHub Api for setting private updated to use private attr, rather than public
         update_repository repo, options.merge({ :private => true })
       end
 
+      # Unhide a private repository
+      #
+      # @param repo [String, Hash, Repository] A GitHub repository
+      # @return [Hashie::Mash] Updated repository info
       def set_public(repo, options={})
         # GitHub Api for setting private updated to use private attr, rather than public
         update_repository repo, options.merge({ :private => false })
@@ -108,6 +225,10 @@ module Octokit
       end
       alias :contribs :contributors
 
+      def stargazers(repo, options={})
+        get "repos/#{Repository.new repo}/stargazers", options, 3
+      end
+
       def watchers(repo, options={})
         get "repos/#{Repository.new repo}/watchers", options, 3
       end

data/lib/octokit/client/users.rb

@@ -63,6 +63,16 @@ module Octokit
         delete("user/following/#{user}", options, 3, true, raw=true).status == 204
       end
 
+      def starred(user=login, options={})
+        get("users/#{user}/starred", options, 3)
+      end
+
+      def starred?(user, repo, options={})
+        get("user/starred/#{user}/#{repo}", options, 3, true, raw=true).status == 204
+      rescue Octokit::NotFound
+        false
+      end
+
       def watched(user=login, options={})
         get("users/#{user}/watched", options, 3)
       end

data/lib/octokit/configuration.rb

@@ -5,6 +5,7 @@ module Octokit
   module Configuration
     VALID_OPTIONS_KEYS = [
       :adapter,
+      :faraday_config_block,
       :api_version,
       :api_endpoint,
       :web_endpoint,
@@ -15,6 +16,7 @@ module Octokit
       :client_id,
       :client_secret,
       :user_agent,
+      :request_host,
       :auto_traversal,
       :per_page].freeze
 
@@ -47,6 +49,10 @@ module Octokit
       @web_endpoint = File.join(value, "")
     end
 
+    def faraday_config(&block)
+      @faraday_config_block = block
+    end
+
     def reset
       self.adapter        = DEFAULT_ADAPTER
       self.api_version    = DEFAULT_API_VERSION
@@ -58,6 +64,7 @@ module Octokit
       self.oauth_token    = nil
       self.client_id      = nil
       self.client_secret  = nil
+      self.request_host   = nil
       self.user_agent     = DEFAULT_USER_AGENT
       self.auto_traversal = DEFAULT_AUTO_TRAVERSAL
     end