Python الدالة الرئيسية والطريقة: فهم دالة main()

⚡ ملخص ذكي

Python تُشير الدالة الرئيسية إلى نقطة البداية التي يبدأ عندها المفسر بتشغيل البرنامج. يتم تعريفها باستخدام def main()، وتُقترن بشرط if __name__ == “__main__”، مما يفصل بين كود الوحدة القابل لإعادة الاستخدام وتنفيذ البرنامج النصي المستقل.

  • 🚀 نقطة الدخول: تحدد الدالة الرئيسية مكان بدء التنفيذ، بحيث يمكن للقراء متابعة تدفق البرنامج من نقطة بداية واضحة واحدة.
  • 🧩 def main():: التفافping المنطق الموجود داخل الدالة الرئيسية () يفصل بين الإعداد والتنفيذ وبين تعريفات الدوال والفئات.
  • 🔒 حارس __name__: يقوم الشرط if __name__ == “__main__” بتشغيل الدالة main() فقط عند التنفيذ المباشر، وليس عند الاستيراد.
  • 🔁 وحدات قابلة لإعادة الاستخدام: يسمح الكود المحمي للبرامج النصية الأخرى باستيراد وظائفك دون تشغيل البرنامج بأكمله.
  • ⌨️ إدخال سطر الأوامر: تُعد الدالة main() المكان الطبيعي لقراءة وسائط sys.argv وإرجاع حالة الخروج.
  • 🤖 مساعدة الذكاء الاصطناعي: تقوم المساعدات الذكية مثل GitHub Copilot بإنشاء قوالب main() وحارس __name__ من خلال موجه قصير.

Python وظيفة الرئيسية

ما هي تفاصيل Python الوظيفة الرئيسية؟

استخدم Python الوظيفة الأساسية هي نقطة البداية لأي برنامج. عند تشغيل البرنامج، Python يقوم المفسر بتشغيل التعليمات البرمجية بالتسلسل. يتم تنفيذ الدالة الرئيسية فقط عند تشغيلها كـ Python لن يتم تشغيل البرنامج. لن يتم تشغيل الدالة الرئيسية إذا تم استيراده كوحدة نمطية.

ما هي وظيفة def main() Pythonلفهم ذلك، انظر إلى مثال الكود التالي، والذي يُعد جزءًا من النواة Python البرمجة الأساسيات:

التعريف الرئيسي () مثال 1

def main():
     print ("Hello World!")
print ("Guru99")

Python وظيفة الرئيسية

هنا، لدينا نصان مطبوعان - أحدهما مُعرّف ضمن الدالة الرئيسية وهو "Hello World!"، والآخر مستقل وهو "Guru99 بوصة. عند تشغيل الدالة def main():

  • فقط "Guru99" يطبع
  • وليس الرمز "Hello World!"

ذلك لأننا لم نعلن النداء الدالة "if__name__== "__main__".

من المهم أنه بعد تعريف الدالة الرئيسية، يمكنك استدعاء الكود عن طريق if__name__== “__main__” ثم تشغيل الكود، وعندها فقط ستحصل على الناتج “hello world!” في وحدة التحكم البرمجية. ضع في اعتبارك الكود التالي

التعريف الرئيسي () مثال 2

def main():
    print("Hello World!")

if __name__ == "__main__":
    main()

print("Guru99")

Guruتمت طباعة الرقم 99 في هذه الحالة.

Python وظيفة الرئيسية

وهنا التوضيح ,

  • متى Python يقرأ المترجم الملف المصدر، وسيقوم بتنفيذ جميع التعليمات البرمجية الموجودة فيه.
  • متى Python يقوم بتشغيل "الملف المصدر" باعتباره البرنامج الرئيسي، ويقوم بتعيين المتغير الخاص (__name__) ليكون له قيمة ("__main__").
  • عند تنفيذ الوظيفة الرئيسية في بايثون، ستقرأ بعد ذلك عبارة "if" وتتحقق مما إذا كان __name__ يساوي __main__.
  • In Python "if__name__== "__main__" يسمح لك بتشغيل Python الملفات إما ك وحدات قابلة لإعادة الاستخدام أو برامج مستقلة.

لماذا نستخدم الدالة main() في Python?

