git_hub 0.0.1

data/History.txt

@@ -0,0 +1,4 @@
+== git_hub 0.0.1 / 2010-01-05
+
+* 1 major enhancement
+  * Birthday!

data/README.txt

@@ -0,0 +1,61 @@
+= 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.
+
+== FEATURES/PROBLEMS:
+
+* FIXME (list of features or problems)
+This project is quite new, so it's probably not ready for prime time just yet...
+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'])
+
+# Create new 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)
+
+== REQUIREMENTS:
+
+* FIXME (list of requirements)
+
+== INSTALL:
+
+$ sudo gem install git_hub
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Arvicco
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,20 @@
+
+require 'bones' rescue abort '### Please install the "bones" gem ###'
+
+ensure_in_path 'lib'
+require 'git_hub'
+
+task :default => 'test:run'
+task 'gem:release' => 'test:run'
+
+Bones {
+  ignore_file '.gitignore'	
+  name  'git_hub'
+  authors  'Arvicco'
+  email  'arvitallian@gmail.com'
+  url  'http://github.com/arvicco/git_hub'
+  version  GitHub::VERSION
+  ignore_file  '.gitignore'
+}
+
+# EOF

data/bin/git_hub

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib git_hub]))
+
+# Put your code here
+

data/lib/git_hub/api.rb

@@ -0,0 +1,39 @@
+require 'net/https'
+require 'singleton'
+
+module GitHub
+  class Api
+    include Singleton
+
+    attr_writer :auth
+
+    def auth
+      @auth || {}
+    end
+
+    def authenticated?
+      auth != {}
+    end
+
+    # Turns string into appropriate class constant, returns nil if class not found
+    def classify name
+      klass = name.split("::").inject(Kernel) {|klass, const_name| klass.const_get const_name }
+      klass.is_a?(Class) ? klass : nil
+    rescue NameError
+      nil
+    end
+
+    def request verb, url, params = {}
+      method = classify('Net::HTTP::' + verb.to_s.capitalize)
+      uri = URI.parse url
+      server = Net::HTTP.new(uri.host, uri.port)
+      server.use_ssl = (uri.scheme == 'https')
+      server.verify_mode = OpenSSL::SSL::VERIFY_NONE if server.use_ssl?
+      server.start do |http|
+        req = method.new(uri.path)
+        req.form_data = params.merge(auth)
+        http.request(req)
+      end
+    end
+  end
+end

data/lib/git_hub/base.rb

@@ -0,0 +1,50 @@
+require 'yaml'
+
+module GitHub
+  class Base
+    @base_uri = ''
+
+    def initialize(attributes={})
+      attributes.each do |key, value|
+        raise "No attr_accessor for #{key} on #{self.class}" unless respond_to?("#{key}=")
+        self.send("#{key}=", value)
+      end
+    end
+
+    def self.base_uri uri
+      @base_uri = uri
+    end
+
+    class << self
+      def request verb, uri, params = {}
+        res = api.request verb, @base_uri+uri, params
+        YAML::load(res.body) if res.respond_to?(:body) # res.kind_of?(Net::HTTPSuccess)
+        #p "in show: #{res}: #{res.code}: #{res.http_version}: #{res.message}", res.body
+      end
+
+      def get uri, params ={}
+        request :get, uri, params
+      end
+
+      def post uri, params = {}
+        request :post, uri, params
+      end
+
+      def api
+        @@api ||= GitHub::Api.instance
+      end
+    end
+
+    def get uri, params ={}
+      self.class.get uri, params
+    end
+
+    def post uri, params ={}
+      self.class.post uri, params
+    end
+
+    def api
+      self.class.api
+    end
+  end
+end

data/lib/git_hub/repo.rb

