git_hub 0.2.0 → 0.2.7

data/README.rdoc

@@ -1,11 +1,11 @@
 = git_hub
-    by:: Arvicco
-    url:: http://github.com/arvicco/git_hub
+    by: Arvicco
+    url: http://github.com/arvicco/git_hub
 
 == DESCRIPTION:
 
 git_hub is a library that wraps github API and exposes simple interface for
-finding, creating and managing github repositories and other resources...
+finding, creating and managing github repositories and other resources.
 
 == FEATURES/PROBLEMS:
 
@@ -15,31 +15,32 @@ Contributors always welcome!
 
 == SYNOPSIS:
 
-require 'git_hub'
-include GitHub
-
-# Find existing repos:
-repo = Repo.find(:user=>user_name, :repo=>repo_name)
-repos = Repo.find(:user=>user_name)
-search_repos = Repo.find(:query=>['search','terms'])
-
-# Retrieve tags, branches and commits for a repo:
-puts repo.tags['v0.1.0']
-puts repo.branches['master']
-repo.commits.each {|commit| p commit.author}
-
-# Retrieve info for a specific commit:
-commits = Commit.find(:user=>user_name, :repo=>repo_name, :branch=>'master')
-commits = Commit.find(:user=>user_name, :repo=>repo_name, :branch=>'master', :path=>'README.rdoc')
-commit = Commit.find(:user=>user_name, :repo=>repo_name, :sha=>'commit_sha')
-# or, if repo is already retrieved:
-commit = repo.commits.last
-commit = repo.tags['v0.1.0']  #TODO - now returns only sha, not Commit
-
-# Create new repo or delete existing repo (need to authenticate with your github credentials first)
-Api.auth = {:user=>user_name, :token=>token}
-new_repo = Repo.create(:name=>repo_name, :desc=>'Description', :homepage=>'http://your_page.org', :private=> false)
-new_repo.delete
+  require 'git_hub'
+  include GitHub
+
+Find existing repos:
+  repo = Repo.find(:user=>user_name, :repo=>repo_name)
+  repos = Repo.find(:user=>user_name)
+  search_repos = Repo.find(:query=>['search','terms'])
+
+Retrieve tags, branches and commits for a repo:
+  puts repo.tags['v0.1.0'].committer
+  puts repo.branches['master'].committed_date
+  repo.commits.each {|commit| p commit.author}
+
+Retrieve info for a specific commit:
+  commits = Commit.find(:user=>user_name, :repo=>repo_name, :branch=>'master')
+  commits = Commit.find(:user=>user_name, :repo=>repo_name, :branch=>'master', :path=>'README.rdoc')
+  commit = Commit.find(:user=>user_name, :repo=>repo_name, :sha=>'commit_sha')
+  # or, if repo is already retrieved:
+  commit = repo.commits.last
+  commit = repo.tags['v0.1.0']
+  commit = repo.branches['master']  # returns most recent commit for a branch
+
+Create new repo or delete existing repo (need to authenticate with your github credentials first)
+  Api.auth = {:user=>user_name, :token=>token}
+  new_repo = Repo.create(:name=>repo_name, :desc=>'Description', :homepage=>'http://your_page.org', :private=> false)
+  new_repo.delete
 
 == REQUIREMENTS:
 
@@ -47,7 +48,7 @@ new_repo.delete
 
 == INSTALL:
 
-$ sudo gem install git_hub
+  $ sudo gem install git_hub
 
 == LICENSE:
 

data/Rakefile

@@ -51,7 +51,7 @@ Rake::RDocTask.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
 
   rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "zemax #{version}"
+  rdoc.title = "git_hub #{version}"
   rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.7

data/features/support/env.rb

@@ -1,4 +1,4 @@
 $LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
-require 'zemax'
+require 'git_hub'
 
 require 'spec/expectations'

