git-blame - Online în cloud

PROGRAM:

NUME

git-blame - Arată ce revizuire și autor au modificat ultima dată fiecare linie a unui fișier

REZUMAT

merge vină [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
[-L ] [-S ] [-M] [-C] [-C] [-C] [--deoarece= ]
[--abbrev= ] [ | --conținut | --verso ] [--]

DESCRIERE

Adnotează fiecare linie din fișierul dat cu informații din versiunea care durează
a modificat linia. Opțional, începeți adnotarea din versiunea dată.

Când este specificat o dată sau de mai multe ori, -L restricționează adnotarea la liniile solicitate.

Originea liniilor este urmărită automat prin redenumiri ale întregului fișier (în prezent acolo
nu este nicio opțiune pentru a dezactiva urmărirea redenumirii). Pentru a urmări liniile mutate dintr-un fișier în
altul, sau pentru a urma liniile care au fost copiate și lipite dintr-un alt fișier etc., consultați
Opțiuni -C și -M.

Raportul nu vă spune nimic despre liniile care au fost șterse sau înlocuite; tu
trebuie să utilizați un instrument precum merge dif sau interfața „târnăcoapă” menționată pe scurt în
paragraful următor.

Pe lângă suportul pentru adnotarea fișierelor, Git acceptă și căutarea în istoricul dezvoltării
pentru când a apărut un fragment de cod într-o modificare. Acest lucru face posibilă urmărirea când un cod
fragment a fost adăugat la un fișier, mutat sau copiat între fișiere și, în cele din urmă, șters sau
înlocuit. Funcționează prin căutarea unui șir de text în difer. Un mic exemplu de
interfață pickaxe care caută blame_usage:

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

OPŢIUNI

-b
Afișați SHA-1 necompletat pentru comiterile de limită. Acest lucru poate fi controlat și prin intermediul
opțiunea de configurare blame.blankboundary.

--rădăcină
Nu tratați comiterile rădăcină ca limite. Acest lucru poate fi controlat și prin intermediul
opțiunea de configurare blame.showRoot.

--show-stats
Includeți statistici suplimentare la sfârșitul producției de vina.

-L , , -L :
Adnotați numai intervalul de linii dat. Poate fi specificat de mai multe ori. Suprapune
sunt permise intervale.

și sunt optionale. „-L ” sau „-L ,” se întinde din la
sfârşitul dosarului. „-L, ” se întinde de la începutul fișierului până la .

și poate lua una dintre aceste forme:

· număr

Dacă sau este un număr, specifică un număr absolut de linie (liniile numără
din 1).

· /regex/

Acest formular va folosi prima linie care se potrivește cu expresia regex POSIX dată. Dacă este o
regex, va căuta de la sfârșitul intervalului anterior -L, dacă există, în caz contrar
de la începutul fișierului. Dacă este „^/regex/”, va căuta de la începutul
fişier. Dacă este un regex, va căuta începând de la linia dată de .

· +offset sau -offset

Acest lucru este valabil doar pentru și va specifica un număr de rânduri înainte sau după
linia dată de .

Dacă ": ” se dă în locul lui și , este o expresie regulată
care denotă intervalul de la prima linie funcname care se potrivește , până la
următoarea linie funcname. „: ” caută de la sfârșitul intervalului anterior -L, dacă
oricare, altfel de la începutul fișierului. „^: ” caută de la începutul fișierului.

-l
Afișează turația lungă (implicit: dezactivat).

-t
Afișează marca temporală brută (Implicit: dezactivat).

-S
Utilizați revizuirile din fișierul revs în loc să apelați git-rev-list(1).

--verso
Mergeți istoricul înainte și nu înapoi. În loc să arate revizuirea în care a
a apărut linia, aceasta arată ultima revizuire în care a existat o linie. Este nevoie de
un interval de revizuire precum START..END unde calea de vină există în START.

-p, --porțelan
Afișați într-un format conceput pentru consumul de mașini.

--line-portelan
Afișați formatul de porțelan, dar scoateți informații de confirmare pentru fiecare linie, nu doar pentru
prima dată când se face referire la un commit. Implica --porțelan.

--incremental
Afișați rezultatul în mod incremental într-un format conceput pentru consumul mașinii.

--encoding=
Specifică codificarea utilizată pentru a ieși numele de autori și rezumatele de comitere. Setarea la
niciunul nu dă vina pe date neconvertite. Pentru mai multe informații vezi discuția
despre codificarea în git-log(1) pagină de manual.

--conținut
Cand nu este specificat, comanda adnotă modificările pornind înapoi de la
copia arborelui de lucru. Acest flag face comanda să pretindă ca și cum ar fi copiat arborele de lucru
are conținutul fișierului numit (specificați - pentru a face comanda citită din fișierul
intrare standard).

--Data
Specifică formatul utilizat pentru a ieși datele. Dacă nu este furnizată --date, valoarea lui
este folosită variabila blame.date de configurare. Dacă nici variabila de configurare blame.date nu este setată,
este folosit formatul iso. Pentru valorile acceptate, consultați discuția despre opțiunea --date
at git-log(1).

-M| |
Detectați liniile mutate sau copiate într-un fișier. Când un commit mută sau copiază un bloc de
linii (de exemplu, fișierul original are A și apoi B, iar commit-ul îl schimbă în B și
apoi A), tradiționalul vină algoritmul observă doar jumătate din mișcare și
de obicei, dă vina pe rândurile care au fost mutate în sus (adică B) către părinte și atribuie vina
la liniile care au fost mutate în jos (adică A) la copilul comite. Cu această opțiune, ambele
grupurile de linii sunt puse pe seama părintelui prin efectuarea de treceri suplimentare de inspecție.

este opțional, dar este limita inferioară a numărului de caractere alfanumerice
pe care Git trebuie să îl detecteze ca mutare/copiere într-un fișier pentru a asocia acele linii
cu commit-ul părintelui. Valoarea implicită este 20.

-C| |
Pe lângă -M, detectează liniile mutate sau copiate din alte fișiere care au fost modificate în
acelasi comit. Acest lucru este util atunci când vă reorganizați programul și mutați codul
peste fișiere. Când această opțiune este dată de două ori, comanda caută suplimentar
copii din alte fișiere din commit-ul care creează fișierul. Când este dată această opțiune
de trei ori, comanda caută în plus copii din alte fișiere în orice commit.

este opțional, dar este limita inferioară a numărului de caractere alfanumerice
pe care Git trebuie să îl detecteze ca mutare/copiere între fișiere pentru a asocia acele linii
cu commit-ul părintelui. Și valoarea implicită este 40. Dacă există mai multe -C
opțiunile date, the argumentul ultimului -C va avea efect.

-h
Afișează mesajul de ajutor.

-c
Utilizați același mod de ieșire ca git-annotate(1) (Implicit: dezactivat).

--score-debug
Includeți informații de depanare legate de mișcarea liniilor între fișiere (vezi -C)
și liniile mutate într-un fișier (vezi -M). Primul număr afișat este scorul. Aceasta este
numărul de caractere alfanumerice detectate ca fiind mutate între sau în interior
fișiere. Acesta trebuie să fie peste un anumit prag pt merge vină a lua în considerare acele linii de
codul să fi fost mutat.

-f, --show-name
Afișați numele fișierului în commit-ul original. În mod implicit, numele fișierului este afișat dacă există
orice linie care provine dintr-un fișier cu alt nume, datorită detectării redenumirii.

-n, --arata-numar
Afișați numărul liniei în comiterea inițială (implicit: dezactivat).

-s
Suprimați numele autorului și marca temporală din rezultat.

-e, --show-email
Afișați e-mailul autorului în loc de numele autorului (implicit: dezactivat). Poate fi și asta
controlat prin opțiunea blame.showEmail de configurare.

-w
Ignorați spațiile albe atunci când comparați versiunea părintelui și a copilului pentru a afla unde
liniile au venit de la.

--abbrev=
În loc să utilizați implicit 7+1 cifre hexazecimale ca nume abreviat al obiectului,
utilizare +1 cifre. Rețineți că 1 coloană este folosită pentru un indicator pentru a marca comiterea limită.

THE PORŢELAN FORMAT

În acest format, fiecare linie este scoasă după un antet; antetul la minimum are
prima linie care are:

· SHA-40 de 1 de octeți ai comenzii căreia îi este atribuită linia;

· numărul rândului liniei din fișierul original;

· numărul rândului liniei din fișierul final;

· pe o linie care începe un grup de linii dintr-un alt commit decât cel precedent,
numărul de linii din acest grup. În rândurile următoare, acest câmp este absent.

Această linie de antet este urmată de următoarele informații cel puțin o dată pentru fiecare comitere:

· numele autorului („autor”), e-mail („autor-mail”), ora („autor-ora”) și fusul orar
(„autor-tz”); la fel pentru committer.

· numele fișierului din commit căruia îi este atribuită linia.

· prima linie a mesajului de jurnal de comitere („rezumat”).

Conținutul liniei reale este scos după antetul de mai sus, prefixat de un TAB. Acest
este de a permite adăugarea mai multor elemente de antet mai târziu.

Formatul porțelan suprimă în general informațiile de comitere care au fost deja văzute.
De exemplu, două linii care sunt atribuite aceluiași comit vor fi afișate ambele, dar
detaliile pentru acel comit vor fi afișate o singură dată. Acest lucru este mai eficient, dar poate necesita
mai multă stare să fie păstrată de către cititor. Opțiunea --line-porțelan poate fi utilizată pentru a ieși complet
commit informații pentru fiecare linie, permițând o utilizare mai simplă (dar mai puțin eficientă), cum ar fi:

# numără numărul de rânduri atribuite fiecărui autor
git blame --line-dosier porțelan |
sed -n 's/^autor //p' |
sortare | uniq -c | sortare -rn

SPECIFICAREA GAMA

Spre deosebire de merge vină și merge adnota în versiunile mai vechi de git, amploarea adnotării
poate fi limitat atât la intervale de linii, cât și la intervale de revizuire. Opțiunea -L, care limitează
adnotarea unui interval de linii, poate fi specificată de mai multe ori.

Când sunteți interesat să găsiți originea pentru liniile 40-60 pentru fișierul foo, puteți utiliza
opțiunea -L așa (înseamnă același lucru - ambele cer 21 de linii care încep la linie
40):

git blame -L 40,60 foo
git blame -L 40,+21 foo

De asemenea, puteți utiliza o expresie regulată pentru a specifica intervalul de linii:

git blame -L '/^sub salut {/,/^}$/' foo

care limitează adnotarea la corpul subrutinei hello.

Când nu sunteți interesat de modificări mai vechi decât versiunea v2.6.18 sau modificări mai vechi de 3
săptămâni, puteți utiliza specificatori de intervale de revizuire similare cu merge rev-list:

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

Când specificatorii intervalului de revizuire sunt utilizați pentru a limita adnotarea, liniile care nu au
modificat de la limita intervalului (fie commit-ul v2.6.18, fie cel mai recent commit care
are mai mult de 3 săptămâni în exemplul de mai sus) sunt acuzați pentru acea comitere a limitei intervalului.

O modalitate deosebit de utilă este de a vedea dacă un fișier adăugat are linii create prin copiere și inserare
din fișierele existente. Uneori, acest lucru indică faptul că dezvoltatorul a fost neglijent și a făcut-o
nu refactorizează corect codul. Puteți găsi mai întâi commit-ul care a introdus fișierul
cu:

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

și apoi adnotă schimbarea dintre commit și părinții săi, folosind commit^! notaţie:

git blame -C -C -f $commit^! -- foo

INCREMENTAL REZULTATE

Când este apelată cu opțiunea --incremental, comanda scoate rezultatul pe măsură ce este construit. The
ieșirea, în general, va vorbi mai întâi despre liniile atinse de comiterile mai recente (adică
liniile vor fi adnotate în afara ordinului) și este menit să fie folosit de spectatorii interactivi.

Formatul de ieșire este similar cu formatul Porțelan, dar nu conține cel real
linii din fișierul care este adnotat.

1. Fiecare intrare de vină începe întotdeauna cu o linie de:

<40-byte hex sha1>

Numerele liniilor contează de la 1.

2. Prima dată când un commit apare în flux, are diverse alte informații
despre ea tipărită cu o etichetă de un cuvânt la începutul fiecărei rânduri care descrie
informații suplimentare de comitere (autor, e-mail, committer, date, rezumat etc.).

3. Spre deosebire de formatul Porțelan, informațiile despre numele fișierului sunt întotdeauna date și se termină
intrarea:

"nume de fișier"

și astfel este destul de ușor de analizat pentru un parser orientat pe linii și cuvinte
(ceea ce ar trebui să fie destul de natural pentru majoritatea limbajelor de scripting).

notițe
Pentru persoanele care fac analiza: pentru a o face mai robustă, ignorați orice rând între ele
primul și ultimul (" " și liniile "nume fișier") unde nu recunoașteți
cuvintele etichete (sau pasă de acel anume) la începutul
linii de „informații extinse”. În acest fel, dacă există vreodată informații adăugate (cum ar fi
codificarea de comitere sau comentariul de comitere extins), unui spectator de vina nu îi va păsa.

CARTOGRAFIERE AUTORI

Dacă fișierul .mailmap există la nivelul superior al depozitului sau în locația indicată
prin opțiunile de configurare mailmap.file sau mailmap.blob, este folosit pentru a mapa autorul și
trimiteți nume și adrese de e-mail în nume reale canonice și adrese de e-mail.

În forma simplă, fiecare linie din fișier constă din numele real canonic al lui an
autor, spații albe și o adresă de e-mail utilizată în comitere (inclusă de < și >) pentru a cartografi
la nume. De exemplu:

Denumirea corectă[e-mail protejat]>

Formele mai complexe sunt:

<[e-mail protejat]>[e-mail protejat]>

care permite mailmap să înlocuiască doar partea de e-mail a unui commit și:

Denumirea corectă[e-mail protejat]>[e-mail protejat]>

care permite mail map să înlocuiască atât numele, cât și e-mailul unui commit care se potrivește cu
adresa de e-mail de confirmare specificată și:

Denumirea corectă[e-mail protejat]> Nume de comitere[e-mail protejat]>

care permite mailmap să înlocuiască atât numele, cât și e-mailul unui commit care se potrivește atât cu
numele de comitere și adresa de e-mail specificate.

Exemplul 1: Istoricul tău conține comiterea a doi autori, Jane și Joe, ale căror nume apar
în depozit sub mai multe forme:

Joe Dezvoltator[e-mail protejat]>
Joe R. Dezvoltator[e-mail protejat]>
femeie necunoscută[e-mail protejat]>
femeie necunoscută
Jane D.

Acum să presupunem că Joe dorește ca inițiala numelui său să fie folosită, iar Jane preferă numele ei de familie
complet precizat. Un fișier .mailmap adecvat ar arăta astfel:

femeie necunoscută
Joe R. Dezvoltator[e-mail protejat]>

Rețineți că nu este nevoie de o intrare pentru , deoarece numele real al
acel autor are deja dreptate.

Exemplul 2: depozitul dvs. conține comite de la următorii autori:

porecla1[e-mail protejat]>
porecla2[e-mail protejat]>
porecla2[e-mail protejat]>
moşul[e-mail protejat]>
claus[e-mail protejat]>
CTO[e-mail protejat]>

Atunci s-ar putea să doriți un fișier .mailmap care să arate astfel:

<[e-mail protejat]>[e-mail protejat]>
Un tip[e-mail protejat]> nick1[e-mail protejat]>
Alt Autor[e-mail protejat]> nick2[e-mail protejat]>
Alt Autor[e-mail protejat]>[e-mail protejat]>
Mos Craciun[e-mail protejat]>[e-mail protejat]>

Folosiți haș # pentru comentarii care sunt fie pe linia lor, fie după adresa de e-mail.

Utilizați git-blame online folosind serviciile onworks.net