Chi.huynh : Chi.huynh a déplacé la page Memo vers Mémo Git

2022-08-14T18:51:55Z

Chi.huynh a déplacé la page Memo vers Mémo Git

← Version précédente	Version du 14 août 2022 à 20:51
(Aucune différence)

Chi.huynh : Création de la page Mémo Git

2022-08-14T18:51:28Z

Création de la page Mémo Git

Nouvelle page

== Commandes git utiles au quotidien ==

* <code>HEAD</code> : dernier commit
* <code>HEAD^</code> : avant-dernier
* <code>HEAD^^</code> : avant-avant-dernier

<code>git status</code> : montre les modifs entre le state actuel et le dernier commit

<code>git diff</code> : montre les modifs entre le state actuel et le dernier commit

<code>git diff path/to/file</code> : idem mais seulement pour le fichier specifie

<code>git log</code> : historique des commits

<code>git add . </code> : ajoute tous les fichiers de . au 'index'

<code>git commit</code> : commit les fichiers du index et demande un message (pas recommandé car ouvre vim)

<code>git commit -m "blablabla"</code> : commit les fichiers du index avec le message "blablabla" (recommande, plus simple)

Soft reset = annuler le fait d'avoir commité

<code>git reset HEAD^</code> : l'avant-dernier commit devient le dernier commit

Hard reset = revert back to a previous commit. Attention ça annihile tes modifs.

<code>git reset --hard HEAD </code> # nuke toutes les modifs qui ont été faites depuis le dernier commit

<code>git pull</code>

* fast forward (no interleaving between local commits and pulled commits), or
* merge without conflict, or
* merge conflict

<code>git push</code> : un push est irréversible.

<code>git branch</code> : list local branchs

<code>git checkout other_branch</code> : aller sur une autre branche

<code>git branch nouvelle_branche</code> : crée une nouvelle branche (locale) (mais ne va pas dessus)

<code>git branch -d branche_a_supprimer</code> : supprime une branche

<code>git checkout -b nouvelle_branche</code> = <code>git branch nouvelle_branche</code> + <code>git checkout nouvelle_branche</code>

Tous les fichiers utilisés par git sont rassemblés dans le sous-dossier <code>.git/</code>. Pour dé-git-ifier un dossier, simplement supprimer le <code>.git/</code>.

<code>.gitignore</code> : fichier où spécifier les fichiers que git n'a pas à suivre (e.g. fichiers de config de projet d'eclipse>))

== Pour les curieux ==

=== Autres version control systems ===

* CVS : vieux
* [SVN] (Subversion) : assez utilisé
* Mercurial
* Bazaar

=== Notions générales ===

==== Notation des commits : ====

* <code>HEAD</code> : dernier commit
* <code>HEAD^</code> : avant-dernier
* <code>HEAD^^</code> : avant-avant-dernier
* <code>HEAD~2</code> : idem
* <code>d6d98923868578a7f38dea79833b56d0326fcba1</code> : indique un numéro de commit précis
* <code>d6d9892</code> : le même commit (autocomplete implicite)
* <code>tags</code>

<blockquote>
Note that merge commits may have more than one parent:

<code>git show HEAD^1 # show the first parent of HEAD (same as HEAD^)</code>
<code>git show HEAD^2 # show the second parent of HEAD</code>
</blockquote>

==== Vocabulaire ====

The '''object database''' is the rather elegant system used to store the history of your project-files, directories, and commits.

The '''index file''' is a cache of the state of a directory tree, used to create commits, check out working directories, and hold the various trees involved in a merge.

'''Blob''' stands for Binary Large Object. Each version of a file is represented by blob. A blob holds the file data but doesn’t contain any metadata about the file. It is a binary file, and in Git database, it is named as SHA1 hash of that file. In Git, files are not addressed by names. Everything is content-addressed.

'''Tree''' is an object, which represents a directory. A tree is a binary file that stores references to blobs and trees which are also named as SHA1 hash of the tree object.

'''Tag''' assigns a meaningful name with a specific version in the repository. A tag is a branch, which nobody intends to modify. Once a tag is created for a particular commit, even if you create a new commit, it will not be updated

'''HEAD''' is a pointer, which always points to the latest commit in the branch. Whenever you make a commit, HEAD is updated with the latest commit. The heads of the branches are stored in .git/refs/heads/directory.

