بايثون - أسلوب الكتابة

مبادئ كتابة الكود في بايثون

في البداية عليك معرفة أن كل ما ستتعلمه في هذا الدرس عبارة عن شرح نظري لأساليب كتابة الكود.
إذاَ في هذا الدرس ستتعلم كيف تكتب كود بايثون بشكل صحيح يفهمه الكمبيوتر و يفهمه أي شخص يحاول قراءة الكود الذي ستقوم أنت بكتابته مستقبلاً عند بناء تطبيقاتك الخاصة.


حساسية الأحرف

بايثون تطبق مفهوم حساسية الأحرف ( Case Sensitivity ) و هذا يعني أنها تميز بين الأحرف الكبيرة و الأحرف الصغيرة.

مثال: note و Note ليسوا شيئاً واحداً.


إسم المتغير

إستخدم الأحرف الصغيرة عند وضع أسماء للمتغيرات و في حال كان إسم المتغير يتألف من أكثر من كلمة قم بوضع _ بين كل كلمتين.

أمثلة

في حال كان إسم المتغير يتألف من كلمة واحدة.

average = 10

في حال كان إسم المتغير يتألف من أكثر من كلمة.

total_score = 20

إسم الدالة

إستخدم الأحرف الصغيرة عند وضع أسماء للدوال و في حال كان إسم الدالة يتألف من أكثر من كلمة قم بوضع _ بين كل كلمتين.

أمثلة

في حال كان إسم الدالة يتألف من كلمة واحدة.

def display():

في حال كان إسم الدالة يتألف من أكثر من كلمة.

def display_user_info():

إسم الكلاس

دائماً إبدأ إسم الكلاس بحرف كبير و في حال كان إسم الكلاس يتألف من أكثر من كلمة إجعل أول حرف من كل كلمة كبيراً.

أمثلة

في حال كان إسم الكلاس يتألف من كلمة واحدة.

class First:

في حال كان إسم الكلاس يتألف من أكثر من كلمة.

class FirstPythonClass:

التعليقات

نستخدم التعليقات لنضع ملاحظات حول الكود الذي كتبناه فقط، لكي لا ننسى كيف برمجنا الكود في حال أردنا مراجعته أو التعديل عليه في وقت لاحق. و بالطبع التعليقات لا تؤثر إطلاقاً على الكود المكتوب.

لإضافة تعليق، ضع الرمز # ثم أكتب بعده ما شئت.

مثال

#      هذا تعليق يتألف من سطر واحد و هو لا يؤثر أبداً على الكود الموضوع
#  هذا تعليق آخر.. كما تلاحظ، يمكنك وضع العدد الذي تريده من التعليقات

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


كتابة أكثر من أمر واحد على نفس السطر

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

في المثال التالي قمنا بوضع ثلاث أوامر على سطر واحد.
فعلياً، كل أمر هنا عبارة عن تعريف متغير مع إعطائه عدد كقيمة.

مثال

x = 1; y = 2; z = 3

كتابة أمر واحد على أكثر من سطر

إذا أردت إعلام مترجم بايثون أن الأمر له تكملة على السطر التالي فقم بوضع الرمز \ في نهاية السطر.

في المثال التالي قمنا بكتابة الأمر الذي يقضي بإعطاء قيمة للمتغير total على ثلاث أسطر.

المثال الأول

Test.py
# هنا قمنا بتعريف ثلاث متغيرات
item_1 = 10
item_2 = 20
item_3 = 30

# الثلاث أسطر التالية عبارة عن أمر واحد
# total و وضع الناتج في المتغير item_3 و item_2 و item_1 إذا هنا سيتم جمع قيم المتغيرات
total = item_1 + \
        item_2 + \
        item_3

# total هنا قمنا بعرض قيمة المتغير
print("total contains:", total)

النتيجة

total contains: 60

الأوامر التي يمكن استخدامها لتعريف مجموعة من القيم و التي نستخدم فيها الرموز [] أو () أو {} يمكن كتابتها مباشرةً على عدة أسطر بدون الحاجة لوضع \ في نهاية كل سطر.


في المثال التالي قمنا بتعريف مصفوفة مع وضع قيمة كل عنصر فيها على سطر منفرد.

المثال الثاني

Test.py
# الأربعة أسطر التالية عبارة عن أمر واحد
seasons = ['Autumn',
           'Winter',
           'Spring',
           'Summer']

# seasons هنا قمنا بعرض القيم المخزنة في المصفوفة
print("Seasons contains:", seasons)

النتيجة

Seasons contains: ['Autumn', 'Winter', 'Spring', 'Summer']

جاهز لرحلة التحدي؟

قم بتوليد تمارين لا نهائية بشكل تدريجي (10 في كل مرة) بناءً على هذا الدرس. كل تمرين مصمم لرفع مستوى تفكيرك المنطقي.