github_repo 0.1.0

data/.document

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

data/.gitignore

@@ -0,0 +1,39 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+#
+# For TextMate
+#*.tmproj
+#tmtags
+#
+# For emacs:
+#*~
+#\#*
+#.\#*
+#
+# For vim:
+#*.swp

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Kristian Mandrup
+
+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/README.markdown

@@ -0,0 +1,53 @@
+# github_repo ##
+
+Library to enable automation of common github repository tasks. 
+This library is a response to some problems I had getting Octopi to work correctly for repository tasks. 
+I use the Octopi API in some cases, but implement my own Http post calls in most cases.   
+
+## Rename ##
+
+Renames a github repo
+
+Rename [old-name] [new-name]
+
+1. Deletes any existing github repository [new-name] (if overwrite option)
+2. Creates a new repository called [new-name]
+3. Clones the github repository [old-name] locally
+4. Deletes the github repository [old-name]
+5. Changes origin of the local [old-name] repository to point to the github repository [new-name]
+6. Push the local repository to the github repository [new-name] 
+7. Makes sure the github repository [old-name] was deleted!      
+8. If the repository [new-name] exists, delete the local repo (only if option set to do so!) 
+
+Note: Currently this task contains a lot of code to retry when things go wrong some some reason. 
+The github API is still pretty unstable! And suffers from some timeout and caching issues, which requires a lot of care and exception handling!
+Feel free to improve it! 
+
+## Other Github tasks ##
+
+* Delete 
+* Create
+* Get clone url
+* Clone
+* Fork
+* Collaborators
+* Languages
+* Tags
+* Branches
+* First commit
+* First origin push
+* Init repository
+
+## Note on Patches/Pull Requests ##
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright ##
+
+Copyright (c) 2010 Kristian Mandrup. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,18 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "github_repo"
+    gem.summary = %Q{Github API v2 wrapper for common github tasks}
+    gem.description = %Q{Github API v2 wrapper for common github tasks. Builds on Octopi gem where possible but works at a higher level.}
+    gem.email = "kmandrup@gmail.com"
+    gem.homepage = "http://github.com/kristianmandrup/github_repo"
+    gem.authors = ["Kristian Mandrup"]
+    gem.add_development_dependency "rspec", ">= 2.0.0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    
+    # add more gem options here    
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/github_repo.rb