=== Config ===

<code>git config --global user.name "mon_pseudo"</code>

<code>git config --global user.email "moi@email.com"</code>

Le fichier modifié par ces commandes et qui garde trace de ces paramètres est <code>~/.gitconfig</code>

==== LF (\n) vs CRLF (\r\n) ====

GNU/Linux and Mac OS uses line-feed (LF), or new line as line ending character, while Windows uses line-feed and carriage-return (LFCR) combination to represent the line-ending character.

* <code>git config --global core.autocrlf true</code> : configure the Git client to convert line endings to CRLF format while checking out, and convert them back to LF format during the commit operation. (Useful for Windows system)
* <code>git config --global core.autocrlf input</code> : configure the Git client to convert line endings from CRLF to LF while performing the checkout operation. (Useful for GNU/Linux or Mac OS)

==== Examiner sa config ====

Examiner sa config globale : tout simplement aller voir <code>~/.gitconfig</code>.

Examiner la config d'un repository : regarder dans le <code>.git/</code>, ou bien utiliser la commande <code>git config git config --list git config --get remote.origin.url</code>

=== Création / import / export de repository ===

<code>git init</code>

<code>git clone [http[s]|ssh|ftp[s]|git]://host.xz[:port]/path/to/repo.git/</code>

Pushing a new (local) repository to the server :

<code>
(user@local:~$) mkdir github_repo ; cd github_repo
vim README.txt [...]
vim blah.c [...]
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/kangralkar/testing_repo.git
# defines remote-repository shorthand "origin" to the value [the GitHub repository's URL]
git push --set-upstream origin master
# push local changes (on local branch master) to the remote repository "origin". push operation will ask for GitHub user name and password. After successful authentication, the operation will succeed.
</code>

==== remote repository shorthand ====

<code>alice$ git remote add bob /home/bob/myrepo</code>

Après avoir exécuté ça, on peut écrire "bob" à la place de "/home/bob/myrepo" partout

=== Voir les modifs ===

==== Voir les modifs locales ====

<code>git status</code> : montre les modifs entre le state actuel et le dernier commit

<code>git diff</code> : montre les modifs entre le state actuel et le dernier commit

<code>git diff path/to/file</code> : idem mais seulement pour le fichier spécifié

<code>git log</code>: historique des commits

<code>git log -p</code> : historique complet des modifs

<code>git log --stat</code> : historique résume des modifs

<code>gitk</code> : will show a nice graphical representation of the history.

<code>git show c82a22c39cbc32576f64f5c6b3f24b99ea8149c7</code> : see the details about this commit

<code>git show HEAD</code>

<code>git show experimental</code> : see the tip of the "experimental" branch

==== Voir les modifs sur le serveur =====

Alice can peek at what Bob did without merging first, using the "fetch" command; this allows Alice to inspect what Bob did, using a special symbol "FETCH_HEAD", in order to determine if he has anything worth pulling, like this:

<code>alice$ git fetch /home/bob/myrepo master

<code>alice$ git log -p HEAD..FETCH_HEAD</code>

<code>alice$ gitk -p HEAD..FETCH_HEAD</code>

The range notation <code>HEAD..FETCH_HEAD</code> means "show everything that is reachable from the <code>FETCH_HEAD</code> but exclude anything that is reachable from HEAD". Alice already knows everything that leads to her current state (<code>HEAD</code>), and reviews what Bob has in his state (<code>FETCH_HEAD</code>) that she has not seen with this command.

Alice may want to view what both of them did since they forked. She can use three-dot form instead of the two-dot form:

<code>alice$ git log HEAD...FETCH_HEAD</code>

<code>alice$ gitk HEAD...FETCH_HEAD</code>

This means "show everything that is reachable from either one, but exclude anything that is reachable from both of them".

===== using remote-repository shorthand =====

<code>alice$ git fetch bob</code> : Unlike the longhand form, when Alice fetches from Bob using a remote repository shorthand set up with git remote, what was fetched is stored in a remote-tracking branch, in this case bob/master

<code>alice$ git log -p master..bob/master</code> : shows a list of all the changes that Bob made since he branched from Alice’s master branch.

=== Commits ===

<code>git add path/to/file1 path/to/file2 ... : ajoute des fichiers au 'index' (~ version 'staging')

<code>git add . </code> : ajoute tous les fichiers de . au 'index'

