Différences

Ci-dessous, les différences entre deux révisions de la page.

--- informatique:git [2020/06/18 07:29] – [Des alias pour gagner du temps] alexis
+++ informatique:git [2024/12/03 07:24] (Version actuelle) – alexis
@@ Ligne 1: / Ligne 1: @@
+{{tag>todo}}
 ====== Git ======
+<catlist informatique:git -sortByTitle -noHead>
 <WRAP todo>
-Séparer la page comme celle pour mysql
-</WRAP>
-===== Configuration =====
-Il est possible de modifier les préférences en utilisant soit git directement soit en modifiant son fichier de configuration.
-<WRAP group>
-<WRAP half column>
-==== En ligne de commande ====
-<code bash>
-git config --global user.name "Nom et prénom de l'utilisateur" # Nom de l'utilisateur
-git config --global user.email "Adresse email de l'utilisateur" # Adresse email de l'utilisateur
-git config --global color.ui "auto" # Colorisation des résultats
-git config --global core.editor vim # Choix de l'éditeur par défaut
-git config --global help.autocorrect 1 # Auto-correction des commandes
-git config --global core.autocrlf false # Non conversion du caractère de fin de ligne
-git config --global commit.template <filename> # Utilisation d'un modèle de message pour la validation
-git config --global alias.st 'status' # Création d'un alias de la fonction "status"
-</code>
-<WRAP alert>
-Pour supprimer un élément de la configuration, il suffit d'ajouter l'option ''%%--unset%%'' lors de l'utilisation de la commande. Par exemple :
-<code bash>
-git config --global --unset user.name
-</code>
-</WRAP>
-<WRAP tip>
-En utilisant ''%%--global%%'', la configuration s'applique à l'utilisateur courant. Il est possible de changer ce comportement en utilisant d'autres options :
-  * Avec ''%%--system%%'', la configuration s'applique à tous les utilisateurs de la machine.
-  * Avec ''%%--local%%'', la configuration s'applique au dépôt courant. Dans ce cas, il faut bien sur se trouver dans un répertoire géré par git.
-</WRAP>
-</WRAP>
-<WRAP half column>
-==== Avec un fichier de configuration ====
-Le fichier a modifier est le fichier //.gitconfig// à la racine du répertoire de l'utilisateur. Il est généré automatiquement lors de l'utilisation des commandes de configuration.
-<code ini>
-[user]
-        email = Adresse email de l'utilisateur
-        name = Nom et prénom de l'utilisateur
-[core]
-        editor = vim
-        autocrlf = false
-[color]
-        ui = auto
-[help]
-        autocorrect = 1
-[alias]
-        st = status
-[commit]
-        template = <filename>
-</code>
-<WRAP alert>
-Pour supprimer un élément de la configuration, il suffit de l'enlever du fichier de configuration.
-</WRAP>
-<WRAP tip>
-En modifiant le fichier ''.gitconfig'', la configuration s'applique à l'utilisateur courant. Il est possible de changer ce comportement en modifiant d'autres fichiers :
-  * En modifiant le fichier ''/etc/gitconfig'', la configuration s'applique à tous les utilisateurs de la machine.
-  * En modifiant le fichier ''.git/config'', la configuration s'applique au dépôt courant. Dans ce cas, il faut bien sur se trouver dans un répertoire géré par git.
-</WRAP>
-</WRAP>
-</WRAP>
-<WRAP info>
-Lorsque l'autocorrection des commandes est activée, git essaye de trouver une correspondance dans les commandes existantes. S'il existe plusieurs possibilités, elles seront affichées à l'utilisateur. S'il n'existe qu'une seule possibilité, elle sera exécutée automatiquement.
-</WRAP>
-<WRAP info>
-Lorsqu'un fichier modèle de message est utilisé pour la validation, celui-ci est affiché à chaque validation. Les lignes de commentaires ((Les lignes qui commencent par ''#'')) ne seront pas utilisées lors de la validation.
-Cela permet de :
-  * donner des indications sur ce que doit contenir le message de validation,
-  * faciliter la rédaction du message de validation en y intégrant les données obligatoires automatiquement.
-</WRAP>
-==== Des alias pour gagner du temps ====
-En plus de raccourcir certaines commandes, les alias permettent aussi de combiner des actions répétitives en une seule commande.
-Voici les alias que j'utilise actuellement.
-<code ini .gitconfig>
-[alias]
-        ; List aliases
-        alias = !git config --get-regexp '^alias\\.' | sed --expression s/^alias\\.// --expression s/\\ /\\\\t\\ / | sort
-        ; Amend content to the last commit
-	amend = commit --amend --no-edit
-        ; Check for whitespace errors
-        check = diff --check HEAD
-        ; Fixup a commit into another
-        fixup = !sh -c 'git stash --keep-index && SHA=$(git rev-parse $1) && git commit --fixup $SHA && GIT_SEQUENCE_EDITOR=: git rebase --interactive --autosquash $SHA~ && git stash pop' -
-	; Show branch ordered by last working time
-	last-work = branch --sort='-committerdate' --format='%(color:green)%(committerdate:relative)%(color:reset) %(refname:short) --color=always'
-        ; Show log on oneline
-        oneline = log --oneline --abbrev-commit --graph
-        ; Retrieve a PR locally
-        pr = !sh -c 'git fetch ${2:-origin} pull/$1/head:pr/$1 && git checkout pr/$1' -
-        ; Prune local tags that don't exist on remote
-        pt = !git tag -l | xargs git tag -d && git fetch -t
-</code>
-<WRAP info>
-La commande '':'', utilisée comme éditeur dans la variable ''GIT_SEQUENCE_EDITOR'', fait partie des commandes incluses dans Bash. Voir [[https://www.gnu.org/software/bash/manual/html_node/Bourne-Shell-Builtins.html#Bourne-Shell-Builtins|ici]] pour plus d'informations.
-</WRAP>
-FIXME Ajouter une section sur les préférences de l'utilisateur par dépot
 <code bash>
 # Ajouter un dépôt distant
 git remote add <nom> <url>
 </code>
-===== Utilisation =====
-==== Utiliser les logs ====
-L'ensemble de ces commandes sont utilisables pour un fichier particulier en ajoutant ''%%-- <file_path>%%'' à la fin de la commande.
-<code bash>
-# Afficher les logs
-git log
-# Afficher les logs avec les statistiques
-git log --stat
-# Afficher les logs des n dernières révisions
-git log -n
-# Afficher les logs sur une ligne
-git log --oneline
-# Afficher les logs entre 2 révisions
-git log <commit>..<commit>
-# Afficher l'historique condensé des révisions
-git log --pretty=oneline --abbrev-commit --graph --decorate
-# Afficher la liste des tags par date
-git log --date-order --graph --tags --simplify-by-decoration --pretty=format:'%ai %h %d'
-</code>
-==== Utiliser les commits ====
-  * Révisionner du code
-<code bash>
-# Ajouter les fichiers à révisionner
-git add <file1> <file2>
-# Révisionner les modifications
-git commit
-# À ce moment, l'éditeur de texte par défaut va s'ouvrir pour ajouter un message à la révision
-# Il est aussi possible de faire tout ça automatiquement
-git commit -a -m <message>
-</code>
-  * Annuler l'ajout d'un fichier dans l'index
-<code bash>
-git reset HEAD <file>
-</code>
-  * Modifier le nom de l'utilisateur de la dernière révision
-<code bash>
-# Attention, l'utilisation de cette commande est déconseillée si le code a été partagé.
-git commit --amend --reset-author
-</code>
-  * Modifier la dernière révision (([[http://stackoverflow.com/questions/179123/how-do-i-edit-an-incorrect-commit-message-in-git#179147|How to modify existing, unpushed commits?]]))
-<code bash>
-# Attention, l'utilisation de cette commande est déconseillée si le code a été partagé.
-git commit --amend
-</code>
-  * Modifier une ancienne révision (([[http://stackoverflow.com/questions/1186535/how-to-modify-a-specified-commit#1186549|How to modify a specified commit in git?]]))
-<code bash>
-# Pour modifier la révision bbc643cd
-git rebase --interactive bbc643cd^
-# À ce moment, l'éditeur de texte par défaut va s'ouvrir pour sélectionner les révisions à modifier.
-# Changer pick pour edit en face des révisions à modifier.
-# Faire les changements nécessaire et ajouter les fichiers.
-git add <file1> <file2>
-# Appliquer les changements
-git commit --amend
-# Poursuivre l'application des changements
-git rebase --continue
-</code>
-  * Supprimer la dernière révision
-<code bash>
-# Si la révision n'a pas été partagée et que l'on veut conserver les modifications
-git reset --soft HEAD~1
-# Si la révision n'a pas été partagée et que l'on veut supprimer les modifications
-git reset --hard HEAD~1
-# Si la révision a été partagée
-git revert HEAD
-</code>
-  * Pour aller plus loin
-    * [[http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html| Squashing commits with rebase]]
-    * [[http://pioupioum.fr/developpement/git-10-commandes-utiles.html#commit-autre-identite|Faire une révision sous une autre identité]]
-    * [[http://pioupioum.fr/developpement/git-10-commandes-utiles.html#antidater-commit|Antidater une révision]]
-    * [[https://stackoverflow.com/questions/4307095/how-can-i-split-up-a-git-commit-buried-in-history#4307158|How can I split up a Git commit buried in history?]]
-==== Utiliser les branches ====
-  * Afficher les branches
-<code bash>
-# Locales
-git branch
-# Distantes
-git branch -r
-# Toutes
-git branch -a
-# Déjà disponibles dans la branche courante
-git branch --merged
-# Pas encore disponibles dans la branche courante
-git branch --no-merged
-</code>
-  * Créer une branche locale
-<code bash>
-# La manière rapide
-git checkout -b <branch>
-# La manière détaillée
-git branch <branch>
-git checkout <branch>
-</code>
-  * Récupérer une branche distante
-<code bash>
-# Récupérer la liste des branches distantes disponibles
-git fetch origin
-# Récupérer la liste des branches distantes disponibles en supprimant les branches supprimées - version longue
-git fetch --prune origin
-# Récupérer la liste des branches distantes disponibles en supprimant les branches supprimées - version courte
-git fetch -p origin
-# Création d'une branche locale à partir de la branche distante
-git checkout -b <branch> origin/<branch>
-</code>
-  * Changer le nom d'une branche locale
-<code bash>
-git branch -m <old-branch> <new-branch>
-</code>
-  * Supprimer une branche locale
-<code bash>
-# Supprimer une branche qui a été fusionnée
-git branch -d <branch>
-# Forcer la suppression d'une branche
-git branch -D <branch>
-</code>
-  * Supprimer une branche distante
-<code bash>
-# La manière compréhensible
-git push --delete origin <branch>
-# La manière moins compréhensible au premier abord
-git push origin :refs/remote/origin/<branch>
-# et son raccourci
-git push origin :<branch>
-</code>
-  * Lier une branche existante à une branche distante
-<code bash>
-# Syntaxe courte
-git branch -u <remote_branch> <local_branch>
-# Syntaxe longue
-git branch --set-upstream-to <remote_branch> <local_branch>
-</code>
-  * Supprimer les branches locales obsolètes
-<code bash>
-git remote prune origin
-</code>
-  * Comparer un fichier entre 2 branches
-<code bash>
-git diff <branch_1> <branch_2> -- <fichier>
-# Avec cette syntaxe, la référence peut être une branche, un tag, un commit, ...
-git diff <reference_1>..<reference_2> <fichier>
-</code>
-  * Pousser une branche
-<code bash>
-# Quand les références des branches sont identiques
-git push <remote> <branch>
-# Quand les références des branches sont différentes
-git push <remote> <src/branch>:<dst/branch>
-</code>
-  * Afficher le point d'origine d'une branche
-<code bash>
-git merge-base HEAD <branch>
-</code>
-  * Revenir à la branche précédente
-<code bash>
-git checkout -
-</code>
-  * Pour aller plus loin
-    - [[https://gist.github.com/jbgo/1944238|How to recover a git branch you accidentally deleted]]
-    - [[https://stackoverflow.com/questions/28932515/how-to-unmerge-a-git-merge#28932585|How to unmerge a Git merge?]]
-==== Utiliser les tags ====
-  * Lister les tags
-<code bash>
-git tag
-</code>
-  * Créer un tag à usage privé ou temporaire (tag léger)
-<code bash>
-git tag <tagname>
-</code>
-  * Créer un tag à usage public (tag annoté)
-<code bash>
-git tag -a <tagname>
-</code>
-  * Créer un tag distant
-Il faut que le tag existe déjà localement pour pouvoir le créer sur un //repository// distant.
-<code bash>
-# Pour créer un seul tag
-git push origin <tagname>
-# Pour créer tous les tags
-git push --tags
-</code>
-  * Supprimer un tag distant (([[http://stackoverflow.com/questions/5480258/how-to-delete-a-remote-git-tag#5480292|How to delete a git remote tag?]]))
-<code bash>
-# La manière compréhensible
-git push --delete origin <tagname>
-# La manière moins compréhensible au premier abord
-git push origin :refs/tags/<tagname>
-# et son raccourci
-git push origin :<tagname>
-</code>
-  * Remplacer un tag léger par un tag annoté (([[http://sartak.org/2011/01/replace-a-lightweight-git-tag-with-an-annotated-tag.html|Replace a Lightweight Git Tag with an Annotated Tag]]))
-<code bash>
-# Récupérer le code associé au tag
-git checkout <tagname>
-# Supprimer le tag local
-git tag -d <tagname>
-# Créer le tag annoté antidaté à la date de la révision
-GIT_COMMITTER_DATE="$(git show --format=%aD | head -1)" git tag -a <tagname>
-# Supprimer le tag distant
-git push origin :refs/tags/<tagname>
-# Créer le tag distant
-git push --tags
-</code>
-==== Utiliser les notes ====
-  * Ajouter une note sur un commit
-<code bash>
-# Sans espace de nom
-git notes add -m <message> <commit>
-# Avec espace de nom
-git notes --ref=<namespace> add -m <message> <commit>
-</code>
-  * Voir une note
-<code bash>
-# Sans espace de nom
-git log
-# Avec espace de nom (les caractères de remplacement sont supportés)
-git log --show-notes=<namespace>
-</code>
-  * Éditer une note
-<code bash>
-# Sans espace de nom
-git notes edit <commit>
-# Avec espace de nom
-git notes --ref=<namespace> edit <commit>
-</code>
-  * Pour aller plus loin
-     - [[http://git-scm.com/blog/2010/08/25/notes.html|Note to Self]]
-     - [[http://alblue.bandlem.com/2011/11/git-tip-of-week-git-notes.html|Git Tip of the Week: Git Notes]]
-==== Divers ====
-  * Créer et appliquer un patch (([[https://ariejan.net/2009/10/26/how-to-create-and-apply-a-patch-with-git/|How to create and apply a patch with Git]]))
-<code bash>
-# Création d'un fichier patch
-git format-patch <commit.1>..<commit.2> --stdout > <file.patch>
-# Création d'un fichier patch en changeant le chemin d'accès aux fichiers
-git format-patch <commit.1>..<commit.2> --src-prefix="a/new/path/" --dst-prefix="b/new/path/" --stdout > <file.patch>
-# Vérification du patch
-git apply --check <file.patch>
-# Application des modifications apportées par le patch
-git apply <file.patch>
-# Application des commits apportés par le patch
-git am <file.patch>
-</code>
-  * Modifier l'historique
-<code bash>
-git rebase -i <commit>
-</code>
-  * Ajouter des fichiers à l'index
-<code bash>
-git add -i
-</code>
-  * Récupérer un fichier d'un révision particulière
-<code bash>
-git checkout <treeish> -- <path>
-</code>
-  * Afficher un fichier d'un révision particulière
-<code bash>
-git show <treeish>:<file>
-</code>
-  * Voir les modifications effectuées
-<code bash>
-# Modifications des fichiers du répertoire de travail
-git diff
-# Modification des fichiers de la zone de transit
-git diff --staged
-git diff --cached
-# Vérification des erreurs de caractères blancs
-git diff --check
-# Modification entre deux branches
-git diff <branch>..<branch>
-# Modification entre deux branches (nom et statut)
-git diff --name-status <branch>..<branch>
-# Modification entre deux branches (nom seulement)
-git diff --name-only <branch>..<branch>
-</code>
-  * Mettre de côté des modifications ([[http://git-scm.com/book/en/Git-Tools-Stashing|documentation officielle]])
-<code bash>
-# Mettre de côté toutes les modifications
-git stash
-# Mettre de côté toutes les modifications à l'exception de celles présentent dans l'index
-git stash --keep-index
-# Lister les réserves de code
-git stash list
-# Appliquer la dernière réserve de code
-git stash apply
-# Supprimer la dernière réserve de code
-git stash drop
-# Afficher les modifications contenues dans le "stash"
-git stash show -p stash@{0}
-</code>
-  * Afficher la liste des fichiers d'un commit
-<code bash>
-git diff-tree --no-commit-id --name-only -r <treeish>
-</code>
-  * Dupliquer un projet
-<code bash>
-# Duplique un projet dans un répertoire éponyme créé automatiquement
-git clone <project>
-# Duplique un projet dans un répertoire sélectionné
-git clone <project> <folder>
-</code>
-  * Créer une archive d'un projet
-<code bash>
-git archive --format=tar.gz <treeish> > <file>
-</code>
-  * Dupliquer un repository (([[https://help.github.com/articles/duplicating-a-repository/|Duplicating a repository]]))
-<code bash>
-# Faire un clone brut du projet
-git clone --bare <old-repository>
-# Faire un miroir du projet
-cd old-repository
-git push --mirror <new-repository>
-# Suppression du clone brut
-cd -
-rm -rf old-repository
-</code>
-  * Afficher la liste des branches actives
-<code bash>
-# Sans filtre
-git ls-remote --heads origin
-# Avec un filtre simple
-git ls-remote --heads origin master
-# Avec un filtre complexe
-git ls-remote --heads origin master develop release\*
-</code>
-===== Pour aller plus loin =====
-Il existe de nombreux outils fournis avec git. L'ensemble de ceux décrit ici ne représentent qu'une petite partie des possibilités de Git. Pour apprendre à connaître Git, la curiosité est de mise et quelques commandes existent pour l'aider :
-<code bash>
-# Afficher la liste et l'usage des commandes les plus communes
-git help
-# Afficher la liste et l'usage de l'ensemble des commandes
-git help --all
-# Afficher la liste des guides
-git help --guides
-# Afficher l'aide d'une commande ou un guide
-git help <command>
-</code>
-===== Liens utiles =====
-==== Aide mémoire ====
-  - [[http://git-scm.com/docs|Index des commandes]]
-  - [[http://ndpsoftware.com/git-cheatsheet.html|Aide mémoire Git]]
-  - [[http://www.cheat-sheets.org/saved-copy/git-cheat-sheet.pdf|Aide mémoire Git]]
-  - [[http://git-scm.com/book|Version en ligne et complète du livre «Pro Git»]]
-==== Pour commencer ====
-  - [[http://danielmiessler.com/study/git/|A git Primer]]
-  - [[http://githowto.com/|Git How To]]
-  - [[http://www.vogella.com/tutorials/Git/article.html|Git - Tutorial]]
-  - [[http://lilobase.wordpress.com/2014/05/12/a-la-decouverte-de-git|Ce que j’aurais aimé savoir quand j’ai commencé Git]]
-  - [[https://wiki.openstack.org/wiki/GitCommitMessages|Git commit good practice]]
-  - [[http://try.github.io|Un cours étape par étape pour apprendre à se servir de Git]]
-  - [[http://connect.ed-diamond.com/GNU-Linux-Magazine/GLMF-119/Git-it|Git it, article pour commencer avec Git]]
-  - [[http://gitimmersion.com/|Git immersion]]
-  - [[http://www.learnenough.com/git-tutorial|Learn Enough Git to Be Dangerous]]
-  - [[https://dev.to/unseenwizzard/learn-git-concepts-not-commands-4gjc|Learn git concepts, not commands - DEV Community 👩‍💻👨‍💻]]
-  - [[https://jwiegley.github.io/git-from-the-bottom-up/|Git from the Bottom Up]]
-==== Pour aller plus loin ====
-  - [[http://alexpeattie.com/blog/working-with-dates-in-git/|Working with dates in Git]]
-  - [[http://www.freeklijten.nl/home/2011/07/05/Git-commit-hooks-using-PHP|Git commit hooks using PHP]]
-  - [[http://git-scm.com/book/en/Customizing-Git-Git-Hooks|Customizing Git - Git Hooks]]
-  - [[http://blog.timcrider.com/2010/08/16/php-syntax-checker-for-git-repository-changes/|PHP syntax checker for Git repository changes]]
-  - [[https://chanux.wordpress.com/2013/06/20/composer-phar-composer-lock-and-git/|Composer.phar, composer.lock and git]]
-  - [[http://stackoverflow.com/questions/540535/managing-large-binary-files-with-git|Managing large binary files with git]]
-  - [[http://connect.ed-diamond.com/GNU-Linux-Magazine/GLMF-101/Git-pour-les-futurs-barbus|Git pour les (futurs) barbus]]
-  - [[http://think-like-a-git.net|Think Like (a) Git]]
-  - [[http://www.git-attitude.fr/2013/05/22/prompt-git-qui-dechire|Un prompt Git qui déchire]]
-  - [[http://www.git-attitude.fr/2014/05/04/bien-utiliser-git-merge-et-rebase|Bien utiliser Git merge et rebase]]
-  - [[http://nvie.com/posts/a-successful-git-branching-model/|Une explication détaillée pour un système de branches efficace]]
-  - [[http://gitready.com/|Apprendre git un commit à la fois]]
-  - [[http://www.miximum.fr/tutos/1546-enfin-comprendre-git|Pour arrêter de galérer avec Git]]
-  - [[http://www.vogella.com/tutorials/Git/article.html|Git - tutorial]]
-  - [[http://www.alexkras.com/19-git-tips-for-everyday-use/|19 Tips For Everyday Git Use]]
-  - [[http://www.iliveinperego.com/2013/12/local-git-repository-with-composer/|Local git repository with composer]]
-  - [[http://haacked.com/archive/2014/07/28/github-flow-aliases/|GitHub Flow Like a Pro with these 13 Git Aliases]]
-  - [[http://danielkummer.github.io/git-flow-cheatsheet/index.fr_FR.html|Git Flow cheatsheet]]
-  - [[https://dev.ghost.org/easy-git-pr-test/|Test Any Open Source Pull Request in Seconds]]
-  - [[https://blog.eleven-labs.com/fr/debugging-with-git/|Débugger avec Git]]
-  - [[http://www-cs-students.stanford.edu/~blynn/gitmagic/intl/fr/index.html|Git magic]]
-  - [[https://stackoverflow.com/questions/89332/how-to-recover-a-dropped-stash-in-git|How to recover a dropped stash in Git?]]
-  - [[https://mghignet.github.io/git-dammit-talk/|Git dammit!]]
-==== Humour ====
-  - sur [[http://angriestprogrammer.com/comic/source_control|angriestprogrammer.com]]
-  - sur [[http://xkcd.com/1296/|xkcd.com]]
-  - sur [[http://www.commitstrip.com/fr/2013/11/05/git-svn-ou/|commitstrip.com]]
-  - [[https://hikaruzone.files.wordpress.com/2015/10/in-case-of-fire-1-git-commit-2-git-push-3-leave-building.pdf|En cas d'incendie]] et [[https://github.com/qw3rtman/git-fire|le script]] qui va avec.
-  - sur [[http://xkcd.com/1597/|xkcd.com]] encore
-===== Divers =====
-FIXME → Vérifier ce que j'ai fait à la maison
-  * Modifier son prompt pour qu'il soit plus utile
-<code bash>
-export GIT_PS1_SHOWDIRTYSTATE=1
-export GIT_PS1_SHOWSTASHSTATE=1
-export GIT_PS1_SHOWUNTRACKEDFILES=1
-export GIT_PS1_SHOWUPSTREAM=verbose
-export GIT_PS1_DESCRIBE_STYLE=branch
-export GIT_PS1_SHOWCOLORHINTS=1
-export PROMPT_COMMAND='__git_ps1 "\[\033[1;32m\]\u@\h:\[\033[1;34m\]\w\[\033[1;m\]" " \\\$ "'
-</code>
   * [[https://stackoverflow.com/questions/25931026/how-can-i-rename-a-git-stash|How can I rename a git stash? - Stack Overflow]]
   * [[https://github.com/saschagrunert/git-journal/|saschagrunert/git-journal: The Git Commit Message and Changelog Generation Framework]]
   * [[https://grimoire.ca/dev/commit-messages|The Codex » Writing Good Commit Messages]]
+  * Vérifier ce que j'ai fait à la maison pour la configuration du prompt
+  * Ajouter une section sur les préférences de l'utilisateur par dépot
+</WRAP>