@@ -0,0 +1,155 @@
+module GitHub
+  class Repo < Base
+    GITHUB_SERVICES = {
+#[github]
+#	user = user
+#	token = token
+#	:donate => {:path => '/edit/donate',  :inputs => ['paypal']}
+#	homepage = homepage_url
+#	webhooks => {:path => '/edit/postreceive_urls', :fields => []
+#http://rdoc.info/projects/update, http://runcoderun.com/github, http://api.devver.net/github
+#	basecamp = url, username, password, project, category
+#	cia = true
+#	campfire = subdomain, username, password, room, ssl, play_sound
+#	email = arvitallian@gmail.com
+#	fogbugz = cvssubmit_url, fb_version, fb_repoid
+#	friendfeed = nickname, remotekey
+#	irc = server, port, room, password, nick, ssl
+#	jabber = user
+#	lighthouse = subdomain, project_id, token, private
+#	presently = subdomain, group_name, username, password
+#	rubyforge = username, password, grupid
+#	runcoderun = true
+#	trac = url, token
+#	twitter = username, password, digest
+    }
+
+    base_uri 'http://github.com/api/v2/yaml/repos'
+
+    attr_accessor :name, :owner, :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 @name
+      @url ||= "http://github.com/#{@owner}/#{@name}"
+      @type ||= "repo"
+    end
+
+    alias followers= watchers=
+    alias followers watchers
+    alias username= owner=
+    alias username owner
+
+    def fork?;
+      !!self.fork
+    end
+
+    def private?;
+      !!self.private
+    end
+
+    def clone_url
+      url = private? || api.auth['login'] == self.owner ? "git@github.com:" : "git://github.com/"
+      url += "#{self.owner}/#{self.name}.git"
+    end
+
+    class << self # Repo class methods
+      # Find repo(s) of a (valid) github user
+      # Accepts either options Hash (:owner/:user/:username and :repo/:repository/:project/:name)
+      # or several search terms as strings or symbols 
+      def find(*params)
+        if params.size == 1 && params.first.is_a?(Hash) # this is /show request
+          opts = params.first
+          owner = opts[:owner] || opts[:user] || opts[:username] || opts[:login] || api.auth['login'] || ''
+          repo = opts[:repo] || opts[:repository] || opts[:name] || opts[:project]
+          path = repo ? "/show/#{owner}/#{repo}" : "/show/#{owner}"
+        else # this is /search request, params are search terms
+          query = params.map(&:to_s).join('+')
+          path = "/search/#{query}"
+        end
+        result = get(path)
+        if result['repository']
+          new result['repository']
+        elsif result['repositories']
+          result['repositories'].map {|r| new r}
+        else
+          result
+        end
+      end
+
+      alias show find
+      alias search find
+
+      # Create new github repo, accepts Hash with :repo, :description, :homepage, :public/:private
+      # or repo name as a single parameter
+      def create(*params)
+        if params.size == 1 && params.first.is_a?(Hash)
+          opts = params.first
+          repo = opts[:repo] || opts[:repository] || opts[:name] || opts[:project]
+          description = opts[:description] || opts[:descr] || opts[:desc]
+          homepage = opts[:homepage]
+          public = opts[:public] || !opts[:private]  # default to true
+        else # repo name as a single parameter
+          repo = params.first.to_s
+          description = nil
+          homepage = nil
+          public = false
+        end
+        raise("Unable to create #{self.class} without authorization") unless api.authenticated?
+        result = post("/create", 'name' => repo, 'description' => description,
+                 'homepage' => homepage, 'public' => (public ? 1 : 0))
+        if result['repository']
+          new result['repository']
+        else
+          result
+        end
+      end
+    end
+
+    # Delete github repo
+    def delete
+      result = post("/delete/#{@name}")
+      if result['delete_token']
+        post("/delete/#{@name}", 'delete_token' => result['delete_token'])
+      else
+        result
+      end  
+    end
+
+    def add_service
+    end
+
+    def remove_service
+    end
+
+    def add_collaborator
+    end
+
+    def remove_collaborator
+    end
+
+    # repos/show/:user/:repo/tags
+    # repos/show/:user/:repo/branches
+    # repos/show/:user/:repo/languages
+    # repos/show/:user/:repo/network
+    #
+    # repos/show/:user/:repo/collaborators
+    # POST repos/collaborators/:repo/add/:user
+    # POST repos/collaborators/:repo/remove/:user
+    #
+    # repos/keys/:repo
+    # POST repos/key/:repo/remove
+    # POST repos/key/:repo/add {title => title of the key, key => public key data}
+
+    # POST repos/set/public/:repo
+    # POST repos/set/private/:repo
+
+    # ? repos/fork/:user/:repo
+    # repos/unwatch/:user/:repo
+    # repos/watch/:user/:repo
+    # repos/show/:user/:repo ? new?
+
+  end
+end

data/lib/git_hub.rb

@@ -0,0 +1,48 @@
+
+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>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the path for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility method used to require all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  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'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+end  # module GitHub
+
+GitHub.require_all_libs_relative_to(__FILE__)
+

data/spec/git_hub/api_spec.rb

