git-blame - عبر الإنترنت في السحابة

برنامج:

اسم

git-blame - إظهار المراجعة والمؤلف الذي قام بتعديل آخر سطر من الملف

موجز

طائرة نفاثة لوم [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--تزايدي]
[-L ] [-س ] [-M] [-C] [-C] [-C] [--منذ= ]
[--اختصار= ] [ | --محتويات | --يعكس ] [--]

الوصف

يعلق كل سطر في الملف المحدد بمعلومات من المراجعة الأخيرة
عدلت الخط. اختياريًا، ابدأ التعليق التوضيحي من المراجعة المحددة.

عند تحديده مرة واحدة أو أكثر، يقوم -L بتقييد التعليق التوضيحي على الأسطر المطلوبة.

تتم متابعة أصل الأسطر تلقائيًا عبر عمليات إعادة تسمية الملف بالكامل (يوجد حاليًا
لا يوجد خيار لإيقاف تشغيل متابعة إعادة التسمية). لمتابعة الأسطر المنقولة من ملف واحد إلى
آخر، أو لمتابعة الأسطر التي تم نسخها ولصقها من ملف آخر، وما إلى ذلك، راجع
خيارات -C و -M.

لا يخبرك التقرير بأي شيء عن الأسطر التي تم حذفها أو استبدالها؛ أنت
تحتاج إلى استخدام أداة مثل طائرة نفاثة فرق أو واجهة "الفأس" المذكورة بإيجاز في ملف
الفقرة التالية.

وبصرف النظر عن دعم التعليقات التوضيحية للملف، يدعم Git أيضًا البحث في سجل التطوير
عندما يحدث مقتطف التعليمات البرمجية في التغيير. وهذا يجعل من الممكن تتبع عندما رمز
تمت إضافة مقتطف إلى ملف، أو نقله أو نسخه بين الملفات، ثم حذفه أو حذفه في النهاية
استبدال. وهو يعمل من خلال البحث عن سلسلة نصية في الفرق. مثال صغير على
واجهة الفأس التي تبحث عن استعمال اللوم:

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

OPTIONS

-b
إظهار SHA-1 الفارغة لالتزامات الحدود. ويمكن أيضًا التحكم في ذلك عبر
خيار التكوين Blankboundary.

--جذر
لا تعامل التزامات الجذر كحدود. ويمكن أيضًا التحكم في ذلك عبر
خيار التكوين إلقاء اللوم.showRoot.

--إحصائيات العرض
قم بتضمين إحصائيات إضافية في نهاية إخراج اللوم.

-ل , ، -ل :
قم بتعليق نطاق الخط المحدد فقط. يمكن تحديدها عدة مرات. تداخل
النطاقات مسموح بها.

و هي اختيارية. "- ل "أو" -L "، يمتد من ل
نهاية الملف. "- ل، " يمتد من بداية الملف إلى .

و يمكن أن يتخذ أحد هذه الأشكال:

· رقم

لو أو هو رقم يحدد رقم سطر مطلق (عدد الأسطر
من عام 1).

· / regex /

سيستخدم هذا النموذج السطر الأول المطابق للتعبير العادي POSIX المحدد. لو هو
regex، فإنه سيتم البحث من نهاية النطاق -L السابق، إن وجد، وإلا
من بداية الملف. لو هو "^/regex/"، وسيبحث من البداية
ملف. لو هو regex ، وسوف يبحث بدءًا من السطر المعطى بواسطة .

· +إزاحة أو -إزاحة

هذا صالح فقط ل وسيحدد عدد الأسطر قبل أو بعد
الخط الذي قدمه .

لو ": "يتم تقديمه بدلاً من و ، إنه تعبير عادي
يشير إلى النطاق من سطر funcname الأول الذي يطابق ، حتى
سطر funcname التالي. ": " يبحث من نهاية النطاق -L السابق، إذا
أي، وإلا من بداية الملف. “^: "البحث من بداية الملف.

-l
إظهار سرعة الدوران الطويلة (الافتراضي: إيقاف).

-t
إظهار الطابع الزمني الأولي (الافتراضي: إيقاف).

