backup_on_the_go 0.1.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YTU0NzNlZWUzYWY4OWY5YmUxNzUyMjM3OTA4MzMyOTk3YzIzNzc5NA==
+  data.tar.gz: !binary |-
+    OGUzOGUwNmQyZDFhYTljNGMwNjc0YzZmNjFhMTI0OGRlZjgyNDQ2Mw==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    YThkYzQxMWUzNTQzYjUyZjk3MzVmZGFkZjVhOGI4ZjJiZjIyNzIzMzI3NDAy
+    Y2RmMjMzNGE0MTdhZGIxNTlkZWMyZGI5ZmRhZmVhNjA3YmM4OTE0ZjhmZjhl
+    ZmMzYTBiNmZiNjI4YWQyYThlZGUzMzgwYzljZjdjYzE5YWE3Yzg=
+  data.tar.gz: !binary |-
+    MDFkMWI5ZjRjZDI5OTI3YjRkY2VlZDhlNmUwYWY1NDg0N2QxNDA5NzhlYjI1
+    NmQ2ZTJhOWFkNjZkYjkzMTE5MDJjZjU4Nzk3MWZiOThhYjlhY2QyMjYzM2Nm
+    YzJjYzFlYmNlYTViZTFiMzQxZDY4OWQ3ZWVmZTIwYjIzNWQ3YzY=

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2013 Hong Xu
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,69 @@
+# Backup On The Go
+
+[RubyGems][1] | [RDocs][2]
+
+Back up (or mirror) your GitHub repositories to BitBucket.
+
+## Install
+
+    gem install backup_on_the_go
+
+## Run Locally
+
+Shortcut:
+
+Back up your personal repositories (will back up your repositories to BitBucket
+with a prefix of `backup-on-the-go-`):
+
+    backup-on-the-go user:your_user_name
+
+Back up your personal repositories to a different account on BitBucket:
+
+    backup-on-the-go github_user:user_name_on_github bitbucket_user:user_name_on_github
+
+Back up your organization repositories:
+
+    backup-on-the-go user:your_user_name github_repos_owner:organization_name bitbucket_repos_owner:team_name
+
+For more options, see the parameters of [BackupOnTheGo.backup][3].
+
+
+## Run in the Cloud
+
+You can deploy to some cloud services to run the backup timely.
+
+### Deploy to Heroku
+
+If you are new to [Heroku](http://heroku.com), first go to Heroku website to
+[create an account][heroku_signup], install [Heroku Toolbelt][], and run
+`heroku login` to login.
+
+Run the following command to obtain the pre-prepared files for deploying:
+
+    git clone -b heroku git://github.com/xuhdev/backup-on-the-go.git
+    cd backup-on-the-go
+    bundle
+    heroku create
+
+Then edit `backup.rb` to configure your backup. After configuring, you may
+wanna run `foreman start` to test locally. Then:
+
+    git commit -a -m "My initial backup commit."
+    git push heroku heroku:master
+
+**NOTE**: Don't push to any public repositories, since your password is there!
+
+At last, you need to [scale your dyno formation][] in order to run the backup
+dyno instead of the web dyno:
+
+    heroku scale web=0 worker=1
+
+Done!
+
+
+[1]: https://rubygems.org/gems/backup_on_the_go
+[2]: http://rubydoc.info/github/xuhdev/backup-on-the-go/master/frames
+[3]: http://rubydoc.info/github/xuhdev/backup-on-the-go/master/BackupOnTheGo.backup
+[heroku_signup]: https://id.heroku.com/signup
+[Heroku Toolbelt]: https://toolbelt.heroku.com/
+[scale your dyno formation]: https://devcenter.heroku.com/articles/scaling

data/bin/backup-on-the-go

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+
+require 'backup_on_the_go'
+
+if ARGV.length == 0
+  puts <<END
+  Usage:
+
+  backup-on-the-go key0:string_value0 key1:string_value1 key2?boolean_value2 ...
+
+  e.g.
+  backup-on-the-go user:username is_prviate?false
+
+  For the description of keys and values, please see the document of
+  BackupOnTheGo.backup
+
+END
+  exit
+end
+
+config = Hash.new
+
+ARGV.each do |a|
+
+  # string value
+  key, value = a.split(':', 2)
+  if value != nil
+    config[key.to_sym] = value
+    next
+  end
+
+  # boolean value
+  key, value = a.split('?', 2)
+  if value != nil
+    value.strip!
+
+    if value == 'true' or value == 'yes' or value == '1'
+      config[key.to_sym] = true
+    elsif value == 'false' or value == 'no' or value == '0'
+      config[key.to_sym] = false
+    end
+  end
+end
+
+BackupOnTheGo.backup config

data/lib/backup_on_the_go.rb

@@ -0,0 +1,180 @@
+# encoding: utf-8
+
+require 'github_api'
+require 'bitbucket_rest_api'
+require 'highline/import'
+require 'tmpdir'
+require 'colorize'
+
+# The module of BackupOnTheGo
+module BackupOnTheGo #:nodoc:#
+
+  DEFAULT_CONFIG = {
+    :backup_fork => false,
+    :git_cmd => 'git',
+    :is_private => true,
+    :no_public_fork => true,
+    :repo_prefix => 'backup-on-the-go-',
+    :verbose => true
+  }.freeze
+
+  # Backup GitHub repositories to BitBucket.
+  #
+  # = Parameters
+  # * <tt>:backup_fork</tt> - Optional boolean - <tt>true</tt> to backup forked repositories, <tt>false</tt> to skip them. Default is <tt>false</tt>.
+  # * <tt>:bitbucket_password</tt> - Optional string - The password to access the BitBucket account. If not specified, a prompt will show up to ask for the password.
+  # * <tt>:bitbucket_repos_owner</tt> - Optional string - Owner of the backup repositories on BitBucket. The owner could be a team. If not specified, <tt>:bitbucket_user</tt> will be used.
+  # * <tt>:bitbucket_user</tt> - *Required* string if <tt>:user</tt> is not specified - The user name on BitBucket. If not specified, <tt>:user</tt> will be used.
+  # * <tt>:git_cmd</tt> - Optional string - The git command you want to use. Default is 'git'.
+  # * <tt>:github_repos_owner</tt> - Optional string - The owner of the repositories that need to be backed up. The owner could be an organization. If not specified, <tt>:github_user</tt> will be used.
+  # * <tt>:github_user</tt> - *Required* string if <tt>:user</tt> is not specified - The user name on GitHub. If not specified, <tt>:user</tt> will be used.
+  # * <tt>:is_private</tt> - Optional boolean - <tt>true</tt> to make the backup repositories private, <tt>false</tt> to make them public. Default is <tt>true</tt>.
+  # * <tt>:no_public_fork</tt> - Optional boolean - <tt>true</tt> to forbid public fork for the backup repositories, <tt>false</tt> to allow public fork. Default is <tt>true</tt>.
+  # * <tt>:repo_prefix</tt> - Optional string - The prefix you wanna prepend to the backup repository names. In this way, if you have a repository with the same name on BitBucket, it won't get flushed. Default is <tt>"backup-on-the-go-"</tt>.
+  # * <tt>:user</tt> - *Required* string if <tt>:github_user</tt> and <tt>:bitbucket_user</tt> are not both specified - The user name of GitHub and BitBucket (if they are same for you). If you want to use different user names on GitHub and BitBucket, please specify <tt>:github_user</tt> and <tt>:bitbucket_user</tt> instead.
+  # * <tt>:verbose</tt> - Optional boolean - <tt>true</tt> to print additional information and <tt>false</tt> to suppress them. Default is <tt>true</tt>.
+  #
+  # = Examples
+  #  
+  #  # Back up personal repositories
+  #  BackupOnTheGo.backup :github_user => 'github_user_name',
+  #  :bitbucket_user => 'bitbucket_user_name',
+  #  :is_private => false,    # make backup repositories public
+  #  :bitbucket_password => 'bitbucket_password',
+  #  :repo_prefix => ''      # don't need any prefix
+  #
+  # = Examples
+  #
+  #  # Back up organization repositories
+  #  BackupOnTheGo.backup :github_user => 'github_user_name',
+  #  :github_repos_owner => 'organization_name',
+  #  :bitbucket_user => 'bitbucket_user_name',
+  #  :bitbucket_repos_owner => 'bitbucket_team_name',
+  #  :bitbucket_password => 'bitbucket_password',
+  #  :repo_prefix => 'our-backup'
+  #
+  def self.backup(configs = {})
+
+    config = DEFAULT_CONFIG.merge(configs)
+
+    # either :user or :github_user and :bitbucket_user have to be set
+    if config.has_key?(:user)
+      config[:github_user] = config[:user] unless config.has_key?(:github_user)
+      config[:bitbucket_user] = config[:user] unless config.has_key?(:bitbucket_user)
+    end
+
+    unless config.has_key?(:github_user) and config.has_key?(:bitbucket_user)
+      raise 'No user name provided.'
+    end
+
+    unless config.has_key?(:github_repos_owner) # Owner of the github repos. Could be an organization
+      config[:github_repos_owner] = config[:github_user]
+    end
+
+    unless config.has_key?(:bitbucket_repos_owner) # Owner of backup repositories. Could be a team.
+      config[:bitbucket_repos_owner] = config[:bitbucket_user]
+    end
+
+    # Ask for the password if it is not specified
+    unless config.has_key?(:bitbucket_password)
+      config[:bitbucket_password] = ask("Enter your BitBucket password: ") { |q| q.echo = false }
+    end
+
+
+    gh_repos = Github.repos.list :user => config[:github_repos_owner] # obtain github repos
+
+    bb = BitBucket.new :login => config[:bitbucket_user], :password => config[:bitbucket_password]
+
+    backup_repo_names = Array.new
+
+    bb.repos.list do |repo|
+      if repo.owner == config[:bitbucket_repos_owner]
+        backup_repo_names.push(repo.slug)
+      end
+    end
+
+    gh_repos.each do |repo|
+      next if repo.fork && !config[:backup_fork]
+
+      puts "Backing up #{repo.name}..." if config[:verbose]
+
+      backup_repo_name = "#{config[:repo_prefix]}#{repo.name}"
+
+      # Create backup repositories if we don't have them yet
+      unless backup_repo_names.include?(backup_repo_name.downcase)
+        puts "Creating new repository #{config[:bitbucket_repos_owner]}/#{backup_repo_name}..." if config[:verbose]
+        begin
+          bb.repos.create :name => backup_repo_name, :owner => config[:bitbucket_repos_owner],
+            :scm => 'git', :is_private => config[:is_private], :no_public_fork => config[:no_public_fork]
+        rescue
+          puts_warning "Creation of repository #{config[:bitbucket_repos_owner]}/#{backup_repo_name} failed."
+        end
+      end
+
+      puts "Backing up resources..." if config[:verbose]
+
+      begin
+        bb.repos.edit config[:bitbucket_repos_owner], backup_repo_name,
+          :website => repo.homepage,
+          :description => repo.description,
+          :is_private => config[:is_private]
+      rescue
+        puts_warning "Failed to update information for #{config[:bitbucket_repos_owner]}/#{backup_repo_name}"
+      end
+
+      Dir.mktmpdir do |dir|
+        cmd = "#{config[:git_cmd]} clone --mirror #{repo.git_url} #{dir}/tmp-repo"
+        puts "Executing #{cmd}" if config[:verbose]
+        unless system(cmd)
+          puts_warning "'git clone' failed for #{repo.git_url}\n"
+          break
+        end
+
+        # Add bitbucket remote
+        cmd = "cd #{dir}/tmp-repo && " +
+          "#{config[:git_cmd]} remote add bitbucket 'https://#{config[:bitbucket_user]}:#{config[:bitbucket_password]}@bitbucket.org/#{config[:bitbucket_repos_owner]}/#{backup_repo_name}.git'"
+        puts "Executing [#{config[:git_cmd]} remote add bitbucket 'https://#{config[:bitbucket_user]}:your_password@bitbucket.org/#{config[:bitbucket_repos_owner]}/#{backup_repo_name}.git']" if config[:verbose]
+        `#{cmd}`
+        unless $?.exitstatus
+          puts_warning "'git remote add bitbucket ...' failed for #{config[:bitbucket_repos_owner]}/#{backup_repo_name}\n"
+          break
+        end
+
+        # obtain the main branch (usually master, just in case)
+        cmd = "cd #{dir}/tmp-repo && #{config[:git_cmd]} branch"
+        puts "Executing #{cmd}" if config[:verbose]
+        branches = `#{cmd}`
+        unless $?.exitstatus
+          puts_warning "''#{config[:git_cmd]} branch' failed for #{config[:github_repos_owner]}/#{repo.name}"
+          break
+        end
+        main_branch = nil
+        branches.each_line do |line|
+          # This is the main branch we need
+          if line.length >= 1 and line[0] == '*'
+            main_branch = line[1..-1].strip
+          end
+        end
+
+        cmd = "cd #{dir}/tmp-repo && "
+        if main_branch != nil # push bitbucket #{main_branch} first before push --mirror
+          cmd += "#{config[:git_cmd]} push bitbucket #{main_branch} && "
+        end
+        cmd += "#{config[:git_cmd]} push --mirror bitbucket"
+        puts "Executing #{cmd}" if config[:verbose]
+        `#{cmd}`
+        unless $?.exitstatus
+          puts_warning "'#{config[:git_cmd]} push' failed for #{config[:bitbucket_repos_owner]}/#{backup_repo_name}\n"
+          break
+        end
+        puts
+      end
+    end
+  end
+
+  private
+
+  def self.puts_warning(str)
+    puts "[Warning]: #{str}".red
+  end
+end

data/lib/backup_on_the_go/version.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module BackupOnTheGo #:nodoc:#
+  module VERSION
+    MAJOR = 0
+    MINOR = 1
+    TINY  = 3
+
+    STRING = [MAJOR, MINOR, TINY].compact.join('.')
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: backup_on_the_go
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: ruby
+authors:
+- Hong Xu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: github_api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.11
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.16
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.16
+- !ruby/object:Gem::Dependency
+  name: bitbucket_rest_api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.8
+description: Backup GitHub repositories to BitBucket
+email: hong@topbug.net
+executables:
+- backup-on-the-go
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/backup-on-the-go
+- lib/backup_on_the_go/version.rb
+- lib/backup_on_the_go.rb
+- LICENSE
+- README.md
+homepage: https://github.com/xuhdev/backup-on-the-go#readme
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Backup GitHub repositories to BitBucket
+test_files: []