تلميح الأنواع (Type Hinting - PEP 484)

Python لغة ديناميكية النوع، لكن Python الحديثة تشجع على تلميح الأنواع (type hinting)—إضافة توضيحات اختيارية تشير إلى نوع البيانات المتوقع للمعاملات وقيم الإرجاع.

تلميحات الأنواع لا تؤثر على تنفيذ البرنامج (لا تزال Python تفحص الأنواع وقت التشغيل)، لكنها تحسن بشكل كبير من قابلية قراءة الكود، وتوثيقه، وتسمح باستخدام أدوات تحليل قوية.

الصيغة الأساسية

استخدم نقطتين رأسيين : بعد اسم المعامل، متبوعة بالنوع المتوقع. استخدم -> متبوعة بنوع الإرجاع المتوقع.

python def greeting(name: str) -> str: return f"Hello, {name}"

استدعاء الدالة يبقى كما هو

print(greeting("Dana"))

تلميح الأنواع للهياكل القياسية

بالنسبة للهياكل المعقدة مثل القوائم والقواميس، استخدم الأنواع من وحدة typing (أو الأنواع القياسية في Python 3.9+).

python from typing import List, Dict

def get_high_scores(scores: List[int]) -> float: """يحسب متوسط الدرجات العالية.""" return sum(scores) / len(scores)

def print_user_info(user: Dict[str, str]) -> None: # استخدم 'None' إذا كانت الدالة لا تعيد شيئاً صراحة print(f"User Name: {user['username']}")

get_high_scores([90, 85, 92])

استخدام تلميحات الأنواع هو سمة من سمات كود Python الاحترافي، مما يسهل على زملائك في الفريق (أو على نفسك في المستقبل) فهم هيكل الدالة.