-س
استخدم المراجعات من ملف revs بدلاً من الاتصال قائمة git-rev(1).

--يعكس
السير بالتاريخ إلى الأمام بدلاً من الخلف. بدلاً من إظهار المراجعة التي فيها أ
ظهر السطر، وهذا يوضح المراجعة الأخيرة التي كان يوجد فيها السطر. هذا يتطلب
نطاق من المراجعة مثل START..END حيث يوجد المسار المسؤول في START.

-p، - بورسلين
اعرض بتنسيق مصمم لاستهلاك الماكينة.

--خط بورسلين
إظهار تنسيق الخزف، ولكن إخراج معلومات الالتزام لكل سطر، وليس فقط
أول مرة تتم الإشارة إلى الالتزام. يعني - الخزف.

--تدريجي
إظهار النتيجة بشكل تدريجي بتنسيق مصمم لاستهلاك الجهاز.

- ترميز =
يحدد الترميز المستخدم لإخراج أسماء المؤلفين وتنفيذ الملخصات. ضبطه على
لا شيء يلقي اللوم على إخراج البيانات غير المحولة. لمزيد من المعلومات راجع المناقشة
حول الترميز في بوابة الدخول(1) صفحة دليل.

--محتويات
متى لم يتم تحديده، يقوم الأمر بتعليق التغييرات التي تبدأ بشكل عكسي من
نسخة شجرة العمل. هذه العلامة تجعل الأمر يتظاهر كما لو كان نسخة شجرة العمل
يحتوي على محتويات الملف المحدد (حدد - لجعل الأمر يقرأ من ملف
الإدخال القياسي).

--تاريخ
يحدد التنسيق المستخدم لإخراج التواريخ. إذا لم يتم توفير --date، فستكون قيمة
يتم استخدام متغير التكوين Blame.date. إذا لم يتم أيضًا تعيين متغير التكوين Blam.date،
يتم استخدام تنسيق ISO. للحصول على القيم المدعومة، راجع مناقشة خيار --date
at بوابة الدخول(1).

-م| |
كشف الخطوط المنقولة أو المنسوخة داخل الملف. عندما يتحرك الالتزام أو ينسخ كتلة من
الأسطر (على سبيل المثال، يحتوي الملف الأصلي على A ثم B، ويغيره الالتزام إلى B و
ثم أ) التقليدية لوم تلاحظ الخوارزمية نصف الحركة فقط و
عادةً ما يلقي اللوم على الأسطر التي تم نقلها للأعلى (أي B) إلى الأصل ويحدد اللوم
إلى الأسطر التي تم نقلها إلى أسفل (أي A) لارتكاب الطفل. مع هذا الخيار، على حد سواء
يتم إلقاء اللوم على مجموعات الخطوط على الوالد عن طريق إجراء تصاريح فحص إضافية.

يعد اختياريًا ولكنه يمثل الحد الأدنى لعدد الأحرف الأبجدية الرقمية
يجب أن يكتشف Git أنه نقل/نسخ داخل ملف حتى يتمكن من ربط تلك الأسطر
مع التزام الوالدين. القيمة الافتراضية هي 20.

-ج| |
بالإضافة إلى -M، يمكنك اكتشاف الخطوط المنقولة أو المنسوخة من الملفات الأخرى التي تم تعديلها فيها
نفس الالتزام. يعد هذا مفيدًا عند إعادة تنظيم برنامجك ونقل التعليمات البرمجية
عبر الملفات. عندما يتم إعطاء هذا الخيار مرتين، يبحث الأمر أيضًا عن
نسخ من ملفات أخرى في الالتزام الذي يقوم بإنشاء الملف. عندما يتم إعطاء هذا الخيار
ثلاث مرات، يبحث الأمر أيضًا عن نسخ من ملفات أخرى في أي التزام.

يعد اختياريًا ولكنه يمثل الحد الأدنى لعدد الأحرف الأبجدية الرقمية
يجب على Git اكتشاف النقل/النسخ بين الملفات حتى يتمكن من ربط تلك الخطوط
مع التزام الوالدين. والقيمة الافتراضية هي 40. إذا كان هناك أكثر من -C
الخيارات المقدمة، وسيطة الأخير -C سوف تصبح نافذة المفعول.

