دليل Python لاستخدام معاملات سطر الأوامر: من sys.argv إلى argparse

1. الاستخدام الأساسي لمعاملات سطر الأوامر في Python

ما هي معاملات سطر الأوامر؟

الحصول على معاملات سطر الأوامر باستخدام sys.argv

مثال: برنامج حساب بسيط

import sys

def main():
    if len(sys.argv) < 3:
        print("خطأ: مطلوب معاملان")
        return

    num1 = float(sys.argv[1])
    num2 = float(sys.argv[2])
    print(f"المجموع: {num1 + num2}")

if __name__ == "__main__":
    main()

$ python script.py 3 5
المجموع: 8.0

2. المعالجة المتقدمة للمعاملات باستخدام argparse

أساسيات argparse

تحليل المعاملات وإنشاء محلل

مثال: الاستخدام الأساسي لـ argparse

import argparse

def main():
    parser = argparse.ArgumentParser(description='برنامج تجريبي')
    parser.add_argument('arg1', help='المعامل الأول')
    parser.add_argument('arg2', type=float, help='المعامل الثاني (عدد)')
    args = parser.parse_args()

    print(f"arg1 = {args.arg1}")
    print(f"arg2 = {args.arg2}")

if __name__ == "__main__":
    main()

$ python script.py test 5.5
arg1 = test
arg2 = 5.5

معالجة المعاملات الاختيارية والأعلام

مثال: استخدام المعاملات الاختيارية والأعلام

import argparse

def main():
    parser = argparse.ArgumentParser()
    parser.add_argument('--verbose', action='store_true', help='إظهار إخراج مفصل')
    parser.add_argument('numbers', nargs='+', type=float, help='قائمة من الأعداد')
    args = parser.parse_args()

    total = sum(args.numbers)
    if args.verbose:
        print(f"تفاصيل الحساب: مجموع {args.numbers} هو {total}")
    else:
        print(f"المجموع: {total}")

if __name__ == "__main__":
    main()

$ python script.py 1 2 3 --verbose
تفاصيل الحساب: مجموع [1.0, 2.0, 3.0] هو 6.0

3. معالجة الأخطاء والتحقق من المعاملات

التحقق من عدد ونوع المعاملات

مثال: التحقق من عدد ونوع المعاملات

import sys

def main():
    if len(sys.argv) != 3:
        print("خطأ: مطلوب معاملان")
        return

    try:
        num1 = float(sys.argv[1])
        num2 = float(sys.argv[2])
    except ValueError:
        print("خطأ: يجب أن تكون المعاملات أعدادًا")
        return

    print(f"المجموع: {num1 + num2}")

if __name__ == "__main__":
    main()

4. حالات الاستخدام العملية والتطبيقات

مثال على إنشاء أداة سطر أوامر

مثال: أداة لعدّ أسطر الملف

import argparse

def main():
    parser = argparse.ArgumentParser(description='أداة لعد أسطر الملف')
    parser.add_argument('filename', help='اسم الملف المطلوب عده')
    args = parser.parse_args()

    try:
        with open(args.filename, 'r') as file:
            lines = file.readlines()
            print(f"عدد الأسطر في الملف {args.filename}: {len(lines)}")
    except FileNotFoundError:
        print(f"خطأ: لم يتم العثور على الملف {args.filename}")

if __name__ == "__main__":
    main()

$ python count_lines.py example.txt
عدد الأسطر في الملف example.txt: 100

5. الخلاصة