A quoi sert GitDTL ?
GitDTL est une interface Windows pour utiliser Git sans devoir en connaître par coeur les commandes. Le menu transforme les opérations Git courantes en actions simples : regarder l'état du projet, enregistrer des fichiers, valider, publier sur GitHub, synchroniser, créer une version et consulter le journal.
Idée importante : GitDTL ne remplace pas Git. Il lance les commandes Git à votre place, dans le dossier du projet choisi, et vous montre aussi la dernière commande envoyée en bas de l'écran pour information (et formation). Exemple :
Commande envoyée :git status --porcelain
Parcours recommandé
Pour travailler avec la logique Git, suivez ce chemin :
Après une première activation, GitDTL met l'option 1 en surbrillance au lancement pour encourager ce réflexe.
Premier lancement
- Au premier démarrage, GitDTL affiche un écran de bienvenue.
- Il demande ensuite quel dossier vous voulez gérer.
- Vous pouvez créer un nouveau projet ou choisir un projet existant.
- Si le dossier n'est pas encore un dépôt Git, GitDTL propose de le créer localement avec
git init. - Attention : GitDTL ne crée pas de dépôt automatiquement sur le site Web de GitHub, cela doit être fait manuellement.
Le bouton Changer de projet permet de sélectionner un autre dossier à tout moment.
Comprendre les couleurs et les repères
- Les textes en vert correspondent à l'ambiance Terminal DTL et aux informations principales.
- La surbrillance ambre indique les étapes conseillées.
- La ligne du bas affiche la dernière commande Git lancée.
- Si vous choisissez une option qui ne lance pas Git, cette ligne s'efface.
Quand l'option 1 signale que des éléments ne sont pas encore validés, GitDTL met en surbrillance l'étape suivante : option 4 s'il faut encore enregistrer les fichiers, option 6 si tout est déjà prêt pour une validation.
Les options du menu
| Option | Quand l'utiliser | Ce que fait GitDTL |
|---|---|---|
| 1 | Au début, après une modification, après une publication. | Affiche le nombre de fichiers modifiés, non suivis, et indique si le projet est prêt à publier. |
| 2 | Quand vous voulez voir le détail des changements. | Affiche un résumé, puis les différences non enregistrées et celles déjà ajoutées au prochain commit. |
| 3 | Pour ajouter un nouveau fichier qui n'est pas encore connu de Git. | Vous choisissez un ou plusieurs fichiers. GitDTL ajoute seulement les fichiers réellement nouveaux. |
| 4 | Pour enregistrer des fichiers modifiés ou non suivis avant validation. | GitDTL détecte les fichiers concernés, demande confirmation, puis lance git add. |
| 5 | Pour retirer un fichier ou un dossier du projet. | Vous choisissez l'élément, puis vous décidez de le supprimer du disque ou seulement du suivi Git. |
| 6 | Quand les changements ont été enregistrés et doivent entrer dans l'historique. | GitDTL demande une description puis lance git commit -m "...". |
| 7 | Quand vous voulez envoyer le projet sur GitHub. | GitDTL vérifie l'état du projet, configure GitHub si besoin, puis lance git push. |
| 8 | Quand vous voulez publier une version officielle. | GitDTL crée un commit de version, un tag annoté, pousse le commit puis pousse le tag. |
| 9 | Pour revoir les dernières validations. | Affiche les 30 derniers commits avec git log --oneline -30. |
| 10 | Quand GitHub contient peut-être des changements absents du PC. | Lance git pull et affiche le résultat. |
| 11 | Quand quelque chose semble confus. | Affiche un diagnostic : état Git, branche, remote GitHub, fichiers modifiés, fichiers non suivis et dernier commit. |
| 12 | Pour vérifier ce que GitDTL a fait. | Ouvre le journal, avec boutons pour actualiser, effacer après confirmation ou exporter une copie. |
| 13 | Pour ouvrir la page GitHub du projet. | Lit l'adresse du remote origin et ouvre l'URL GitHub dans le navigateur. |
| 14 | Pour consulter la documentation intégrée du projet. | Affiche le fichier README.md du projet dans une fenêtre markdown. |
Publier sur GitHub
L'option 7 lance une publication, mais GitDTL vérifie d'abord plusieurs points.
- Si des fichiers ne sont pas encore validés, GitDTL les liste et demande si vous voulez publier quand même.
- Si aucun dépôt GitHub n'est configuré, GitDTL demande l'adresse du dépôt et crée ou met à jour en local le "remote"
origin. - Si la branche locale n'a pas encore de branche GitHub associée, GitDTL peut corriger le problème avec
git push --set-upstream origin <branche>.
Conseil : avant de publier, utilisez l'option 1. Si GitDTL indique que le projet n'est pas prêt, suivez la surbrillance proposée.
Suppression et fichiers ignorés
L'option 5 propose deux comportements :
- Retirer et supprimer : l'élément est retiré du suivi Git et supprimé du disque.
- Retirer mais conserver : l'élément reste dans le dossier, il est retiré du suivi Git et ajouté dans
.gitignore.
Après certaines vérifications, GitDTL peut aussi proposer d'ajouter des dossiers Python courants comme __pycache__/ ou logs/ dans .gitignore.
Créer une version
L'option 8 permet de marquer officiellement une version importante du projet dans l'historique Git.
GitDTL demande un numéro de version (par exemple 1.0.0), ajoute automatiquement le préfixe « v », puis affiche les commandes qui vont être exécutées :
git commit -m "Version 1.0.0" git tag -a v1.0.0 -m "Version 1.0.0" git push git push origin v1.0.0
Utilisez cette option lorsqu'une étape importante du développement est terminée et doit pouvoir être retrouvée facilement par la suite.
Le tag créé (par exemple v1.0.0) constitue un repère permanent dans l'historique Git.
Attention : cette action crée un tag Git et l'envoie vers GitHub, mais elle ne crée pas automatiquement une Release GitHub. Si vous souhaitez publier officiellement la version, vous devrez créer la Release manuellement depuis GitHub.
Journal et diagnostic
GitDTL écrit un journal dans :
logs\gitdtl.log
Ce journal contient les commandes Git envoyées, les erreurs et les actions importantes. L'option 12 permet de le lire, de l'actualiser, de l'effacer après confirmation ou de l'exporter.
L'option 11 donne un diagnostic plus court et lisible, utile avant de demander de l'aide.
Sécurité et limites
- GitDTL demande confirmation avant les actions sensibles : suppression, publication avec fichiers non validés, création de version, effacement du journal.
- Les commandes Git sont lancées silencieusement sous Windows : aucune fenêtre console noire ne doit apparaître.
- GitDTL travaille dans le dossier de projet affiché en haut de l'écran. Vérifiez ce chemin avant une action importante.
- GitDTL ne crée pas le dépôt GitHub sur le site GitHub : il configure l'adresse d'un dépôt déjà créé.
En cas de problème
- Lancez l'option 1 pour voir l'état du projet.
- Lancez l'option 11 pour obtenir un diagnostic.
- Ouvrez l'option 12 pour consulter le journal.
- Si une erreur Git s'affiche, lisez le conseil du système expert lorsqu'il est proposé.
- Vérifiez que Git est installé et disponible dans le
PATHWindows.