-h
إظهار رسالة المساعدة.

-c
استخدم نفس وضع الإخراج كما git-annotate(1) (الإعداد الافتراضي: إيقاف).

--score-debug
تضمين معلومات تصحيح الأخطاء المتعلقة بحركة الخطوط بين الملفات (انظر -C)
والخطوط المنقولة داخل ملف (انظر -M). الرقم الأول المذكور هو النتيجة. هذا هو
عدد الأحرف الأبجدية الرقمية التي تم اكتشاف أنها تم نقلها بين أو داخل
ملفات. ويجب أن يكون هذا أعلى من حد معين ل طائرة نفاثة لوم للنظر في تلك الخطوط من
الرمز الذي تم نقله.

-f، --show-name
إظهار اسم الملف في الالتزام الأصلي. بشكل افتراضي، يتم عرض اسم الملف إذا كان هناك
أي سطر يأتي من ملف باسم مختلف، بسبب اكتشاف إعادة التسمية.

-ن، --إظهار الرقم
إظهار رقم السطر في الالتزام الأصلي (الافتراضي: إيقاف).

-s
منع اسم المؤلف والطابع الزمني من الإخراج.

-e, --show-email
إظهار البريد الإلكتروني للمؤلف بدلاً من اسم المؤلف (الافتراضي: إيقاف). يمكن أن يكون هذا أيضًا
يتم التحكم فيه عن طريق خيار التكوين flesh.showEmail.

-w
تجاهل المسافة البيضاء عند مقارنة إصدار الوالدين وإصدار الطفل للعثور على المكان
جاءت الخطوط من.

--abbrev=
بدلاً من استخدام الأرقام السداسية العشرية 7+1 الافتراضية كاسم كائن مختصر،
يستخدم +1 أرقام. لاحظ أنه يتم استخدام عمود واحد لعلامة الإقحام لوضع علامة على التزام الحدود.

ال الخزف FORMAT

في هذا التنسيق، يتم إخراج كل سطر بعد الرأس؛ الرأس في الحد الأدنى لديه
السطر الأول الذي يحتوي على:

· 40 بايت SHA-1 من الخط المنسوب إلى الالتزام؛

· رقم السطر في الملف الأصلي.

· رقم السطر في الملف النهائي.

· على السطر الذي يبدأ مجموعة أسطر من التزام مختلف عن سابقتها،
عدد الأسطر في هذه المجموعة. في الأسطر اللاحقة هذا الحقل غائب.

يتبع سطر الرأس هذا المعلومات التالية مرة واحدة على الأقل لكل التزام:

· اسم المؤلف ("المؤلف")، والبريد الإلكتروني ("بريد المؤلف")، والوقت ("وقت المؤلف")، والمنطقة الزمنية
("المؤلف-tz")؛ بالمثل بالنسبة للملتزم.

· اسم الملف الموجود في الالتزام المنسوب إليه السطر.

· السطر الأول من رسالة سجل الالتزام ("الملخص").

يتم إخراج محتويات السطر الفعلي بعد الرأس أعلاه، مسبوقًا بعلامة تبويب. هذا
هو السماح بإضافة المزيد من عناصر الرأس لاحقًا.

يقوم تنسيق الخزف عمومًا بمنع معلومات الالتزام التي تمت رؤيتها بالفعل.
على سبيل المثال، سيتم عرض سطرين يتم إلقاء اللوم عليهما في نفس الالتزام، ولكن
سيتم عرض تفاصيل هذا الالتزام مرة واحدة فقط. وهذا أكثر كفاءة، ولكنه قد يتطلب
المزيد من الحالة يجب أن يحتفظ بها القارئ. يمكن استخدام خيار --line-porcelain للإخراج بالكامل
معلومات الالتزام لكل سطر، مما يسمح باستخدام أبسط (ولكن أقل كفاءة) مثل:

# حساب عدد الأسطر المنسوبة لكل مؤلف
git Blame --line-porcelain file |
sed -n 's/^author //p' |
فرز | يونيك -ج | فرز -rn

التحديد نطاقات