@@ -0,0 +1,99 @@
+require File.expand_path(
+        File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+module GitHubTest
+  describe GitHub::Api do
+    after(:each) do
+      GitHub::Api.instance.auth.clear
+    end
+
+    context 'authentication' do
+      it 'starts out unauthenticated' do
+        api = described_class.instance
+        api.should_not be_authenticated
+        api.auth.should == {}
+      end
+
+      it 'authenticates with login and token' do
+        api = described_class.instance
+        api.auth = joe_auth
+        api.should be_authenticated
+        api.auth.should == joe_auth
+        api.auth.clear
+        api.should_not be_authenticated
+        api.auth.should == {}
+      end
+    end
+
+    context 'requests' do
+      before :each do
+        @api= described_class.instance
+        @api.auth = joe_auth
+        @hash = {'name' => 'name', 'description' => 'descr'}
+        @hash_with_auth = @hash.merge joe_auth
+      end
+
+      context 'post' do
+        it 'connects via http, submits post request' do
+          server, post = stub_server_and_req()
+          Net::HTTP::Post.should_receive(:new).with('/api/v2/yaml/repos/create').and_return(post)
+          Net::HTTP.should_receive(:new).with('github.com', 80).and_return(server)
+          server.should_receive(:request).with(post)
+
+          @api.request(:post, "#{github_yaml}/repos/create", @hash)
+        end
+
+        it 'connects to github via https, submits post request' do
+          server, post = stub_server_and_req( :port => 443)
+          Net::HTTP::Post.should_receive(:new).with('/api/v2/yaml/repos/create').and_return(post)
+          Net::HTTP.should_receive(:new).with('github.com', 443).and_return(server)
+          server.should_receive(:request).with(post)
+
+          @api.request(:post, 'https://github.com/api/v2/yaml/repos/create', @hash)
+        end
+
+        it 'sends form params urlencoded  with added authentication' do
+          server = stub_server
+          server.should_receive(:request) do |req|
+            req.content_type.should == 'application/x-www-form-urlencoded'
+            req.body.should == 'name=name&description=descr&login=joe007&token=b937c8e7ea5a5b47f94eafa39b1e0462'
+          end
+
+          @api.request(:post, "#{github_yaml}/repos/create", @hash)
+        end
+      end
+
+      context 'get' do
+        it 'connects to github via http, submits get request' do
+          server, req = stub_server_and_req(:get => true)
+          Net::HTTP::Get.should_receive(:new).with('/api/v2/yaml/repos/create').and_return(req)
+          Net::HTTP.should_receive(:new).with('github.com', 80).and_return(server)
+          server.should_receive(:request).with(req)
+
+          @api.request(:get, "#{github_yaml}/repos/create")
+        end
+
+        it 'connects to github via https, submits get request' do
+          server, req = stub_server_and_req(:get => true, :port => 443)
+          Net::HTTP::Get.should_receive(:new).with('/api/v2/yaml/repos/create').and_return(req)
+          Net::HTTP.should_receive(:new).with('github.com', 443).and_return(server)
+          server.should_receive(:request).with(req)
+
+          @api.request(:get, "https://github.com/api/v2/yaml/repos/create")
+        end
+
+        it 'sends get request with added authentication' do
+          server = stub_server(:get => true)
+          server.should_receive(:request) do |req|
+            req.content_type.should == 'application/x-www-form-urlencoded'
+            req.body.should == 'login=joe007&token=b937c8e7ea5a5b47f94eafa39b1e0462'
+          end
+
+          @api.request(:get, "#{github_yaml}/repos/create")
+        end
+      end # requests
+    end
+  end
+end # module GitHubTest
+
+# EOF

data/spec/git_hub/base_spec.rb

@@ -0,0 +1,47 @@
+require File.expand_path(
+        File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+module GitHubTest
+  describe GitHub::Base do
+    after(:each) do
+      api.auth.clear
+    end
+
+    context 'general' do
+      it 'has instance and class method api pointing to the same Api instance' do
+        api1 = described_class.api
+        api2 = described_class.new.api
+        api1.should be_a GitHub::Api
+        api1.should be_equal api2
+        api1.should be_equal api
+      end
+    end
+
+    context 'requests' do
+      it 'submits appropriate requests to api as get/post methods (both class and instance)' do
+        base = described_class.new
+        api.should_receive(:request).with(:get, '/blah', anything()).twice
+        base.get ('/blah')
+        described_class.get ('/blah')
+
+        api.should_receive(:request).with(:post, '/blah', anything()).twice
+        base.post ('/blah')
+        described_class.post ('/blah')
+      end
+
+      it 'prepends get/post calls to api by string set by base_uri class macro' do
+        base = described_class.new
+        described_class.class_eval { base_uri 'http://base1.com' }
+        api.should_receive(:request).with(:get, 'http://base1.com/blah', anything()).twice
+        base.get ('/blah')
+        described_class.get ('/blah')
+
+        api.should_receive(:request).with(:post, 'http://base1.com/blah', anything()).twice
+        base.post ('/blah')
+        described_class.post ('/blah')
+      end
+    end                                                
+  end
+end # module GitHubTest
+
+# EOF

data/spec/git_hub/repo_spec.rb

@@ -0,0 +1,247 @@
+require File.expand_path(
+        File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+module GitHubTest
+  describe GitHub::Repo do
+    after(:each) do
+      api.auth.clear
+    end
+
+    context '::find as /show/:user)' do
+      it 'returns an array of repos for a valid github user' do
+        expect(:get, "#{github_yaml}/repos/show/joe007") do
+          repos = described_class.find(:user=>'joe007')
+          repos.should_not be_empty
+          repos.should be_an Array
+          repos.should have(3).repos
+          repos.each {|repo| repo.should be_a described_class}
+        end
+      end
+
+      it 'returns repos with "show" attributes set' do
+        expect(:get, "#{github_yaml}/repos/show/joe007") do
+          repo = described_class.find(:user=>'joe007').first
+          repo.name.should == 'fine_repo'
+          repo.url.should == 'http://github.com/joe007/fine_repo'
+          repo.clone_url.should == 'git://github.com/joe007/fine_repo.git'
+          repo.description.should == 'Fine repo by joe'
+          repo.homepage.should == ''
+          repo.watchers.should == 3
+          repo.followers.should == 3
+          repo.open_issues.should == 0
+          repo.forks.should == 0
+          repo.should_not be_fork
+          repo.should_not be_private
+          repo.owner.should == 'joe007'
+          repo.username.should == 'joe007'
+        end
+      end
+
+      it 'returns repos with "search" attributes unset' do
+        expect(:get, "#{github_yaml}/repos/show/joe007") do
+          repo = described_class.find(:user=>'joe007').first
+          repo.id.should == nil
+          repo.language.should == nil
+          repo.size.should == nil
+          repo.created.should == nil
+          repo.pushed.should == nil
+          repo.score.should == nil
+          repo.type.should == 'repo'  
+        end
+      end
+    end
+
+    context '::find as /search' do
+      it 'searches github repos with specific search terms' do
+        expect(:get, "#{github_yaml}/repos/search/joe+repo") do
+          repos = described_class.find('joe', 'repo')
+          repos.should_not be_empty
+          repos.should be_an Array
+          repos.should have(3).repos
+          repos.each {|repo| repo.should be_a described_class}
+        end
+      end
+
+      it 'returns repos with "search" attributes set' do
+        expect(:get, "#{github_yaml}/repos/search/joe+repo") do
+          repo = described_class.find('joe', 'repo').first
+          repo.name.should == 'fine_repo'
+          repo.description.should == 'Fine repo by joe'
+          repo.watchers.should == 3
+          repo.followers.should == 3
+          repo.forks.should == 0
+          repo.should_not be_fork
+          repo.owner.should == 'joe007'
+          repo.username.should == 'joe007'
+          repo.id.should == 'repo-270000'
+          repo.language.should == ''
+          repo.size.should == 1228
+          repo.created.should == '2009-08-06T00:20:39Z'
+          repo.pushed.should == '2009-11-11T22:58:52Z'
+          repo.score.should == 4.918499
+          repo.type.should == 'repo'
+          repo.clone_url.should == 'git://github.com/joe007/fine_repo.git'
+        end
+      end
+
+      it 'returns repos with "show" attributes unset' do
+        expect(:get, "#{github_yaml}/repos/search/joe+repo") do
+          repo = described_class.find('joe', 'repo').first
+          repo.url.should == 'http://github.com/joe007/fine_repo'
+          repo.homepage.should == nil
+          repo.open_issues.should == nil
+          repo.should_not be_private
+        end
+      end
+    end
+
+    context '::find as /show/user/repo' do
+      it 'finds repo of a (valid) github user' do
+        expect(:get, "#{github_yaml}/repos/show/joe007/fine_repo") do
+          repo = described_class.find(:user=>'joe007', :repo=>'fine_repo')
+          repo.should be_a described_class
+          repo.name.should == 'fine_repo'
+          repo.url.should == 'http://github.com/joe007/fine_repo'
+          repo.clone_url.should == 'git://github.com/joe007/fine_repo.git'
+          repo.description.should == 'Fine repo by joe'
+          repo.homepage.should == ''
+          repo.watchers.should == 1
+          repo.followers.should == 1
+          repo.open_issues.should == 0
+          repo.forks.should == 0
+          repo.should_not be_fork
+          repo.should_not be_private
+          repo.owner.should == 'joe007'
+          repo.username.should == 'joe007'
+        end
+      end
+
+      it 'returns error object instead of non-existing repo' do
+        expect(:get, "#{github_yaml}/repos/show/joe007/err_repo") do
+          res = described_class.find(:user=>'joe007', :repo=>'err_repo')
+          res.should have_key 'error'  # res = {"error"=>[{"error"=>"repository not found"}]}
+          res['error'].should be_kind_of Array
+          res['error'].first.should have_key 'error'
+        end
+      end
+    end
+
+    context '::create' do
+      it 'creates new repo for authenticated github user' do
+        api.auth = joe_auth
+        keys = {:name => 'new_repo', :description => 'New repo',
+                :homepage => 'http://joe.org/new_repo', :public => 1}.merge joe_auth
+        expects(:post, "#{github_yaml}/repos/create", :expected_keys=>keys, :body=>body_from_file('/repos/create'))
+        repo = described_class.create(:name=>'new_repo', :description => 'New repo',
+                                      :homepage => 'http://joe.org/new_repo', :private => false)
+        repo.should be_a described_class
+        repo.name.should == 'new_repo'
+        repo.url.should == 'http://github.com/joe007/new_repo'
+        repo.clone_url.should == 'git@github.com:joe007/new_repo.git'
+        repo.description.should == 'New repo'
+        repo.homepage.should == 'http://joe.org/new_repo'
+        repo.watchers.should == 1
+        repo.followers.should == 1
+        repo.open_issues.should == 0
+        repo.forks.should == 0
+        repo.should_not be_fork
+        repo.should_not be_private
+        repo.owner.should == 'joe007'
+        repo.username.should == 'joe007'
+      end
+    end
+
+    context '#delete' do
+      it 'deletes new repo for authenticated github user' do
+        api.auth = joe_auth
+        expect(:get, "#{github_yaml}/repos/show/joe007/new_repo")
+        repo = described_class.find(:repo=>'new_repo')
+        post1 = { :expected_keys => joe_auth,
+                  :body => body_from_file('/repos/delete/new_repo.1') }
+        post2 = { :expected_keys => {:delete_token => :any}.merge(joe_auth),
+                  :body => body_from_file('/repos/delete/new_repo.2') }
+        expects(:post, "#{github_yaml}/repos/delete/new_repo", [post1, post2])
+        res = repo.delete
+        res['status'].should == 'deleted'
+      end
+    end
+
+    it 'tests' do
+      pending
+      api.auth = joe_auth
+      expect(:get, "#{github_yaml}/repos/showp/joe007/new_repo")
+      repos = described_class.show('arvicco')
+      p repos
+      p repos.map(&:url)
+      repos.should be_an Array
+      repos.should_not be_empty
+      if repos.last.name == 'new_repo'
+        repos.last.delete
+      end
+      true.should == false
+    end
+
+#  context 'manipulating repos' do
+#    before (:each) do
+#      @gh = described_class.new('joerepo')
+#      @name = "test#{Time.now.to_i}"
+#    end
+#    after (:each) do
+#      @gh.delete_repo @name
+#    end
+#
+#    it 'creates new repo of a valid github user' do
+#      @gh.create_repo @name
+#      repos = @gh.repos
+#      repos.should_not be_empty
+#      repos.last[:name].should == @name
+#    end
+#
+#    it 'creates SINGLE new repo' do
+#      # Problem: sticky cache
+#      r = @gh.repos
+#      p r
+#      n = r.size
+#
+#      @gh.create_repo @name
+#      sleep 2
+#      rr = @gh.repos
+#      p rr
+#      rr.size.should == n+1
+#    end
+#
+#    it 'creates and deletes repo of a valid github user' do
+#      #creating
+#      @gh.create_repo @name
+#      repos = @gh.repos
+#      repos.should_not be_empty
+#      repos.last[:name].should == @name
+#
+#      #deleting
+#      @gh.delete_repo @name
+#      sleep 2
+#      repos = @gh.repos
+#      repos.last[:name].should_not == @name
+#      repos.find {|r|r[:name] == @name}.should == nil
+#      #false.should be_true
+#    end
+#
+#    it 'returns nil if deleting non-existing repo' do
+#      result = @gh.delete_repo @name
+#      result.should == nil
+#    end
+#
+#    it 'does not change repos size if deleting non-existing repo' do
+#      n = @gh.repos.size
+#
+#      @gh.delete_repo @name
+#      sleep 1.5
+#      @gh.repos.should have(n).repos
+#    end
+#  end
+#
+  end # describe GitHub::Repo
+
+end # module GithubTest
+
+# EOF

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--color
+--format nested

data/spec/spec_helper.rb

@@ -0,0 +1,190 @@
+require 'spec'
+require 'cgi'
+require 'fakeweb'
+require 'fakeweb_matcher'
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib git_hub]))
+
+# Module that extends RSpec with my own extensions/macros
+module SpecMacros
+
+  # Wrapper for *it* method that extracts description from example source code, such as:
+  # spec{ use{  result =  function(arg1 = 4, arg2 = 'string')  }}
+  def spec &block
+    it description_from(*block.source_location), &block
+  end
+
+  # reads description line from source file and drops external brackets (like *spec*{}, *use*{})
+  def description_from(file, line)
+    File.open(file) do |f|
+      f.lines.to_a[line-1].gsub( Regexp.new('(spec.*?{)|(use.*?{)|}'), '' ).lstrip.rstrip
+    end
+  end
+end
+
+Spec::Runner.configure do |config|
+  # Add my macros
+  config.extend(SpecMacros)
+end
+
+module GitHubTest
+
+  # Test related Constants:
+  TEST_PROJECT = 'GitHub'
+  TEST_STRING = 'This is test string'
+
+  # Checks that given block does not raise any errors
+  def use
+    lambda {yield}.should_not raise_error
+  end
+
+  # Returns empty block (for use in spec descriptions)
+  def any_block
+    lambda {|*args| args}
+  end
+
+  # Extract response from file
+  def response_from_file(path)
+    filename = File.join(File.dirname(__FILE__), 'stubs', path + '.res')
+    unless File.exists?(filename) && !File.directory?(filename)
+      raise "No stub file #{filename}. To obtain it use:\n#{curl_string(path, filename)}"
+    end
+    filename
+  end
+
+  # Extract response body from file
+  def body_from_file(path)
+    File.read(response_from_file(path)).gsub(/.*\n\n/m, '')
+  end
+
+  def curl_string(path, filename)
+    auth_string = api.authenticated? ? "?login=#{api.auth['login']}&token=#{api.auth['token']}" : ""
+    "curl -i #{github_yaml}#{path}#{auth_string} > #{filename}"
+  end
+
+  # Stubs github server, with options:
+  # :host:: Host name - default 'github.com'
+  # :port:: Port - default 80
+  def stub_server(options={})
+    server = Net::HTTP.new(options[:host] ||'github.com', options[:port] || 80)
+    Net::HTTP.stub!(:new).and_return(server)
+    server
+  end
+
+  # Stubs http request, with options:
+  # :path:: Request path - default '/api/v2/yaml/repos/create'
+  # :get:: Indicates that request is get, otherwise post
+  def stub_req(options={})
+    path = options[:path] || '/api/v2/yaml/repos/create'
+    options[:get] ? Net::HTTP::Get.new(path) : Net::HTTP::Post.new(path)
+  end
+
+  def stub_server_and_req(options = {})
+    [stub_server(options), stub_req(options)]
+  end
+
+  # Turns string into appropriate class constant, returns nil if class not found
+  def classify name
+    klass = name.split("::").inject(Kernel) {|klass, const_name| klass.const_get const_name }
+    klass.is_a?(Class) ? klass : nil
+  rescue NameError
+    nil
+  end
+
+  # Builds fake HTTP response from a given options Hash. Accepts options:
+  # :klass:: Response class, default - Net::HTTPOK
+  # :http_version:: HTTP version - default 1.1
+  # :code:: Response return code - default 200
+  # :message:: Response message - default 'OK'
+  # :status:: [code, message] pair as one option
+  # :body:: Response body - default ''
+  # TODO: make it more lifelike using StringIO, instead of just stubbing :body
+  def build_response(options={})
+    code = options[:status] ? options[:status].first : options[:code] || 200
+    message = options[:status] ? options[:status].last : options[:message] || 'OK'
+    version = options[:http_version] || 1.1
+    resp = (options[:klass] || Net::HTTPOK).new(code, version, message)
+    resp.stub!(:body).and_return(options[:body] || '')
+    resp
+  end
+
+  # Expects request of certain method(:get, :post, ... :any) to specific uri (given as a String, URI or Regexp),
+  # (optionally) matches expected query keys with actuals and handles request and response according to options.
+  # In addition to build_response options (:klass, :http_version, :code, :message, :status, :body), it supports:
+  # :expected_keys:: Hash of expected query keys(if value is not important, :key => :any)
+  # :response:: Use this ready-made response object instead of building response
+  # :exception:: Raise this Exception object instead of response
+  # If you expect multiple requests to the same uri, options may also be an Array containing a list of the
+  # above-described Hashes - requests will be expected in the same order they appear in the Array
+  def expects(method, uri, options={})
+    @github ||= stub_server
+    opts = options.is_a?(Array) ? options.shift : options # may be a single options Hash or Array of Hashes
+    @github.should_receive(:request) do |req|
+      case method # match expected request method to actual
+        when :any
+          Net::HTTPRequest
+        when Class
+          method
+        when Symbol, String
+          classify('Net::HTTP::' + method.to_s.capitalize)
+      end.should === req
+      case uri # match expected uri to actual
+        when URI::HTTP, URI::HTTPS
+          uri.path
+        when String
+          URI.parse(uri).path
+        when Regexp
+          uri
+      end.should === req.path
+      if opts[:expected_keys] # match expected request query keys to actual keys
+        actuals = CGI::parse(req.body)
+        opts[:expected_keys].each do |key, val|
+          actuals.should have_key key.to_s
+          actual = actuals[key.to_s]
+          actual = actual.first if actual.size == 1 # if only one array element, extract it
+          case val # match expected key value to actual
+            when :any
+            when Class, Regexp, String
+              val.should === actual
+            else
+              val.to_s.should === actual
+          end
+        end
+      end
+      expects(method, uri, options) if options.is_a?(Array) && !options.empty? # expect next request in Array
+      raise opts[:exception] if opts[:exception] && opts[:exception].kind_of?(Exception)
+      opts[:response] || build_response(opts)
+    end
+  end
+
+  # Extends path to uri, registers it with FakeWeb with stub file at stubs/path as a response
+  # If block is given, yields to block and checks that registered uri was hit during block execution
+  def expect(method, path)
+    case path
+      when Regexp.new(github_yaml)
+        uri = path
+        file = path.sub(github_yaml, '')
+      else
+        uri = github_yaml + path
+        file = path
+    end
+    FakeWeb.register_uri(method, uri, :response=>response_from_file(file))
+    if block_given?
+      yield
+      FakeWeb.should have_requested(method, uri)
+    end
+  end
+
+  # Auth for joe
+  def joe_auth
+    {'login' => 'joe007', 'token' => 'b937c8e7ea5a5b47f94eafa39b1e0462'}
+  end
+
+  def github_yaml
+    'http://github.com/api/v2/yaml'
+  end
+
+  def api
+    GitHub::Api.instance
+  end
+
+end # module GithubTest

data/spec/stubs/repos/create.res

@@ -0,0 +1,24 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 14:17:37 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "3448dffce35f5b38d4e477cd57aa7249"
+X-Runtime: 76ms
+Content-Length: 235
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+repository: 
+  :url: http://github.com/joe007/new_repo
+  :description: New repo
+  :forks: 0
+  :open_issues: 0
+  :homepage: http://joe.org/new_repo
+  :fork: false
+  :private: false
+  :name: new_repo
+  :owner: joe007
+  :watchers: 1

data/spec/stubs/repos/delete/new_repo.1.res

@@ -0,0 +1,14 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 15:04:15 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "71c252d33cdcaab261e3adea39b35dcc"
+X-Runtime: 7ms
+Content-Length: 30
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+delete_token: jtytnzdcdk

data/spec/stubs/repos/delete/new_repo.2.res

@@ -0,0 +1,14 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 15:05:59 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "2805d28a06ffb58479b7a08117a67714"
+X-Runtime: 23ms
+Content-Length: 21
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+status: deleted

data/spec/stubs/repos/search/joe+repo.res

@@ -0,0 +1,54 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 10:59:42 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "173a8304817dc5a17d79f49e4b7af5b4"
+X-Runtime: 48ms
+Content-Length: 8727
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+repositories: 
+- name: fine_repo
+  size: 1228
+  followers: 3
+  username: joe007
+  language: ""
+  fork: false
+  id: repo-270000
+  type: repo
+  pushed: "2009-11-11T22:58:52Z"
+  forks: 0
+  description: Fine repo by joe
+  score: 4.918499
+  created: "2009-08-06T00:20:39Z"
+- name: another_repo
+  size: 224
+  followers: 1
+  username: joe007
+  language: ""
+  fork: false
+  id: repo-270001
+  type: repo
+  pushed: "2009-09-15T22:27:51Z"
+  forks: 1
+  description: Another fine repo by joe
+  score: 0.66973364
+  created: "2009-05-27T03:18:32Z"
+- name: private_repo
+  size: 656
+  followers: 1
+  username: joe007
+  language: ""
+  fork: false
+  id: repo-26145
+  type: repo
+  pushed: "2009-11-22T18:09:13Z"
+  forks: 0
+  description: Private repo by joe
+  score: 1.9410602
+  created: "2008-06-17T19:51:25Z"
+  

