Contrôle de version : git - Hydro-Informatics

Le concept¶

git est un système de contrôle (version) rapide, évolutif et distribué, initialement développé par Linus Torvalds (en savoir plus sur le noyau git]. git permet de coordonner le travail entre collaborateurs au-delà de la programmation, dans n’importe quel ensemble de fichiers. Son soutien aux flux de travail non linéaires, à la vitesse et à l’intégrité des données en fait un outil indispensable dans de nombreuses industries et recherches. Avant de commencer à lire ce tutoriel git, regardez le fonctionnement schématique des dépôts hébergés avec git.

git-scheme — Le concept de vocabulaire git et de base. Le cadre REMOTE est en ligne (c’est-à-dire l’ordinateur de quelqu’un d’autre) et le cadre LOCAL est ce qui se passe sur un ordinateur personnel, qui est connecté à Internet. Les dépôts peuvent être nouvellement créés ou fourrés à distance. Les dépôts à distance peuvent être clonés localement, modifiés localement et les modifications locales peuvent être poussées vers un dépôt à distance. Les collaborateurs veulent s’assurer de tirer régulièrement les modifications d’un dépôt distant. Travailler avec et sur différentes branches devient de plus en plus important avec le nombre de développeurs et pour le moment nous devons juste nous rappeler que nous commençons à travailler dans la branche principale (c.-à-d., origine en amont / HEAD = main).

Installer git¶

Les documents fournis avec ce livre électronique sont les mieux téléchargés et mis à jour en utilisant des environnements git (éviter de télécharger les documents sous forme de fichier zip).

Linux

Windows

macOS

Bien que git soit une caractéristique intégrale de la plupart des distributions Linux, les utilisateurs de Debian pourraient encore avoir besoin de l’installer. À cette fin, ouvrez Terminal et tapez :

sudo apt install git

Les utilisateurs macOS peuvent utiliser Homebrew pour installer git, mais il existe d’autres options, comme Xcode.

Pour utiliser Homebrew pour installer git, commencez par installer Homebrew par le macOS Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

L’installation de Homebrew peut prendre un certain temps. Après l’installation, assurez-vous d’exporter la variable PATH requise (copier ligne par ligne):

echo 'eval $(/opt/homebrew/bin/brew shellenv)' >> /Users/$USER/.zprofile
eval $(/opt/homebrew/bin/brew shellenv)

Il est possible que les chemins des commandes ci-dessus doivent être adaptés aux répertoires que l’installateur Homebrew invite à la fin de son installation.

Enfin, installer git avec Homebrew :

brew install git

En fin de compte, Homewbrew fournit beaucoup d’autres paquets, qui sont essentiellement utiles pour les développeurs, tels que ruby ou React (aller à la liste complète des paquets).

Read more installation instructions and about options for git on macOS at https://git-scm.com/download/mac.

Les dépôts de ce cours sont principalement hébergés sur GitHub. Il y a beaucoup d’autres fournisseurs de services git, comme GitLab, plan.io, ou BitBucket.

Créer un dépôt¶

Pour créer un dépôt git, assurez-vous d’avoir accès à un fournisseur git. La façon la plus populaire d’accéder à un serveur git-able est de s’inscrire avec un serveur sur la longue liste de fournisseurs git populaires.

Clone (Télécharger) un dépôt¶

GitHub fournit des descriptions détaillées et des procédures standard pour travailler avec leurs dépôts (read more]. Les guides “recette” suivants à travers la première fois télécharger des matériaux git

Ouvrez votre ligne de commande git préférée :
- Windows Options : PowerShell, Git Bash ou *Commandement
- Linux: Terminal
Cloner le dépôt de cours (changer le matériel selon le cours) :
git clone https://github.com/hydro-informatics/materials (ou tout dépôt que vous voulez cloner)

C’est fait.

Tirer (Mise à jour/Re-Télécharger) un dépôt local¶

git (dans Git Bash, PyCharm ou Terminal) est la seule option pour mettre à jour de façon uniforme les copies locales d’un dépôt distant. Pour ce faire, ouvrez l’une des lignes de commande git ci-dessus et faites ce qui suit :

Go to the local directory of the repository with the cd command (e.g., materials):
cd "D:/Python/materials/" (or wherever materials was cloned).
git status - montre les modifications apportées.
Les erreurs de fusion peuvent survenir lorsque des modifications ont été apportées à la copie locale. Pour éviter les erreurs de fusion, tapez :
git pull --rebase - si les scripts modifiés localement ont été modifiés à distance depuis le dernier tirage, cela va provoquer des problèmes et mettre en évidence des sections problématiques avec >>> ). Ouvrir manuellement les fichiers concernés et résoudre les problèmes (supprimer les points forts >>>).
git push

C’est fait.

Mettre à jour un dépôt à distance (Modifications locales de push)¶

Après avoir édité les fichiers dans un dépôt localement, add - commit - push (dans cet ordre) vos modifications à la copie distante du dépôt avec contrôle de version. Vers add - commit - push modifications locales à un dépôt distant, assurez-vous d’être le propriétaire du dépôt distant ou un contributeur. Ouvrez ensuite un terminal git-able et tapez :

git status - cela montre les modifications apportées.
Si le statut semble correct avec les modifications consciemment faites, tapez git add .
Optionally, si seulement des fichiers uniques ont été modifiés, utilisez git add filename.py à la place. Meilleure solution : utiliser un fichier local .gitignore.
Commettez les changements git commit -m "Leave a message" - laissez un message court significatif et précis.
git pull --rebase - si les scripts modifiés localement ont été modifiés à distance depuis la dernière traction, cela va provoquer des problèmes et mettre en évidence des sections problématiques avec >>>. Ouvrir manuellement les fichiers concernés et résoudre les problèmes (supprimer les points forts >>>).
git push

Summary for updating a repository

Appuyez sur ce qui suit dans Terminal ou GitBash pour télécharger toutes les modifications dans un dépôt local vers le dépôt distant (veuillez vous assurer de savoir dans quel dossier votre dépôt est situé sur votre ordinateur - ceci définit ce que vous devez saisir pour /change-directory-to/repository/):

cd /change-directory-to/repository/
git status
git add .
git commit -m "Leave a commit message"
git pull --rebase
git push

En cas d’erreur, lisez attentivement pourquoi l’erreur s’est produite et suivez les instructions pour le dépannage (p. ex., pour configurer votre utilisateur avec git config --global user.email “email@example.com”). Vous pouvez ignorer les messages d’avertissement concernant les formats line-end (WARNING ... LF se termine ...) pour la plupart des applications présentées dans ce livre électronique.