ionchy
/
hg2git
1
0
Fork 0
Code
Migration scripts from Mercurial to Git (last worked in 2017)
7 Commits 1 Branch 0 Tags 38 KiB
Python 52.9%
Shell 47.1%
Go to file
jochan 6283bad98a Added full workflow for migration. 2017-06-20 10:50:47 -07:00
README.md Added full workflow for migration. 2017-06-20 10:50:47 -07:00
authors.py Updated authors.py to read from users.csv; modified some steps in hg2git 2017-06-15 11:13:31 -07:00
hg2git.cf Converted migration steps into bash scripts. 2017-06-19 17:59:08 -07:00
hg2git.sh Added full workflow for migration. 2017-06-20 10:50:47 -07:00
hg2git_clean.sh Added full workflow for migration. 2017-06-20 10:50:47 -07:00
hg2git_ignore.sh Added full workflow for migration. 2017-06-20 10:50:47 -07:00
hg2git_update.sh Added full workflow for migration. 2017-06-20 10:50:47 -07:00
pattern-author.txt Initial commit of generic migration files 2017-06-08 17:05:45 -07:00

README.md

Mercurial to Git Migration

Notes

  • If any .sh scripts cannot be executed, replace ./ with bash or execute chmod u+x <.sh script>.
  • The scripts require some of the following arguments:
    • <source>: The Mercurial repository that you are migrating FROM.
    • <target>: The Git repository that you are mirating TO.
    • <authors>: The directory to which authors.py and users.csv will be copied.
    • <fast-export>: The directory to which https://github.com/frej/fast-export will be cloned. All files in this directory will be overwritten.
    • <bfg-cleaner>: The directory to which the BFG Repo-Cleaner .jar file will be downloaded.

Instructions

  1. Copy all hg2git*.sh, authors.py, and users.csv files to the same directory.
  2. Run ./hg2git.sh <source> <target> <authors> <fast-export>. This may take a while. Do NOT delete the reformatted-authors.txt file.
  3. If you have new changes in your Mercurial repository and you wish to update your Git repository, ensure the changes have been pulled (hg pull) and run ./hg2git_update.sh <source> <target>.
  4. Before moving on, make sure that you are absolutely sure you no longer need to update your Git repository from your Mercurial repository. Once you perform the next steps, you cannot update again.
  5. To strip out large files from history and delete closed branches, run ./hg2git_clean.sh <source> <target> <bfg-cleaner>. Files larger than 40M will be stripped. This may take a while.
  6. To copy .hgignore files to .gitignore, convert some of the regex to globs, and commit these files for every branch, run ./hg2git_ignore.sh <target>. Note that this will convert the repository from bare to non-bare and check out files.
  7. Set an upstream (git remote add origin <url>) and push the repository (git push -u origin master). This may take a while.

TL;DR

  1. ./hg2git.sh <source> <target> <authors> <fast-export>
  2. ./hg2git_update.sh <source> <target>
  3. Read Instructions > Step 3.
  4. ./hg2git_clean.sh <source> <target> <bfg-cleaner>
  5. ./hg2git_ignore.sh <target>
  6. git remote add origin <url> && git push -u origin master