data/spec/stubs/repos/show/joe007/err_repo.res

@@ -0,0 +1,14 @@
+HTTP/1.1 403 Forbidden
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 13:12:41 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 403 Forbidden
+X-Runtime: 8ms
+Content-Length: 43
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: no-cache
+
+--- 
+error: 
+- error: repository not found

data/spec/stubs/repos/show/joe007/fine_repo.res

@@ -0,0 +1,24 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 13:21:54 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "7d6e90fc96569a71927a11994c8125ad"
+X-Runtime: 14ms
+Content-Length: 224
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+repository: 
+  :url: http://github.com/joe007/fine_repo
+  :description: Fine repo by joe
+  :open_issues: 0
+  :homepage: ""
+  :forks: 0
+  :fork: false
+  :private: false
+  :name: fine_repo
+  :owner: joe007
+  :watchers: 1

data/spec/stubs/repos/show/joe007/new_repo.res

@@ -0,0 +1,24 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Wed, 30 Dec 2009 14:34:15 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "62c142268ede730d1035636172c65318"
+X-Runtime: 8ms
+Content-Length: 235
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+repository: 
+  :url: http://github.com/joe007/new_repo
+  :description: New repo
+  :open_issues: 0
+  :homepage: http://joe.org/new_repo
+  :fork: false
+  :private: false
+  :name: new_repo
+  :owner: joe007
+  :watchers: 1
+  :forks: 0