<code>git commit</code> : commit les fichiers du index et demande un message

<code>git commit -m "blablabla"</code> : commit les fichiers du index avec le message "blablabla"

<code>git commit -a</code> : = <code>git add . </code> + <code>git commit</code>

<code>git commit --amend</code> : modifie le dernier message de commit

==== Undo a commit ====

Soft reset = annuler le fait d'avoir commité

<code>git reset HEAD^ # l'avant-dernier commit devient le dernier commit</code>

Hard reset = revert back to a previous commit. Attention ça annihile des modifs.

<code>git reset --hard HEAD # nuke toutes les modifs qui ont été faites depuis le dernier commit</code>

<code>git checkout path/to/file</code> : restaurer un fichier tel qu’il était au dernier commit

Si on a déjà push au serveur, la seule option est de créer et de push un commit qui fait les modifs inverses (revert commit).

<code>git revert 6261cc2</code> : crée un commit "inverse" du commit spécifié, i.e. qui revert les modifs (-- et le commit)

<code>git revert 6261cc2 --no-commit</code> : pareil, mais ne commit pas ces modifs inverses

==== Push and pull to server ====

<code>git pull</code> (= <code>git fetch</code> + <code>git merge</code>)

* fast forward (no interleaving between local commits and pulled commits), or
* merge without conflict, or
* merge conflict
<code>git push</code>

Le changement vers le serveur doit être de type fast-forward car le serveur ne peut régler les conflits à votre place s’il y en a. Personne ne doit avoir fait un push avant vous depuis votre dernier pull. Le mieux est de s’assurer que vous êtes à jour en faisant un pull avant de faire un push. Si le push échoue, vous serez de toute façon invités à faire un pull. Un push est irréversible.

=== Branches ===

==== gestion locale ====

<code>git branch</code> : see local branches

<code>git branch nouvelle_branche</code> : crée une nouvelle branche (locale) (mais ne va pas dessus)

<code>git checkout other_branch</code> : aller sur une autre branche

<code>git branch -d branche_a_supprimer</code> : supprime une branche

<code>git checkout -b nouvelle_branche</code> = <code>git branch nouvelle_branche</code> + <code>git checkout nouvelle_branche</code>

<code>git merge branche_a_merger</code> : merge branche_a_merger vers (dans) la branche courante

Avant de changer de branche, tous les fichiers doivent être commités ou stashés. git status ne devrait afficher aucun fichier en cours de modification.

==== stash ====

<code>git stash</code> : stash toutes les modifs dans un stash (propre à chaque branche)

<code>git stash apply</code> : unstash les modifs de la stash (de la branche courante)

==== gestion des branches locales + branches sur le serveur ====

origin/branche_machin : désigne une branche sur le serveur (origin)

<code>git branch -r</code> : lister toutes les branches que le serveur connait

<code>git push --set-upstream origin branche_locale</code> : copier une branche créée en local sur le serveur

supprimer une branche sur le serveur : cf Google

=== Tags ===

<code>git tag NOMTAG IDCOMMIT</code> : tagger une version, i.e. donner un alias à un commit précis pour le référencer sous ce nom.

<code>git push --tags</code> : un tag n’est pas envoyé au serveur lors d’un push, il faut préciser l’option --tags pour que ce soit le cas.

<code>git tag -d NOMTAG</code> : supprime un tag déjà créé

=== Divers ===

<code>git grep "TODO"</code> (avec expressions régulières). avec -n : numéros de lignes. search any of the files it manages in your current directory

<code>git grep "TODO" c82a22c39cbc32576f64f5c6b3f24b99ea8149c7</code> : search for strings in a specified version of your project .gitignore

=== Références ===

https://git-scm.com/docs/gittutorial (replicates man gittutorial) https://git-scm.com/docs/giteveryday (replicates man giteveryday) https://www.tutorialspoint.com/git/ https://openclassrooms.com/fr/courses/1233741-gerez-vos-codes-source-avec-git https://git-scm.com/book/en/v1/Getting-Started

Mémo Git - Historique des versions

Chi.huynh : Chi.huynh a déplacé la page Memo vers Mémo Git

Chi.huynh : Création de la page Mémo Git

Chi.huynh : Chi.huynh a déplacé la page Memo vers Mémo Git

Chi.huynh : Création de la page Mémo Git