الدرس 7: إحساس الدالة: دوال صغيرة، ذات غرض واحد، وبديهية
الدالة هي ذرة البرمجة الجوهرية. إذا كانت الدوال متضخمة، أو مربكة، أو تتعامل مع الكثير من المسؤوليات، يصبح النظام بأكمله هشاً.
مبدأ المسؤولية الواحدة (SRP)
يجب أن تقوم كل دالة بشيء واحد، وأن تفعله بشكل جيد. إذا وجدت نفسك تستخدم كلمة 'و' عند وصف ما تفعله الدالة، فهذه علامة على أنه يجب تقسيمها.
فحص الـVibe: طول الدالة
حاول إبقاء الدوال أقل من 50 سطراً (ويفضل أن تكون 10-20 سطراً من المنطق الأساسي). الدوال الأطول يصعب اختبارها وصيانتها.
| دالة بإحساس سيئ | دالة بإحساس جيد |
|---|---|
process_order_and_send_confirmation_and_update_inventory(order) | process_order(order) (تستدعي دوال أخرى) |
setup_environment() | setup_database(), configure_logging() |
الوسائط والمخرجات: واجهات نظيفة
قلل عدد الوسائط التي تأخذها الدالة (ويفضل أن تكون 0-3). تشير الوسائط الكثيرة جداً إلى أن الدالة تفعل الكثير، أو أن البيانات يجب أن يتم تغليفها في كائن/فئة.
علامات Boolean: إشارة تحذير للـVibe
إذا مررت علامة Boolean للتحكم في السلوك الداخلي للدالة، فمن المحتمل أنك تنتهك مبدأ المسؤولية الواحدة (SRP)، لأن الدالة الآن لديها مسؤوليتان مختلفتان.
python
إحساس سيئ: وظيفتان في دالة واحدة
def save_data(data, validate_only=False): if validate_only: # Validation logic return is_valid else: # Save logic db.save(data)
إحساس جيد: دوال منفصلة لمسؤوليات منفصلة
def validate_data(data): # Validation logic pass
def save_data(data): validate_data(data) # التأكد من حدوث التحقق أولاً db.save(data)
تصميم الدالة الجيد يجعل الكود سهل الاختبار وإعادة الاستخدام والفهم بمجرد النظر.