إنشاء الأصناف (Classes) في Python

# الصيغة الأساسية
class ClassName:
    # محتوى الصنف هنا
    pass

# مثال بسيط: صنف فارغ
class Dog:
    pass

# إنشاء كائن من الصنف
my_dog = Dog()
print(type(my_dog))  # 
print(my_dog)        # <__main__.Dog object at 0x...>

# تعريف صنف بسيط للكتاب
class Book:
    pass

# إنشاء كتاب
my_book = Book()

# الآن my_book هو كائن من نوع Book
print(f"نوع المتغير: {type(my_book)}")
print(f"هل my_book كائن من Book؟ {isinstance(my_book, Book)}")

class Dog:
    # خصائص على مستوى الصنف (مشتركة بين كل الكلاب)
    species = "Canis familiaris"  # كل الكلاب من نفس الفصيلة
    legs = 4                       # كل الكلاب لها 4 أرجل
    is_mammal = True               # كل الكلاب من الثدييات

# إنشاء كائنات
dog1 = Dog()
dog2 = Dog()
dog3 = Dog()

# كل الكائنات تشارك نفس القيم
print(f"كلب 1 - الفصيلة: {dog1.species}, الأرجل: {dog1.legs}")
print(f"كلب 2 - الفصيلة: {dog2.species}, الأرجل: {dog2.legs}")
print(f"كلب 3 - الفصيلة: {dog3.species}, الأرجل: {dog3.legs}")

# يمكن الوصول للخاصية من الصنف نفسه (بدون إنشاء كائن)
print(f"\nمن الصنف مباشرة: {Dog.species}")

class Student:
    # عداد مشترك لجميع الطلاب
    total_students = 0
    school_name = "مدرسة النجاح"

# إنشاء طلاب
student1 = Student()
student2 = Student()
student3 = Student()

# الوصول للعداد المشترك
print(f"عدد الطلاب الحالي: {Student.total_students}")
print(f"اسم المدرسة: {Student.school_name}")

# يمكن الوصول أيضاً من خلال أي كائن
print(f"من خلال student1: {student1.school_name}")

class Dog:
    species = "Canis familiaris"
    
    # أسلوب (Method) - دالة داخل الصنف
    def bark(self):
        print("واف واف!")
    
    def sleep(self):
        print("الكلب نائم...")
    
    def eat(self):
        print("الكلب يأكل طعامه")

# إنشاء كائن
my_dog = Dog()

# استدعاء الأساليب
my_dog.bark()   # واف واف!
my_dog.sleep()  # الكلب نائم...
my_dog.eat()    # الكلب يأكل طعامه

class Calculator:
    def add(self, a, b):
        result = a + b
        print(f"{a} + {b} = {result}")
        return result
    
    def multiply(self, a, b):
        result = a * b
        print(f"{a} × {b} = {result}")
        return result

# إنشاء آلة حاسبة
calc = Calculator()

# استخدام الأساليب
calc.add(5, 3)        # 5 + 3 = 8
calc.multiply(4, 7)   # 4 × 7 = 28

# يمكننا حفظ النتيجة
total = calc.add(10, 20)
print(f"المجموع المحفوظ: {total}")

class Dog:
    def bark(self):
        print("واف واف!")
    
    def introduce(self):
        print("أنا كلب")

# إنشاء 3 كلاب مختلفة
dog1 = Dog()
dog2 = Dog()
dog3 = Dog()

# كل كائن مستقل
print("الكلب الأول:")
dog1.bark()

print("\nالكلب الثاني:")
dog2.introduce()

print("\nالكلب الثالث:")
dog3.bark()

# التحقق من أن كل كائن مختلف
print(f"\nهل dog1 و dog2 نفس الكائن؟ {dog1 == dog2}")  # False
print(f"عنوان dog1 في الذاكرة: {id(dog1)}")
print(f"عنوان dog2 في الذاكرة: {id(dog2)}")
print(f"هل العناوين مختلفة؟ {id(dog1) != id(dog2)}")  # True

