octokit 1.3.0 → 1.4.0

data/CHANGELOG.md

@@ -1,5 +1,6 @@
 # CHANGELOG
 
+* [1.4.0 - June 3, 2012](https://github.com/pengwynn/octokit/compare/v1.3.0...v1.4.0)
 * [1.3.0 - May 17, 2012](https://github.com/pengwynn/octokit/compare/v1.2.1...v1.3.0)
 * [1.2.0 - May 17, 2012](https://github.com/pengwynn/octokit/compare/v1.1.1...v1.2.0)
 * [1.1.1 - May 15, 2012](https://github.com/pengwynn/octokit/compare/v1.1.0...v1.1.1)

data/lib/octokit/client.rb

@@ -21,6 +21,7 @@ require 'octokit/client/timelines'
 require 'octokit/client/users'
 require 'octokit/client/events'
 require 'octokit/client/authorizations'
+require 'octokit/client/refs'
 
 module Octokit
   class Client
@@ -54,5 +55,6 @@ module Octokit
     include Octokit::Client::Users
     include Octokit::Client::Events
     include Octokit::Client::Authorizations
+    include Octokit::Client::Refs
   end
 end

data/lib/octokit/client/refs.rb

@@ -0,0 +1,85 @@
+module Octokit
+  class Client
+    module Refs
+
+      # List all refs for a given user and repo
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param namespace [String] The ref namespace, e.g. <tt>tag</tt> or <tt>heads</tt>
+      # @return [Array] A list of references matching the repo and the namespace
+      # @see http://developer.github.com/v3/git/refs/
+      # @example Fetch all refs for sferik/rails_admin
+      #   Octokit.refs("sferik/rails_admin")
+      def refs(repo, namespace="", options={})
+        get("/repos/#{Repository.new(repo)}/git/refs/#{namespace}", options, 3)
+      end
+      alias :list_refs :refs
+      alias :references :refs
+      alias :list_references :refs
+
+      # Fetch a given reference
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param ref [String] The ref, e.g. <tt>tags/v0.0.3</tt>
+      # @return [Reference] The reference matching the given repo and the ref id
+      # @see http://developer.github.com/v3/git/refs/
+      # @example Fetch tags/v0.0.3 for sferik/rails_admin
+      #   Octokit.ref("sferik/rails_admin","tags/v0.0.3")
+      def ref(repo, ref, options={})
+        get("/repos/#{Repository.new(repo)}/git/refs/#{ref}", options, 3)
+      end
+      alias :reference :ref
+
+      # Create a reference
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param ref [String] The ref, e.g. <tt>tags/v0.0.3</tt>
+      # @param sha [String] A SHA, e.g. <tt>827efc6d56897b048c772eb4087f854f46256132</tt>
+      # @return [Array] The list of references, already containing the new one
+      # @see http://developer.github.com/v3/git/refs/
+      # @example Create refs/heads/master for octocat/Hello-World with sha 827efc6d56897b048c772eb4087f854f46256132
+      #   Octokit.create_ref("octocat/Hello-World","heads/master", "827efc6d56897b048c772eb4087f854f46256132")
+      def create_ref(repo, ref, sha, options={})
+        parameters = {
+          :ref  => "refs/#{ref}",
+          :sha  => sha
+        }
+        post("repos/#{Repository.new(repo)}/git/refs", options.merge(parameters))
+      end
+      alias :create_reference :create_ref
+
+      # Update a reference
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param ref [String] The ref, e.g. <tt>tags/v0.0.3</tt>
+      # @param sha [String] A SHA, e.g. <tt>827efc6d56897b048c772eb4087f854f46256132</tt>
+      # @param force [Boolean] A flag indicating one wants to force the update to make sure the update is a fast-forward update.
+      # @return [Array] The list of references updated
+      # @see http://developer.github.com/v3/git/refs/
+      # @example Force update heads/sc/featureA for octocat/Hello-World with sha aa218f56b14c9653891f9e74264a383fa43fefbd
+      #   Octokit.update_ref("octocat/Hello-World","heads/sc/featureA", "aa218f56b14c9653891f9e74264a383fa43fefbd")
+      def update_ref(repo, ref, sha, force=true, options={})
+        parameters = {
+          :sha  => sha,
+          :force => force
+        }
+        patch("repos/#{Repository.new(repo)}/git/refs/#{ref}", options.merge(parameters))
+      end
+      alias :update_reference :update_ref
+
+      # Delete a single reference
+      #
+      # @param repo [String, Repository, Hash] A GitHub repository
+      # @param ref [String] The ref, e.g. <tt>tags/v0.0.3</tt>
+      # @return [Response] A response object with status
+      # @see http://developer.github.com/v3/git/refs/
+      # @example Delete tags/v0.0.3 for sferik/rails_admin
+      #   Octokit.delete_ref("sferik/rails_admin","tags/v0.0.3")
+      def delete_ref(repo, ref, options={})
+        delete("/repos/#{Repository.new(repo)}/git/refs/#{ref}", options, 3, true, true)
+      end
+      alias :delete_reference :delete_ref
+
+    end
+  end
+end

data/lib/octokit/version.rb

@@ -1,3 +1,3 @@
 module Octokit
-  VERSION = "1.3.0" unless defined?(Octokit::VERSION)
+  VERSION = "1.4.0" unless defined?(Octokit::VERSION)
 end

data/spec/fixtures/v3/ref.json

@@ -0,0 +1,9 @@
+{
+  "object": {
+    "sha": "0591c7b765779ea8797f0f0b9222299e600393ca",
+    "type": "tag",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/tags/0591c7b765779ea8797f0f0b9222299e600393ca"
+  },
+  "ref": "refs/tags/v0.0.3",
+  "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/tags/v0.0.3"
+}

data/spec/fixtures/v3/ref_create.json

@@ -0,0 +1,29 @@
+[
+  {
+    "ref": "refs/heads/master",
+    "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/master",
+    "object": {
+      "type": "commit",
+      "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
+      "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
+    }
+  },
+  {
+    "ref": "refs/heads/gh-pages",
+    "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/gh-pages",
+    "object": {
+      "type": "commit",
+      "sha": "612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac",
+      "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/612077ae6dffb4d2fbd8ce0cccaa58893b07b5ac"
+    }
+  },
+  {
+    "ref": "refs/tags/v0.0.1",
+    "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/tags/v0.0.1",
+    "object": {
+      "type": "tag",
+      "sha": "940bd336248efae0f9ee5bc7b2d5c985887b16ac",
+      "url": "https://api.github.com/repos/octocat/Hello-World/git/tags/940bd336248efae0f9ee5bc7b2d5c985887b16ac"
+    }
+  }
+]

data/spec/fixtures/v3/ref_update.json

@@ -0,0 +1,11 @@
+[
+  {
+    "ref": "refs/heads/sc/featureA",
+    "url": "https://api.github.com/repos/octocat/Hello-World/git/refs/heads/sc/featureA",
+    "object": {
+      "type": "commit",
+      "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
+      "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/aa218f56b14c9653891f9e74264a383fa43fefbd"
+    }
+  }
+]

data/spec/fixtures/v3/refs.json

@@ -0,0 +1,38 @@
+[
+  {
+    "object": {
+      "sha": "19453d77913e5cc92dd836294bcb6e7ceb4d2a7f",
+      "type": "commit",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/commits/19453d77913e5cc92dd836294bcb6e7ceb4d2a7f"
+    },
+    "ref": "refs/heads/actions",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/heads/actions"
+  },
+  {
+    "object": {
+      "sha": "1cb0628eea5be6120c4bfcbe609b3cea5f246290",
+      "type": "commit",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/commits/1cb0628eea5be6120c4bfcbe609b3cea5f246290"
+    },
+    "ref": "refs/heads/activo",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/heads/activo"
+  },
+  {
+    "object": {
+      "sha": "acfa1e5d2bf3c80a511d3d2ea6dcd60169d5c564",
+      "type": "commit",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/commits/acfa1e5d2bf3c80a511d3d2ea6dcd60169d5c564"
+    },
+    "ref": "refs/heads/associated-collection-refact",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/heads/associated-collection-refact"
+  },
+  {
+    "object": {
+      "sha": "14cdd3be4ada38f8e6974935f806c8de170abf11",
+      "type": "commit",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/commits/14cdd3be4ada38f8e6974935f806c8de170abf11"
+    },
+    "ref": "refs/heads/dsl-refactoring",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/heads/dsl-refactoring"
+  }
+]

data/spec/fixtures/v3/refs_tags.json

@@ -0,0 +1,29 @@
+[
+  {
+    "object": {
+      "sha": "69edc0b0ac7dfa2780a39c113b54718b6defe081",
+      "type": "tag",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/tags/69edc0b0ac7dfa2780a39c113b54718b6defe081"
+    },
+    "ref": "refs/tags/v0.0.1",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/tags/v0.0.1"
+  },
+  {
+    "object": {
+      "sha": "daa8d377587115484ab4f06272a9242436ab615c",
+      "type": "tag",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/tags/daa8d377587115484ab4f06272a9242436ab615c"
+    },
+    "ref": "refs/tags/v0.0.2",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/tags/v0.0.2"
+  },
+  {
+    "object": {
+      "sha": "0591c7b765779ea8797f0f0b9222299e600393ca",
+      "type": "tag",
+      "url": "https://api.github.com/repos/sferik/rails_admin/git/tags/0591c7b765779ea8797f0f0b9222299e600393ca"
+    },
+    "ref": "refs/tags/v0.0.3",
+    "url": "https://api.github.com/repos/sferik/rails_admin/git/refs/tags/v0.0.3"
+  }
+]

data/spec/octokit/client/refs_spec.rb

@@ -0,0 +1,79 @@
+# -*- encoding: utf-8 -*-
+require 'helper'
+
+describe Octokit::Client::Refs do
+
+  before do
+    @client = Octokit::Client.new(:login => 'sferik')
+  end
+
+  describe ".refs" do
+
+    it "should return all refs" do
+      stub_get("/repos/sferik/rails_admin/git/refs/").
+        to_return(:body => fixture("v3/refs.json"))
+      refs = @client.refs("sferik/rails_admin")
+      refs.first.ref.should == "refs/heads/actions"
+    end
+
+    it "should return all tag refs" do
+      stub_get("/repos/sferik/rails_admin/git/refs/tags").
+        to_return(:body => fixture("v3/refs_tags.json"))
+      refs = @client.refs("sferik/rails_admin","tags")
+      refs.first.ref.should == "refs/tags/v0.0.1"
+    end
+
+  end
+
+  describe ".ref" do
+
+    it "should return the tags/v0.0.3 ref" do
+      stub_get("/repos/sferik/rails_admin/git/refs/tags/v0.0.3").
+        to_return(:body => fixture("v3/ref.json"))
+      ref = @client.ref("sferik/rails_admin","tags/v0.0.3")
+      ref.object.type.should eq("tag")
+      ref.ref.should eq("refs/tags/v0.0.3")
+      ref.url.should eq("https://api.github.com/repos/sferik/rails_admin/git/refs/tags/v0.0.3")
+    end
+
+  end
+
+  describe ".create_ref" do
+
+    it "should create a ref" do
+      stub_post("/repos/octocat/Hello-World/git/refs").
+        with(:body => { "ref" => "refs/heads/master", "sha" => "827efc6d56897b048c772eb4087f854f46256132" },
+             :headers => {'Content-Type'=>'application/json'}).
+        to_return(:body => fixture("v3/ref_create.json"))
+      ref = @client.create_ref("octocat/Hello-World","heads/master", "827efc6d56897b048c772eb4087f854f46256132")
+      ref.first.ref.should eq("refs/heads/master")
+    end
+
+  end
+
+  describe ".update_ref" do
+
+    it "should update a ref" do
+      stub_patch("/repos/octocat/Hello-World/git/refs/heads/sc/featureA").
+        with(:body => { "sha" => "aa218f56b14c9653891f9e74264a383fa43fefbd", "force" => true },
+             :headers => {'Content-Type'=>'application/json'}).
+        to_return(:body => fixture("v3/ref_update.json"))
+      refs = @client.update_ref("octocat/Hello-World","heads/sc/featureA", "aa218f56b14c9653891f9e74264a383fa43fefbd", true)
+      refs.first.ref.should eq("refs/heads/sc/featureA")
+      refs.first.object.sha.should eq("aa218f56b14c9653891f9e74264a383fa43fefbd")
+    end
+  end
+
+  describe ".delete_ref" do
+
+    it "should delete an existing ref" do
+      stub_delete("/repos/octocat/Hello-World/git/refs/heads/feature-a").
+        to_return(:status => 204)
+      ref = @client.delete_ref("octocat/Hello-World", "heads/feature-a")
+      ref.status.should == 204
+    end
+
+  end
+
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: octokit
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -11,11 +11,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-25 00:00:00.000000000 Z
+date: 2012-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
-  requirement: &70239311442360 !ruby/object:Gem::Requirement
+  requirement: &70182007527020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -23,10 +23,10 @@ dependencies:
         version: '2.2'
   type: :runtime
   prerelease: false
-  version_requirements: *70239311442360
+  version_requirements: *70182007527020
 - !ruby/object:Gem::Dependency
   name: faraday
-  requirement: &70239311441620 !ruby/object:Gem::Requirement
+  requirement: &70182007526200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -34,10 +34,10 @@ dependencies:
         version: '0.8'
   type: :runtime
   prerelease: false
-  version_requirements: *70239311441620
+  version_requirements: *70182007526200
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
-  requirement: &70239311440380 !ruby/object:Gem::Requirement
+  requirement: &70182007525620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -45,10 +45,10 @@ dependencies:
         version: '0.8'
   type: :runtime
   prerelease: false
-  version_requirements: *70239311440380
+  version_requirements: *70182007525620
 - !ruby/object:Gem::Dependency
   name: hashie
-  requirement: &70239311438260 !ruby/object:Gem::Requirement
+  requirement: &70182007524920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -56,10 +56,10 @@ dependencies:
         version: '1.2'
   type: :runtime
   prerelease: false
-  version_requirements: *70239311438260
+  version_requirements: *70182007524920
 - !ruby/object:Gem::Dependency
   name: multi_json
-  requirement: &70239311436780 !ruby/object:Gem::Requirement
+  requirement: &70182007523940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -67,10 +67,10 @@ dependencies:
         version: '1.3'
   type: :runtime
   prerelease: false
-  version_requirements: *70239311436780
+  version_requirements: *70182007523940
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70239311433780 !ruby/object:Gem::Requirement
+  requirement: &70182007522920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -78,10 +78,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311433780
+  version_requirements: *70182007522920
 - !ruby/object:Gem::Dependency
   name: maruku
-  requirement: &70239311411840 !ruby/object:Gem::Requirement
+  requirement: &70182007522100 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -89,10 +89,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311411840
+  version_requirements: *70182007522100
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70239311410940 !ruby/object:Gem::Requirement
+  requirement: &70182007521480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -100,10 +100,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311410940
+  version_requirements: *70182007521480
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70239311407980 !ruby/object:Gem::Requirement
+  requirement: &70182007519800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -111,10 +111,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311407980
+  version_requirements: *70182007519800
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70239311406460 !ruby/object:Gem::Requirement
+  requirement: &70182007519380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -122,10 +122,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311406460
+  version_requirements: *70182007519380
 - !ruby/object:Gem::Dependency
   name: webmock
-  requirement: &70239311405000 !ruby/object:Gem::Requirement
+  requirement: &70182007518920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -133,10 +133,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311405000
+  version_requirements: *70182007518920
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70239311403620 !ruby/object:Gem::Requirement
+  requirement: &70182007518500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -144,7 +144,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70239311403620
+  version_requirements: *70182007518500
 description: Simple wrapper for the GitHub v3 API
 email:
 - wynn.netherland@gmail.com
@@ -182,6 +182,7 @@ files:
 - lib/octokit/client/pub_sub_hubbub.rb
 - lib/octokit/client/pub_sub_hubbub/service_hooks.rb
 - lib/octokit/client/pulls.rb
+- lib/octokit/client/refs.rb
 - lib/octokit/client/repositories.rb
 - lib/octokit/client/timelines.rb
 - lib/octokit/client/users.rb
@@ -253,6 +254,11 @@ files:
 - spec/fixtures/v3/pull_created.json
 - spec/fixtures/v3/pull_request.json
 - spec/fixtures/v3/pull_requests.json
+- spec/fixtures/v3/ref.json
+- spec/fixtures/v3/ref_create.json
+- spec/fixtures/v3/ref_update.json
+- spec/fixtures/v3/refs.json
+- spec/fixtures/v3/refs_tags.json
 - spec/fixtures/v3/repo_events.json
 - spec/fixtures/v3/repo_issues_events.json
 - spec/fixtures/v3/repositories.json
@@ -282,6 +288,7 @@ files:
 - spec/octokit/client/pub_sub_hubbub/service_hooks_spec.rb
 - spec/octokit/client/pub_sub_hubbub_spec.rb
 - spec/octokit/client/pulls_spec.rb
+- spec/octokit/client/refs_spec.rb
 - spec/octokit/client/repositories_spec.rb
 - spec/octokit/client/timelines_spec.rb
 - spec/octokit/client/users_spec.rb
@@ -374,6 +381,11 @@ test_files:
 - spec/fixtures/v3/pull_created.json
 - spec/fixtures/v3/pull_request.json
 - spec/fixtures/v3/pull_requests.json
+- spec/fixtures/v3/ref.json
+- spec/fixtures/v3/ref_create.json
+- spec/fixtures/v3/ref_update.json
+- spec/fixtures/v3/refs.json
+- spec/fixtures/v3/refs_tags.json
 - spec/fixtures/v3/repo_events.json
 - spec/fixtures/v3/repo_issues_events.json
 - spec/fixtures/v3/repositories.json
@@ -403,6 +415,7 @@ test_files:
 - spec/octokit/client/pub_sub_hubbub/service_hooks_spec.rb
 - spec/octokit/client/pub_sub_hubbub_spec.rb
 - spec/octokit/client/pulls_spec.rb
+- spec/octokit/client/refs_spec.rb
 - spec/octokit/client/repositories_spec.rb
 - spec/octokit/client/timelines_spec.rb
 - spec/octokit/client/users_spec.rb