الغاء الاعجاب طائرة نفاثة لوم و طائرة نفاثة علق في الإصدارات الأقدم من git، مدى التعليق التوضيحي
يمكن أن يقتصر على نطاقات الخط ونطاقات المراجعة. الخيار -L، الذي يحد
يمكن تحديد التعليق التوضيحي لمجموعة من الأسطر عدة مرات.

عندما تكون مهتمًا بالعثور على أصل الأسطر 40-60 للملف foo، يمكنك استخدامه
الخيار -L هكذا (يعنيان نفس الشيء - كلاهما يطلب 21 سطرًا بدءًا من السطر
40):

بوابة اللوم -L 40,60 foo
بوابة اللوم -L 40,+21 foo

كما يمكنك استخدام تعبير عادي لتحديد نطاق الخط:

gitلوم -L '/^sub hello {/,/^}$/' foo

مما يحد من التعليق التوضيحي على نص برنامج الترحيب الفرعي.

عندما لا تكون مهتمًا بالتغييرات الأقدم من الإصدار v2.6.18، أو التغييرات الأقدم من 3
أسابيع، يمكنك استخدام محددات نطاق المراجعة المشابهة لـ طائرة نفاثة قائمة المراجعة:

gitلوم v2.6.18.. -- foo
gitلوم --since=3.weeks -- foo

عندما يتم استخدام محددات نطاق المراجعة للحد من التعليق التوضيحي، فإن الأسطر التي لم يتم ذلك
تم تغييره منذ حدود النطاق (إما الالتزام v2.6.18 أو الالتزام الأحدث
عمرها أكثر من 3 أسابيع في المثال أعلاه) يتم إلقاء اللوم عليها في الالتزام بحدود النطاق.

هناك طريقة مفيدة بشكل خاص وهي معرفة ما إذا كان الملف المضاف يحتوي على أسطر تم إنشاؤها عن طريق النسخ واللصق
من الملفات الموجودة في بعض الأحيان يشير هذا إلى أن المطور كان قذرًا وقد فعل ذلك
عدم إعادة بناء الكود بشكل صحيح. يمكنك أولاً العثور على الالتزام الذي قدم الملف
مع:

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

ثم قم بتعليق التغيير بين الالتزام ووالديه باستخدام الالتزام^! الرموز:

gitلوم -C -C -f $commit^! -- فو

تدريجي OUTPUT

عند استدعائه باستخدام خيار --incremental، يُخرج الأمر النتيجة كما تم إنشاؤها. ال
سيتحدث الإخراج بشكل عام عن الخطوط التي تم التطرق إليها من خلال الالتزامات الأحدث أولاً (على سبيل المثال
سيتم وضع تعليقات توضيحية على الأسطر خارج الترتيب) ومن المفترض أن يستخدمها المشاهدون التفاعليون.

يشبه تنسيق الإخراج تنسيق البورسلين، ولكنه لا يحتوي على التنسيق الفعلي
أسطر من الملف الذي يتم شرحه.

1. يبدأ كل إدخال لللوم دائمًا بسطر من:

<40 بايت سداسي عشري sha1>

أرقام الأسطر العد من 1.

2. في المرة الأولى التي يظهر فيها الالتزام في الدفق، فإنه يحتوي على معلومات أخرى متنوعة
عنه مطبوعًا بعلامة مكونة من كلمة واحدة في بداية كل سطر تصف
معلومات الالتزام الإضافية (المؤلف، البريد الإلكتروني، المرسل، التواريخ، الملخص، وما إلى ذلك).

3. على عكس التنسيق الخزفي، يتم دائمًا تقديم معلومات اسم الملف وإنهائها
الدخول:

"اسم الملف"

وبالتالي فمن السهل حقًا التحليل لبعض المحلل اللغوي الموجه للخط والكلمة
(والذي يجب أن يكون طبيعيًا جدًا بالنسبة لمعظم لغات البرمجة النصية).

