git2bit 1.0.1 → 1.0.2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    git2bit (1.0.1)
+    git2bit (1.0.2)
       bitbucket_rest_api
       github_api
       methadone (~> 1.2.4)

data/README.md

@@ -1,11 +1,61 @@
 # git2bit
 
-There are many people out there that have migrated their private repositories from Github to BitBucket. BitBucket has a goo utility that will clone your entire repository over, however, there is no way to migrate any existing issues that you have on Github. 
+There are many people out there that have migrated their private repositories from Github to Bitbucket. Bitbucket has a goo utility that will clone your entire repository over, however, there is no way to migrate any existing issues that you have on Github. 
 
-git2bit is a CLI that solves this by migrating all your issues along with their comments and milestones from Github into your new BitBucket repo. 
+git2bit is a CLI that solves this by migrating all your issues along with their comments and milestones from Github into your new Bitbucket repo. 
 
 **Important Tip**: I recommend that you create a new blank repo in Bitbucket to run intial migration tests with. Once you are happy with the migration results, you can delete this repository and proceed with migrating issues to the production repo.
 
+## How does it work?
+
+The issues systems between Github and Bitbucket are similar but also pretty different. Github uses *labels* in order to get you to organize and categorize your issues. Bitbucket does not support labels and instead has a more traditional approach using  a predefined set of fields. 
+
+Obviously the issue title and body will come over unchanged. However, all of the migrated issues will be created by the Bitbucket user account that is configred in git2bit. The original creation date of the issue will not be migrated either. As a consolation, the original data from Github will be inserted at the top of the newly created issue.  
+
+	Github issue #459 created by joeworkman on 2012-09-06 20:51:49
+
+Here are some more caveats with each Bitbucket issue field. 
+
+**Tip**: Chances are you already had labels in Github for organizing issues by kind, priority, or component. Before you migrate issues using git2bit, make sure that you rename your labels to maps to the supported Bitbucket fields documented below. 
+
+### Comments
+
+The first comment added to newly created issues will contain a list of all the Github labels that were assigned to the original ticket. This will ensure that you still have this data if its valuable to you. 
+
+All comments from Github will be brought over and inserted into the new issue created on Bitbucket. Just like at the ticket level the creation data (username & date) will be inserted at the top of each comment. 
+
+### Kind
+
+Bitbucket supports 4 different kinds of issues: `bug`, `enhancement`, `proposal`, and `task`. 
+
+git2bit will evaluate all of the labels that are assigned to each Github issue. If one of the labels matches the mentioned Bitbucket kinds, when the issue if created, it will be assigned to that kind. If no matching label is found, the issue will default to be a bug. 
+
+### Priority
+
+Bitbucket supports 5 different priorities for issues: `trivial`, `minor`, `major`, `critical`, and `blocker`. 
+
+git2bit will evaluate all of the labels that are assigned to each Github issue. If one of the labels matches the mentioned Bitbucket priorities, when the issue if created, it will be assigned to that priority. If no matching label is found, the issue will default to the priority of trivial. 
+
+### Status
+
+Bitbucket supports 7 different priorities for issues: `new`, `open`, `resolved`, `on hold`, `invalid`, `duplicate`, and `wontfix`.
+
+This somewhat overlaps with Github issue status. In Github an issue can only ever be opened or closed. However, I know for a fact that developers use labels to get better fine-grained control over this. Therefore, git2bit evaluates the labels on each Github issue. If one of the labels matches the mentioned Bitbucket status options, when the issue if created, it will be assigned to that status. If no matching label is found, then the issue will be set to open. 
+
+**Note**: The `closed` status in a Github issue will trump everything. In this case, the newly created issue will be set to `resolved` in Bitbucket.
+
+### Component
+
+Bitbucket has support for manually defined components. If you would like for git2bit to populate this field for an issue, you will need to make sure that all of the Components are defined in your repository's Issues settings. 
+
+git2bit will evaluate all of the labels that are assigned to each Github issue. If one of the labels matches a preconfigured Component, the newly created issue will be assigned to that Component. If no matching label is found, no Components will be assigned. 
+
+**Note**: Bitbucket only allows an issue to be associated with one Component. Therefore, if you were using Github labels to assign multiple Components to an issue, when git2bit processes an issue, the first Component found within the labels wins. 
+
+### Milestone
+
+git2bit will honor the assignment of an issue to a milestone. If a mielstone does not exist in Bitbucket, it will be created. This ensure that when the new issue is created, its properly associated with the same milestones as it was in Github.
+
 ## Installation
 
 Install it via the gem command in terminal:
@@ -20,26 +70,24 @@ You can now execute it:
 
 Here is an overview of the options available to git2bit along with some helpful examples. See below for how to set these values using a `.git2bit.rc` config file. 
 
-<pre>
-Usage: git2bit [options]
-
-Options:
-    -h, --help                 Show command line help
-        --version              Show help/version info
-        --[no-]closed          [Do not] migrate closed issues
-        --issue ISSUE_NUMBER   Process only a single Github issue number
-        --guser USER           Github username
-        --gpass PASSWORD       Github password
-        --grepo REPO           Github repo name
-        --buser USER           BitBucket username
-        --bpass PASSWORD       BitBucket password
-        --brepo REPO           BitBucket repo name
-        --log-level LEVEL      Set the logging level
-                               (debug|info|warn|error|fatal)
-                               (Default: info)
-</pre>
-
-The following examples assume that you have the following options configured in your `.git2bit.rc` file: guser, gpass, grepo, buser, bpass, brepo
+    Usage: git2bit [options]
+
+    Options:
+        -h, --help                 Show command line help
+            --version              Show help/version info
+            --[no-]closed          [Do not] migrate closed issues
+            --issue ISSUE_NUMBER   Process only a single Github issue number
+            --guser USER           Github username
+            --gpass PASSWORD       Github password
+            --grepo REPO           Github repo name
+            --buser USER           Bitbucket username
+            --bpass PASSWORD       Bitbucket password
+            --brepo REPO           Bitbucket repo name
+            --log-level LEVEL      Set the logging level
+                                   (debug|info|warn|error|fatal)
+                                   (Default: info)
+
+The following examples assume that you have the following options configured in your `.git2bit.rc` file: `guser`, `gpass`, `grepo`, `buser`, `bpass`, `brepo`
 
 Move *all* issues (open and closed):
 
@@ -55,7 +103,7 @@ Move a single issue:
 
 ### .git2bit.rc
 
-Instead of passing a ton of options via command line, you can setup the configuration values in a file named **.git2bit.rc**. This file should live in your home directory.
+Instead of passing a ton of options via command line, you can setup the configuration values in a file named `.git2bit.rc`. This file should live in your home directory.
 
 Here is a sample file to get you going. 
 
@@ -75,3 +123,10 @@ Here is a sample file to get you going.
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
+
+## Thank You
+
+git2bit uses the following awesome Ruby Gems:
+
+* github_api - <https://github.com/peter-murach/github>
+* bitbucket_rest_api - <https://github.com/exceptionary/bitbucket>

data/README.rdoc

@@ -1,19 +1,27 @@
-= git2bit - DESCRIBE YOUR GEM
+= git2bit - git2bit migrates issues with their comments and milestones from a github repo to a bitbucket repo
 
-Author::  YOUR NAME (YOUR EMAIL)
-Copyright:: Copyright (c) 2013 YOUR NAME
+Author::  Joe Workman (joe at workmanmail.com)
+Copyright:: Copyright (c) 2013 Joe Workman
 
 
 DESCRIBE YOUR GEM HERE
 
 == Links
 
