git-blame - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

git-blame - Показує, яка редакція та автор востаннє змінювали кожен рядок файлу

СИНТАКСИС

мерзотник звинувачувати [-c] [-b] [-l] [--корінь] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--інкрементальний]
[-Л ] [-С ] [-M] [-C] [-C] [-C] [--с= ]
[--скорочене= ] [ | --зміст | --зворотний ] [--]

ОПИС

Анотує кожен рядок у даному файлі інформацією з останньої редакції
змінив лінію. За бажанням, починайте коментувати з даної редакції.

Якщо вказано один або кілька разів, -L обмежує анотацію запитаними рядками.

Початок рядків автоматично слідує в усіх перейменуваннях файлів (наразі є
немає можливості вимкнути перейменування). Щоб слідувати рядкам, переміщеним з одного файлу в
інший, або щоб слідувати рядкам, які були скопійовані та вставлені з іншого файлу тощо, див
Параметри -C і -M.

Звіт нічого не повідомляє про рядки, які були видалені або замінені; ти
необхідно використовувати такий інструмент, як мерзотник різниця або інтерфейс "кирки", коротко згаданий у
наступний параграф.

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

$ git log --pretty=oneline -S'blame_usage'
5040f17eba15504bad66b14a645bddd9b015ebb7 blame -S <ancestry-file>
ea4c7f9bf69e781dd0cd88d2bccb2bf5cc15c9a7 git-blame: Make the output

ВАРІАНТИ

-b
Показати порожній SHA-1 для межових фіксацій. Цим також можна керувати за допомогою
Параметр конфігурації blame.blankboundary.

--корінь
Не розглядайте кореневі коміти як межі. Цим також можна керувати за допомогою
Параметр конфігурації blame.showRoot.

--show-stats
Включіть додаткову статистику в кінці виводу звинувачення.

-Л , , -L :
Додайте анотації лише до заданого діапазону рядків. Можна вказати кілька разів. Перекриття
діапазони дозволені.

і є необов'язковими. “-Л ” або “-L », охоплює від до
кінець файлу. “-Л, ” охоплює від початку файлу до .

і може приймати одну з таких форм:

· кількість

Якщо або є числом, він визначає абсолютний номер рядка (кількість рядків
з 1).

· /регулярний вираз/

Ця форма використовуватиме перший рядок, що відповідає заданому регулярному виразу POSIX. Якщо є
регулярний вираз, він шукатиме з кінця попереднього діапазону -L, якщо такий є, інакше
від початку файлу. Якщо є “^/regex/”, він шукатиме з початку
файл. Якщо є регулярним виразом, він шукатиме, починаючи з рядка, заданого .

· +зміщення або -зміщення

Це справедливо лише для і вказуватиме ряд рядків до або після
рядок, заданий .

Якщо «: ” подається замість і , це регулярний вираз
який позначає діапазон від першого рядка назви функції, який відповідає , аж до
наступний рядок назви функції. “: ” виконує пошук з кінця попереднього діапазону -L, якщо
будь-який, інакше з початку файлу. «^: ” виконує пошук із початку файлу.

-l
Показати довгий оборот (за замовчуванням: вимкнено).

-t
Показувати необроблену мітку часу (за замовчуванням: вимкнено).

-С
Використовуйте версії з revs-файлу замість виклику git-rev-list(1).

--зворотний
Пройдіть історію вперед, а не назад. Замість показу редакції, в якій a
з’явився рядок, це показує останню редакцію, в якій існував рядок. Це вимагає
діапазон ревізій, наприклад START..END, де шлях до вини існує в START.

-р, --порцеляновий
Показати у форматі, призначеному для машинного споживання.

--лінії-фарфор
Показати порцеляновий формат, але вивести інформацію про фіксацію для кожного рядка, а не лише для
вперше посилається на коміт. Мається на увазі -- порцеляна.

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

--кодування=
Визначає кодування, яке використовується для виведення імен авторів та підсумків фіксації. Налаштування на
none не змушує виводити неперетворені дані. Для отримання додаткової інформації дивіться обговорення
про кодування в git-log(1) сторінка посібника.

--зміст
Коли не вказано, команда анотує зміни, починаючи з
копія робочого дерева. Цей прапор змушує команду робити вигляд, ніби робоче дерево копіює
має вміст названого файлу (вказати - щоб команда читалася з файлу
стандартний вхід).

--дата
Вказує формат, який використовується для виведення дат. Якщо --date не вказано, значення
використовується змінна конфігурації blame.date. Якщо змінна конфігурації blame.date також не встановлена,
використовується формат iso. Щоб дізнатися про підтримувані значення, див. обговорення параметра --date
at git-log(1).

