GitHub Pair Extraordinaire Badge Automation

Scripts automatisés pour obtenir le badge Pair Extraordinaire sur GitHub sans intervention manuelle.

🎯 Objectif

Le badge "Pair Extraordinaire" est décerné aux développeurs qui démontrent une collaboration efficace en créant des commits impliquant plusieurs contributeurs. Ces scripts automatisent entièrement ce processus.

📋 Prérequis

• Git installé et configuré
• Un compte GitHub
• Un dépôt GitHub (de préférence votre profil README spécial)
• Python 3.6+ (pour le script Python)
• requests library pour Python (pip install requests)

🚀 Utilisation

Option 1: Script Bash (Recommandé pour simplicité)

# Rendre le script exécutable
chmod +x github_pair_badge_automation.sh

# Exécuter le script
./github_pair_badge_automation.sh

Option 2: Script Python (Recommandé pour automatisation complète)

# Installer les dépendances
pip install requests

# Exécuter le script
python3 github_pair_badge.py

Option 3: Configuration par variables d'environnement

# Définir les variables d'environnement
export REPO_URL="https://github.com/username/repository.git"
export USER_NAME="Votre Nom"
export USER_EMAIL="votre-email@example.com"
export GITHUB_TOKEN="ghp_votre_token_optionnel"

# Exécuter le script Python
python3 github_pair_badge.py

⚙️ Configuration

Variables nécessaires:

1. URL du dépôt: Votre dépôt GitHub (format: https://github.com/user/repo.git)
2. Nom d'utilisateur: Votre nom GitHub
3. Email: Votre email associé à GitHub
4. Token GitHub (optionnel): Pour automatisation complète des PR

Obtenir un token GitHub:

1. Allez sur GitHub → Settings → Developer settings → Personal access tokens
2. Générez un nouveau token avec les permissions:
   • repo (pour les dépôts privés)
   • public_repo (pour les dépôts publics)
   • pull_request (pour créer des PR)

🔧 Fonctionnalités

Script Bash (github_pair_badge_automation.sh)

• ✅ Clonage automatique du dépôt
• ✅ Création de branche
• ✅ Modifications automatiques des fichiers
• ✅ Commit collaboratif avec co-auteurs
• ✅ Push automatique
• ✅ Instructions pour PR manuelle
• ✅ Support GitHub CLI (optionnel)

Script Python (github_pair_badge.py)

• ✅ Toutes les fonctionnalités du script Bash
• ✅ Création automatique de PR via API GitHub
• ✅ Merge automatique des PR
• ✅ Suppression automatique des branches
• ✅ Gestion avancée des erreurs
• ✅ Interface colorée
• ✅ Nettoyage automatique des fichiers temporaires

📝 Processus automatisé

1. Configuration: Collecte des informations utilisateur
2. Préparation: Clonage et préparation du dépôt
3. Branche: Création d'une nouvelle branche avec timestamp
4. Modifications: Ajout/modification de fichiers de documentation
5. Commit: Création d'un commit avec co-auteurs multiples
6. Push: Envoi des modifications vers GitHub
7. Pull Request: Création automatique ou manuelle
8. Merge: Fusion de la PR (automatique si token fourni)
9. Nettoyage: Suppression de la branche et des fichiers temporaires

🤝 Format du commit collaboratif

Le script génère automatiquement des commits avec le format:

feat: Add collaborative documentation for Pair Extraordinaire

This commit demonstrates pair programming practices
and collaborative development workflows.

Co-authored-by: GitHub Assistant <assistant@github.example>
Co-authored-by: Votre Nom <votre-email@example.com>

✅ Vérification du succès

Après exécution, vérifiez:

1. Commit multi-auteurs: Le commit doit afficher 2 avatars d'utilisateurs
2. Badge sur profil: Allez sur votre profil GitHub
3. Section Achievements: Le badge "Pair Extraordinaire" doit apparaître
4. Délai: Le badge peut prendre quelques minutes à s'afficher

🔍 Résolution de problèmes

Erreurs communes:

1. Authentification: Vérifiez vos credentials Git
2. Permissions: Assurez-vous d'avoir les droits sur le dépôt
3. Token: Vérifiez les permissions du token GitHub
4. Format email: Utilisez l'email exact associé à votre compte GitHub

Debug:

# Vérifier la configuration Git
git config --list

# Tester l'authentification GitHub
git ls-remote https://github.com/username/repository.git

# Vérifier les permissions du token
curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user

📁 Structure des fichiers créés

votre-repo/
├── README.md (modifié si existant)
├── COLLABORATION.md (nouveau fichier)
└── .git/

🔒 Sécurité

• Les tokens GitHub ne sont jamais stockés dans les fichiers
• Les répertoires temporaires sont automatiquement nettoyés
• Toutes les communications utilisent HTTPS
• Respect des meilleures pratiques Git

📞 Support

En cas de problème:

1. Vérifiez les prérequis
2. Consultez les logs d'erreur affichés
3. Vérifiez la configuration GitHub
4. Testez manuellement les étapes Git

⚠️ Note importante

Bien que ces scripts permettent d'obtenir le badge facilement, la meilleure pratique consiste à développer une véritable collaboration dans des projets open-source pour acquérir cette reconnaissance de manière organique.

🎉 Résultat attendu

Une fois le processus terminé avec succès:

• ✅ Votre dépôt contiendra un commit collaboratif
• ✅ Le badge "Pair Extraordinaire" apparaîtra sur votre profil
• ✅ Vous aurez démontré vos compétences en collaboration

---

Scripts créés pour l'automatisation du badge GitHub Pair Extraordinaire

🤝 Pair Programming: Contributing to open source with collaboration