قواعد التسمية

الدرس 3 من 28 في دورة Clean Code - كتابة كود أفضل باستخدام Python على Coddy.

تُعدّ التسمية جزءًا بالغ الأهمية من كتابة التعليمات البرمجية. فأنت تمنح أسماءً لـ variable وfunction وclasses وغير ذلك...

تقدّم Python بعض أساليب التسمية المقترحة:

النوع	الاصطلاح	مثال
متغير	Snake case	`x`، `index`، `max_number`
دالة	Snake case	`calculate`، `convert_to_int`
class	Pascal case	`Person`، `JavaCompiler`
طريقة	Snake case	`print`، `make_sound`
ثابت	Snake case (بحروف كبيرة)	`PI`، `MAX_TIMEOUT`، `MIN_AGE`
وحدة	Snake case	`script.py`، `my_app.py`
حزمة	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())

لاحظ جميع الأنواع المختلفة هنا!