Passer de Mercurial à GIT dans Atlassian Bitbucket avec enregistrer des fichiers en cyrillique

Contexte

En été, un article de blog officiel a été publié sur le blog officiel de BitBucket annonçant la fin de la prise en charge des référentiels Mercurial.

L'arrêt de Mercurial se fera en deux temps:

1. À partir du 1er février 2020, les utilisateurs ne pourront plus créer de nouveaux référentiels.
2. À compter du 1er juin 2020, les utilisateurs ne pourront plus utiliser les fonctions Mercurial dans Bitbucket ou via son API, et tous les référentiels Mercurial seront supprimés.

Les raisons de cette décision sont plus ou moins claires, mais j'utilise plusieurs référentiels sur Mercurial dans mon travail (j'ai toujours plus aimé Mercurial, mais je laisserai cette question hors du champ de cet article), dont j'avais besoin pour convertir en GIT.

En fait, cet endroit a commencé ...

Le problème

Les développeurs et le service d'assistance de BitBucket ont offert plusieurs options pour une telle conversion, je les ai toutes essayées et en même temps, j'ai essayé des outils tiers, comme l' importation de référentiels dans GitHub.

Il s'est avéré que tous ces outils gâchent les noms de fichiers et de répertoires qui contiennent des caractères de l'alphabet cyrillique, et j'ai beaucoup de ces fichiers (savoirs traditionnels, spécifications et autres fichiers similaires). C'est drôle que les commentaires contenant du cyrillique soient bien tolérés et affichés après la migration.

J'ai trouvé des informations sur Internet qu'il existe des outils dans Mercurial (clés dans le fichier de configuration du référentiel) qui vous permettent de contrôler l'encodage des caractères par défaut, mais d'une part, ils ne sont inclus qu'explicitement, et d'autre part, il n'y a pas d'outil pour convertir le référentiel existant . Eh bien, je n'ai pas vérifié en quoi cette option aide à la migration à l'aide d'outils prêts à l'emploi - il est trop tard pour moi de suivre cette voie.

Il n'y avait aucun désir de rechercher manuellement les fichiers problématiques et de faire un remplissage manuel, j'ai donc dû creuser un peu et trouver une solution.

Peut-être, le transfert d'un référentiel avec des caractères russes dans les noms de fichiers est également pertinent pour quelqu'un, et mon article vous fera gagner un peu de temps.

Solution

Procédure de base

1. Prenez le référentiel git@github.com: seewindcn / tortoisehg.git - il a le plugin fixutf8, qui n'est pas dans la distribution principale. Il est en outre supposé que la copie locale sera située dans le répertoire D: \ Development \ tortoisehg
2. Faites une copie de votre référentiel Mercurial afin de ne pas endommager l'emplacement principal. De plus, toutes les commandes sont exécutées dans le répertoire de copie.
3. Corrigez les noms de fichiers et de répertoires avec la commande D: \ Development \ tortoisehg \ hg.exe addremove -s 100
4. Validez dans le référentiel D: \ Development \ tortoisehg \ hg.exe commit -m "Fix filen names"
5. Activez le plugin hggit - dans le fichier .hg \ hgrc que vous devez ajouter
   [extensions]
   hggit =
6. Préparez-vous à convertir en GIT - créez une étiquette principale avec la commande D: \ Development \ tortoisehg \ hg.exe bookmark -r default master
7. Créer un référentiel GIT dans BitBucket
8. Nous nous engageons dans le référentiel hg push git + ssh: //git@bitbucket.org: <user> / <reponame> .git ( notez que cela utilise hg normal car le clone de seewindcn ne veut pas travailler sur SSH)
9. Nous vérifions sur le site Web de BitBucket, assurez-vous que les noms de fichiers cyrilliques ne cassent pas
10. Nous clonons le référentiel GIT pour nous-mêmes, vérifions les noms de fichiers, effectuons une comparaison d'octets de tous les fichiers, construisons le projet, testons
11. Après la construction, il y aura probablement une tonne de nouveaux fichiers que GIT suggérera de valider. Le fichier .hgignore devra être converti à la main en .gitignore. Heureusement, vous pouvez le faire une fois et utiliser un seul fichier pour tous les autres référentiels.

En conséquence, nous avons réussi à transférer la branche principale par défaut du référentiel Mercurial d'origine avec l'historique complet des validations vers le maître du référentiel GIT et même avec des étiquettes. Parmi les inconvénients, je note uniquement le manque total d'informations sur les modifications apportées aux fichiers avec cyrillique dans l'historique des validations - il y a des validations, et il n'y a même pas de références aux fichiers avec cyrillique (le reste des fichiers, bien sûr, sont en parfait état).

En général, la tâche pouvait être considérée comme terminée, mais par intérêt sportif, il était également intéressant pour moi de transférer les branches restantes.

Habillage de branche sauf par défaut

1. Obtenir une liste des succursales hg branches
2. Pour chaque branche
   
   1. Passer à la branche hg up <branchname>
   2. Créez une étiquette (le nom de l'étiquette ne doit pas correspondre au nom de la branche): hg bookmark -r <hgbranchname> <gitbranchname>
   3. Versez la branche dans GIT hg push git@bitbucket.org: <user> / <reponame> .git

Il peut arriver que le nom de la branche contienne également l'alphabet cyrillique, dans ce cas les branches hg afficheront krakozyabry. Dans ce cas, j'ai utilisé un plan de travail visuel hg - passé à une branche et créé une étiquette là-bas.

À ce stade, vient le Feng Shui complet.

Si quelqu'un souhaite creuser plus profondément, je pars ...

Liste de références

• github.com/seewindcn/tortoisehg (travaillé)
• www.mercurial-scm.org/wiki/FixUtf8Extension (partie d'une solution précédente)
• www.mercurial-scm.org/wiki/ConvertExtension#Converting_from_Mercurial (n'a pas aidé)
• serverfault.com/questions/319070/mercurial-convert-filename-encoding (utilise l'extension de conversion, n'a pas aidé)
• bitbucket.org/rominf/hg_convert_filenames_encoding/src/default (automatisation de la version précédente)
• stackoverflow.com/questions/16037787/convert-mercurial-project-to-git (décrit l'extension de téléchargement dans GIT)