Python لا يُلزمك نمط def main() بكتابة دالة رئيسية، ومع ذلك يستخدمها المطورون ذوو الخبرة في معظم البرامج النصية غير البسيطة. يُضفي هذا النمط تنظيمًا على الملف ويجعل الكود آمنًا لإعادة الاستخدام. إليك أهم أسباب استخدامه:

  • نقطة دخول واضحة: تُخبر الدالة main() أي قارئ بالضبط من أين يبدأ البرنامج، لذا فإن المنطق سهل المتابعة.
  • وحدات قابلة لإعادة الاستخدام: Code يتم تشغيلها فقط عند التنفيذ المباشر، لذا يمكن للملفات الأخرى استيراد وظائفك دون آثار جانبية.
  • النطاق المحلي: تبقى المتغيرات التي يتم إنشاؤها داخل الدالة main() محلية، مما يتجنب حدوث تعارضات عرضية مع الأسماء العامة في أماكن أخرى من الوحدة.
  • اختبار أسهل: يتيح عزل المنطق في الدالة الرئيسية () لمجموعة الاختبارات استدعاءها مباشرة والتحقق من النتيجة.
  • اتفاقية مشتركة: تُعد الدالة main() إشارة معترف بها على نطاق واسع لنقطة دخول البرنامج، مما يحسن من إمكانية الصيانة عبر الفرق.

باختصار، دالة main() اختيارية في Python، ولكنه يحافظ على البرامج الأكبر حجماً قابلة للقراءة والاختبار وآمنة للاستيراد.

المتغير __name__ و Python وحدة

لفهم أهمية المتغير __name__ في Python طريقة الوظيفة الرئيسية، ضع في اعتبارك الكود التالي:

def main():
    print("hello world!")

if __name__ == "__main__":
    main()

print("Guru99")

print("Value in built variable name is:  ",__name__)

المتغير __name__ و Python وحدة

ضع في اعتبارك الآن أنه يتم استيراد الكود كوحدة نمطية

import MainFunction

print("done")

المتغير __name__ و Python وحدة

وهنا شرح الكود : مثل ج، Python يستخدم == للمقارنة بينما = للمهمة. Python يستخدم المترجم الوظيفة الرئيسية بطريقتين

تشغيل مباشر:

  • __الاسم__=__الرئيسي__
  • إذا كانت العبارة == True، فسيتم تنفيذ البرنامج النصي الموجود في _main_

استيراد كوحدة نمطية

  • __name__= اسم ملف الوحدة
  • إذا كانت العبارة == false، ولن يتم تنفيذ البرنامج النصي الموجود في __main__

عند تنفيذ الكود، سيتم التحقق من اسم الوحدة باستخدام "if". تضمن هذه الآلية تنفيذ الوظيفة الرئيسية فقط كتشغيل مباشر وليس عند استيرادها كوحدة نمطية.

الأمثلة المذكورة أعلاه هي Python 3 رموز، إذا كنت تريد استخدامها Python 2، يرجى مراعاة الكود التالي

def main():
  print "Hello World!"
  
if __name__== "__main__":
  main()

print "Guru99"

In Python 3. لا تحتاج إلى استخدام if__name. يعمل الكود التالي أيضًا

def main():
  print("Hello World!")
  
main()
print("Guru99")

ملاحظة: تأكد من ترك مسافة بادئة بعد تعريف الدالة الرئيسية وعدم إعلان الكود أسفل الدالة def main(): مباشرةً وإلا فسيؤدي ذلك إلى حدوث خطأ في المسافة البادئة.

كيفية تمرير وسائط سطر الأوامر إلى Python الدالة الرئيسية ()

تُعد الدالة main() المكان الطبيعي لمعالجة المدخلات التي يمررها المستخدم عبر سطر الأوامر. Python يخزن هذه القيم في قائمة sys.argv، التي توفرها وحدة sys القياسية. العنصر الأول، sys.argv[0]، هو اسم البرنامج النصي، وكل قيمة بعده هي وسيطة يُدخلها المستخدم.

يقرأ المثال التالي ويطبع وسائط سطر الأوامر من داخل دالة main():

import sys

def main():
    print("Script name:", sys.argv[0])
    print("Arguments passed:", sys.argv[1:])

if __name__ == "__main__":
    main()

إذا قمت بحفظ الملف باسم script.py وتشغيله python script.py alpha betaيقوم البرنامج بطباعة اسم البرنامج النصي والقائمة ['alpha', 'beta']. ولأن القيم تصل داخل الدالة الرئيسية main()، فإن منطق البرنامج يبقى منظمًا ويسهل اختباره.

إليك بعض النصائح العملية عند العمل مع مدخلات سطر الأوامر:

  • احذف اسم البرنامج النصي: استخدم sys.argv[1:] لقراءة الوسائط التي أدخلها المستخدم فقط.
  • استخدم argparse للحصول على أدوات حقيقية: تقوم وحدة argparse المدمجة بتحليل العلامات والخيارات ونصوص المساعدة بشكل أكثر أمانًا بكثير من قراءة sys.argv يدويًا.
  • أعد رمز الخروج: قم بتغليف الاستدعاء كـ sys.exit(main()) بحيث تصبح القيمة المرجعة من main() هي حالة خروج العملية.
  • التحقق المبكر: تحقق من عدد ونوع الوسائط في أعلى الدالة main() قبل تشغيل بقية البرنامج.