data/git_hub.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{git_hub}
-  s.version = "0.2.0"
+  s.version = "0.2.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["arvicco"]
-  s.date = %q{2010-01-11}
+  s.date = %q{2010-01-12}
   s.default_executable = %q{git_hub}
   s.description = %q{Simple interface to github API}
   s.email = %q{arvitallian@gmail.com}
@@ -24,9 +24,9 @@ Gem::Specification.new do |s|
      "Rakefile",
      "VERSION",
      "bin/git_hub",
-     "features/step_definitions/zemax_steps.rb",
+     "features/git_hub.feature",
+     "features/step_definitions/git_hub_steps.rb",
      "features/support/env.rb",
-     "features/zemax.feature",
      "git_hub.gemspec",
      "lib/git_hub.rb",
      "lib/git_hub/api.rb",
@@ -36,11 +36,13 @@ Gem::Specification.new do |s|
      "rdoc/classes/GitHub.html",
      "rdoc/classes/GitHub/Api.html",
      "rdoc/classes/GitHub/Base.html",
+     "rdoc/classes/GitHub/Commit.html",
      "rdoc/classes/GitHub/Repo.html",
      "rdoc/created.rid",
      "rdoc/files/README_rdoc.html",
      "rdoc/files/lib/git_hub/api_rb.html",
      "rdoc/files/lib/git_hub/base_rb.html",
+     "rdoc/files/lib/git_hub/commit_rb.html",
      "rdoc/files/lib/git_hub/repo_rb.html",
      "rdoc/files/lib/git_hub_rb.html",
      "rdoc/fr_class_index.html",
@@ -52,12 +54,15 @@ Gem::Specification.new do |s|
      "spec/git_hub/base_spec.rb",
      "spec/git_hub/commit_spec.rb",
      "spec/git_hub/repo_spec.rb",
+     "spec/git_hub/user_spec.rb",
      "spec/spec.opts",
      "spec/spec_helper.rb",
      "spec/stubs/api_route_error.res",
      "spec/stubs/commits/list/joe007/fine_repo/master.res",
      "spec/stubs/commits/list/joe007/fine_repo/master/README.res",
+     "spec/stubs/commits/show/joe007/fine_repo/3a70f86293b719f193f778a8710b1f83f2f7bf38.res",
      "spec/stubs/commits/show/joe007/fine_repo/5e61f0687c40ca48214d09dc7ae2d0d0d8fbfeb8.res",
+     "spec/stubs/commits/show/joe007/fine_repo/f7f5dddaa37deacc83f1f56876e2b135389d03ab.res",
      "spec/stubs/repos/create.1.res",
      "spec/stubs/repos/create.2.res",
      "spec/stubs/repos/create.3.res",
@@ -82,6 +87,7 @@ Gem::Specification.new do |s|
      "spec/git_hub/base_spec.rb",
      "spec/git_hub/commit_spec.rb",
      "spec/git_hub/repo_spec.rb",
+     "spec/git_hub/user_spec.rb",
      "spec/spec_helper.rb"
   ]
 

data/lib/git_hub/base.rb

@@ -4,10 +4,10 @@ module GitHub
   class Base
 
     def initialize(attributes={})
-      update_attributes attributes
+      set_attributes attributes
     end
 
-    def update_attributes attributes
+    def set_attributes attributes
       attributes.each do |key, value|
         raise "No attr_accessor for #{key} on #{self.class}" unless respond_to?("#{key}=")
         self.send("#{key.to_s}=", value)
@@ -16,9 +16,9 @@ module GitHub
 
     class << self
       def request verb, uri, params = {}
-        path = uri[0] == '/' ? base_uri+uri : uri
-        #p "request: #{verb} #{path} #{params}"
-        res = api.request verb, path, params
+        full_uri = uri[0] == '/' ? base_uri+uri : uri
+        #p "request: #{verb} #{full_uri} #{params}"
+        res = api.request verb, full_uri, params
         YAML::load(res.body) if res.respond_to?(:body)
         #p "response: #{res}: #{res.code}: #{res.http_version}: #{res.message}", res.body
       end