ملاحظات
بالنسبة للأشخاص الذين يقومون بالتحليل: لجعله أكثر قوة، ما عليك سوى تجاهل أي خطوط بينهما
الأول والأخير (" " وأسطر "اسم الملف") حيث لا يمكنك التعرف عليها
الكلمات المميزة (أو تهتم بهذه الكلمة بالذات) في بداية
خطوط "المعلومات الموسعة". بهذه الطريقة، إذا كانت هناك معلومات إضافية (مثل
ترميز الالتزام أو تعليق الالتزام الممتد)، لن يهتم المشاهد الملوم.

MAPPING مؤلفون

إذا كان الملف .mailmap موجودًا في المستوى الأعلى للمستودع ، أو في الموقع المشار إليه
بواسطة خيارات تكوين mailmap.file أو mailmap.blob ، يتم استخدامه لتعيين المؤلف و
الأسماء وعناوين البريد الإلكتروني للأسماء الحقيقية المتعارف عليها وعناوين البريد الإلكتروني.

في النموذج البسيط ، يتكون كل سطر في الملف من الاسم الحقيقي المتعارف عليه لملف
المؤلف ، والمسافة البيضاء ، وعنوان البريد الإلكتروني المستخدم في الالتزام (محاط بـ < و >) الى الخريطة
على الاسم. على سبيل المثال:

الاسم الصحيح[البريد الإلكتروني محمي]>

الأشكال الأكثر تعقيدًا هي:

<[البريد الإلكتروني محمي]>[البريد الإلكتروني محمي]>

الذي يسمح لخريطة البريد باستبدال جزء البريد الإلكتروني فقط من الالتزام ، و:

الاسم الصحيح[البريد الإلكتروني محمي]>[البريد الإلكتروني محمي]>

مما يسمح لخريطة البريد باستبدال كل من الاسم والبريد الإلكتروني للالتزام المطابق لـ
عنوان البريد الإلكتروني المحدد ، و:

الاسم الصحيح[البريد الإلكتروني محمي]> اسم الالتزام[البريد الإلكتروني محمي]>

مما يسمح لخريطة البريد باستبدال كل من الاسم والبريد الإلكتروني للالتزام المطابق لكل من
اسم الالتزام المحدد وعنوان البريد الإلكتروني.

مثال 1: يحتوي سجلك على تعهدات من قبل اثنين من المؤلفين ، جين وجو ، اللذين تظهر أسماؤهما
في المستودع تحت عدة أشكال:

مطور جو[البريد الإلكتروني محمي]>
مطور جو ر[البريد الإلكتروني محمي]>
جين دو[البريد الإلكتروني محمي]>
جين دو
جين د.

افترض الآن أن Joe يريد استخدام الاسم الأوسط لأول مرة ، وتفضل Jane اسم عائلتها
مكتوبة بالكامل. سيبدو ملف .mailmap المناسب بالشكل التالي:

جين دو
مطور جو ر[البريد الإلكتروني محمي]>

لاحظ كيف ليست هناك حاجة لإدخال ، لأن الاسم الحقيقي لـ
هذا المؤلف صحيح بالفعل.

مثال 2: يحتوي المستودع الخاص بك على تعهدات من المؤلفين التاليين:

نيك 1[البريد الإلكتروني محمي]>
نيك 2[البريد الإلكتروني محمي]>
نيك 2[البريد الإلكتروني محمي]>
سانتا[البريد الإلكتروني محمي]>
جملة[البريد الإلكتروني محمي]>
CTO[البريد الإلكتروني محمي]>

ثم قد ترغب في ملف .mailmap يشبه:

<[البريد الإلكتروني محمي]>[البريد الإلكتروني محمي]>
بعض المتأنق[البريد الإلكتروني محمي]> نيك 1[البريد الإلكتروني محمي]>
مؤلف آخر[البريد الإلكتروني محمي]> نيك 2[البريد الإلكتروني محمي]>
مؤلف آخر[البريد الإلكتروني محمي]>[البريد الإلكتروني محمي]>
سانتا كلوز[البريد الإلكتروني محمي]>[البريد الإلكتروني محمي]>

استخدم التجزئة # للتعليقات الموجودة على السطر الخاص بهم أو بعد عنوان البريد الإلكتروني.

استخدم git-blame عبر الإنترنت باستخدام خدمات onworks.net