-M| |
Виявлення переміщених або скопійованих рядків у файлі. Коли коміт переміщує або копіює блок
рядків (наприклад, вихідний файл має A, а потім B, а коміт змінює його на B і
потім А), традиційний звинувачувати Алгоритм помічає лише половину руху і
зазвичай звинувачує рядки, які були переміщені вгору (тобто B), до батьківського та приписує вину
до рядків, які були переміщені вниз (тобто A) до дочірнього фіксації. При цьому варіанті обидва
групи ліній звинувачуються на батьків, виконуючи додаткові проходи перевірки.

є необов’язковим, але це нижня межа кількості буквено-цифрових символів
що Git має виявити переміщення/копіювання у файлі, щоб він пов’язав ці рядки
з батьківським комітом. Значення за замовчуванням – 20.

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

є необов’язковим, але це нижня межа кількості буквено-цифрових символів
що Git повинен виявити як переміщення/копіювання між файлами, щоб він зв’язав ці рядки
з батьківським комітом. А значення за замовчуванням — 40. Якщо їх більше одного -C
надані варіанти, аргумент останнього -C набуде чинності.

-h
Показати довідкове повідомлення.

-c
Використовуйте той самий режим виводу, що і git-анотація(1) (За замовчуванням: вимкнено).

--score-debug
Включити інформацію про налагодження, пов’язану з переміщенням рядків між файлами (див. -C)
і рядки, переміщені у файлі (див. -M). Перше число в списку - це рахунок. Це
кількість алфавітно-цифрових символів, виявлених як переміщені між або всередині
файлів. Це повинно бути вище певного порогу для мерзотник звинувачувати розглянути ці рядки
код був переміщений.

-f, --показати-ім'я
Показати назву файлу в оригінальному коміті. За замовчуванням відображається ім’я файлу, якщо є
будь-який рядок, що надійшов із файлу з іншою назвою, через виявлення перейменування.

-n, --показати-номер
Показати номер рядка в оригінальному коміті (за замовчуванням: вимкнено).

-s
Вилучити ім’я автора та мітку часу з виводу.

-e, --show-email
Показувати електронну адресу автора замість імені автора (за умовчанням: вимкнено). Це також може бути
керується за допомогою параметра конфігурації blame.showEmail.

-w
Ігноруйте пробіли, порівнюючи батьківську версію та дитячу, щоб знайти, де
з’явилися рядки.

--скорочено=
Замість використання стандартних 7+1 шістнадцяткових цифр як скороченої назви об’єкта,
використовувати +1 цифри. Зверніть увагу, що 1 стовпець використовується для каретки для позначення межі.

THE ПАРЦЕЛЯНОВИЙ ФОРМАТ

У цьому форматі кожен рядок виводиться після заголовка; заголовок на мінімумі має
перший рядок, який має:

· 40-байтовий SHA-1 коміту, до якого приписується рядок;

· номер рядка в оригінальному файлі;

· номер рядка в кінцевому файлі;

· у рядку, який починається групу рядків з іншого коміту, ніж попередній,
кількість рядків у цій групі. У наступних рядках це поле відсутнє.

Після цього рядка заголовка принаймні один раз для кожного коміту йде така інформація:

· ім'я автора («автор»), електронна адреса («автор-пошта»), час («автор-час») та часовий пояс
(«автор-ц»); аналогічно для комітера.

· ім'я файлу в коміті, до якого приписується рядок.

· перший рядок повідомлення журналу фіксації («резюме»).

Вміст фактичного рядка виводиться після вищезазначеного заголовка з префіксом TAB. Це
дозволяє додавати більше елементів заголовка пізніше.

Формат порцеляни зазвичай приховує інформацію про фіксацію, яку вже бачили.
Наприклад, два рядки, які є винними в одному і тому ж коміті, будуть показані обидва, але
деталі цього коміту будуть показані лише один раз. Це ефективніше, але може знадобитися
більше стану зберігається у читача. Для повного виведення можна використовувати параметр --line-porcelain
фіксувати інформацію для кожного рядка, що дозволяє простіше (але менш ефективне) використовувати, наприклад:

# підрахуйте кількість рядків, приписаних кожному автору
git blame --line-porcelain файл |
sed -n 's/^автор //p' |
сортувати | uniq -c | сортувати -рн

УКАЗАННЯ ДИАПАЗОНИ

на відміну від мерзотник звинувачувати та мерзотник коментувати у старіших версіях git — обсяг анотації
може бути обмежено як діапазонами рядків, так і діапазонами редакцій. Параметр -L, який обмежує
анотацію до діапазону рядків можна вказати кілька разів.

Якщо вам цікаво знайти початок для рядків 40-60 для файлу foo, ви можете використовувати
параметр -L так (вони означають одне й те саме — обидва запитують 21 рядок, починаючи з рядка
40):

git винуватий -L 40,60 foo
git винуватий -L 40,+21 foo

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

git blame -L '/^sub привіт {/,/^}$/' foo

який обмежує анотацію тілом підпрограми hello.