data/spec/stubs/repos/show/joe007.res

@@ -0,0 +1,44 @@
+HTTP/1.1 200 OK
+Server: nginx/0.7.61
+Date: Tue, 29 Dec 2009 15:54:21 GMT
+Content-Type: application/x-yaml; charset=utf-8
+Connection: keep-alive
+Status: 200 OK
+ETag: "67456d99562ca82c4e70efcc72b9f5ef"
+X-Runtime: 13ms
+Content-Length: 661
+Set-Cookie: _github_ses=BAh7BiIKZmxhc2hJQzonQWN0aW9uQ29udHJvbGxlcjo6Rmxhc2g6OkZsYXNoSGFzaHsABjoKQHVzZWR7AA%3D%3D--884981fc5aa85daf318eeff084d98e2cff92578f; path=/; expires=Wed, 01 Jan 2020 08:00:00 GMT; HttpOnly
+Cache-Control: private, max-age=0, must-revalidate
+
+--- 
+repositories: 
+- :url: http://github.com/joe007/fine_repo
+  :description: Fine repo by joe
+  :forks: 0
+  :open_issues: 0
+  :homepage: ""
+  :fork: false
+  :private: false
+  :name: fine_repo
+  :owner: joe007
+  :watchers: 3
+- :url: http://github.com/joe007/another_repo
+  :description: Another fine repo by joe
+  :forks: 0
+  :open_issues: 0
+  :homepage: ""
+  :fork: false
+  :private: false
+  :name: another_repo
+  :owner: joe007
+  :watchers: 1
+- :url: http://github.com/joe007/private_repo
+  :description: Private repo by joe
+  :forks: 0
+  :open_issues: 0
+  :homepage: ""
+  :fork: false
+  :private: false
+  :name: private_repo
+  :owner: joe007
+  :watchers: 1

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: git_hub
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Arvicco
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-05 00:00:00 +03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bones
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 3.2.0
+    version: 
+description: |-
+  git_hub is a library that wraps github API and exposes simple interface for
+  finding, creating and managing github repositories and other resources.
+email: arvitallian@gmail.com
+executables: 
+- git_hub
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- README.txt
+- bin/git_hub
+files: 
+- History.txt
+- README.txt
+- Rakefile
+- bin/git_hub
+- lib/git_hub.rb
+- lib/git_hub/api.rb
+- lib/git_hub/base.rb
+- lib/git_hub/repo.rb
+- spec/git_hub/api_spec.rb
+- spec/git_hub/base_spec.rb
+- spec/git_hub/repo_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/stubs/repos/create.res
+- spec/stubs/repos/delete/new_repo.1.res
+- spec/stubs/repos/delete/new_repo.2.res
+- spec/stubs/repos/search/joe+repo.res
+- spec/stubs/repos/show/joe007.res
+- spec/stubs/repos/show/joe007/err_repo.res
+- spec/stubs/repos/show/joe007/fine_repo.res
+- spec/stubs/repos/show/joe007/new_repo.res
+has_rdoc: true
+homepage: http://github.com/arvicco/git_hub
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: git_hub
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: git_hub is a library that wraps github API and exposes simple interface for finding, creating and managing github repositories and other resources
+test_files: []
+