benthayer / git-gud

C’est quoi ?

Bienvenue à Git Gud, un jeu en ligne de commande conçu pour vous aider à apprendre à utiliser le populaire système de contrôle de version connu sous le nom de Git !Au fur et à mesure que les niveaux progressent, vous en saurez de plus en plus sur git, et finirez par devenir un grand maître de git !

Si quelque chose manque, n’hésitez pas à ajouter un problème, ou si vous êtes intéressé, consultez le fichier des contributeurs et ajoutez quelque chose vous-même ! Le projet est intentionnellement structuré pour rendre très facile l’ajout de nouveaux niveaux !

Si vous êtes plus un apprenant visuel, vous devriez commencer par « Learn Git Branching », et puis donner à Git Gud un essai. Learn Git Branching est plus visuel, mais avec Git Gud, vous utilisez réellement git pour compléter les niveaux.

Comment puis-je l’utiliser ?

Pour les instructions d’installation, voir ci-dessous.

Une fois Git Gud installé, taper « git gud » produira une sortie et commencera à vous dire quoi faire.Git Gud est censé être comme un jeu, et comme un jeu, il a des niveaux.Les niveaux sont divisés en compétences, dont chacune vous introduira à un nouveau sujet dans Git.Il commence, en supposant que vous avez zéro connaissance, et puis se construit.Pour chaque niveau, il vous donnera un objectif et expliquera ce qui se passe.Idéalement, le jeu vous enseignera tout ce que vous devez savoir pour le battre, mais vous êtes toujours encouragé à utiliser d’autres ressources pour apprendre autant que vous voulez.

Les premiers niveaux du jeu commencent par vous habituer à l’interface de Git Gud, mais plus tard, les roues d’entraînement tombent, et vous devrez vous rappeler de taper les commandes.Si jamais vous oubliez quelles commandes il y a, ou si vous voulez commencer à un niveau ultérieur, vous pouvez toujours exécuter « git gud help « Les commandes les plus importantes sont git gud goal, git gud status, git gud explain git gud test, et git gud load next.D’autres commandes sont également utiles, mais la sortie de ces commandes devrait être suffisante pour vous guider à travers le niveau.

Pour commencer, vous devez initialiser Git Gud dans un répertoire vide.Une fois Git Gud initialisé, il aura le contrôle total de ce répertoire, et il commencera à ajouter/supprimer des commits et des fichiers.Il y aura normalement plusieurs branches, et vous devrez utiliser des commandes Git pour résoudre chaque niveau.Les niveaux varient en difficulté, et vous demandent de faire différentes choses.Certains niveaux sont vraiment faciles et ne nécessitent que de lire l’explication, mais d’autres vous donnent juste une situation et vous devrez utiliser ce que vous avez appris pour résoudre le niveau.

Comment installer

Git Gud est écrit en Python 3.Vous aurez besoin d’avoir Python >=3.6 installé dans votre système pour que Git Gud fonctionne.Je préfère utiliser Anaconda pour m’assurer que tout fonctionne correctement, mais vous pouvez également installer avec pip si vous savez maintenant ce que vous faites.

Une fois que votre environnement est configuré avec Python >=3.6, l’installation est simple:

pip3 install git-gud

Démarrer est également simple:

git gud

Git Gud vous guidera à travers ce qu’il faut faire

Si l’une ou l’autre de ces commandes ne fonctionne pas, il y a verious things you can try :

• Utiliser pip au lieu de pip3
• S’assurer que votre variable PATH inclut les exécutables Python
• Installation utilisateur : pip3 install --user git-gud
• Utiliser Anaconda

.