الأساليب (Methods) في Python: السلوكيات والوظائف

class Dog:
    def __init__(self, name):
        self.name = name
    
    def bark(self):
        print(f"{self.name} ينبح: واف واف!")

# إنشاء كلب
my_dog = Dog("ماكس")

# استدعاء الأسلوب
my_dog.bark()

class BankAccount:
    def __init__(self, owner, balance):
        self.owner = owner
        self.balance = balance
    
    def deposit(self, amount):
        """إيداع مبلغ في الحساب"""
        self.balance += amount
        print(f"تم إيداع {amount} ريال")
        print(f"الرصيد الجديد: {self.balance} ريال")
    
    def withdraw(self, amount):
        """سحب مبلغ من الحساب"""
        if amount > self.balance:
            print(f"رصيد غير كافي! الرصيد الحالي: {self.balance}")
        else:
            self.balance -= amount
            print(f"تم سحب {amount} ريال")
            print(f"الرصيد المتبقي: {self.balance} ريال")

# إنشاء حساب
account = BankAccount("أحمد", 1000)

# استخدام الأساليب
account.deposit(500)
print()
account.withdraw(300)
print()
account.withdraw(2000)  # محاولة سحب أكثر من الرصيد

class Rectangle:
    def __init__(self, width, height):
        self.width = width
        self.height = height
    
    def get_area(self):
        """حساب المساحة"""
        area = self.width * self.height
        return area
    
    def get_perimeter(self):
        """حساب المحيط"""
        perimeter = 2 * (self.width + self.height)
        return perimeter
    
    def is_square(self):
        """التحقق: هل هو مربع؟"""
        return self.width == self.height

# إنشاء مستطيل
rect1 = Rectangle(5, 10)
rect2 = Rectangle(7, 7)

# استخدام الأساليب التي تُرجع قيماً
area1 = rect1.get_area()
print(f"مساحة المستطيل 1: {area1}")

perimeter1 = rect1.get_perimeter()
print(f"محيط المستطيل 1: {perimeter1}")

# استخدام القيمة المُرجعة مباشرة
print(f"هل المستطيل 1 مربع؟ {rect1.is_square()}")
print(f"هل المستطيل 2 مربع؟ {rect2.is_square()}")

class Student:
    def __init__(self, name):
        self.name = name
        self.grades = []
    
    def add_grade(self, grade):
        """إضافة درجة"""
        self.grades.append(grade)
        print(f"تم إضافة درجة {grade} للطالب {self.name}")
    
    def get_average(self):
        """حساب المعدل"""
        if not self.grades:
            return 0
        return sum(self.grades) / len(self.grades)
    
    def get_status(self):
        """تحديد حالة النجاح/الرسوب"""
        # استدعاء أسلوب آخر من نفس الصنف
        average = self.get_average()
        
        if average >= 50:
            return "ناجح"
        else:
            return "راسب"
    
    def display_report(self):
        """عرض تقرير كامل"""
        # استدعاء عدة أساليب
        average = self.get_average()
        status = self.get_status()
        
        print(f"\n{'='*40}")
        print(f"تقرير الطالب: {self.name}")
        print(f"{'='*40}")
        print(f"الدرجات: {self.grades}")
        print(f"المعدل: {average:.2f}")
        print(f"الحالة: {status}")
        print(f"{'='*40}")

# استخدام الصنف
student = Student("أحمد")

# إضافة درجات
student.add_grade(85)
student.add_grade(90)
student.add_grade(78)

# عرض التقرير (يستدعي أساليب أخرى داخلياً)
student.display_report()

