مبادئ كتابة الاكواد في بايثون
| هناك بعض المبادئ التوجيهية التي يجب اتباعها عند كتابة الأكواد في بايثون. هذه بعض المبادئ الأساسية: | |
| استخدام التعليقات | يجب كتابة تعليقات داخل الكود لشرح المهام المنفذة وضمان فهمها لسهولة الصيانة في المستقبل. |
| اختيار أسماء مفهومة | يجب استخدام أسماء مفهومة للمتغيرات والدوال لتسهيل فهم الكود وتجنب الخلط بين المتغيرات. |
| الالتزام بالتنسيق | يجب الالتزام بتنسيق الكود الموحد لسهولة القراءة والفهم. |
| تجنب التكرار | يجب تجنب تكرار الأكواد واستخدام التقنيات المناسبة للحفاظ على الكود نظيفًا وسهل الصيانة. |
| استخدام المكتبات والوحدات | يجب استخدام المكتبات والوحدات لتسهيل إعادة استخدام الأكواد وتقليل وقت التطوير. |
| اختبار الأكواد | يجب اختبار الأكواد بشكل دوري لضمان عملية تشغيلها بشكل صحيح والكشف عن أي أخطاء وإصلاحها في الوقت المناسب. |
الأحرف المستخدمة في وضع الأسماء في بايثون
يمكن استخدام الأحرف الأبجدية الإنجليزية الكبيرة والصغيرة (A-Z و a-z) والأرقام (0-9) في وضع الأسماء في بايثون. كما يمكن استخدام الشرطة السفلية (_) في بداية ونهاية الأسماء. ومن الجيد استخدام الأحرف الأبجدية الإنجليزية الكبيرة والصغيرة بعناية للحصول على أسماء مفهومة وسهلة الفهم، مثل استخدام اسم الدالة "calculate_sum" بدلاً من "cs".
قواعد ترتيب الكود في بايثون
تُعتبر بايثون من اللغات البرمجية المشهورة والمُفضلة لدى المطورين نظرًا لسهولتها وقابليتها للقراءة. ولكن، ما يُميز بايثون حقًا هو التأكيد على قابلية القراءة والتنظيم في الكود. وهنا بعض القواعد الأساسية التي يجب مراعاتها عند كتابة كود بايثون:
- المسافات البادئة: في بايثون، لا تستخدم الأقواس لتحديد الأقواس البادئة والختامية للدوال والشروط. بدلاً من ذلك، تُستخدم المسافات البادئة. يُفضل استخدام 4 مسافات لكل مستوى من المسافات البادئة.
- طول السطر: يُفضل ألا يتجاوز طول السطر الواحد 79 حرفًا للكود، و72 حرفًا للتعليقات.
- استيراد الوحدات: يُفضل أن يتم استيراد كل وحدة في سطر منفصل. كما يُفضل استيراد الوحدات في البداية قبل أي كود آخر.
- التعليقات: يُفضل استخدام التعليقات بحذر وبشكل معتدل. يجب أن تكون التعليقات مُوجزة وواضحة وتشرح الأجزاء المعقدة من الكود.
- مسافات حول العمليات: يُفضل وضع مسافة واحدة حول العمليات والتعيينات، مثل
a = b + c. - تجنب الأكواد الزائدة: في بايثون، يُفضل البساطة والوضوح. فمن الأفضل تجنب استخدام الأكواد المُعقدة أو الزائدة إذا كان بالإمكان الاستغناء عنها.
- استخدام الاستثناءات: استخدم الاستثناءات للتعامل مع الحالات الاستثنائية بدلاً من استخدام شروط
if.
الهدف من هذه القواعد هو تحقيق كتابة كود نظيف، قابل للقراءة، وسهل الصيانة. وعلى الرغم من أنه يمكن الانحراف عن بعض هذه القواعد في بعض الأحيان، إلا أن الالتزام بها بشكل عام سيجعل حياة المطورين أسهل.
الكلمات المحجوزة في بايثون
في لغة بايثون، هناك بعض الكلمات المحجوزة والتي لا يمكن استخدامها كمسميات للمتغيرات أو الدوال أو الفئات وغيرها. وهذه الكلمات هي:
and, as, assert, break, class, continue, def, del, elif, else, except, False, finally, for, from, global, if, import, in, is, lambda, None, nonlocal, not, or, pass, raise, return, True, try, while, with, yield, async, await
يجب تجنب استخدام أياً من هذه الكلمات كمسميات للمتغيرات أو الدوال أو الفئات وغيرها، وإلا فستحدث أخطاء في الكود.
امثلة حول طريقة كتابة كود في بايثون
هناك العديد من الأمثلة التي يمكن استخدامها لشرح طريقة كتابة الكود في بايثون، وفيما يلي بعض الأمثلة البسيطة:
- طباعة نص على الشاشة:
print("Hello, World!")
Output:
Hello, World!
- التعامل مع المتغيرات:
a = 5
b = 3
c = a + b
print(c)
Output:
8
- استخدام الشرطية:
x = 10
if x > 5:
print("x is greater than 5")
else:
print("x is less than or equal to 5")
Output:
x is greater than 5
- استخدام الحلقات:
for i in range(1, 6):
print(i)
Output:
1
2
3
4
5
- العمل مع القوائم:
fruits = ["apple", "banana", "cherry"]
for fruit in fruits:
print(fruit)
Output:
apple
banana
cherry
- استخدام الدوال
def add_numbers(x, y):
return x + y
result = add_numbers(3, 5)
print(result)
Output:
8
هذه الأمثلة البسيطة توضح طريقة كتابة الكود في بايثون بشكل عام، ويمكن تعديلها وتطويرها لتناسب الاحتياجات المحددة لكل مشروع.
لا تقلق إذا لم تفهم أحد الأكواد السابقة، سيتم شرحها بالتفصيل في الدروس القادمة. في هذه المرحلة، ركز فقط على كيفية بناء كود بايثون وترتيبه.