-* {Source on Github}[LINK TO GITHUB]
-* RDoc[LINK TO RDOC.INFO]
+* {Source on Bitbucket}[https://bitbucket.org/joeworkman/git2bit]
 
 == Install
 
-== Examples
+Install:
+	gem install git2bit
 
-== Contributing
+== Shell Examples
 
+Move all issues (open and closed):
+	git2bit
+
+Move only open issues: 
+	git2bit --no-close
+
+Move a single issue:
+	git2bit -i 532

data/bin/git2bit

@@ -22,7 +22,7 @@ class App
 
     # Connect to Bitbucket and Github
     bitbucket = Git2bit::BitbucketProxy.new({:user => options[:buser], :pass => options[:bpass],:repo => options[:brepo]})
-    github = Git2bit::GithubProxy.new({:user => options[:guser], :pass => options[:gpass], :repo => options[:grepo]})
+    github = Git2bit::GithubProxy.new({:user => options[:guser], :pass => options[:gpass], :org => options[:gorg], :repo => options[:grepo]})
 
     if options[:issue]
       info "Will only process Github issue ##{options[:issue]}"
@@ -35,8 +35,13 @@ class App
     end  
 
     # Start processing each issue in Github
+    issues = Hash.new
     github.each_issue(options[:closed]) { |issue|
-
+      issues.store(issue.number, issue)
+    }
+    
+    issues.keys.sort.each { |key|
+      issue = issues[key]
       # Go to the next iteration if the issue number does not match option provided
       next if options[:issue] and options[:issue].to_i != issue.number
 
@@ -84,8 +89,8 @@ class App
           # Add the comment into the newly created bitbucket issue
           bitbucket.create_comment new_issue, "_Github comment by **#{comment.user.login}** on #{comment_date.strftime('%F %T')}_\n\n#{comment[:body]}"
         end
-      end    
-    }
+      end
+    }  
     info "Processing Complete."
   end
 
@@ -101,7 +106,8 @@ class App
   on("--guser USER","Github username")
   on("--gpass PASSWORD","Github password")
   on("--grepo REPO","Github repo name")
-
+  on("--gorg ORG", "Github Organization name for repos owned by Organizations")
+  
   on("--buser USER","BitBucket username")
   on("--bpass PASSWORD","BitBucket password")
   on("--brepo REPO","BitBucket repo name")

data/lib/git2bit/github.rb

@@ -10,21 +10,27 @@ module Git2bit
 		def initialize(args)
 			@repo = args[:repo]
 			@user = args[:user]
-	    begin
+	    @org = args[:org]
+	    if @org
+	      @repo_owner = @org
+	    else
+	      @repo_owner = @user
+	    end
+			begin
   			@conn = Github.new :basic_auth => "#{@user}:#{args[:pass]}"
   			@conn.repos.list user: @user
-				info "Successfully connected to Github #{@user}/#{@repo}"
+				info "Successfully connected to Github with user #{@user}"
 	    rescue Exception => e 
-	      error = ["Error: Unable to connect to Github #{@user}/#{@repo}", e.message].push e.backtrace
+	      error = ["Error: Unable to connect to Github with user #{@user}", e.message].push e.backtrace
 	      exit_now!(error.join("\n"))
 	    end
 		end
 
 		def each_issue(process_closed = true)
 			data = Array.new
-			data.push @conn.issues.list :filter => 'all', :state => 'open', :user => @user, :repo => @repo
+			data.push @conn.issues.list :filter => 'all', :state => 'open', :user => @repo_owner, :repo => @repo
 			if process_closed
-				data.push @conn.issues.list :filter => 'all', :state => 'closed', :user => @user, :repo => @repo
+				data.push @conn.issues.list :filter => 'all', :state => 'closed', :user => @repo_owner, :repo => @repo
 			end
 
 			data.each do |result_set|
@@ -37,7 +43,7 @@ module Git2bit
 		def get_comments(issue_id)	    
 			begin
 				# Get Github comments for issue ID
-				comments = @conn.issues.comments.all @user, @repo, issue_id: issue_id
+				comments = @conn.issues.comments.all @repo_owner, @repo, issue_id: issue_id
 				debug "Github: got comments for issue ##{issue_id}: " + comments.inspect
 	    rescue Exception => e 
 	      error "Error: Unable to get comments for Github issue ##{issue_id} - " + e.message

data/lib/git2bit/version.rb

@@ -1,3 +1,3 @@
 module Git2bit
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git2bit
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-09 00:00:00.000000000 Z
+date: 2013-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdoc
@@ -148,7 +148,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4585294509181792167
+      hash: -3228153391256863325
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -157,7 +157,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4585294509181792167
+      hash: -3228153391256863325
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24