waddlesplash / bitbucket_issues_to_github

Transfer (import, migrate) issues from Bitbucket to Github.

Migrate Bitbucket issues to Github

Migrate Bitbucket issues to Github, with comments.

We use the Python wrapper for Github API v3 to achieve this.

Installation

1. Create a virtualenv and activate it.
2. Clone this repo.
3. $ pip install -r requirements.txt
4. $ python bb2gh_issues.py -h

You'll see an explanation of options.

Example

$ python bb2gh_issues.py -l viniciusban -p my_password -r test_repo bb-issues.json

Notes and known limitations

You must export your issues in Bitbucket, first.

Issues import cannot be undone. So, I suggest you to run this process in a test repository before importing them to your real one.

All issues created on Github will have your --login user as the creator and the commenter. So, each issue and comment will have a note to tell you who and when created the issue (or comment).

You can preserve issues' assignees. Edit bb2gh_issues.py and change the ASSIGNEES dict to represent your situation. Read comments on source code.

Depending on how many issues and comments you have, this process can take a while. Don't panic.

We don't import milestones or images. Pull requests are welcome. :-)

Options explained

1. -l, --login

   You need to be logged in to create issues in Github. This is the username will be the creator of all issues and comments in this process.

2. -p, --password

   Password for --login user.

3. -r, --repo

   The repository will receive your issues.

4. -u, --user

   The username who owns the repo. Also known as the username that appears in the repo url. I.e.: http://github.com/**this_is_the_username**/reponame

   If ommited, --login will be used.

5. --no-assignees

   Don't use assignee information.

6. file

   The JSON file name with Bitbucket exported issues.