====== Git. Шпаргалка ======

----

===== Man =====

Есть три способа открыть страницу руководства по любой команде Git:

<code bash>
git help <verb>
git <verb> --help
man git-<verb>
</code>

----

===== Создание Git-репозитория =====

==== Создание локального репозитория ====

<code bash>
git init                    # создать репозиторий в текущем каталоге
git init <directory>        # создать репозиторий в указанном каталоге
</code>

==== Создание локального репозитория существующего проекта ====

<code bash>
git init        # Создать Git-репозиторий в текущем каталоге
git add .       # Индексировать рекурсивно все данные в каталоге
git commit      # Создать первый commit (снимок)
</code>

----

===== Индексация =====

==== Добавление файла в репозиторий ====

<code bash>
git add file.txt        # Добавить один файл
git add .               # Добавить каталог рекурсивно
git add *.html          # Добавить файлы по маске
</code>

==== Сброс индексации ====

<code bash>
git reset file.txt
</code>

  * [[ https://git-scm.com/book/ru/v2/Инструменты-Git-Раскрытие-тайн-reset | Инструменты Git. Раскрытие тайн reset ]]

==== Игнорирование файлов ====

Шаблон игнорируемых файлов задается в **''.gitignore''** или **''.git/info/exclude''** . Пример содержимого:
<code bash>
*.[oa]        # Все файлы, которые заканчиваются на .o или .a
!lib.a        # Однако НЕ игнорировать файл lib.a
*~            # Всё, что заканчивается на ~
/TODO         # Игнорировать файл TODO, однако НЕ каталог TODO
build/        # Игнорировать все файлы в каталоге build/
doc/*.txt     # Игнорировать, например, doc/notes.txt, но не doc/server/arch.txt
doc/**/*.txt  # Игнорировать все .txt файлы во всех вложенных в doc/ каталогах
</code>

<WRAP center round info 100%>
При этом помним:
  * пустые строки, а так же строки, начинающиеся с <wrap em>%%#%%</wrap>, игнорируются
  * можно использовать стандартные glob-шаблоны
  * можно начать шаблон символом слэша <wrap em>%%/%%</wrap>, чтобы избежать рекурсии
  * можно заканчивать шаблон символом слэша <wrap em>%%/%%</wrap> для указания каталога
  * можно инвертировать шаблон, использовав восклицательный знак <wrap em>%%!%%</wrap> в качестве первого символа
</WRAP>

----

==== Удаление из индекса ====

При удалении файла с диска, он остаётся в Git и помечается как **''Cnahget not staged for commit''** (Изменённый, но не проиндексированный). Для того, чтобы удаление файла попало в индекс, необходимо так же выполнить **''git rm''**. С данной команды можно и начинать, по умолчанию удаляется файл из индекса и рабочего каталога

<code bash>
git rm README              # Удалить файл README из индекса и рабочего каталога
git rm --cached README     # Удалить файл README только из индекса (на диске файл останется)
</code>

==== Перемещение файлов ====

Git не отслеживает перемещение файлов явно. 

<code bash>
git mv file_from file_to
</code>

Данная команда аналогично следующему процессу

<code bash>
mv file_from file_to
git rm file_from
git add file_to
</code>

----

===== Просмотр изменений =====

==== Просмотр неиндексрованных изменений ====

<code bash>
git diff           # в консоли
git difftool       # в графическом приложении (напр. vimdiff)
</code>

==== Просмотр индексированных изменений ====

<code bash>
git diff --staged
# или
git diff --cached

</code>

----

===== Commit (фиксированное изменение) =====
==== Создание коммита ====

<code bash>
git commit                         # Коммит изменений с добавлением комментария через редактор
git commit -m "First commit"       # Коммит изменений с комментарием в командной строке
git commit -a                      # Коммит с автоматическим индексированием всех отслеживаемых файлов
</code>

<WRAP center round info 100%>
Редактор выбирается из следующего списка (в порядке приоритета):
  - переменная среды GIT_EDITOR
  - параметр конфигурации core.editor
  - переменная среды VISUAL
  - переменная среды EDITOR
</WRAP>

==== Отмена коммита ====

Сделать коммит с новыми изменениями, отменяющими предыдущие. При этом предыдущий коммит останется доступным и будет отображаться при использовании команды ''git log''
<code bash>
git revert HEAD --no-edit
</code>

==== Сброс коммитов к предшествующему состоянию ====

<code bash>
git reset --hard <hash>    # Удаление коммита по hash-коду. Все изменения в нём будут утеряны.
git reset --hard HEAD~1    # Удаление последнего коммита. Все изменения в последнем коммите будут утеряны.
</code>

----

===== Переход между состояниями =====

**Перейти к последнему состоянию в ветке master:**
<code bash>
git checkout master
</code>

**Перейти к определённому состоянию в текущей ветке:**
<code bash>
git checkout <hash>
</code>

----

===== Проверка состояния репозитория =====

<code bash>
git status
</code>

----

===== Операции отмены =====

==== Изменить последний коммит ====

Изменить последний коммит можно с помощью ключа **''%%--amend%%''**. \\
Пример добавления файла:
<code bash>
git commit -m 'initial commit'
git add forgotten_file
git commit --amend
</code>

Для изменения комментария к коммиту, при условии, что //**ещё не было внесено правок в индексируемые файлы**//, достаточно выполнить
<code bash>
git commit --amend
</code>

==== Отмена подготовки файла ====
Ситуация: есть 2 файла, добавленных в индекс. Необходимо закоммитить вначале изменения одного файла, затем второго.

<code bash>
git reset HEAD <filename_two>
git commit -m 'Commiting is first file'
git add <filename_two>
git commit -m 'Commiting is second file '
</code>

==== Отмена изменения измененного файла ====

Вернуть файл **filename** к состоянию из последнего коммита.

<code bash>
git checkout -- filename
</code>
При этом помним: всё что, не коммитим и теряем, вероятней всего теряем безвозвратно.

----

===== Работа с ветками =====

<code bash>
git branch                           # Посмотреть локальные ветки
git branch <имя_ветки>               # Создать ветку
git branch -v                        # Посмотреть последний коммит на каждой из локальных веток
git branch -a                        # Посмотреть все существующие локальные и удаленные ветки
git branch -a -v                     # Посмотреть последние коммиты на всех ветках (локальных и удаленных)
git branch -vv                       # Посмотреть отслеживаемые ветки
git branch -u origin/serverfix       # Сделать локальную ветку serverfix отслеживаемой
git branch new_branch 5a0eb04        # Создать ветку на определенном коммите
git branch -m <oldname> <newname>    # Переименовать ветку
git branch -m <newname>              # Переименовать текущую ветку
git branch -d <имя_ветки>            # Удалить ветку
git push origin --delete serverfix   # Удалить ветку serverfix на удаленном сервере
</code>

<code bash>
git checkout <имя_ветки>             # Переключится на ветку
git checkout -b <имя_ветки>          # Создать ветку и сразу же переключиться на нее
</code>

==== Слияние веток (в примере находимся на ветке master и сливаем с ней ветку hotfix) ====
<code bash>
git checkout master
git merge hotfix
</code>

----

===== История =====

<code bash>
git log                      # Вывод простой истории коммитов
git log -2                   # Вывод последних n записей, в примере вывод двух последних записей
git log -p -2                # Вывод дельты (diff) разницы между последними двумя изменениями (на уровне строк)
git log -p -2 --word-diff    # Вывод изменений между двумя последними коммитами на уровне слов
git log -2 --stat            # Вывод краткой статистики по 2 последним коммитам
git log --pretty=oneline     # И очень полезный ключ --pretty (позволяет изменить формат вывода лога)

git log --since=2.weeks      # Cписок коммитов, сделанных за последние две недели
git log --after="2017-01-01" # after является синонимом since
git log --until=2.weeks      # Список коммитов, сделанных ранее двух недель назад
git log --before="2017-01-01"# before является синонимом until

git log --author="Daniil Nareyko"    # Вывести только коммиты, которые были сделаны указанным пользователем
git log -S<stirng>           # Показать только коммиты, в которых изменение в коде повлекло за собой добавление ил удаление указанной строки
git log --oneline            # Список коммитов с хэшем (короткое число)
</code>

**Более удобный формат вывода для постоянного использования:**
<code bash>
git log --pretty=format:"%h %ad | %s%d [%an]" --graph --date=short
</code>

==== Параметры ключа format ====

^  Параметр  ^  Описание выводимых данных  ^
|  **%%%H%%**  | Хеш коммита |
|  **%%%h%%**  | Сокращённый хеш коммита |
|  **%%%T%%**  | Хеш дерева |
|  **%%%t%%**  | Сокращённый хеш дерева |
|  **%%%P%%**  | Хеши родительских коммитов |
|  **%%%p%%**  | Сокращённые хеши родительских коммитов |
|  **%%%an%%**  | Имя автора |
|  **%%%ae%%**  | Электронная почта автора |
|  **%%%ad%%**  | Дата автора %%(формат соответствует параметру --date=)%% |
|  **%%%ar%%**  | Дата автора, относительная %%(пр. "2 мес. назад")%% |
|  **%%%cn%%**  | Имя коммитера |
|  **%%%ce%%**  | Электронная почта коммитера |
|  **%%%cd%%**  | Дата коммитера |
|  **%%%cr%%**  | Дата коммитера, относительная |
|  **%%%s%%**  | Комментарий |

**Другие примеры:**
<code bash>
git log --pretty=oneline --max-count=2
git log --pretty=oneline --since='5 minutes ago'
git log --pretty=oneline --until='5 minutes ago'
git log --pretty=oneline --author=<your name>
git log --pretty=oneline --all
</code>

<code bash>
git reflog # Просмотр истории перемещения указателя HEAD
</code>

----

===== Тэги =====

<code bash>
git tag                                # Посмотреть все (перечисляет в алфавитном порядке)
git tag -l 'v1.4.2.*'                  # Посмотреть попадающие под маску тэги
git tag -a v1.4 -m 'my version 1.4'    # Создать аннотированную метку на текущем коммите (ключ -а) с меточным сообщением (ключ -m)
git tag -a v1.4 -m 'my v1.4' 98fced0   # То же самое, но для определённого коммита (98fced0)
git tag <имя_метки>                    # Создание легковесной метки на текущем коммите
git show <tag>                         # Посмотреть данные аннотированной метки вместе с коммитом, который был помечен
git checkout <tag>^                    # Добавить тэг для предыдущего коммита
git checkout <tag>~1                   # Добавить тэг для предыдущего коммита 
git tag -d <tag>                       # Удалить тэг
git push origin v1.4                   # Отправить метку на общий сервер (по умолчанию git push метки не отправляет)
git push origin --tags                 # Отправить все метки на общий сервер
</code>

----