ما هي دندر (magic) methods؟

Question

Accepted Answer

**دندر methods** ("double underscore"، وتسمى أيضاً magic/special methods) هي methods مسماة بشكل خاص مثل `__init__`، `__str__`، `__len__` التي تسمح لكائناتك بالتكامل مع **المعاملات والدوال المدمجة في Python**. يستدعيها Python تلقائياً استجابة للصيغة — على سبيل المثال `len(obj)` يستدعي `obj.__len__()`.

## جعل الكائنات تتصرف مثل المدمجة

```python
class Vector:
    def __init__(self, x, y):       # constructor — Vector(1, 2)
        self.x, self.y = x, y

def __repr__(self):             # repr(v) and the REPL — for developers
        return f"Vector({self.x}, {self.y})"

def __str__(self):              # str(v) / print(v) — for users
        return f"({self.x}, {self.y})"

def __add__(self, other):       # enables the + operator: v1 + v2
        return Vector(self.x + other.x, self.y + other.y)

def __eq__(self, other):        # enables ==
        return self.x == other.x and self.y == other.y

v1, v2 = Vector(1, 2), Vector(3, 4)
v1 + v2          # Vector(4, 6) — calls __add__
print(v1)        # (1, 2) — calls __str__
v1 == Vector(1, 2)  # True — calls __eq__
```

تعريف هذه الدوال يسمح لكائناتك المخصصة بالعمل مع الصيغة الأصلية (`+`، `==`، `print`) تماماً كما هي الأنواع المدمجة.

## dunder methods الشائعة

```text
__init__   → constructor (object creation)
__repr__   → unambiguous developer representation (debugging, REPL)
__str__    → readable user-facing string (print, str())
__len__    → len(obj)
__getitem__→ obj[key]  (indexing/subscripting)
__iter__ / __next__ → make an object iterable (for loops)
__eq__, __lt__, __gt__ → comparison operators (==, <, >)
__add__, __sub__, __mul__ → arithmetic operators
__call__   → make an instance callable like a function: obj()
__contains__ → the `in` operator
__enter__ / __exit__ → context managers (with statement)
```

## مثال: جعل كائن iterable و indexable

```python
class Deck:
    def __init__(self): self.cards = [...]
    def __len__(self): return len(self.cards)        # len(deck)
    def __getitem__(self, i): return self.cards[i]    # deck[0], and iteration/slicing!

deck = Deck()
len(deck)           # works
for card in deck:   # __getitem__ makes it iterable too
    ...
```

تطبيق `__len__` و `__getitem__` يجعل الكائن يتصرف مثل sequence — ويدعم `len()`، والفهرسة، والتكرار، والتقطيع.

## لماذا يهمك

دندر methods هي كيف يحقق Python "كل شيء هو كائن" المتسقة — فهي تسمح لفئاتك المخصصة بالتكامل السلس مع معاملات اللغة والدوال المدمجة (`+`، `==`، `len()`، `for`، `[]`، `with`، `print`).

هذا هو أساس تصميم Python الأنيق والمتعدد الأشكال ("duck typing" + data model).

معرفة dunder methods الرئيسية — خاصة `__init__`، `__repr__`/`__str__`، معاملات المقارنة والحسابية، وبروتوكول التكرار — تسمح لك ببناء فئات حدسية وPythonic تشعر مثل الأنواع الأصلية، وتشرح كيفية تخطيط صيغة اللغة على استدعاءات method تحت الغطاء.