====== Projet : gestion de base ======

[[command-line:git|Retour à l'article Git]]

//Note : toutes les commandes relatives à un projet doivent être effectuée après s'être placé dans le dossier du projet//
<code bash>cd /to/the/source/directory
#les lecteurs "windows" sont indiqués par /d/ au lieu de D:\ dans le bash de git
cd /d/project-directory/source-directory</code>

===== Configurer un projet =====
Initialiser le projet (créé un sous-dossier ".git") :
<code bash>git init</code>

==== Nouveau projet ====

"Ajouter" chaque fichier source qu'on veut versionner à git :
<code bash>
git add <filepattern>
</code>
Exemples :
<code bash>
git add fichier.c
git add *.c
git add *
</code>
//Note : sauf erreur de ma part, '*' ne prend pas en compte les sous-répertoires et leurs contenus.//

Une fois le projet lancé, git add continue à servir pour indexer les nouveaux fichiers ajoutés au projet, mais aussi pour indexer les fichiers modifiés. Pour faire d'un coup l'indexation de toutes les modifs :
<code bash>
git add .    #stage new and modified files
git add -u   #stage modified and removed files

git add -A   #stage new, modified and removed files
</code>
==== Projet existant ====
Pour partir d'un projet déjà présent dans un dépôt (repository) git (local ou distant) :
<code bash>
git clone <local-path>/<project>.git
git clone git://<git-url>/<project>.git
git clone http(s)://<url>/<project>.git
</code>
//Note : un dossier <project> sera créé. Il faut donc se placer dans le dossier parent de celui où on voudra placer les sources.//

===== Informations =====

==== Etat des fichiers ====

Pour connaître l'état d'un fichier (suivi, non suivi, modifié, indexé, etc...) :
<code bash>git status</code>

Pour avoir des informations plus détaillées :
<code bash>
git diff           #compare your version with your staged version
git diff --cached  #compare your staged version and the last commited version
git diff --staged  #same as --cached
</code>

==== Historique : accès aux commits ====
Lister les commits (et leurs commentaires)
<code bash>
git log
git log -p         #shows the diff introduced in each commit
git log -<number>  #shows only the last <number> commits
git log --since=2.weeks  #shows only commits for the past 2 weeks
git log --stat     #gives a few stats (nb of files changed, lines added or removed)
git log --pretty=format:"%h %s" --graph  #shows a view of branches and merges
</code>

===== Préparer un commit =====
Marquer un fichier comme prêt à être commité suite à modification se fait aussi via la commande git add. Il sera alors considéré comme indexé.

Si on "git add" plusieurs fois d'affilé un même fichier (suite à des modifs), seule la dernière version est conservée, tandis que si on effectue un commit à chaque fois, alors toutes les versions seront dans le dépôt.

===== Commit =====
Une fois les modifications indexées, on peut enfin commiter, c'est-à-dire transmettre cette version indexée au dépôt local.
<code bash>
git commit
git commit -v              #verbose: shows the diff while you write the comment
git commit -m "Message..." #to write the commit comment directly in command-line
git commit -a              #skips the staged area and commit directly your version
</code>
Un fichier texte s'ouvre dans l'éditeur de texte défini par défaut dans la config de git, pour permettre la saisie du commentaire du commit.
<code bash>git config --global core.editor "'C:\Program Files\Sublime Text 2\sublime_text.exe' -w"</code>
...pour définir Sublime Text 2 comme éditeur par défaut.

Si vous commettez un erreur lors de votre dernière commit, il est toujours possible de la rattraper. Après avoir apporté la modification en local puis l'avoir indexée :
<code bash>git commit --amend</code>

===== Ignorer des fichiers =====
Pour exclure certains fichiers ou types de fichiers de nos commit, il faut créer un fichier .gitignore et y lister les éléments à exclure.
<code bash>
file.ext
/README         #ignore the root README, but not ones in subdirectories
*.doc
!test.doc       #exception for rules listed above : test.doc will NOT be ignored
thisDirectory/  #...and everything in it
#or any glob syntax, including: [aoe], [0-9], *, ?
</code>

===== Retirer des fichiers =====
Pour supprimer un fichier partout :
<code bash>
git rm Supprime-Moi.txt
git commit -m "Suppression de fichier inutile"
</code>
Git rm retire le fichier du dossier de travail et de la version indexée, donc il faut ensuite effectuer un commit pour appliquer la modif au dépôt. L'historique du fichier reste dans le dépôt.

Par contre si vous ajoutez un fichier au .gitignore un peu tard et qu'il est déjà indexé ou commité, il faut ajouter --cached à la commande. Le comportement sera identique sauf que le fichier ne sera pas supprimé du dossier de travail.
<code bash>
git rm --cached Supprime-Moi.txt
</code>

===== Déplacer/Renommer un fichier =====
Comme la commande mv de linux. Cela évite de déplacer/renommer le fichier à la main, puis de supprimer l'ancien des fichiers indexés et d'y ajouter le nouveau.
<code bash>git mv source.txt directory/destination.txt</code>

===== Désindexer =====
Si vous avez ajouté à la version indexée un fichier et voulez l'en retirer :
<code bash>git reset HEAD monFichier.php</code>

===== Annuler les modifications d'un fichier =====
Si vous voulez écraser un fichier pour revenir à la dernière version indexée ou commitée
<code bash>git checkout -- monFichier.php</code>
Attention cependant : toute modification apportée localement sera perdue.

====== Dépôts distants ======
Les dépôts distantssont des répertoires hébergeant les versions d'un projet généralement à distance (internet, réseau). Cela permet d'y conserver toutes les sauvegardes, d'y travailler à plusieurs, etc...

===== Informations =====
<code bash>
git remote          #lists all remotes configured for the current project
git remote -v       #same list with urls
</code>
Chaque dépôt distant comporte un nom librement choisi par l'utilisateur

Plus de détails sur un dépôt distant :
<code bash>
git remote show custom-name
</code>

===== Ajout d'un dépôt distant =====
<code bash>
git remote add custom-name git://git@domain.com/path/project.git
git remote add custom-name https://domain.com/path/project.git
git remote add custom-name /d/path/to/local/remote/project.git
</code>

===== Récupérer les données d'un dépôt distant =====
<code bash>
git fetch custom-name
git pull custom-name
</code>
Si fetch récupère les information, il ne les fusionne pas avec les versions locales, contrairement à pull.

Quand on a récupéré un projet existant via clone, le nom attribué au dépôt distant est par défaut origin. Pour le mettre à jour par la suite :
<code bash>
git fetch origin
</code>

Lors du clone, on peut directement définir le nom souhaité 
<code bash>
git clone -o <remote-name> git://<git-url>/<project>.git
</code>

===== Transmettre des données à un dépôt distant =====
Lorsqu'on commit, la version est stockée dans le dépôt local (sous-répertoire .git de notre projet). Pour transmettre ces données au dépôt distant :
<code bash>
git push <remote name> <branch name>
</code>
La branche par défaut est master, tout comme le nom de dépôt distant par défaut est origin. Souvent vous n'aurez qu'à faire :
<code bash>
git push origin master
</code>
//Note : certains serveurs ne vous seront accessible qu'en lecture : vous pourrez faire des pull, mais pas de push//

===== Renommer/Retirer un dépôt distant =====
<code bash>
git remote rename old-name new-name  #rename remote
git remote rm custom-name            #remove remote
</code>