Travailler avec GitHub depuis PyCharm

10.1 Clonage du dépôt

Souviens-toi, je t'ai parlé des 3 endroits pour stocker des fichiers? Rappel : il y a le dépôt distant, le dépôt local et le répertoire de travail.

Eh bien, maintenant tu devras cloner ton dépôt distant (que tu as créé sur GitHub) dans ton dépôt local (celui qui est sur ton ordinateur).

Alors lance PyCharm et commençons…

Étape 1. Si tu n'as pas encore créé de projets, alors choisis le bouton :

Si tu en as créé, alors :

Étape 2. Indique l'url de ton dépôt distant, que tu veux cloner sur ton ordinateur.

Cette méthode est utile si tu clones le dépôt de quelqu'un d'autre.

Si tu clones le tien, ce sera plus simple si tu te connectes directement à GitHub via PyCharm.

Étape 3. Ne fais confiance à personne. Même pas à toi-même.

PyCharm te prévient de ne pas exécuter de code provenant de dépôts inconnus. Comme c'est ton propre dépôt, coche la case "faire confiance".

Étape 4. Si tu es sous Windows, l'antivirus standard te préviendra de l'apparition de fichiers qu'il ne connaît pas. Les antivirus n'aiment généralement pas les programmes qui leur sont inconnus.

MAIS! On va créer ces programmes, donc on dit à l'IDE de demander à l'antivirus de ne pas bloquer tes futurs programmes. Clique sur le bouton « Automatically », puis — « YES ».

10.2 Premier commit

Si tu as cloné un nouveau dépôt, il contiendra seulement un fichier — README.md

Étape 1. Ouvre le fichier README.md.

Important! L'extension md signifie Markdown – c'est un format primitif de stylisation des fichiers texte. Tu peux voir comment il fonctionne en cliquant sur le bouton en haut à droite.

Modifie ce fichier comme tu le souhaites : tu peux écrire n'importe quel message de bienvenue ou une description du dépôt...

Étape 2. Une fois les modifications apportées au fichier, PyCharm commence à l'afficher en bleu dans l'arborescence des fichiers à gauche. Les fichiers modifiés sont marqués en bleu, si les modifications dans ton répertoire de travail n'ont pas encore été apportées à ton dépôt local.

Étape 3. Commit.

Après avoir apporté toutes les modifications prévues aux fichiers, et vérifié qu'elles sont correctes, il faut les pousser dans ton dépôt git local. Pour l'instant, elles se trouvent uniquement dans ton répertoire de travail.

Pour cela, clique sur le bouton Commit et coche tous les fichiers dont les modifications doivent être poussées dans le dépôt local :

Étape 4. En bas à gauche, ajoute un commentaire décrivant tes modifications.

Étape 5. Et appuie sur le bouton « Commit ».

Étape 6. Vérification.

Retourne dans ton projet et vérifie la couleur des fichiers : si les fichiers ne sont plus en bleu, cela signifie que toutes les modifications de ton répertoire de travail ont été apportées avec succès à ton dépôt local.

10.3 Travailler avec les fichiers

Étape 1. Créons quelques fichiers dans PyCharm.

On écrit du code en Python — ce seront donc des fichiers :

1. main.py
2. init.py

Étape 2. Ajouter le fichier au dépôt local.

Dès que PyCharm voit que tu as créé un fichier, il propose immédiatement de l'ajouter à ton dépôt local. PyCharm suit les modifications uniquement des fichiers de ton répertoire de travail qui se trouvent déjà dans ton dépôt local. Ces fichiers, et seulement eux, seront marqués en bleu.

Si le fichier est dans ton répertoire de travail, mais pas dans le dépôt local, il est marqué en rouge, comme sur l'image ci-dessous :

En principe, tu peux toujours cliquer sur Add, mais cette fois, cliquons sur « Cancel » puis ajoutons le fichier manuellement. Pour que tu te souviennes comment faire.

Étape 3. Écris ton code préféré dans le fichier.

Par exemple, j'ai écrit : print("first commit")

Étape 4. Ajoutons maintenant notre fichier main.py dans le dépôt local.

Clique simplement n'importe où dans le fichier avec le bouton droit de la souris et choisis Git -> Add File

Si tout s'est bien passé, le fichier ajouté sera en vert.

Étape 5. Ensuite, committons le fichier comme d'habitude :

10.4 Premier push

Maintenant, il faut pousser nos modifications du dépôt local vers le dépôt distant sur GitHub. Quand plusieurs programmeurs travaillent sur un même projet, c'est comme ça qu'ils synchronisent leurs modifications de code.

Étape 1. Clique sur le bouton Push.

En fait, c'est très simple à faire : il suffit d'utiliser le bouton Push dans le menu supérieur de l'IDE :

Étape 2. Confirmer les commits apportés.

À cette étape, tu peux vérifier toutes les modifications apportées et t'assurer de ne rien avoir cassé d'important par accident. Ou de ne pas avoir oublié d'ajouter un fichier dont dépendent d'autres fichiers.

Étape 3. Vérification.

Si tout s'est bien passé, tu verras des messages de ce genre :

Étape 4. Et maintenant, ouvre ton dépôt GitHub et vérifie :

La magie des technologies!

10.5 Utilisation des fichiers .gitignore

Si tu as ajouté des fichiers système à ton projet et que tu ne veux pas qu'ils se retrouvent par accident sur GitHub, tu peux les ajouter à des exceptions. Pour cela, il y a un fichier nommé «.gitignore». C'est très simple et pratique.