@@ -0,0 +1,303 @@
+require 'octopi'
+require 'git'
+require 'yaml'
+require 'github_util'
+
+module GithubParser
+  def parse_single_result(key)
+    self.body[/#{Regexp.escape(key)}:\s(.*)/, 1]
+  end
+
+  def parse_result(key)
+    result = self.body.gsub("\n", '')         
+    token = result[/#{Regexp.escape(key)}:(.*)/, 1]
+    token.split("- ").reject{|e| e == ' ' || e.match('{}') }.collect{|e| e.strip}
+  end
+end  
+
+class GithubApi
+  include Octopi 
+  include GithubUtil
+
+  class DeleteError < StandardError 
+  end
+  class CreateError < StandardError 
+  end
+  class RenameError < StandardError 
+  end
+  class CloneError < StandardError 
+  end
+  class FirstCommitError < StandardError 
+  end
+  class FirstPushOriginError < StandardError 
+  end         
+  class InitRepoError < StandardError 
+  end
+  class FindError < StandardError 
+  end
+
+
+  attr_accessor :config, :log_level
+
+  def initialize(options = {})
+    @config = configure
+    @log_level = options[:log_level] || 0
+  end
+
+  def log_on   
+    self.log_level = 1
+  end    
+
+  def verbose_log_on
+    self.log_level = 2
+  end    
+
+
+  def log_off
+    self.log_level = 0
+  end    
+
+  def delete!(name)                  
+    begin             
+      if !user.repositories.find(name)
+        info "repo #{name} not found"
+        return nil 
+      end     
+      delete_it!(name) 
+    rescue Octopi::APIError 
+      return nil
+    end
+  end
+
+  def delete_it!(name) 
+    begin
+      info "deleting repo: #{name}"
+      result = post "http://github.com/api/v2/yaml/repos/delete/#{name}"
+      token = result.parse_single_result('delete_token')                               
+      return true if token && token.length > 20
+      raise DeleteError, "delete error" if !token
+      status = post "http://github.com/api/v2/yaml/repos/delete/#{name}", 'delete_token' => token 
+      return true if status.to_s.length > 100
+      log "repo #{name} deleted ok"
+      status
+    rescue Octopi::APIError 
+      log "delete error!"
+      raise DeleteError, "delete error"
+    end
+  end
+
+  def user(user_name = nil)
+    if user_name 
+      User.find(user_name) 
+    else      
+      authenticated do
+        Api.api.user
+      end
+    end
+  end
+  
+  def clone(repo_name, user_name = nil, clone_name = nil)
+    begin
+      info "cloning: #{repo_name}"
+      clone_user = user(user_name)
+      repo = clone_user.repositories.find(repo_name)    
+      url = get_clone_url(repo, clone_user)
+      name = clone_name ? clone_name : repo_name 
+      `git clone #{url} #{name}`  
+      log "cloned #{repo_name} ok"
+      return url
+    rescue Octopi::APIError
+      raise CloneError
+    end
+  end    
+
+  def get_clone_url(repo, user)   
+    # log "user: '#{user}' == repo_user: '#{repo.owner.login}', #{user.to_s == repo.owner.login.to_s}"
+    url = user.to_s == repo.owner.login.to_s ? "git@github.com:" : "git://github.com/"
+    url += "#{repo.owner}/#{repo.name}.git"
+  end
+  
+  def clone_url(repo_name, user_name = nil, options = {:retries => 3} )
+    begin   
+      authenticated do
+        clone_user = user(user_name)
+        repo = clone_user.repositories.find(repo_name)    
+        get_clone_url(repo, clone_user)
+      end
+    rescue Octopi::APIError 
+      return "git://github.com/#{repo.owner}/#{repo.name}.git" if options[:retries] == 0     
+      info "retry get clone url for #{repo_name} in 10 secs"
+      sleep 10        
+      options.merge! :retries => options[:retries] -1                           
+      clone_url(repo_name, user_name, options)
+    end
+  end
+
+  def create(name, options = {})           
+    log "creating repo: #{name}"
+    authenticated do
+      begin
+        if user.repositories.find(name) 
+          unless options[:overwrite]
+            info "repo #{name} not created since it already exists"
+            return true
+          else
+            info "repo #{name} already exists, but will be overwritten with new repo!"            
+            delete!(name, options)
+            create(name, options)
+          end
+        end
+      rescue Octopi::APIError
+        create_it(name, options)
+      end
+    end
+  end
+
+  def create_it(name, options = {:retries => 2})
+    begin  
+      status = nil
+      authenticated do 
+        repo_options = {:name => name}
+        [:description, :homepage ].each{|o| repo_options[o] = options[o] if options[o]}
+        repo_options[:public] = 0 if options[:private]                    
+        log repo_options.inspect   
+        status = Repository.create(repo_options)
+        status.to_s == name ? status : nil
+      end
+    rescue Octopi::APIError => e 
+      info "create error: #{e}"
+    ensure
+      options.merge! :retries => options[:retries] -1
+      if status.to_s == name
+        log "created repo ok"
+        return status
+      else
+        info "bad status #{status}, should be #{name} - try again!"
+        sleep 32         
+        return create_it(name, options )        
+      end   
+    end
+  end
+
+  def first_commit(msg = 'first commit')
+    begin
+      info "first commit"
+      `git init`
+      `touch README`    
+      `git add .`
+      `git commit -m '#{msg}'`            
+      log "first push commit completed ok"      
+    rescue
+      raise FirstCommitError
+    end      
+  end    
+
+  def first_push_origin(name) 
+    begin
+      info "first push origin"    
+      origin = clone_url(name) 
+      `git remote rm origin`   
+      `git remote add origin #{origin}`
+      `git push origin master`
+      log "first push origin completed ok"
+    rescue
+      raise FirstPushOriginError
+    end      
+  end    
+
+  def init_repo(name, options = {:overwrite => true})  
+    begin
+      if File.directory?(name) && options[:overwrite]
+        log "removing local repo: #{name}"
+        FileUtils.rm_rf(name) 
+      end
+      clone name
+      FileUtils.cd name do
+        first_commit
+        first_push_origin name
+      end  
+      log "init repo complete!"
+    rescue
+      raise InitRepoError
+    end
+  end
+
+
+  def rename!(repo_name, new_repo_name, user_name = nil, options = {:overwrite => true})
+    begin
+      delete!(new_repo_name) if options[:overwrite]   
+      info "waiting 20 secs for delete to take effect before creating new repo"
+      sleep 20   
+      return nil if !create(new_repo_name)   
+      log "created new repo: #{new_repo_name}"
+      
+      # clone old repo
+      info "current dir: #{Dir.pwd}"
+      if File.directory?(repo_name) 
+        if overwrite
+          info "removing local repo: #{repo_name}"
+          FileUtils.rm_rf(repo_name)  
+          old_clone_url = clone(repo_name, user_name)                  
+        else
+          old_clone_url = clone_url(repo_name, user_name)                 
+        end
+      else
+        old_clone_url = clone(repo_name, user_name)                  
+      end        
+      log "cloned old repo from : #{old_clone_url}"
+      # create new repo with new name
+      raise RenameError, "Error getting hold of old repository" if !old_clone_url
+
+      info "get clone_url for new repo: #{repo_name}"
+      new_clone_url = clone_url(new_repo_name, user_name)                 
+      raise RenameError, "Error getting new repository url for: #{new_repo_name}" if !new_clone_url
+      
+      # change remote origin of repo
+      info "current dir: #{Dir.pwd}"      
+      return "no local clone dir for #{repo_name}" if !File.directory? repo_name 
+      FileUtils.cd repo_name do 
+        info "update old local repo to point to new repo" 
+        `git remote rm origin`      
+        info "removed old origin"
+        `git remote add origin #{new_clone_url}`
+        info "added new origin"
+        `git push origin master --force`
+        log "pushed to new origin master: #{new_clone_url}"      
+        status = delete!(repo_name)
+        log "old repo #{repo_name} deleted" if status              
+      end
+      
+      FileUtils.rm_rf repo_name if options[:delete_local]
+      log "old local repo directory deleted"
+
+      info "making sure old repo is deleted"
+      log delete!(repo_name)                          
+    rescue StandardError => e 
+      log e
+      true
+    end      
+  end
+
+  def fork(repo, options = {})                               
+    post_repo_user 'repos/fork', options
+  end    
+                        
+  def collaborators(repo, options = {})    
+    post_repo_show repo, 'collaborators', options    
+  end
+
+  def languages(repo, options = {})    
+    post_repo_show repo, 'languages', options
+  end
+
+  def tags(repo, options = {})    
+    post_repo_show repo, 'tags', options
+  end
+
+  def branches(repo, options = {})    
+    post_repo_show repo, 'branches', options
+  end
+    
+end
+  
+

data/lib/github_util.rb

@@ -0,0 +1,41 @@
+module GithubUtil
+  def configure
+
+    git_config = Git.global_config
+    user_name       = git_config['user.name']
+    user_email      = git_config['user.email']
+    github_username = git_config['github.user']
+    github_token    = git_config['github.token']
+
+    {:name => github_username, :token => github_token, :login => github_username}
+  end
+   
+  def info(msg) 
+    puts msg if log_level > 0
+  end
+
+  def log(msg)    
+    puts msg if log_level > 1
+  end
+
+
+  def post(path, options = {})
+    opts = {'login' => config[:login], 'token' => config[:token]}        
+    res = Net::HTTP.post_form URI.parse(path), opts.merge(options) 
+    res.extend(GithubParser)
+  end
+
+  def post_repo_user(api_path, repo, action, options = {})
+    user = options[:user] ? options[:user] : config[:name]
+    path = 'http://github.com/api/v2/yaml/' 
+    path << api_path
+    path << "/#{user}/#{repo}"
+    path << "/#{action}" if action
+    post path, options
+  end
+
+  def post_repo_show(repo, action, options = {})
+    res = post_repo_user 'repos/show', repo, action, options
+    res.parse_result(action)
+  end
+end

data/spec/github_repo_spec.rb

@@ -0,0 +1,69 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+# describe "GithubRepo" do
+#   it "works" do
+#     api = GithubApi.new
+#     res = api.tags 'github_thor_tasks'
+#     puts res.inspect
+# 
+#     res = api.branches 'github_thor_tasks'
+#     puts res.inspect
+#   end
+# end
+
+describe "GithubRepo" do
+  it "works" do        
+    api = GithubApi.new
+    api.log_on
+#    res = api.create 'hello2', :description => 'my hello2', :homepage => 'my homepage2'  
+    # puts api.delete! 'hello2'
+    # api.authenticated do
+    #   clone_user = api.user
+    #   repo = clone_user.repositories.find 'new_hello'    
+    #   url = api.get_clone_url(repo, clone_user)    
+    #   puts repo
+    #   puts url
+    # end
+
+    res = api.create 'hello', :description => 'my hello', :homepage => 'my homepage' 
+    # puts res
+    # # puts Dir.pwd
+    # api.init_repo 'hello'
+    # puts res
+    # api.rename! 'hello', 'new_hello'
+    # res = api.rename 'hello', 'new_hello'
+    # puts res
+  end
+end                            
+
+
+# Running “github_repo_spec.rb”…
+# ruby 1.9.1p378 (2010-01-10 revision 26273) [i386-darwin10.2.0]
+# Theme:  
+# W, [2010-04-13T15:40:17.884494 #91255]  WARN -- : Using in memory store
+# F
+# 
+# 1) GithubRepo works
+#     Failure/Error: res = api.create 'hello', :description => 'my hello', :homepage => 'my homepage'
+#     Github returned status 403, you may not have access to this resource.
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi/api.rb:129:in `rescue in get'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi/api.rb:117:in `get'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi/api.rb:100:in `find'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi/resource.rb:41:in `find'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi/repository.rb:82:in `find'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi/repository_set.rb:7:in `find'
+#     # /Users/kristianconsult/Development/Languages/Ruby/Apps/Gems/github_repo/lib/github_repo.rb:74:in `block in create'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi.rb:33:in `block in authenticated'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi.rb:63:in `authenticated_with'
+#     # /Users/kristianconsult/.rvm/gems/ruby-1.9.1-p378/gems/octopi-0.2.8/lib/octopi.rb:32:in `authenticated'
+#     # /Users/kristianconsult/Development/Languages/Ruby/Apps/Gems/github_repo/lib/github_repo.rb:73:in `create'
+#     # /Users/kristianconsult/Development/Languages/Ruby/Apps/Gems/github_repo/spec/github_repo_spec.rb:19:in `block (2 levels) in <main>'
+# 
+# 
+# Finished in 3.542207 seconds
+# 1 example, 1 failures
+# GitHub returned status 403. Retrying request.
+# copy output
+# Program exited with code #1 after 4.91 seconds.
+#    
+# 

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'github_repo'
+require 'rspec'
+require 'rspec/autorun'
+
+Rspec.configure do |c|
+  # c.mock_with :rspec
+end
+

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: github_repo
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Kristian Mandrup
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-13 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  type: :development
+  version_requirements: *id001
+description: Github API v2 wrapper for common github tasks. Builds on Octopi gem where possible but works at a higher level.
+email: kmandrup@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lib/github_repo.rb
+- lib/github_util.rb
+- spec/github_repo_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/kristianmandrup/github_repo
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Github API v2 wrapper for common github tasks
+test_files: 
+- spec/github_repo_spec.rb
+- spec/spec_helper.rb