class TaskManager:
    """نظام إدارة المهام"""
    
    def __init__(self, owner):
        self.owner = owner
        self.tasks = []  # قائمة المهام
        self.completed_tasks = []  # المهام المكتملة
    
    def add_task(self, task_name, priority="متوسطة"):
        """إضافة مهمة جديدة"""
        task = {
            'name': task_name,
            'priority': priority,
            'completed': False
        }
        self.tasks.append(task)
        print(f"تمت إضافة المهمة: {task_name} (أولوية: {priority})")
    
    def complete_task(self, task_name):
        """تحديد مهمة كمكتملة"""
        for task in self.tasks:
            if task['name'] == task_name and not task['completed']:
                task['completed'] = True
                self.completed_tasks.append(task)
                print(f"تم إكمال المهمة: {task_name}")
                return True
        print(f"لم يتم العثور على المهمة: {task_name}")
        return False
    
    def get_pending_count(self):
        """عدد المهام المعلقة"""
        count = 0
        for task in self.tasks:
            if not task['completed']:
                count += 1
        return count
    
    def get_completed_count(self):
        """عدد المهام المكتملة"""
        return len(self.completed_tasks)
    
    def get_completion_rate(self):
        """نسبة الإنجاز"""
        if not self.tasks:
            return 0
        completed = self.get_completed_count()
        total = len(self.tasks)
        return (completed / total) * 100
    
    def display_summary(self):
        """عرض ملخص المهام"""
        print(f"\n{'='*50}")
        print(f"ملخص مهام: {self.owner}")
        print(f"{'='*50}")
        print(f"إجمالي المهام: {len(self.tasks)}")
        print(f"المهام المكتملة: {self.get_completed_count()}")
        print(f"المهام المعلقة: {self.get_pending_count()}")
        print(f"نسبة الإنجاز: {self.get_completion_rate():.1f}%")
        print(f"{'='*50}")
    
    def display_all_tasks(self):
        """عرض جميع المهام"""
        print(f"\n--- قائمة مهام {self.owner} ---")
        if not self.tasks:
            print("لا توجد مهام")
            return
        
        for i, task in enumerate(self.tasks, 1):
            status = "✓ مكتملة" if task['completed'] else "○ معلقة"
            print(f"{i}. {task['name']} - {task['priority']} - {status}")

# استخدام النظام
print("=== نظام إدارة المهام ===\n")

# إنشاء مدير مهام
manager = TaskManager("أحمد")

# إضافة مهام
manager.add_task("كتابة التقرير الشهري", "عالية")
manager.add_task("مراجعة البريد الإلكتروني", "متوسطة")
manager.add_task("الاتصال بالعميل", "عالية")
manager.add_task("تحديث الموقع", "منخفضة")

# عرض جميع المهام
manager.display_all_tasks()

# إكمال بعض المهام
print("\n--- إكمال المهام ---")
manager.complete_task("مراجعة البريد الإلكتروني")
manager.complete_task("الاتصال بالعميل")

# عرض المهام بعد التحديث
manager.display_all_tasks()

# عرض الملخص
manager.display_summary()

# خطأ
class Calculator:
    def add(a, b):  # نسينا self!
        return a + b

calc = Calculator()
# calc.add(5, 3)  # TypeError!

# صحيح
class Calculator:
    def add(self, a, b):  # يجب إضافة self
        return a + b

calc = Calculator()
result = calc.add(5, 3)  # يعمل بشكل صحيح

# خطأ
class Person:
    def __init__(self, name):
        self.name = name
    
    def greet(self):
        # خطأ: name غير معرّف!
        print(f"مرحباً {name}")  # NameError!

# صحيح
class Person:
    def __init__(self, name):
        self.name = name
    
    def greet(self):
        # يجب استخدام self.name
        print(f"مرحباً {self.name}")

# خطأ
class Math:
    def square(self, x):
        return x * x
    
    def sum_of_squares(self, a, b):
        # خطأ: يجب استخدام self.square
        return square(a) + square(b)  # NameError!

# صحيح
class Math:
    def square(self, x):
        return x * x
    
    def sum_of_squares(self, a, b):
        # استخدام self للوصول للأسلوب
        return self.square(a) + self.square(b)