class BankAccount:
    # خاصية على مستوى الصنف
    bank_name = "البنك الوطني"
    interest_rate = 0.02  # معدل فائدة 2%
    
    # أسلوب لعرض معلومات البنك
    def show_bank_info(self):
        print(f"مرحباً بك في {self.bank_name}")
        print(f"معدل الفائدة السنوي: {self.interest_rate * 100}%")
    
    # أسلوب لعرض رسالة ترحيبية
    def welcome(self):
        print("شكراً لاختيارك خدماتنا البنكية")
        print("نحن هنا لخدمتك على مدار الساعة")

# إنشاء حسابين
print("=== الحساب الأول ===")
account1 = BankAccount()
account1.show_bank_info()
account1.welcome()

print("\n=== الحساب الثاني ===")
account2 = BankAccount()
account2.show_bank_info()

# الوصول للخاصية المشتركة
print(f"\nاسم البنك من الصنف مباشرة: {BankAccount.bank_name}")

class CookieMold:
    """قالب الكوكيز - الصنف"""
    shape = "نجمة"
    size = "5 سم"
    
    def describe(self):
        print(f"هذا كوكيز على شكل {self.shape} بحجم {self.size}")

# صنع كوكيز من القالب - إنشاء كائنات
cookie1 = CookieMold()
cookie2 = CookieMold()
cookie3 = CookieMold()

# كل كوكيز له نفس الشكل (من نفس القالب)
cookie1.describe()
cookie2.describe()
cookie3.describe()

# لكن كل كوكيز كائن مستقل
print(f"\nعدد الكوكيز المصنوع: 3")
print(f"هل cookie1 و cookie2 نفس الكوكيز؟ {cookie1 is cookie2}")

# خطأ شائع
class Dog:
    def bark():  # نسينا self!
        print("واف واف!")

dog = Dog()
dog.bark()  # TypeError: bark() takes 0 positional arguments but 1 was given

# الصحيح
class Dog:
    def bark(self):  # يجب إضافة self
        print("واف واف!")

dog = Dog()
dog.bark()  # يعمل بشكل صحيح

class Dog:
    def bark(self):
        print("واف واف!")

# خطأ - بدون أقواس
dog = Dog  # هذا يشير للصنف نفسه، وليس كائناً!
print(type(dog))  # 

# محاولة استدعاء الأسلوب ستفشل
# dog.bark()  # AttributeError

# الصحيح - مع أقواس
dog = Dog()  # الآن أنشأنا كائناً
print(type(dog))  # 
dog.bark()  # يعمل بشكل صحيح

# خطأ - أسماء محجوزة
class list:  # list اسم محجوز
    pass

class str:   # str اسم محجوز
    pass

class int:   # int اسم محجوز
    pass

# الصحيح - استخدم أسماء وصفية
class StudentList:
    pass

class CustomString:
    pass

class IntegerWrapper:
    pass

class Counter:
    count = 0  # خاصية صنف (مشتركة)
    
    def increment(self):
        # خطأ: هذا ينشئ خاصية كائن جديدة!
        self.count = self.count + 1

c1 = Counter()
c2 = Counter()

c1.increment()
print(f"c1.count: {c1.count}")  # 1
print(f"c2.count: {c2.count}")  # 0 (لم يتأثر!)
print(f"Counter.count: {Counter.count}")  # 0 (لم يتأثر!)

# الصحيح: إذا أردت تعديل خاصية الصنف
class Counter:
    count = 0
    
    def increment(self):
        Counter.count += 1  # تعديل خاصية الصنف

class BankAccount:
    """
    صنف يمثل حساباً بنكياً بسيطاً.
    
    يوفر وظائف أساسية مثل الإيداع والسحب
    وعرض الرصيد الحالي.
    """
    
    def deposit(self, amount):
        """إيداع مبلغ في الحساب"""
        pass