@@ -42,34 +42,48 @@ module GitHub
       end
 
       def base_uri
-        @base_uri || ""
+        @base_uri || ''
       end
 
       private
 
-      def normalize opts
-        opts[:user] ||= opts[:owner] || opts[:username] || opts[:login] || api.auth['login']
-        opts[:repo] ||= opts[:repository] || opts[:name] || opts[:project]
-        opts[:sha] ||= opts[:hash] || opts[:object_id] || opts[:id]
-        opts[:description] ||= opts[:descr] || opts[:desc]
-        opts[:query] ||= opts[:search]
-        opts[:branch] ||= 'master'
-        opts[:public] ||= !opts[:private] unless opts[:public] = false # defaults to true
+      # extracts arguments described by *args from an opts Hash
+      def extract(opts, *args)
+        raise "Expected options Hash, got #{opts}" unless opts.kind_of? Hash
+        args.map do |arg|
+          opts[arg] || opts[arg.to_sym] || case arg.to_sym
+            when :user
+              opts[:owner] || opts[:username] || opts[:login] || api.auth['login']
+            when :repo
+              opts[:repository] || opts[:name] || opts[:project]
+            when :sha
+              opts[:hash] || opts[:object_id] || opts[:id]
+            when :desc
+              opts[:description] || opts[:descr]
+            when :query
+              opts[:search]
+            when :branch
+              'master'
+            when :public
+              !opts[:private] unless opts[:public] == false
+            else
+              nil
+          end
+        end
       end
 
-      def instantiate hash
-        if res = contains(hash, @singulars)
-          new res
-        elsif res = contains(hash, @plurals)
-          res.map {|r| new r}
+      # tries to single instance or an Array of instances for a given Hash of
+      # attributes Hash(es), returns original Hash if unsuccessful
+      def instantiate hash, extra_inits={}
+        raise "Expected result Hash, got #{hash}" unless hash.kind_of? Hash
+        if init = hash.values_at(*@singulars).compact.first
+          new init.merge extra_inits
+        elsif inits = hash.values_at(*@plurals).compact.first
+          inits.map {|init| new init.merge extra_inits}
         else
           hash
         end
       end
-
-      def contains hash, keys
-        keys.inject(nil) {|memo, key| memo ||= hash[key.to_s]}
-      end
     end
 
     def get uri, params ={}

data/lib/git_hub/commit.rb

@@ -1,13 +1,14 @@
 module GitHub
   class Commit < Base
 
-    set_resource 'http://github.com/api/v2/yaml/commits', 'commit', ['commits', 'tags', 'branches']
+    set_resource 'http://github.com/api/v2/yaml/commits', 'commit', 'commits'
 
     attr_accessor :id, :author, :committer, :parents, :url, :committed_date, :authored_date, :message, :tree,
-                  #  :user, :name, :sha, :repo,
-                  # retrieving commit for a specific sha - "/show/#{opts[:user]}/#{opts[:repo]}/#{opts[:sha]}"
-                  :added, :modified, :removed
-    
+                  # retrieving commit for a specific sha - "/show/:user/:repo/:sha" adds:
+                  :added, :modified, :removed,
+                  # extra attributes:
+                  :user, :repo
+
     def initialize opts
       super
       raise "Unable to initialize #{self.class} without id(sha)" unless sha
@@ -22,23 +23,25 @@ module GitHub
       # Find commits, accepts Hash with keys:
       # :user/:owner/:username:: Github user name
       # :repo/:repository/:project:: Repo name
-      # :branch:: Repo branch - default 'master'
-      # :path:: For specific path
-      # :sha/:hash/:id:: Unique commit id (sha)
+      # :branch:: Only commits for specific branch - default 'master'
+      # :path:: Only commits for specific path
+      # :sha/:id:: Only one commit with specific id (sha)
       def find(opts)
-        normalize opts
-        raise "Unable to find Commits for #{opts}" unless opts[:user] && opts[:repo]
-        path = if opts[:sha]
-          "/show/#{opts[:user]}/#{opts[:repo]}/#{opts[:sha]}"
-        elsif opts[:path]
-          "/list/#{opts[:user]}/#{opts[:repo]}/#{opts[:branch]}/#{opts[:path]}"
+        user, repo, branch, sha, path = extract opts, :user, :repo, :branch, :sha, :path 
+        repo_given = branch && user && repo
+        path = if sha && repo_given
+          "/show/#{user}/#{repo}/#{sha}"
+        elsif path && repo_given
+          "/list/#{user}/#{repo}/#{branch}/#{path}"
+        elsif repo_given 
+          "/list/#{user}/#{repo}/#{branch}"
         else
-          "/list/#{opts[:user]}/#{opts[:repo]}/#{opts[:branch]}"
+          raise "Unable to find #{self.class}(s) for #{opts}"
         end
-        instantiate get(path)
+        instantiate get(path), :user=>user, :repo=>repo
       end
 
-      #alias show find
+      alias show find
     end
   end
 

data/lib/git_hub/repo.rb

@@ -26,26 +26,26 @@ module GitHub
 
     set_resource 'http://github.com/api/v2/yaml/repos', 'repository', 'repositories'
 
-    attr_accessor :name, :owner, :description, :url, :homepage, :open_issues, :watchers, :forks, :fork, :private,
+    attr_accessor :name, :user, :description, :url, :homepage, :open_issues, :watchers, :forks, :fork, :private,
                   # additional attributes from search:
                   :id, :type, :size, :language, :created, :pushed, :score #?
 
     def initialize options
       super
-      raise "Unable to initialize #{self.class} without name" unless user && name     
-      @url ||= "http://github.com/#{user}/#{name}"
+      raise "Unable to initialize #{self.class} without user and name" unless @user && @name
+      @url ||= "http://github.com/#{@user}/#{@name}"
       @type ||= "repo"
-    end
+    end 
 
     alias followers= watchers=
     alias followers watchers
-    alias username= owner=
-    alias username owner
-    alias user= owner=
-    alias user owner
+    alias username= user=
+    alias username user
+    alias owner= user=
+    alias owner user
 
     def fork?;
-      !!self.fork
+      !!fork
     end
 
     def private?;
@@ -53,22 +53,24 @@ module GitHub
     end
 
     def clone_url
-      url = private? || api.auth['login'] == self.user ? "git@github.com:" : "git://github.com/"
-      url += "#{self.user}/#{self.name}.git"
+      url = private? || api.auth['login'] == user ? "git@github.com:" : "git://github.com/"
+      url += "#{@user}/#{@name}.git"
     end
 
     def tags
-      result = get "/show/#{self.user}/#{self.name}/tags"
-      result['tags'] || result
+      hash_of_commits(:tags)
     end
 
     def branches
-      result = get "/show/#{self.user}/#{self.name}/branches"
-      result['branches'] || result
+      hash_of_commits(:branches)
     end
 
+    # Returns commits for this repo, accepts options:
+    # :branch:: Only commits for specific branch - default 'master'
+    # :path:: Only commits for specific path
+    # :sha/:id:: Only one commit with specific id (sha)
     def commits opts = {}
-       Commit.find opts.merge(:user => self.user, :repo => self.name)
+       Commit.find opts.merge(:user => @user, :repo => @name)
     end
 
     class << self # Repo class methods
@@ -78,13 +80,13 @@ module GitHub
       # :repo/:repository/:project/:name:: Repo name
       # :query/:search:: Array of search terms as Strings or Symbols
       def find(opts)
-        normalize opts
-        path = if opts[:query]
-          "/search/#{opts[:query].map(&:to_s).join('+')}"
-        elsif opts[:user] && opts[:repo]
-          "/show/#{opts[:user]}/#{opts[:repo]}" 
-        elsif opts[:user]
-          "/show/#{opts[:user]}"
+        user, repo, query = extract opts, :user, :repo, :query
+        path = if query
+          "/search/#{query.map(&:to_s).join('+')}"
+        elsif user && repo
+          "/show/#{user}/#{repo}"
+        elsif user
+          "/show/#{user}"
         else
           raise "Unable to find #{self.class}(s) for #{opts}"
         end