يحوّل هذا النمط نصًا برمجيًا بسيطًا إلى أداة سطر أوامر موثوقة مع الحفاظ علىping كل خطوة داخل دالة main() واحدة قابلة للاختبار.

Python دالة main() مقابل لغات البرمجة الأخرى

المطورون القادمون من لغة C، C++ أو Java غالباً ما نتوقع وجود دالة main() إلزامية. Python يختلف أسلوب عملها لأنها لغة مُفسَّرة، لذا يقوم المُفسِّر ببساطة بتشغيل الملف من السطر الأول إلى السطر الأخير. الدالة main() في Python لذا فهو عرف وليس قاعدة.

  • C, C++، سي#، و Java: تُعد الدالة main() نقطة دخول إلزامية. يقوم وقت التشغيل باستدعائها تلقائيًا، ولا يمكن أن يكون هناك سوى دالة واحدة لكل برنامج.
  • Python: لا حاجة لدالة main(). يبدأ التنفيذ من السطر الأول في الملف، ولا يتم تشغيل دالة main() إلا إذا استدعاها الكود الخاص بك.
  • الحارس: يُعطي الشرط if __name__ == “__main__” Python غرض مشابه لـ main() المترجم عن طريق تحديد التعليمات البرمجية التي يجب تشغيلها فقط عندما يكون الملف هو البرنامج الرئيسي.

لذا، بينما تفرض لغات البرمجة الأخرى نقطة دخول رئيسية (main())، Python يترك لك الخيار، ويقدم نفس الوضوح من خلال الاتفاقية بدلاً من قاعدة المترجم.

الأسئلة الشائعة

__main__ هو الاسم Python يُحدد هذا النص البرمجي الرئيسي، والذي يتم اكتشافه من خلال المتغير __name__. أما الدالة main() فهي دالة عادية يُعرّفها المستخدم وتحتوي على منطق البرنامج. تعمل هاتان الدالتان معًا، ولكن __main__ هو اسم بيئة التشغيل، بينما main() هي دالة.

يضمن وضعه في النهاية Python تم تعريف جميع الدوال والفئات المذكورة أعلاه قبل استدعاء الدالة main(). قد يؤدي تشغيلها في وقت سابق إلى الإشارة إلى أسماء غير مُعرَّفة بعد، مما قد يتسبب في ظهور خطأ NameError.

رقم Python لا يحمل اسم "main" أي معنى خاص. يمكنك تسمية دالة الدخول بأي اسم تريده، إلا أن تسميتها "main()" يُعدّ اصطلاحًا قويًا يُشير إلى نقطة بداية البرنامج للمطورين الآخرين.

نعم. يمكن للدالة main() أن تُرجع قيمة، ويُستخدم نمط شائع لكتابة sys.exit(main()) بحيث تُصبح القيمة المُرجعة هي رمز خروج العملية. إرجاع القيمة 0 يُشير إلى نجاح العملية، بينما تُشير القيمة غير الصفرية إلى وجود خطأ.

بدون الحماية، يتم تشغيل الدالة main() سواءً عند تنفيذ الملف مباشرةً أو عند استيراده. أما البرامج الأخرى التي ترغب فقط في إعادة استخدام وظائفها، فستؤدي إلى تنفيذ غير مرغوب فيه وآثار جانبية.

يجب أن يكون جسم الدالة main() مُزاحًا أسفل سطر def main():. كتابة العبارة التالية مُحاذية لليسار تُؤدي إلى عدم وجود كتلة مُزاحة في الدالة، لذا Python يُسبب خطأ في المسافة البادئة. أضف مسافات متناسقة أو علامة جدولة.

يُكمل GitHub Copilot تلقائيًا هيكل الدالة الرئيسية def main() وشرط if __name__ == “__main__” من تعليق قصير. كما يقترح تحليل الوسائط وسلاسل التوثيق، مما يسمح لك بالتركيز على منطق البرنامج بدلاً من الشيفرة النمطية.

في مشاريع الذكاء الاصطناعي والتعلم الآلي، تُعدّ الدالة main() نقطة الدخول لبرامج التدريب أو الاستدلال. فهي تقرأ المعلمات الفائقة من وسائط سطر الأوامر، وتحافظ على إمكانية استيراد الأدوات المساعدة لإعادة استخدامها، وتجعل التجارب أسهل في الاختبار والأتمتة.

تلخيص هذه التدوينة بـ: