Skip to content

Latest commit

 

History

History
151 lines (97 loc) · 4.71 KB

slides.md

File metadata and controls

151 lines (97 loc) · 4.71 KB

% Git : Historique, commandes de base

marp: true

<style> section { font-size: 22pt; } h1 { font-size: 1.6em; margin:0 0; padding:0 0; } h2 { font-size: 1.4em; margin:0 0; padding:0 0; } h3 { font-size: 1.2em; margin:0 0; padding:0 0; } </style>

1. Problème

2. Problème

2bis. Problèmes combinés

À partir de ces documents donc, d'après vous, quels besoins éprouvent les utilisateur-rice-s ?

3. Problème(s)

  • À partir de ces documents, les besoins éprouvés peuvent être :
    • Comprendre les versions
    • Pouvoir revenir en arrière, avoir une "trace"
    • Pouvoir avoir une collaboration simple

4. Git : un outil de versionnage

  • Date d'avril 2005, créé par le créateur du noyau Linux Linus Torvalds et par Junio Hamano
  • Sous licence libre GNU GPLv2
  • Version 2.43 actuellement (novembre 2023)
  • Autres outils :

5. Git : Principes généraux (le .git)

  • Travail dans un repository (dépôt en français) == un dossier
    • Il contient un dossier (souvent caché) .git qui contient toutes les archives enregistrées
  • Contrairement à Dropbox ou Google Drive, pour qu'une modification soit archivée, il faut que cela soit explicité
    • Ces modifications archivées sont appelées "commit"
    • Elles portent un message enregistré par l'utilisateur
    • Elles peuvent comporter plusieurs fichiers
    • Les fichiers qui ont subi des modifications doivent y être ajoutés explicitement

6. Git : Principes généraux (les états des fichiers)

On distingue trois "états" des fichiers

  • un état de travail : le fichier a subi des modifications, mais nous ne l'avons pas encore ajouté (add) à un futur commit
  • un état de futur enregistrement : le fichier a été ajouté (add) à un commit, mais le commit n'a pas été finalisé avec un message
    • Appelée staging area, ou stage
  • un état archivé : le fichier a subi des modifications enregistrées et n'a pas été modifié depuis lors.

7. Git : Commandes principales

  • Initialisation : git init
  • Ajout de modifications : git add [Nom du fichier] ou git add -A (Ajout de tous les fichiers changés)
  • État du dépôt : git status (donne la liste des modifications réalisées)
  • Enregistrement de modifications : git commit -m "Message du commit". N'oubliez jamais le -m à moins de vouloir passer un mauvais moment.
  • Historique du repository : git log
  • Différence entre l'état archivé et l'état actuel : git diff pour une différence détaillée, git status pour un point général.

8. Changer les couleurs si difficiles à lire

9. Importance des messages

10. Précisions techniques

Contrairement à ce que l'on pourrait penser, Git n'archive ou ne sauvegarde pas vos fichiers. Ce qu'il sauvegarde, ce sont les modifications apportées à des fichiers. Par exemple, si je crée un fichier toto.txt qui contient "toto" en ligne 1, il enregistrera:

-> Nouveau(toto.txt)
-> Content(toto.txt, "toto")

Si ensuite, j'ajoute une nouvelle ligne:

-> Content(toto.txt, "\nune nouvelle ligne")

Où \n est un retour à la ligne.

11. Par conséquent (premieres bonnes pratiques):

Git est performant avec des fichiers simples (code source), du texte.
Il est bien moins performant avec des fichiers complexes.
Il possède d'ailleurs son propre système de compression.

  • On évite les formats "compilés" / "compressés" :

    • Images
    • Fichiers et archives compressés (zip etc)

  • On évite d'inclure les fichiers lourds, redondants, mis à jour fréquemment:

    • base de données
    • les fichiers binaires, journaux, résultats de suivi ou données de diagnostic
      Ce sont des sorties de votre code, pas le code source lui-même.
      Partagez ce type de fichiers de suivi avec votre équipe via des outils de suivi/partage de fichiers, non pas un dépôt de versionnage.

  • On évite d'inclure les fichiers périphériques au code (bibliothèques Python, etc) :
    Ces dépendances sont souvent listées dans un fichier texte, et elles sont installées séparemment.
    Vous avez peut-être déjà croisé la commande pip install -r requirements.txt ?

Crédits