@@ -96,23 +98,23 @@ module GitHub
 
       # Create new github repo, accepts Hash with :repo, :description, :homepage, :public/:private
       def create(opts)
-        normalize opts
+        repo, desc, homepage, public = extract opts, :repo, :desc, :homepage, :public
         api.ensure_auth opts
-        instantiate post("/create", 'name' => opts[:repo], 'description' => opts[:description],
-                             'homepage' => opts[:homepage], 'public' => (opts[:public] ? 1 : 0))  
+        instantiate post("/create", 'name' => repo, 'description' => desc,
+                             'homepage' => homepage, 'public' => (public ? 1 : 0))
       end
-    end
+    end 
 
     # Delete github repo, accepts optional Hash with authentication
     def delete(opts = {})
       api.ensure_auth opts
-      result = post("/delete/#{name}")
-      if result['delete_token']
-        post("/delete/#{name}", 'delete_token' => result['delete_token'])
+      result = post("/delete/#{@name}")
+      if token = result['delete_token']
+        post("/delete/#{@name}", 'delete_token' => token)
       else
         result
       end
-    end
+    end 
 
     def add_service
     end
@@ -120,12 +122,30 @@ module GitHub
     def remove_service
     end
 
+    def collaborators
+      'repos/show/:user/:repo/collaborators'
+    end
+
     def add_collaborator
     end
 
     def remove_collaborator
     end
 
+    private
+
+    def hash_of_commits(resource)
+      result = get "/show/#{@user}/#{@name}/#{resource}"
+      if tagged_shas = result[resource.to_s]
+        tagged_commits = tagged_shas.map do |tag,sha|
+          [tag, Commit.find(:user=>@user, :repo=>@name, :sha=>sha)]
+        end
+        Hash[*tagged_commits.flatten]
+      else
+        result
+      end
+    end
+
     # repos/show/:user/:repo/tags
     # repos/show/:user/:repo/branches
     # repos/show/:user/:repo/languages

data/lib/git_hub.rb

@@ -2,17 +2,10 @@
 module GitHub
 
   # :stopdoc:
-  VERSION = '0.0.1'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
   # :startdoc:
 
-  # Returns the version string for the library.
-  #
-  def self.version
-    VERSION
-  end
-
   # Returns the library path for the module. If any arguments are given,
   # they will be joined to the end of the libray path using
   # <tt>File.join</tt>.
@@ -36,8 +29,7 @@ module GitHub
   #
   def self.require_all_libs_relative_to( fname, dir = nil )
     dir ||= ::File.basename(fname, '.*')
