الدليل: أتمتة الإصدار باستخدام Git وPython

أتمتة الإصدار في بايثون باستخدام Git Hooks

برنامج بايثون النصي لخطاف الدفع المسبق

#!/usr/bin/env /usr/bin/python
import os
import subprocess
import re
import sys

commit_msg_file = sys.argv[1]
with open(commit_msg_file, 'r') as file:
    commit_msg = file.read().strip()

version_file = os.path.abspath('version.py')
hashed_code = subprocess.check_output(['git', 'rev-parse', 'HEAD']).strip().decode('utf-8')

if os.path.exists(version_file):
    print(f'Reading previous {version_file}')
    with open(version_file, 'r') as f:
        content = f.read()
        major, minor, patch = map(int, re.search(r'version = "(\d+)\.(\d+)\.(\d+)"', content).groups())
    patch += 1
else:
    print(f'Creating new {version_file}')
    major, minor, patch = 0, 0, 1

print(f'Writing contents of {version_file} with "{commit_msg}"')
with open(version_file, 'w') as f:
    f.write(f'''# This file is created by the pre-push script
class Version:
    comment = "{commit_msg}"
    hash = "{hashed_code}"
    version = "{major}.{minor}.{patch}"

if __name__ == "__main__":
    print(Version.version)
''')

subprocess.call(['git', 'add', version_file])

إعداد Git Hook لزيادة الإصدار

جيت هوك البرنامج النصي في شل

#!/bin/sh

VERSION_PY="version.py"

# Get the commit message file from the arguments
COMMIT_MSG_FILE=$1

# Extract the commit message
COMMIT_MSG=$(cat $COMMIT_MSG_FILE)

# Get the latest commit hash
GIT_HASH=$(git rev-parse HEAD)

if [ -f "$VERSION_PY" ]; then
  VERSION=$(grep -oP '(?<=version = ")(\d+\.\d+\.\d+)' $VERSION_PY)
  IFS='.' read -r -a VERSION_PARTS <<< "$VERSION"
  VERSION_PARTS[2]=$((VERSION_PARTS[2] + 1))
  NEW_VERSION="${VERSION_PARTS[0]}.${VERSION_PARTS[1]}.${VERSION_PARTS[2]}"
else
  NEW_VERSION="0.0.1"
fi

echo "# This file is created by the pre-push script" > $VERSION_PY
echo "class Version:" >> $VERSION_PY
echo "    comment = \"$COMMIT_MSG\"" >> $VERSION_PY
echo "    hash = \"$GIT_HASH\"" >> $VERSION_PY
echo "    version = \"$NEW_VERSION\"" >> $VERSION_PY

git add $VERSION_PY

أسئلة شائعة حول التشغيل الآلي للإصدار باستخدام Git وPython

1. كيف يمكنني أتمتة عملية الإصدار في مستودع Git الخاص بي؟
2. يمكنك أتمتة عملية الإصدار باستخدام خطافات Git، مثل خطاف الدفع المسبق والبرامج النصية لتحديث ملف الإصدار عند كل التزام.
3. ما هو خطاف الدفع المسبق؟
4. خطاف الدفع المسبق هو خطاف Git الذي يقوم بتشغيل البرامج النصية قبل دفع التغييرات إلى مستودع بعيد. ويمكن استخدامه لأتمتة المهام مثل تحديث ملف الإصدار.
5. كيف يمكنني الوصول إلى رسالة الالتزام في البرنامج النصي Git Hook؟
6. يمكنك الوصول إلى رسالة الالتزام من خلال قراءة الملف الذي تم تمريره كوسيطة للبرنامج النصي، عادةً باستخدام sys.argv في بايثون أو $1 في البرنامج النصي شل.
7. ما الأمر الذي يسترد أحدث تجزئة التزام Git؟
8. الامر git rev-parse HEAD يسترد أحدث تجزئة الالتزام في مستودع Git.
9. كيف يمكنني زيادة رقم الإصدار في البرنامج النصي؟
10. استخدم التعبيرات العادية لاستخراج الإصدار الحالي وزيادة رقم التصحيح وإعادة كتابة ملف الإصدار برقم الإصدار الجديد.
11. هل يمكنني استخدام هذه الطريقة مع أدوات التكامل المستمر؟
12. نعم، يمكن دمج الإصدار التلقائي باستخدام خطافات Git في مسارات CI/CD لضمان اتساق الإصدار عبر عمليات الإنشاء والنشر.
13. ما هي فوائد الإصدار الآلي؟
14. يعمل الإصدار التلقائي على تقليل الأخطاء اليدوية، ويضمن تتبعًا متسقًا للإصدار، ويبسط عملية التطوير والنشر.
15. كيف أتأكد من تضمين ملف الإصدار في الالتزام التالي؟
16. يستخدم git add لعرض ملف الإصدار بعد تحديثه بواسطة البرنامج النصي.
17. ماذا يحدث إذا كان ملف الإصدار غير موجود؟
18. إذا كان ملف الإصدار غير موجود، فيمكن للبرنامج النصي إنشاؤه برقم إصدار أولي، مثل 0.0.1.
19. هل من الممكن استخدام لغات برمجة أخرى لخطافات Git؟
20. نعم، يمكنك كتابة نصوص Git Hook النصية بلغات برمجة مختلفة، مثل Python أو Bash أو Perl، اعتمادًا على تفضيلاتك ومتطلبات المشروع.