🚀 Outil de Migration Git Multi-Providers

Cet projet fournit un outil pratique et modulable pour migrer automatiquement vos repositories entre différents providers Git.

✨ Fonctionnalités

• Migration multi-providers : Supporte plusieurs providers source et destination
• Providers supportés :
  • Sources : Gitea, GitLab
  • Destinations : GitHub, GitLab
• Mode interactif par défaut : Interface élégante pour sélectionner/déselectionner les repos à migrer
• Vision complète : Voit tous les repositories accessibles (vos repos + ceux d'organisations)
• Sélection intelligente : Vos repositories sont pré-sélectionnés, les autres sont désélectionnés par défaut
• Renommage intelligent : Possibilité de renommer les repositories lors de la migration
• Migration sélective : Choisissez spécifiquement quels repositories migrer en ligne de commande
• Interface en ligne de commande : Interface colorée et intuitive avec navigation au clavier
• Logging complet : Suivi détaillé des opérations avec fichier de log
• Gestion des erreurs : Robuste avec gestion gracieuse des erreurs
• Architecture extensible : Facilement extensible pour ajouter de nouveaux providers

🛠 Installation

1. Clonez le repository :

git clone https://github.com/votre-username/GitMigrator.git
cd GitMigrator

2. Configuration automatique :

./run.sh --setup

Le script va automatiquement :

• Créer un environnement virtuel Python
• Installer toutes les dépendances
• Créer le fichier de configuration .env

Cela créera un fichier .env que vous devrez remplir avec vos informations selon les providers choisis.

🔧 Configuration

Configuration basique (Gitea → GitHub)

# Source Provider
SOURCE_PROVIDER=gitea
GITEA_URL=https://votre-instance-gitea.com
GITEA_TOKEN=votre_token_gitea
GITEA_USERNAME=votre_nom_utilisateur_gitea

# Destination Provider
DESTINATION_PROVIDER=github
GITHUB_TOKEN=votre_token_github
GITHUB_USERNAME=votre_nom_utilisateur_github

Configuration GitLab → GitHub

# Source Provider
SOURCE_PROVIDER=gitlab
GITLAB_URL=https://gitlab.com
GITLAB_TOKEN=votre_token_gitlab
GITLAB_USERNAME=votre_nom_utilisateur_gitlab

# Destination Provider
DESTINATION_PROVIDER=github
GITHUB_TOKEN=votre_token_github
GITHUB_USERNAME=votre_nom_utilisateur_github

Configuration GitLab → GitLab (migration entre instances)

# Source Provider
SOURCE_PROVIDER=gitlab
GITLAB_URL=https://gitlab-source.com
GITLAB_TOKEN=votre_token_gitlab_source
GITLAB_USERNAME=votre_nom_utilisateur_source

# Destination Provider
DESTINATION_PROVIDER=gitlab
GITLAB_DEST_URL=https://gitlab-destination.com
GITLAB_DEST_TOKEN=votre_token_gitlab_dest
GITLAB_DEST_USERNAME=votre_nom_utilisateur_dest

🔑 Configuration des tokens

Token Gitea

1. Allez dans Settings → Applications → Generate New Token
2. Donnez un nom au token et sélectionnez les permissions :
   • repo (accès complet aux repositories)
   • user (accès aux informations utilisateur)

Token GitLab

1. Allez dans Settings → Access Tokens ou User Settings → Access Tokens
2. Créez un Personal Access Token avec les permissions :
   • read_api (lecture des informations API)
   • read_repository (lecture des repositories)
   • write_repository (écriture des repositories - pour destination)

Token GitHub

1. Allez dans Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Cliquez sur Generate new token (classic)
3. Sélectionnez les permissions :
   • repo (accès complet aux repositories privés)
   • public_repo (accès aux repositories publics)

🚀 Utilisation

Après avoir configuré vos tokens dans le fichier .env, utilisez le script de lancement :

Migration interactive (par défaut)

./run.sh

Migration automatique de tous vos repos

./run.sh --no-interactive

Migration de repositories spécifiques

./run.sh --repos mon-repo autre-repo

Lister les repositories disponibles

./run.sh --list

Mode verbose (plus de détails)

./run.sh --verbose

💡 Alternative : Vous pouvez aussi utiliser directement python main.py si vous avez activé l'environnement virtuel (source venv/bin/activate)

🎯 Mode Interactif

Le mode interactif (activé par défaut) offre une interface utilisateur élégante pour sélectionner précisément quels repositories migrer :

./run.sh  # Mode interactif par défaut

Contrôles dans l'interface interactive :

• ↑↓ : Naviguer entre les repositories
• ←→ : Changer de page (si beaucoup de repos)
• ESPACE : Cocher/décocher un repository
• A : Sélectionner tous les repositories
• N : Désélectionner tous les repositories
• ENTRÉE : Confirmer la sélection et passer au renommage (optionnel)
• Q : Quitter sans migrer

Interface de renommage :

Après la sélection, l'outil propose de renommer les repositories :

• Y : Ouvrir l'interface de renommage
• N/ENTRÉE : Conserver les noms actuels
• Validation automatique des noms de repositories pour le provider de destination

Fonctionnalités :

• ✅ Checkboxes visuelles avec émojis
• 👤 Distinction propriétaire : Vos repos vs repos d'autres utilisateurs
• 🎯 Sélection intelligente : Vos repos pré-sélectionnés par défaut
• 📋 Tri intelligent : Vos repos en premier, puis les autres, tous par ordre alphabétique
• ✏️ Renommage optionnel : Possibilité de renommer les repos sur le provider de destination
• 📄 Pagination automatique (15 repos par page)
• 🎨 Interface colorée avec mise en surbrillance et séparateurs visuels
• 📊 Compteur en temps réel des repos sélectionnés
• 🔒 Indicateurs visuels (privé/public)
• 📝 Descriptions tronquées pour un affichage propre

📋 Exemples d'utilisation

Exemple 1 : Migration Gitea → GitHub (défaut)

# Configuration dans .env
SOURCE_PROVIDER=gitea
DESTINATION_PROVIDER=github

# Interface interactive pour sélectionner les repos
./run.sh

Exemple 2 : Migration GitLab → GitHub

# Configuration dans .env
SOURCE_PROVIDER=gitlab
DESTINATION_PROVIDER=github

# Migration automatique
./run.sh --no-interactive

Exemple 3 : Migration GitLab → GitLab (entre instances)

# Configuration dans .env
SOURCE_PROVIDER=gitlab
DESTINATION_PROVIDER=gitlab

# Migration sélective
./run.sh --repos projet-web api-backend

Exemple 4 : Migration depuis une organisation

# Migre un repository d'une organisation (fonctionne avec tous les providers)
./run.sh --repos mon-org/projet-important

Exemple 5 : Premier lancement (configuration)

# 1. Setup initial
./run.sh --setup

# 2. Éditez le fichier .env avec vos credentials et providers
nano .env

# 3. Listez vos repositories disponibles
./run.sh --list

# 4. Lancez la migration interactive
./run.sh

Exemple 6 : Migration avec renommage

# 1. Lancer le mode interactif
./run.sh

# 2. Sélectionner les repos à migrer
# 3. Choisir "Y" pour le renommage
# 4. Renommer les repos un par un
#    - Appuyer sur ENTRÉE pour garder le nom original
#    - Taper un nouveau nom pour renommer
# 5. Confirmer et lancer la migration

📊 Résultats

L'outil affiche un résumé détaillé à la fin :

• ✅ Nombre de migrations réussies
• ❌ Nombre de migrations échouées
• 📝 Détail par repository

Tous les logs sont également sauvegardés dans migration.log.

🔧 Structure du projet

GitMigrator/
├── main.py                     # Script principal
├── core/                       # Logique métier centrale
│   ├── config.py              # Gestion de la configuration multi-providers
│   └── migration_engine.py    # Moteur de migration
├── providers/                  # Providers pour différents services Git
│   ├── base.py                # Classes abstraites et modèles
│   ├── factory.py             # Factory pour créer les providers
│   ├── source/                # Providers source
│   │   ├── gitea.py          # Support Gitea
│   │   └── gitlab.py         # Support GitLab
│   └── destination/           # Providers destination
│       ├── github.py         # Support GitHub
│       └── gitlab.py         # Support GitLab
├── ui/                        # Interface utilisateur
│   └── interactive_selector.py
├── requirements.txt           # Dépendances Python
├── .env                      # Configuration (à créer)
└── README.md                 # Documentation

🌟 Providers supportés

Providers Source

• Gitea : Instances Gitea (self-hosted ou cloud)
• GitLab : GitLab.com ou instances GitLab self-hosted

Providers Destination

• GitHub : GitHub.com
• GitLab : GitLab.com ou instances GitLab self-hosted

Combinaisons possibles

• Gitea → GitHub
• Gitea → GitLab
• GitLab → GitHub
• GitLab → GitLab (migration entre instances)

⚠️ Prérequis

• Python 3.7+
• Git installé sur votre système
• Accès aux APIs des providers source et destination
• Tokens d'authentification valides pour les providers

🛡 Sécurité

• Les tokens sont stockés dans un fichier .env (ajoutez-le à .gitignore)
• Les URLs d'authentification ne sont jamais loggées
• Nettoyage automatique des repositories temporaires

🐛 Résolution de problèmes

Erreur d'authentification

• Vérifiez que vos tokens sont valides et ont les bonnes permissions
• Assurez-vous que les noms d'utilisateur correspondent
• Vérifiez que les URLs des providers sont correctes

Erreur de clonage

• Vérifiez votre connexion internet
• Assurez-vous que Git est installé et accessible

Repository déjà existant

• L'outil vérifie automatiquement l'existence sur le provider de destination
• Les repositories existants sont ignorés avec un avertissement

Provider non supporté

• Vérifiez que le provider est bien configuré dans SOURCE_PROVIDER ou DESTINATION_PROVIDER
• Providers disponibles : gitea, gitlab (source) | github, gitlab (destination)

📝 Logs

Tous les détails d'exécution sont sauvegardés dans migration.log :

• Timestamps des opérations
• Détails des erreurs
• Statistiques de migration
• Informations sur les providers utilisés

🚀 Extensibilité

L'architecture modulaire permet d'ajouter facilement de nouveaux providers :

1. Créer un nouveau provider source dans providers/source/
2. Créer un nouveau provider destination dans providers/destination/
3. Enregistrer le provider dans providers/factory.py
4. Ajouter la configuration dans core/config.py

Voir ARCHITECTURE.md pour plus de détails sur l'ajout de nouveaux providers.

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

• Signaler des bugs
• Proposer des améliorations
• Soumettre des pull requests
• Ajouter de nouveaux providers

📄 Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.