-    search_me = ::File.expand_path(
-        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+    search_me = ::File.expand_path(::File.join(::File.dirname(fname), dir, '**', '*.rb'))
 
     Dir.glob(search_me).sort.each {|rb| require rb}
   end
@@ -45,4 +37,3 @@ module GitHub
 end  # module GitHub
 
 GitHub.require_all_libs_relative_to(__FILE__)
-

data/rdoc/classes/GitHub/Api.html

@@ -2,7 +2,7 @@
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>Class: GitHub::Api [zemax 0.1.0
+  <title>Class: GitHub::Api [git_hub 0.2.7
 ]</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <meta http-equiv="Content-Script-Type" content="text/javascript" />
@@ -92,12 +92,14 @@
 
       <div class="name-list">
 
-        <a href="#M000005">auth</a>&nbsp;&nbsp;
+        <a href="#M000004">auth</a>&nbsp;&nbsp;
 
-        <a href="#M000006">authenticated?</a>&nbsp;&nbsp;
+        <a href="#M000005">authenticated?</a>&nbsp;&nbsp;
 
         <a href="#M000007">classify</a>&nbsp;&nbsp;
 
+        <a href="#M000006">ensure_auth</a>&nbsp;&nbsp;
+
         <a href="#M000008">request</a>&nbsp;&nbsp;
 
       </div>
@@ -147,12 +149,12 @@
       <h3 class="section-bar">Public Instance methods</h3>
 
 
-      <div id="method-M000005" class="method-detail">
-        <a name="M000005"></a>
+      <div id="method-M000004" class="method-detail">
+        <a name="M000004"></a>
 
         <div class="method-heading">
 
-          <a href="#M000005" class="method-signature">
+          <a href="#M000004" class="method-signature">
 
           <span class="method-name">auth</span><span class="method-args">()</span>
 
@@ -163,8 +165,8 @@
         <div class="method-description">
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000005-source">
+            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000004-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 10</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">auth</span>
@@ -177,12 +179,12 @@
       </div>
 
 
-      <div id="method-M000006" class="method-detail">
-        <a name="M000006"></a>
+      <div id="method-M000005" class="method-detail">
+        <a name="M000005"></a>
 
         <div class="method-heading">
 
-          <a href="#M000006" class="method-signature">
+          <a href="#M000005" class="method-signature">
 
           <span class="method-name">authenticated?</span><span class="method-args">()</span>
 
@@ -193,8 +195,8 @@
         <div class="method-description">
 
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000006-source">
+            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000005-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 14</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">authenticated?</span>
@@ -231,7 +233,7 @@ found
             onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000007-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 19</span>
+<span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 25</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">classify</span> <span class="ruby-identifier">name</span>
       <span class="ruby-identifier">klass</span> = <span class="ruby-identifier">name</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">&quot;::&quot;</span>).<span class="ruby-identifier">inject</span>(<span class="ruby-constant">Kernel</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">klass</span>, <span class="ruby-identifier">const_name</span><span class="ruby-operator">|</span> <span class="ruby-identifier">klass</span>.<span class="ruby-identifier">const_get</span> <span class="ruby-identifier">const_name</span> }
       <span class="ruby-identifier">klass</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Class</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">klass</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">nil</span>
@@ -245,6 +247,38 @@ found
       </div>
 
 
+      <div id="method-M000006" class="method-detail">
+        <a name="M000006"></a>
+
+        <div class="method-heading">
+
+          <a href="#M000006" class="method-signature">
+
+          <span class="method-name">ensure_auth</span><span class="method-args">(opts ={})</span>
+
+          </a>
+
+        </div>
+
+        <div class="method-description">
+
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000006-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 18</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ensure_auth</span> <span class="ruby-identifier">opts</span> ={}
+      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">authenticated?</span>
+      <span class="ruby-ivar">@auth</span> = {<span class="ruby-value str">'login'</span>=<span class="ruby-operator">&gt;</span><span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:login</span>], <span class="ruby-value str">'token'</span>=<span class="ruby-operator">&gt;</span><span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:token</span>]}
+      <span class="ruby-identifier">raise</span>(<span class="ruby-value str">&quot;Authentication failed&quot;</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">authenticated?</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+
+        </div>
+      </div>
+
+
       <div id="method-M000008" class="method-detail">
         <a name="M000008"></a>
 
@@ -264,7 +298,7 @@ found
             onclick="toggleCode('M000008-source');return false;">[Source]</a></p>
           <div class="method-source-code" id="M000008-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 26</span>
+<span class="ruby-comment cmt"># File lib/git_hub/api.rb, line 32</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">request</span> <span class="ruby-identifier">verb</span>, <span class="ruby-identifier">url</span>, <span class="ruby-identifier">params</span> = {}
       <span class="ruby-identifier">method</span> = <span class="ruby-identifier">classify</span>(<span class="ruby-value str">'Net::HTTP::'</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">verb</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">capitalize</span>)
       <span class="ruby-identifier">uri</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span> <span class="ruby-identifier">url</span>