قواعد التسمية
الدرس 3 من 28 في دورة Clean Code - كتابة كود أفضل باستخدام Python على Coddy.
تعد التسمية جزءاً حاسماً في كتابة الكود، حيث تمنح أسماءً للمتغيرات، الدوال، الأصناف (classes) والمزيد...
تقدم لغة بايثون بعض أنماط التسمية المقترحة:
| النوع | العرف المتبع | مثال |
|---|---|---|
| Variable | Snake case | x, index, max_number |
| Function | Snake case | calculate, convert_to_int |
| Class | Pascal case | Person, JavaCompiler |
| Method | Snake case | print, make_sound |
| Constant | Snake case (أحرف كبيرة بالكامل) | PI, MAX_TIMEOUT, MIN_AGE |
| Module | Snake case | script.py, my_app.py |
| Package | Snake case (بدون شرطات سفلية) | package, mypackage |
- Snake case (snake_case) - أحرف صغيرة، والكلمات مفصولة بشرطات سفلية.
- Pascal case (PascalCase) - كلمات تبدأ بأحرف كبيرة.
مثال أكثر تفصيلاً لاستخدام كل ذلك معاً،
import my_module
class ImportantClass:
MY_CONSTANT = 3.14
def good_function(self, variable):
return variable
def better_function(self):
return MY_CONSTANT
def __name__ == '__main__':
var = my_module.secret()
important_class = ImportantClass()
important_class.good_function(var)
print(important_class.better_function())
لاحظ جميع الأنواع المختلفة هنا!
هل تعلم؟ الفرق بين الدالة (function) والطريقة (method) هو أن الطريقة هي دالة مرتبطة بكائن أو صنف.
جرّب بنفسك
لا يتضمّن هذا الدرس تحدّيًا برمجيًا.