git-for-each-ref - מקוון בענן

תָכְנִית:

שֵׁם

git-for-each-ref - פלט מידע על כל ref

תַקצִיר

סילון לכל רפ [--ספירה= ] [--shell|--perl|--python|--tcl]
[(--sort= )...] [--format= ] [ ...]
[--מצביע-על ] [(--מוזג | --לא-מוזג) [ ]]
[--מכיל [ ]]

תיאור

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

אפשרויות

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


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


מחרוזת שמערבת את %(fieldname) מהאובייקט שעליו מצביע ישות ref
מוצג. אם הקידומת של שם השדה יש ​​כוכבית (*) וה-ref מצביע על תג
אובייקט, נעשה שימוש בערך של השדה בתג האובייקט מתייחס. כאשר לא מצוין,
ברירת המחדל היא %(objectname) SPC %(objecttype) TAB %(refname). זה גם אינטרפולציה של %% ל
%, ו-%xx כאשר xx הן ספרות hex אינטרפולציה לתווים עם קוד hex xx; ל
דוגמה %00 מתערב ל-\0 (NUL), %09 ל-\t (TAB) ו-%0a ל-\n (LF).

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

--shell, --perl, --python, --tcl
אם ניתנת, מחרוזות שמחליפות את %(fieldname) מצייני מיקום מצוטטות כמחרוזת
מילוליות המתאימים לשפה המארחת שצוינה. זה נועד לייצר א
scriptlet שניתן `לבחון` ישירות.

--מצביע על
רשום רק רפי שמצביעים על האובייקט הנתון.

--מיוחד [ ]
רשימת שופטים בלבד שניתן להגיע לטיפים שלהם מה-commit שצוין (HEAD אם לא
נָקוּב).

--לא ממוזג [ ]
רשימת שופטים בלבד שלא ניתן להגיע לטיפים שלהם מה-commit שצוין (HEAD אם לא
נָקוּב).

--מכיל [ ]
רשום רק תגים המכילים את ה-commit שצוין (HEAD אם לא צוין).

שדה שמות

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

עבור כל האובייקטים, ניתן להשתמש בשמות הבאים:

refname
שם ה-ref (החלק שאחרי $GIT_DIR/). לשם קצר שאינו חד משמעי של ה
ref append :קצר. האפשרות core.warnAmbiguousRefs משמשת לבחירת המחמיר
מצב קיצור. אם רצועה= מצורף, רצועות נתיב מופרד ברצועה
רכיבים מהחלק הקדמי של ה-refname (למשל, %(refname:strip=2) הופך refs/tags/foo
לתוך foo. חייב להיות מספר שלם חיובי. אם לשופט המוצג יש פחות רכיבים
מאשר , הפקודה מבטלת עם שגיאה.

סוג אובייקט
סוג האובייקט (בלוב, עץ, commit, תג).

גודל אובייקט
גודל האובייקט (זהה ל סילון קובץ חתול -s דיווחים).

שם אובייקט
שם האובייקט (המכונה SHA-1). לקיצור לא חד משמעי של שם האובייקט
להוסיף :קצר.

בְּמַעֲלֶה הַזֶרֶם
שם השופט המקומי שיכול להיחשב "במעלה הזרם" מהשו"ט המוצג.
מכבדים: קצר באותו אופן כמו refname לעיל. כבוד נוסף: מסלול להצגה
"[לפני N, מאחורי M]" ו-:trackshort כדי להציג את הגרסה התמציתית: ">" (לפני), "<"
(מאחור), "<>" (לפני ומאחור), או "=" (מסונכרן). אין השפעה אם השופט לא
יש מידע מעקב הקשור אליו.

לדחוף
שמו של ר"פ מקומי המייצג את המיקום @{push} עבור הר"מ המוצג.
מכבד את האפשרויות :short, :track ו-:trackshort כמו במעלה הזרם. מייצר ריק
מחרוזת אם אין @{push} ref מוגדר.

ראש
* אם HEAD תואם את ה-ref הנוכחי (הענף שהוצא החוצה), ' ' אחרת.

צֶבַע
שנה את צבע הפלט. בא אחריו : , שבו שמות מתוארים ב
צבע.ענף.*.

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

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

עבור אובייקטים של commit ותיוג, השדות המיוחדים לתאריך היוצר והיוצר יתאימו אליהם
התאריך המתאים או שם-דוא"ל-תאריך tuple משדות ה-committer או התיוג
בהתאם לסוג האובייקט. אלה מיועדים לעבודה על שילוב של מוער ו
תגיות קלות משקל.

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

ההודעה המלאה באובייקט commit ותג היא תוכן. השורה הראשונה שלו היא
contents:subject, כאשר נושא הוא השרשור של כל השורות של הודעת ה-commit למעלה
לשורה הריקה הראשונה. השורה הבאה היא תוכן: גוף, כאשר הגוף הוא כל הקווים
לאחר השורה הריקה הראשונה. חתימת ה-GPG האופציונלית היא contents:signature. ה-N הראשון
שורות ההודעה מתקבלות באמצעות contents:lines=N.

למטרות מיון, שדות עם ערכים מספריים ממיינים בסדר מספרי (גודל אובייקט,
authordate, committerdate, creatordate, taggerdate). כל שאר השדות משמשים למיון
סדר ערכי הבתים שלהם.

ישנה גם אפשרות למיין לפי גרסאות, ניתן לעשות זאת באמצעות שם השדה
version:refname או כינויו v:refname.

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

כמקרה מיוחד עבור שדות סוג התאריך, תוכל לציין פורמט עבור התאריך עד
הוספה : ואחריו שם פורמט התאריך (ראה את הערכים שהאפשרות --date to :git-rev-
רשימה(1) לוקח).

דוגמאות

דוגמה להפקה ישירה של טקסט מעוצב. הצג את 3 ההתחייבויות המתויגות האחרונות:

#!/ Bin / sh

git for-each-ref --count=3 --sort='-*authordate' \
--format='מאת: %(*authorname) %(*authoremail)
נושא: %(*נושא)
תאריך: %(*מחבר)
Ref: %(*refname)

%(*גוּף)
' 'refs/tags'

דוגמה פשוטה המציגה את השימוש ב- shell eval על הפלט, המדגימה את השימוש ב
--צדף. רשום את הקידומות של כל הראשים:

#!/ Bin / sh

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
בזמן קריאת הערך
do
eval "$entry"
echo `שם שם $ref`
עשה

דוח קצת יותר משוכלל על תגים, המוכיח שהפורמט עשוי להיות שלם
תַסרִיט:

#!/ Bin / sh

fmt='
r=%(refname)
t=%(*סוג אובייקט)
T=${r#refs/tags/}

o=%(*שם אובייקט)
n=%(*שם המחבר)
e=%(*מייל מחבר)
s=%(*נושא)
d=%(*מחבר)
b=%(*body)

סוג=תג
אם מבחן "z$t" = z
אז
# יכול להיות תג קל משקל
t=%(סוג אובייקט)
kind="תג קל משקל"
o=%(שם אובייקט)
n=%(שם המחבר)
e=%(authoremail)
s=%(נושא)
d=%(מחבר)
b=%(גוף)
fi
echo "$kind $T מצביע על $t אובייקט $o"
if test "z$t" = zcommit
אז
echo "המחאה נכתבה על ידי $n $e
ב-$d, ובכותרת

$s

ההודעה שלו נכתבת כך:
"
הד "$b" | sed -e "s/^/ /"
הד
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*objecttype' \
--sort=-taggerdate \
refs/tags`
eval "$eval"

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