# 06. Inspecting a Repository

The **history** in Git is the complete list of all commits made since the repository was created. The history also contains references to any branches, merges, and tags made within the repository.

### Status

The `git status` command displays the state of the working directory and the staging area. It lets you see which changes have been staged, which haven’t, and which files aren’t being tracked by Git. 

Status output does not show you any information regarding the committed project history.

* On branch...
* Changes to be committed:
* Changes not staged for commit:
* Untracked files:

```bash
git status
git status -s # short output
```

### Logging

The git log command displays committed snapshots. It lets you list the project history, filter it, and search for specific changes.

`git log` показывает историю коммитов:

* `-<limit>` - показать `<limit>` число последних коммитов
* `--oneline` - сокращенная запись вывода
* `-p` показывает изменения в коммитах
* `--stat` - показывает статистику для каждого коммита
* `--pretty=online|short|full|fuller|format:%h`
* `--graph` - рисует ASCII график коммитов
* `--relative-date` - показывает относительную дату коммита, а не абсолютную
* `--name-status` - показывает список измененных файлов с информацией о добавлении/изменении и удалении.
* `--since`/`--until`/`--after` - задает время отсчета истории (`2.weeks`, `2008-01-15`, `2.years.`)
* `--author="<pattern>"`/`--commiter` - поиск коммитов определенного автора
* `--grep="<pattern>" --all-match` - `grep` позволяет искать по ключевым словам, а `--all-match` задает поиск по всем им.
* `--decorate` - показывает имена веток над последними коммитами в этих ветках
* `--abbrev-commit` - показывать сокращенные хэши коммитов
* `путь` - путь указывается последним и выводит только те коммиты, которые связаны с измененными файлами в этой директории

```bash
git log <file> # show commits only affecting specified <file>
git log --since=2.weeks
git log --graph --decorate --oneline

git log master..branch # показать все коммиты, которые есть в branch но нет в master
git log branch --not master # то же самое

git diff master...branch # показать только те наработки, которые появились в ветке branch после расхождения с master
git log origin/master..HEAD # все коммиты в текущей ветке, отсутствующие в ветке origin/master
```

### Advanced Logging

Запись `master..branch` - вычислит разницу между `branch` и `master`: покажет какие коммиты есть в `branch`, но нет в `master`. Запись `branch..master` делает обратную операцию.

Запись `git log branch1 ^branch2` или `git log branch1 --not branch2` покажет все коммиты, которые есть в ветке `branch1`, но не в ветке `branch2`.

Запись `master...branch` показывает коммиты которые есть или в одной ветке, или в другой, но не в обоих одновременно. С этой командой часто используют параметр `--left-right`, позволяющий посмотреть, с какой стороны диапазона находится каждый коммит.

```bash
git grep "<text>"
git clean -n
```

### Show

The git show command is really useful for presenting any of the objects in a very human readable format.

* Running this command on a file will simply output the contents of the file.
* Running it on a tree will just give you the filenames of the contents of that tree, but none of its subtrees.
* If you call it on a tree that is a commit object, you will get simple information about the commit.

```bash
git show master@{yesterday}
git show HEAD^ # показать предыдущий коммит относительно HEAD
```

Команда `git describe branch` возвращает имя последнего тега, плюс число сделанных поверх него коммитов и хеш код, например `v1.6.2-rc1-20-g8c5b85c`.

### Diffing

If you simply run `git diff` with no arguments, it will show you the differences between your current working directory and your index, that is, the last time you ran ‘git add’ on your files.

By default diff show difference for:

* Working directory
* Last commit

```bash
git diff # show diff only for changed files
git diff --stat # short diff
git diff --cached # compare staging area with last commit
git diff HEAD # compare working area and staged area with the last commit
git diff --staged # show diff only for staged files

git diff <branch> # show diff between current branch and specified branch

git diff <branch>...<master> # show all difference between branch and master.
git config --global diff.indentHeuristic true
```

The default output of the `git diff` command is a valid patch file. If you pipe the output into a file and email it to someone, they can apply it with the `patch` command: `git diff master..experiment > experiment.patch`.

![](/files/-M6ftiemjBqrZc2hqG9c)

### `git blame`

Показывает кто и когда модифицировал файл последний раз.

### `git shortlog`

The `git shortlog` command is a special version of git log intended for creating release announcements. It groups each commit by author and displays the first line of each commit message. This is an easy way to see who is been working on what.

```bash
git shortlog -since="last week"
git shortlog -s -n --all # number of commits per author on all branches
```

### Other commands

* `git rev-parse` показывает по имени коммита в какой ветке он находится
* `git reflog` возвращает список изменений `HEAD` для текущей ветки (историю изменения `HEAD` во времени в вашем репозитории).
* `git bisect` позволяет в интерактивном режиме выполнять двоичный поиск по истории коммитов.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://strctr.gitbook.io/programming/02-tools/git/06-inspecting-a-repository.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.