Візуалізація галузевої топології в Git

Я граю з Git ізольовано на власній машині, і мені важко підтримувати ментальну модель всіх моїх гілок і зобов'язань. Я знаю, що я можу зробити, git logщоб побачити історію фіксів, звідки я є, але чи є спосіб побачити всю топографію гілок, щось подібне до цих карт ASCII, які, здається, використовуються скрізь для пояснення гілок?

      .-A---M---N---O---P
     /     /   /   /   /
    I     B   C   D   E
     \   /   /   /   /
      `-------------'

Просто відчувається, що хтось підійде і намагається забрати моє сховище, буде складно розібратися, що саме відбувається.

Я думаю, на мене впливає браузер потоку AccuRev ...

Використовуйте git log --graphабо gitk. (Обидва також приймають --all, що покаже всі гілки, а не лише поточну.)

Для назв гілок та компактного вигляду спробуйте:

git log --graph --decorate --oneline

Я зазвичай використовую

git log --graph --full-history --all --pretty=format:"%h%x09%d%x20%s"

З кольорами (якщо ваша оболонка - Bash):

git log --graph --full-history --all --color \
        --pretty=format:"%x1b[31m%h%x09%x1b[32m%d%x1b[0m%x20%s"

Це надрукує текстове представлення так:

* 040cc7c       (HEAD, master) Manual is NOT built by default
* a29ceb7       Removed offensive binary file that was compiled on my machine and was hence incompatible with other machines.
| * 901c7dd     (cvc3) cvc3 now configured before building
| * d9e8b5e     More sane Yices SMT solver caller
| | * 5b98a10   (nullvars) All uninitialized variables get zero inits
| |/
| * 1cad874     CFLAGS for cvc3 to work successfully
| *   1579581   Merge branch 'llvm-inv' into cvc3
| |\
| | * a9a246b   nostaticalias option
| | * 73b91cc   Comment about aliases.
| | * 001b20a   Prints number of iteration and node.
| |/
|/|
| * 39d2638     Included header files to cvc3 sources
| * 266023b     Added cvc3 to blast infrastructure.
| * ac9eb10     Initial sources of cvc3-1.5
|/
* d642f88       Option -aliasstat, by default stats are suppressed

(Ви можете просто скористатися git log --format=oneline, але він прив’яже повідомлення до фіксації цифр, що виглядає менш симпатичним IMHO).

Щоб зробити ярлик для цієї команди, ви можете відредагувати свій ~/.gitconfigфайл:

[alias]
  gr = log --graph --full-history --all --color --pretty=tformat:"%x1b[31m%h%x09%x1b[32m%d%x1b[0m%x20%s%x20%x1b[33m(%an)%x1b[0m"

Однак, як зазначає Содель Вокофер в коментарях, таку довгу команду форматування важко запам'ятати. Зазвичай це не проблема, оскільки ви можете помістити його у ~/.gitconfigфайл. Однак якщо вам іноді доводиться входити на віддалену машину, де ви не можете змінювати конфігураційний файл, ви можете скористатися більш простою, але швидшою для введення версією:

git log --graph --oneline

У мене є 3 псевдоніми (і 4 псевдоніми для швидкого використання), які я зазвичай кидаю у свій ~/.gitconfigфайл:

[alias]
    lg = lg1
    lg1 = lg1-specific --all
    lg2 = lg2-specific --all
    lg3 = lg3-specific --all

    lg1-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(auto)%d%C(reset)'
    lg2-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset)%C(auto)%d%C(reset)%n''          %C(white)%s%C(reset) %C(dim white)- %an%C(reset)'
    lg3-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset) %C(bold cyan)(committed: %cD)%C(reset) %C(auto)%d%C(reset)%n''          %C(white)%s%C(reset)%n''          %C(dim white)- %an <%ae> %C(reset) %C(dim white)(committer: %cn <%ce>)%C(reset)'

git lg/ git lg1виглядає приблизно так:

git lg2 виглядає так:

і git lg3виглядає так:

Слід зазначити, що це не має на увазі рішення, яке має бути закінченим всім - це шаблон, який ви можете змінити, додати та виправити на свій смак. Якщо ви хочете їх використовувати, моя рекомендація:

1. Додайте їх до своїх .gitconfig,
2. Налаштуйте на свій смак (різний вибір кольорів, різні розташування ліній для 2- та 3-рядкової версії тощо),
3. А потім збережіть копію в інструменті Gist або іншому фрагменті коду, щоб ви змогли скопіювати і вставити її в .gitconfigs в майбутньому (або, звичайно, керувати версією ваших точкових файлів) .

_{Примітка. Відповідь скопійовано та покращено у відповідь на stackoverflow.com/questions/1057564/pretty-git-branch-graphs, оскільки тут вона набагато доречніша, ніж там. Залишив копію на інше питання з історичних причин - він зараз закритий, а відповідь посилається на купу інших відповідей.}

До будь-якого з цих рецептів (заснованих на журналі git або gitk) ви можете додати, --simplify-by-decorationщоб згортати нецікаві лінійні частини історії. Це робить значно більше топології одразу видно. Зараз я можу зрозуміти великі історії, які були б незрозумілими без цього варіанту!

Я відчув необхідність опублікувати це, тому що він, здається, не такий відомий, як має бути. Він не з’являється у більшості запитань щодо переповнення стека щодо візуалізації історії, і мені знадобилося зовсім небагато пошуків - навіть після того, як я зрозумів, що цього хочу! Нарешті я знайшов це у звіті про помилки Debian . Першою згадкою про стек переповнення, здається, є ця відповідь Антуана Пелісса.

Gitk колись мені боляче читати.

Мотивуйте мене написати GitVersionTree .

99,999% мого часу переглядає історію, git lgа 0,001% - це git log.

Я просто хочу поділитися двома псевдонімами журналу, які можуть бути корисними (налаштування з .gitconfig):

[Alias]
     lg = log --graph --pretty=format:'%Cred%h%Creset %ad %s %C(yellow)%d%Creset %C(bold blue)<%an>%Creset' --date=short
     hist = log --graph --full-history --all --pretty=format:'%Cred%h%Creset %ad %s %C(yellow)%d%Creset %C(bold blue)<%an>%Creset' --date=short

• git lg побачить поточну історію філії.
• git hist побачить всю історію галузі.

Погляньте на Gitkraken - кросплатформенний графічний інтерфейс, який показує топологію виразно .

Ось короткий відео-посібник про деякі вдосконалені функції.

Мені подобається git logробити:

 git log --graph --oneline --branches

(також --all, також для перегляду віддалених гілок)

Працює з останніми випусками Git: вводиться з 1.6.3 ( Чт, 7 травня 2009 р. )

• --pretty=<style>Опція " " для сімейства команд журналів тепер може бути написана як " --format=<style>".
  Крім того, --format=%formatstringце короткий хід для --pretty=tformat:%formatstring.

• " --oneline" - синонім " --pretty=oneline --abbrev-commit".

PS D:\git\tests\finalRepo> git log --graph --oneline --branches --all
* 4919b68 a second bug10 fix
* 3469e13 a first bug10 fix
* dbcc7aa a first legacy evolution
| * 55aac85 another main evol
| | * 47e6ee1 a second bug10 fix
| | * 8183707 a first bug10 fix
| |/
| * e727105 a second evol for 2.0
| * 473d44e a main evol
|/
* b68c1f5 first evol, for making 1.0

Ви також можете обмежити проміжок відображення журналу (кількість комірок):

PS D:\git\tests\finalRepo> git log --graph --oneline --branches --all -5
* 4919b68 a second bug10 fix
* 3469e13 a first bug10 fix
* dbcc7aa a first legacy evolution
| * 55aac85 another main evol
| | * 47e6ee1 a second bug10 fix

(показати лише останні 5 комітів)

Що мені не подобається у поточному обраному рішенні:

 git log --graph

Тут відображається занадто багато інформації (коли я хочу лише переглянути короткий підсумок):

PS D:\git\tests\finalRepo> git log --graph
* commit 4919b681db93df82ead7ba6190eca6a49a9d82e7
| Author: VonC <vonc@laposte.net>
| Date:   Sat Nov 14 13:42:20 2009 +0100
|
|     a second bug10 fix
|
* commit 3469e13f8d0fadeac5fcb6f388aca69497fd08a9
| Author: VonC <vonc@laposte.net>
| Date:   Sat Nov 14 13:41:50 2009 +0100
|
|     a first bug10 fix
|

gitk чудово, але змушує мене залишити сеанс оболонки для іншого вікна, тоді як відображення останніх n фіксованих файлів досить швидко досить часто.

Gitg - це чудовий інструмент для Linux, подібний до Gitx для OS X. Просто запустіть "gitg" у командному рядку десь із структури дерева вашого сховища (те саме, що і з gitx).

Я вважав "git-big-picture" досить корисним: https://github.com/esc/git-big-picture

Він створює досить двовимірні графіки, використовуючи крапки / графік замість досить лінійних, "одновимірних" поглядів, що створюються gitk та друзями. За допомогою параметра -i він показує точки філії та об'єднання об'єктів, але залишає все між ними.

Хороший веб-інструмент - це мовчки . Він працює на будь-якій платформі, яку підтримує node.js & git. Є відео, як це працює для тих, кому такі речі легше, ніж читання ...

Погляньте на BranchMaster .

Я написав це для візуалізації складної структури гілки, згортаючи всі комісії між ними в один рядок. Цифри вказують на кількість комітів.

Ніхто не згадав tig? Він не згинає гілки, як "BranchMaster", але ...

Це швидко, працює в терміналі.

Оскільки настільки швидко (+ управління клавіатурою) ви отримуєте чудовий UX, він майже як " ls" для моїх каталогів, що містять сховища git.

https://jonas.github.io/tig/

У ньому є звичайні ярлики /для пошуку тощо.

(ps. це термінал на тлі цього скріншоту; він виглядає краще сьогодні, але мій комп'ютер відмовляється робити знімок екрана, вибачте)

(pps. Я також використовую gitkraken і має дуже чіткі візуалізації, але це набагато важче, ніж tig)

Tortoise Git має інструмент під назвою "Графік перегляду". Якщо ви працюєте в Windows, це так просто, як клацнути правою кнопкою миші на репо-репортажі -> Tortoise Git -> Графік редагування.

Giggle малює дуже гарні графіки.

Я використовую такі псевдоніми.

[alias]
    lol = log --graph --decorate --pretty=oneline --abbrev-commit
    lola = log --graph --decorate --pretty=oneline --abbrev-commit --all

Він має більше інформації в кольоровій гамі, ніж псевдоніми, які я бачив вище. Це також здається досить поширеним, тому у вас може виникнути шанс його існування в оточенні інших людей або ви зможете згадати його в розмові, не пояснюючи це.

З скріншотами та повним описом тут: http://blog.kfish.org/2010/04/git-lola.html

Для користувачів Mac, оформити замовлення (не призначено каламбур) безкоштовний інструмент з відкритим кодом GitUp: http://gitup.co/

Мені подобається те, як відображаються графіки, це чіткіше, ніж деякі інші інструменти, які я бачив.

Проект тут: https://github.com/git-up/GitUp

У мене є цей git logпсевдонім ~/.gitconfigдля перегляду історії графіків:

[alias]
l = log --all --graph --pretty=format:'%C(auto)%h%C(auto)%d %s %C(dim white)(%aN, %ar)'

З псевдонімом на місці git lпокаже щось подібне:

У Git 2.12 + ви навіть можете налаштувати кольори ліній графіка, використовуючиlog.graphColors конфігурації.

Що стосується формату журналів, він схожий --onelineз додаванням імені автора (з повагою .mailmap) та відносної дати автора . Зауважте, що %C(auto)синтаксис, який вказує Git використовувати кольори за замовчуванням для здійснення хешу тощо, підтримується в Git> = 1.8.3 .

Я знайшов цю сторінку в блозі, яка показує стислий спосіб:

git log --oneline --abbrev-commit --all --graph --decorate --color

Я зазвичай створюю псевдонім для вищевказаної команди:

alias gl='git log --oneline --abbrev-commit --all --graph --decorate --color'

і просто просто використовувати gl.

Ви також можете додати псевдонім до конфігурації git. Відкрийте ~/.gitconfigта додайте наступний рядок до [псевдоніма]

[alias]
        lg = log --oneline --abbrev-commit --all --graph --decorate --color

і використовувати його так: git lg

Мій особистий улюблений псевдонім, через .gitconfig, це:

graph = log --graph --color --all --pretty=format:"%C(yellow)%H%C(green)%d%C(reset)%n%x20%cd%n%x20%cn%x20(%ce)%n%x20%s%n"

Для тих, хто використовує текстовий редактор VSCode , розгляньте розширення історії Git від D. Jayamanne:

Gitx - це також фантастичний інструмент візуалізації, якщо ви потрапили в ОС X.

Ще одна команда журналу git. Цей із стовпцями фіксованої ширини :

git log --graph --pretty=format:"%x09%h | %<(10,trunc)%cd |%<(25,trunc)%d | %s" --date=short

Перевірте SmartGit. Це дуже нагадує мені візуалізацію відділення TortoiseHg і безкоштовно для некомерційного використання.

У Windows є дуже корисний інструмент, який ви можете використовувати: розширення git. Це інструмент gui і робить операції з git дуже простими.

Крім того, це відкриті джерела.

http://gitextensions.github.io

Я намагався, --simplify-by-decorationале всі мої злиття не показані. Тож я замість цього просто обрізаю рядки без символів "\" та "/" у заголовках, при цьому завжди зберігаю рядки з "(" вказуючи гілки одразу після цього. Коли відображається історія гілки, я взагалі незацікавлений у коментарях "виконувати", так Я також видаляю їх, і закінчую наступним псевдонімом оболонки.

gbh () { 
    git log --graph --oneline --decorate "$@" | grep '^[^0-9a-f]*[\\/][^0-9a-f]*\( [0-9a-f]\|$\)\|^[^0-9a-f]*[0-9a-f]*\ (' | sed -e 's/).*/)/'
}

чи можемо ми зробити це складніше?

Як щодо простого журналу git --all - decorate --oneline --graph (запам'ятайте собаку = - всі - декорат - он-лайн - граф)

Офіційний сайт Git заручився деякими інструментами GUI, призначеними сторонніми платформами. Потрапте сюди git Інструменти графічного інтерфейсу для платформи Linux

Я використовував gitgі GitKrakenдля Linux платформу. І те й інше добре розуміти дерево комітів