تعليقات

مقدمة

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

Comments

يبدأ التعليق ذو السطر الواحد بالرقم # ويستمر حتى نهاية السطر. يمكن أن تظهر التعليقات على سطر منفرد، أو على نفس سطر الكود الفعلي. وتُسمى هذه التعليقات “التعليقات المضمنة”.

def main():
    # This is a single-line comment
    console.print("Hello!")  # Print a greeting message

# Start threads — Do not delete
start_thread(main)

def main():
    # Print a greeting and then a farewell
    console.print("Hello!")
    console.new_line()
    console.print("Goodbye!")

# Start threads — Do not delete
start_thread(main)

Multiline String Comments

يمكن استخدام التعليقات النصية المحاطة بثلاث علامات اقتباس (“”” “”” أو ‘’’ ‘’’) لشرح النصوص متعددة الأسطر. على الرغم من أنها تُصنف تقنيًا ككائنات نصية، إلا أنها تعمل كتعليقات إذا لم يتم إسنادها إلى متغير.

def main():
    """
    This project prints a greeting message,
    followed by a farewell message
    """
    console.print("Hello!")
    console.new_line()
    console.print("Goodbye!")

# Start threads — Do not delete
start_thread(main)