كيفية إدراج جميع الملفات في التزام Git محدد

عرض الملفات في Git Commit

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

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

شرح مفصل لوظائف البرنامج النصي

تعمل البرامج النصية المقدمة على سرد جميع الملفات التي كانت جزءًا من التزام Git معين دون عرض معلومات الفرق. يبدأ البرنامج النصي Shell بالتحقق من توفير تجزئة الالتزام كوسيطة. إذا لم يكن الأمر كذلك، فإنه يطبع رسالة استخدام ويخرج. إذا تم توفير تجزئة الالتزام، فسيتم تشغيل الأمر git diff-tree مع الخيارات --no-commit-id, --name-only، و -r. يسرد هذا الأمر الملفات المتأثرة بالالتزام المحدد بتنسيق عادي. تضمن هذه الطريقة عرض أسماء الملفات فقط، مع تجنب المعلومات المختلفة غير المرغوب فيها. يعد هذا البرنامج النصي مفيدًا بشكل خاص للقوائم السريعة والمباشرة لمحتويات الالتزام في البيئات التي يتوفر فيها Git.

يؤدي برنامج Python النصي وظيفة مماثلة ولكنه يستخدم لغة Python subprocess وحدة لتشغيل git diff-tree يأمر. فهو يلتقط مخرجات الأمر ويطبعه على وحدة التحكم. يتحقق هذا البرنامج النصي من العدد الصحيح لوسيطات سطر الأوامر، ويطبع رسالة خطأ إذا لزم الأمر، ثم يتابع تنفيذ أمر Git. ال subprocess.run يتم استخدام الوظيفة هنا للتعامل مع تنفيذ الأمر، والتقاط كل من الإخراج القياسي والخطأ القياسي. يعد هذا الأسلوب مفيدًا لدمج عمليات Git في سير عمل Python وفي الحالات التي قد تكون هناك حاجة إلى مزيد من المعالجة للمخرجات داخل تطبيق Python.

يحقق البرنامج النصي Node.js أيضًا نفس الهدف ولكنه يستخدم exec وظيفة من Node.js child_process وحدة. يأخذ تجزئة الالتزام كوسيطة وينفذ git diff-tree الأمر مع الخيارات المناسبة. يلتقط البرنامج النصي المخرجات ويطبعها، ويتعامل مع أي أخطاء تحدث أثناء التنفيذ. يعد هذا البرنامج النصي مفيدًا بشكل خاص للمطورين الذين يعملون في بيئة JavaScript أو Node.js ويحتاجون إلى دمج عمليات Git في تطبيقاتهم أو سير العمل الآلي. يجسد كل برنامج نصي تعدد استخدامات لغات وبيئات البرمجة المختلفة في حل نفس مشكلة إدراج الملفات في التزام Git.

#!/bin/bash
# This script lists all files in a given git commit

commit_hash=$1

if [ -z "$commit_hash" ]; then
  echo "Usage: $0 <commit_hash>"
  exit 1
fi

git diff-tree --no-commit-id --name-only -r $commit_hash

import subprocess
import sys

def list_files_in_commit(commit_hash):
    try:
        result = subprocess.run(['git', 'diff-tree', '--no-commit-id', '--name-only', '-r', commit_hash],
                                stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
        if result.returncode != 0:
            print(f"Error: {result.stderr.strip()}")
        else:
            print(result.stdout.strip())
    except Exception as e:
        print(f"An error occurred: {e}")

if __name__ == "__main__":
    if len(sys.argv) != 2:
        print("Usage: python list_files_in_commit.py <commit_hash>")
    else:
        list_files_in_commit(sys.argv[1])

const { exec } = require('child_process');

function listFilesInCommit(commitHash) {
  exec(`git diff-tree --no-commit-id --name-only -r ${commitHash}`, (error, stdout, stderr) => {
    if (error) {
      console.error(`Error: ${stderr}`);
      return;
    }
    console.log(stdout.trim());
  });
}

const commitHash = process.argv[2];

if (!commitHash) {
  console.log('Usage: node listFilesInCommit.js <commitHash>');
} else {
  listFilesInCommit(commitHash);
}

التقنيات المتقدمة لإدراج الملفات في Git Commit

بالإضافة إلى استخدام أوامر Git الأساسية، هناك تقنيات وأدوات متقدمة أخرى لسرد الملفات في التزام محدد. إحدى هذه الأدوات هي git log جنبا إلى جنب مع خيارات مختلفة. باستخدام git log مع --name-only و --pretty=format: الخيارات، يمكنك تنسيق الإخراج لسرد الملفات بطريقة أكثر تخصيصًا. على سبيل المثال، git log --name-only --pretty=format:"%h %s" -1 [commit_hash] سيُظهر تجزئة الالتزام والموضوع، متبوعًا بأسماء الملفات. تسمح هذه الطريقة بمخرجات أكثر مرونة ويمكن أن تكون مفيدة لإنشاء التقارير أو التكامل مع الأدوات الأخرى.

هناك طريقة أخرى تتمثل في استخدام مكتبات Git المتاحة للغات برمجة مختلفة، مثل libgit2 ل ج، pygit2 لبيثون، و nodegit للNode.js. توفر هذه المكتبات طريقة برمجية للتفاعل مع مستودعات Git ويمكن استخدامها لسرد الملفات في الالتزام برمجيًا. على سبيل المثال، مع pygit2، يمكنك الوصول إلى كائن الالتزام والتكرار فوق شجرته للحصول على قائمة الملفات. يعد هذا الأسلوب مفيدًا عندما تحتاج إلى دمج وظائف Git مباشرةً في التطبيقات أو البرامج النصية التي تتطلب منطقًا أو معالجة أكثر تعقيدًا من مخرجات سطر الأوامر البسيطة.