Коли вас не цікавлять зміни, старіші за версію 2.6.18 або зміни, старіші за 3
тижнів, ви можете використовувати специфікатори діапазону редакцій, подібні до мерзотник рев-лист:

git blame v2.6.18.. -- foo
git blame --since=3.weeks -- foo

Коли специфікатори діапазону редагування використовуються для обмеження анотації, рядки, які цього не мають
змінено з моменту межі діапазону (або фіксація версії 2.6.18, або остання фіксація, яка
у наведеному вище прикладі віком більше 3 тижнів) звинувачують у фіксації межі діапазону.

Особливо корисний спосіб – перевірити, чи є у доданому файлі рядки, створені за допомогою копіювання та вставки
із наявних файлів. Іноді це вказує на те, що розробник був неохайним і зробив
не реорганізувати код належним чином. Спершу ви можете знайти комміт, який представив файл
з:

git log --diff-filter=A --pretty=short -- foo

а потім коментуйте зміну між комітом та його батьками, використовуючи commit^! позначення:

git звинувачувати -C -C -f $commit^! -- фу

НЕПРАВИЛЬНИЙ ВИХІД

При виклику з опцією --incremental команда виводить результат у міру створення. The
Як правило, вихідні дані будуть говорити про рядки, яких торкнулися останні коміти (тобто
рядки будуть анотовані не в порядку) і призначений для використання інтерактивними глядачами.

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

1. Кожен запис провини завжди починається з рядка:

<40-байтовий шістнадцятковий sha1>

Номери рядків відраховуються від 1.

2. Коли коміт вперше з'являється в потоці, він містить різну іншу інформацію
про це надруковано з однослівним тегом на початку кожного рядка, що описує
додаткова інформація про фіксацію (автор, електронна адреса, комітер, дати, підсумок тощо).

3. На відміну від формату Porcelain, інформація про назву файлу завжди надається та закінчується
запис:

"ім'я файлу"

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

примітки
Для людей, які займаються розбором: щоб зробити його більш надійним, просто ігноруйте будь-які рядки між ними
перший і останній (" " і "ім'я файлу"), де ви не впізнаєте
слова тегу (або турбота про це) на початку
рядки «розширена інформація». Таким чином, якщо коли-небудь буде додана інформація (наприклад
кодування коміту або розширений коментар до фіксації), звинувачувати глядача буде все одно.

СКАСУВАННЯ AUTHORS

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

У простій формі кожен рядок у файлі складається з канонічного справжнього імені an
автор, пробіл та адреса електронної пошти, що використовується в коміті (укладено < та >) на карту
до імені. Наприклад:

Власне ім'я[захищено електронною поштою]>

Більш складні форми:

<[захищено електронною поштою]>[захищено електронною поштою]>

що дозволяє mailmap замінювати лише частину повідомлення електронної пошти коміта, і:

Власне ім'я[захищено електронною поштою]>[захищено електронною поштою]>

що дозволяє mailmap замінювати як ім’я, так і адресу електронної пошти коміта, що відповідає
вказана електронна адреса для фіксації та:

Власне ім'я[захищено електронною поштою]> Ім'я коміту[захищено електронною поштою]>

що дозволяє mailmap замінити ім'я та адресу електронної пошти коміта, що відповідає обома
вказане ім’я коміту та адресу електронної пошти.

Приклад 1: Ваша історія містить коміти двох авторів, Джейн та Джо, чиї імена з’являються
у сховищі в кількох формах:

Джо Розробник[захищено електронною поштою]>
Джо Р. Розробник[захищено електронною поштою]>
Джейн Доу[захищено електронною поштою]>
Джейн Доу
Джейн Д.

Тепер припустимо, що Джо хоче, щоб спочатку використовувалося його друге ім’я, а Джейн віддає перевагу її прізвище
повністю прописаний. Правильний файл .mailmap виглядатиме так:

Джейн Доу
Джо Р. Розробник[захищено електронною поштою]>

Зверніть увагу, що немає потреби в записі для , тому що справжня назва
цей автор уже правий.

Приклад 2: Ваше сховище містить коміти від таких авторів:

нік1[захищено електронною поштою]>
нік2[захищено електронною поштою]>
нік2[захищено електронною поштою]>
Санта[захищено електронною поштою]>
клаус[захищено електронною поштою]>
технічний директор[захищено електронною поштою]>

Тоді вам може знадобитися файл .mailmap, який виглядає так:

<[захищено електронною поштою]>[захищено електронною поштою]>
Якийсь чувак[захищено електронною поштою]> нік1[захищено електронною поштою]>
Інший Автор[захищено електронною поштою]> нік2[захищено електронною поштою]>
Інший Автор[захищено електронною поштою]>[захищено електронною поштою]>
Санта Клаус[захищено електронною поштою]>[захищено електронною поштою]>

Використовуйте хеш # для коментарів, які знаходяться або в окремому рядку, або після адреси електронної пошти.

Використовуйте git-blame онлайн, використовуючи служби onworks.net