git-blame - מקוון בענן

תָכְנִית:

שֵׁם

git-blame - הראה איזה גרסה ומחבר שינו לאחרונה כל שורה בקובץ

תַקצִיר

סילון להאשים [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
[-ל ] [-ס ] [-M] [-C] [-C] [-C] [--מאז= ]
[--קיצור= ] [ | --תוכן | --לַהֲפוֹך ] [--]

תיאור

מציין כל שורה בקובץ הנתון עם מידע מהגרסה שנמשכה
שינה את הקו. לחלופין, התחל לכתוב הערות מהגרסה הנתונה.

כאשר צוין פעם אחת או יותר, -L מגביל את ההערה לשורות המבוקשות.

המקור של השורות עוקב באופן אוטומטי על פני שמות שינויי קבצים שלמים (נכון לעכשיו
אין אפשרות לבטל את שינוי השם). כדי לעקוב אחר שורות הועבר מקובץ אחד ל
אחר, או לעקוב אחר שורות שהועתקו והודבקו מקובץ אחר וכו', ראה את
אפשרויות -C ו-M.

הדוח אינו אומר לך דבר על שורות שנמחקו או הוחלפו; אתה
צריך להשתמש בכלי כגון סילון הבדל או ממשק ה-"pickaxe" שהוזכר בקצרה ב-
הפסקה הבאה.

מלבד תמיכה בהערות קבצים, 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.

--הצג סטטיסטיקות
כלול נתונים סטטיסטיים נוספים בסוף פלט האשמה.

-ל , , -L :
ציין רק את טווח השורות הנתון. ניתן לציין מספר פעמים. חוֹפֵף
טווחים מותרים.

ו הם אופציונליים. "-ל " או "-L " משתרע מ ל
סוף הקובץ. "-ל, " משתרע מתחילת הקובץ ועד .

ו יכול ללבוש אחת מהצורות הבאות:

· מספר

אם אוֹ הוא מספר, הוא מציין מספר קו מוחלט (ספירת שורות
משנת 1).

· /regex/

טופס זה ישתמש בשורה הראשונה התואמת את הביטוי הרגולרי הנתון של POSIX. אם הוא
regex, הוא יחפש מסוף טווח -L הקודם, אם בכלל, אחרת
מתחילת הקובץ. אם הוא "^/regex/", הוא יחפש מההתחלה של
קוֹבֶץ. אם הוא ביטוי רגולרי, הוא יחפש החל מהשורה שניתנה על ידי .

· +היסט או -היסט

זה תקף רק עבור ויציין מספר שורות לפני או אחרי
השורה שניתנה על ידי .

אם ": ” ניתן במקום ו , זה ביטוי רגולרי
שמציין את הטווח משורת ה-funcname הראשונה התואמת , עד
שורת funcname הבאה. ": " מחפש מסוף טווח -L הקודם, אם
כל, אחרת מתחילת הקובץ. "^: " מחפש מתחילת הקובץ.

-l
הצג סיבוב ארוך (ברירת מחדל: כבוי).

-t
הצג חותמת זמן גולמית (ברירת מחדל: כבוי).

-ס
השתמש בגרסאות מ-revs-file במקום להתקשר git-rev-list(1).

--לַהֲפוֹך
הלך בהיסטוריה קדימה במקום אחורה. במקום להציג את הגרסה שבה א
הופיע שורה, זה מראה את הגרסה האחרונה שבה קיימת שורה. זה דורש
טווח של גרסאות כמו START..END שבו הנתיב להאשים קיים ב-START.

-p, --פורצלן
הצג בפורמט המיועד לצריכת מכונות.

--ליין-פורצלן
הצג את פורמט הפורצלן, אבל פלט מידע מחויבות עבור כל שורה, לא רק עבור
פעם ראשונה שמתייחסים להתחייבות. מרמז על --פורצלן.

--מצטבר
הצג את התוצאה בהדרגה בפורמט המיועד לצריכת מכונה.

--קידוד=
מציין את הקידוד המשמש לפלט שמות מחברים וסיכומי התחייבות. מגדיר את זה ל
אף אחד לא גורם להאשים פלט נתונים לא מומרים. למידע נוסף עיין בדיון
לגבי קידוד ב- git-log(1) דף מדריך.

--תוכן
מתי לא צוין, הפקודה מסמנת את השינויים החל אחורה מ
עותק עץ העבודה. הדגל הזה גורם לפקודה להעמיד פנים כאילו עותק עץ העבודה
יש את התוכן של הקובץ בעל השם (ציין - כדי לגרום לפקודה לקרוא מתוך
קלט סטנדרטי).

--תַאֲרִיך
מציין את הפורמט המשמש לפלט תאריכים. אם לא מסופק --date, הערך של ה-
נעשה שימוש במשתנה התצורה blame.date. אם גם משתנה התצורה blame.date לא מוגדר,
נעשה שימוש בפורמט ISO. לערכים נתמכים, עיין בדיון על אפשרות --date
at git-log(1).

-מ| |
זיהוי שורות שהוזזו או שהועתקו בתוך קובץ. כאשר commit זז או מעתיק בלוק של
שורות (למשל בקובץ המקורי יש A ולאחר מכן B, וה-commit משנה אותו ל-B ו
ואז א), המסורתי להאשים האלגוריתם מבחין רק במחצית מהתנועה ו
בדרך כלל מאשים את השורות שהועברו למעלה (כלומר ב') להורה ומטיל אשמה
לקווים שהועברו למטה (כלומר א') ל-child commit. עם אפשרות זו, גם וגם
קבוצות של קווים מואשמות על ההורה על ידי הפעלת מעברי בדיקה נוספים.

הוא אופציונלי אך הוא הגבול התחתון של מספר התווים האלפאנומריים
ש-Git חייב לזהות כמוזז/מעתיק בתוך קובץ כדי שישייך את השורות האלה
עם התחייבות ההורים. ערך ברירת המחדל הוא 20.

-C| |
בנוסף ל-M, זהה שורות שהועתקו או הועתקו מקבצים אחרים ששונו
אותה התחייבות. זה שימושי כאשר אתה מארגן מחדש את התוכנית שלך ומעביר קוד
על פני קבצים. כאשר אפשרות זו ניתנת פעמיים, הפקודה מחפשת בנוסף
עותקים מקבצים אחרים ב-commit שיוצר את הקובץ. כאשר אפשרות זו ניתנת
שלוש פעמים, הפקודה מחפשת בנוסף עותקים מקבצים אחרים בכל commit.

הוא אופציונלי אך הוא הגבול התחתון של מספר התווים האלפאנומריים
ש-Git חייב לזהות כנע/מעתיק בין קבצים כדי שישייך את השורות האלה
עם התחייבות ההורים. וערך ברירת המחדל הוא 40. אם יש יותר מ-C אחד
אפשרויות שניתנו, ה הטיעון של ה-C האחרון ייכנס לתוקף.

-h
הצג הודעת עזרה.

-c
השתמש באותו מצב פלט כמו git-annotate(1) (ברירת מחדל: כבוי).

--ניפוי-ציון
כלול מידע איתור באגים הקשור לתנועת קווים בין קבצים (ראה -C)
ושורות שהועברו בתוך קובץ (ראה -M). המספר הראשון הרשום הוא הציון. זה
מספר התווים האלפאנומריים שזוהו כאילו הועברו בין או בתוכם
קבצים. זה חייב להיות מעל סף מסוים עבור סילון להאשים לשקול את השורות האלה של
הקוד שהועבר.

-f, --הצג-שם
הצג את שם הקובץ ב-commit המקורי. כברירת מחדל, שם הקובץ מוצג אם קיים
כל שורה שהגיעה מקובץ בשם אחר, עקב זיהוי שינוי שם.

-n, --הצג-מספר
הצג את מספר השורה ב-commit המקורי (ברירת מחדל: כבוי).

-s
דחק את שם המחבר וחותמת הזמן מהפלט.

-ה, --show-email
הצג את הדוא"ל של המחבר במקום את שם המחבר (ברירת מחדל: כבוי). זה גם יכול להיות
נשלט באמצעות אפשרות התצורה blame.showEmail.

-w
התעלם מרווח לבן בעת ​​השוואת גרסת ההורה לגרסת הילד כדי למצוא היכן
השורות הגיעו.

--קיצור=
במקום להשתמש ברירת המחדל של 7+1 ספרות הקסדצימליות כשם האובייקט המקוצר,
להשתמש +1 ספרות. שים לב שעמודה אחת משמשת לסימן לסימון התחייבות הגבול.

LA חַרְסִינָה פורמט

בפורמט זה, כל שורה יוצאת לאחר כותרת; הכותרת במינימום כוללת את
שורה ראשונה שיש בה:

· 40-בתים SHA-1 של ה-commit שהקו מיוחס אליו;

· מספר השורה של השורה בקובץ המקורי;

· מספר השורה של השורה בקובץ הסופי;

· בשורה שמתחילה קבוצת שורות מ-commit שונה מהקודמת,
מספר השורות בקבוצה זו. בשורות הבאות שדה זה נעדר.

אחרי שורת הכותרת הזו מופיע המידע הבא לפחות פעם אחת עבור כל commit:

· שם המחבר ("המחבר"), האימייל ("המחבר-מייל"), השעה ("זמן המחבר") ואזור הזמן
("מחבר-ץ"); באופן דומה עבור מתחייב.

· שם הקובץ ב-commit שהשורה מיוחסת לו.

· השורה הראשונה של הודעת יומן ההתחייבות ("סיכום").

התוכן של השורה בפועל מופק לאחר הכותרת למעלה, עם קידומת TAB. זֶה
היא לאפשר הוספת רכיבי כותרת נוספים מאוחר יותר.

פורמט הפורצלן בדרך כלל מדכא מידע להתחייבות שכבר נראה.
לדוגמה, שתי שורות המואשמות לאותו commit יוצגו, אבל ה-
הפרטים עבור התחייבות זו יוצגו פעם אחת בלבד. זה יעיל יותר, אבל עשוי לדרוש
מצב נוסף יישמר על ידי הקורא. ניתן להשתמש באפשרות --line-porcelain לפלט מלא
התחייבות למידע עבור כל שורה, מה שמאפשר שימוש פשוט יותר (אך פחות יעיל) כמו:

# לספור את מספר השורות המיוחסות לכל מחבר
git blame --line-porcelain file |
sed -n 's/^מחבר //p' |
מיון | uniq -c | מיון -rn

מפרט ריינג'ים

שונה סילון להאשים ו סילון ביאור בגרסאות ישנות יותר של git, מידת ההערה
ניתן להגביל הן לטווחי שורות והן לטווחי גרסאות. אפשרות -L, המגבילה
הערה לטווח של שורות, עשויה להיות מוגדרת מספר פעמים.

כאשר אתה מעוניין למצוא את המקור לשורות 40-60 עבור file foo, אתה יכול להשתמש
האפשרות -L כך (הם מתכוונים לאותו הדבר - שניהם מבקשים 21 שורות המתחילות בקו
40):

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

כמו כן, אתה יכול להשתמש בביטוי רגולרי כדי לציין את טווח השורות:

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

מה שמגביל את ההערה לגוף המשנה של שלום.

כאשר אינך מעוניין בשינויים ישנים מגרסה v2.6.18, או שינויים ישנים מ-3
שבועות, אתה יכול להשתמש במפרטי טווח גרסאות דומים ל סילון רשימת סיבובים:

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

כאשר משתמשים במפרטי טווח גרסאות כדי להגביל את ההערה, שורות שלא
השתנה מאז גבול הטווח (או ה-commit v2.6.18 או ה-commit האחרון
הוא בן יותר מ-3 שבועות בדוגמה שלמעלה) מואשמים בהתחייבות גבול הטווח.

דרך שימושית במיוחד היא לראות אם לקובץ נוסף יש שורות שנוצרו על ידי העתק והדבק
מקבצים קיימים. לפעמים זה מצביע על כך שהמפתח היה מרושל ועשה זאת
לא מחדש את הקוד כראוי. תחילה תוכל למצוא את ה-commit שהציג את הקובץ
עם:

git log-diff-filter = A-די = קצר-foo

ולאחר מכן הערה את השינוי בין ההתחייבות להוריה, באמצעות מחויבים^! סִמוּן:

git אשם -C -C -f $ להתחייב^! - פו

עלייה תפוקה

כאשר נקרא עם אפשרות --incremental, הפקודה מפלטת את התוצאה כפי שהיא נבנית. ה
הפלט, בדרך כלל, ידבר תחילה על שורות שנגעו בהתחייבויות אחרונות יותר (כלומר
שורות יופיעו ללא סדר) והן מיועדות לשמש את הצופים האינטראקטיביים.

פורמט הפלט דומה לפורמט פורצלן, אך אינו מכיל את הפורמט בפועל
שורות מהקובץ שמקבל הערות.

1. כל ערך אשמה מתחיל תמיד בשורה של:

<40-byte hex sha1>

מספרי שורות נספרות מ-1.

2. בפעם הראשונה ש-commit מופיע בזרם, יש לו מידע אחר
על זה מודפס עם תג של מילה אחת בתחילת כל שורה המתאר את
מידע נוסף על התחייבות (מחבר, דואר אלקטרוני, מתחייב, תאריכים, סיכום וכו').

3. בניגוד לפורמט פורצלן, מידע שם הקובץ תמיד ניתן ומסתיים
הכניסה:

"שם קובץ"

ולפיכך זה באמת די קל לנתח עבור מנתח בעל אוריינטציה של שורה ומילים
(מה שאמור להיות די טבעי עבור רוב שפות הסקריפט).

הערות
לאנשים שעוסקים בניתוח: כדי להפוך אותו חזק יותר, פשוט התעלם מכל השורות ביניהם
הראשון והאחרון (" " ו"שם קובץ") שבהם אינך מזהה
מילות התגית (או שאכפת לך ממנה) בתחילת ה-
שורות "מידע מורחב". בדרך זו, אם אי פעם יתווסף מידע (כמו
קידוד ה-commit או פרשנות ה-commit המורחבת), לצופה מאשים לא יהיה אכפת.

מיפוי מחברים

אם הקובץ .mailmap קיים ברמה העליונה של המאגר, או במיקום הצביע
כדי לפי אפשרויות התצורה mailmap.file או mailmap.blob, הוא משמש למיפוי מחבר ו
שמות מתחייבים וכתובות דוא"ל לשמות אמיתיים וכתובות דוא"ל קנוניים.

בצורה הפשוטה, כל שורה בקובץ מורכבת מהשם האמיתי הקנוני של an
מחבר, רווח לבן וכתובת דוא"ל המשמשת ב-commit (מצורף על ידי < ו >) למפות
לשם. לדוגמה:

שם מתאים[מוגן בדוא"ל]>

הצורות המורכבות יותר הן:

<[מוגן בדוא"ל]>[מוגן בדוא"ל]>

מה שמאפשר למפת דואר להחליף רק את חלק האימייל של commit, ו:

שם מתאים[מוגן בדוא"ל]>[מוגן בדוא"ל]>

מה שמאפשר למפת דואר להחליף גם את השם וגם את האימייל של commit התואם את
כתובת הדוא"ל שצוינה להתחייב, ו:

שם מתאים[מוגן בדוא"ל]> שם התחייבות[מוגן בדוא"ל]>

מה שמאפשר למייל להחליף גם את השם וגם את האימייל של commit התואם את שני
שם התחייבות וכתובת דוא"ל שצוינו.

דוגמה 1: ההיסטוריה שלך מכילה התחייבויות של שני מחברים, ג'יין וג'ו, ששמותיהם מופיעים
במאגר במספר צורות:

ג'ו מפתח[מוגן בדוא"ל]>
ג'ו ר. מפתח[מוגן בדוא"ל]>
ג'יין דו[מוגן בדוא"ל]>
ג'יין דו
ג'יין ד.

עכשיו נניח שג'ו רוצה שישמש את השם האמצעי שלו, וג'יין מעדיפה את שם המשפחה שלה
מאוית במלואו. קובץ ‎.mailmap תקין ייראה כך:

ג'יין דו
ג'ו ר. מפתח[מוגן בדוא"ל]>

שימו לב איך אין צורך בכניסה עבור , כי השם האמיתי של
הכותב הזה כבר צודק.

דוגמה 2: המאגר שלך מכיל התחייבויות מהמחברים הבאים:

ניק1[מוגן בדוא"ל]>
ניק2[מוגן בדוא"ל]>
ניק2[מוגן בדוא"ל]>
סנטה[מוגן בדוא"ל]>
קלאוס[מוגן בדוא"ל]>
CTO[מוגן בדוא"ל]>

אז אולי תרצה קובץ ‎.mailmap שנראה כך:

<[מוגן בדוא"ל]>[מוגן בדוא"ל]>
איזה אחי[מוגן בדוא"ל]> ניק1[מוגן בדוא"ל]>
מחבר אחר[מוגן בדוא"ל]> ניק2[מוגן בדוא"ל]>
מחבר אחר[מוגן בדוא"ל]>[מוגן בדוא"ל]>
סנטה קלאוס[מוגן בדוא"ל]>[מוגן בדוא"ל]>

השתמש ב-hash # להערות שנמצאות בשורה משלהן או אחרי כתובת האימייל.

השתמש ב-git-blame באינטרנט באמצעות שירותי onworks.net