You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
The Atlassian Community can help you and your team get more value out of Atlassian products and practices.
Following the recent announcement that BitBucket will be 'sunsetting' support for Mercurial repositories from 1/6/20 it became fairly urgent for me to find a straightforward solution to migrate my Hg projects over to Git.
I only have a few projects but an automated approach should be less error-prone and able to preserve project metadata where possible. I therefore created a simple tool to handle my migration needs.
This project is a simple Python 3.7 script that makes use of the BitBucket 2.0 API to identify and create new equivalent Git repositories and a Git/Mercurial compatibility addon to do the conversion.
I've used it only in a Cygwin environment on Windows but I tried to keep it fairly generic so hopefully it will work anywhere that Python 3 is installed. I used Python 3.7.4.
It functions approximately as follows:
1) Ensure git and git-remote-hg are available on PATH
2) Connect (authenticate) to BitBucket API
3) Read list of projects for user
4) For each project:
5) If it's not a Mercurial project, skip processing
6) If a Git equivalent project exists already, skip processing
7) Create Git equivalent project on BitBucket
8) Clone project locally using git clone --mirror with hg:: prefix
9) Push local project to new git remote using git push --mirror
For the authentication (2) you should set up a temporary App Password (under your account > Settings > Access Management > App Passwords) with 'Admin' access to your repositories. You can easily revoke this when done. I used the following configuration:
The script can be found in a Git project bitbucket-hg-to-git and is dedicated to the community. Please feel free to modify it for your own needs or even raise issues and pull-requests if necessary.