Što su dunder (magic) metode?

Question

Accepted Answer

**Dunder metode** ("double underscore", još zvane magic/special metode) su posebno-nazvane metode poput `__init__`, `__str__`, `__len__` koje omogućavaju vašim objektima integraciju s Python-ovim **ugrađenim operatorima i funkcijama**. Python ih poziva automatski kao odgovor na sintaksu — npr. `len(obj)` poziva `obj.__len__()`.

## Objekti koji se ponašaju kao ugrađeni tipovi

```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__
```

Definiranje ovih omogućava vašim prilagođenim objektima rad s nativnom sintaksom (`+`, `==`, `print`) baš kao ugrađeni tipovi.

## Česte dunder metode

```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)
```

## Primjer: činjenje objekta iterabilnim i indeksabilnim

```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
    ...
```

Implementiranje `__len__` i `__getitem__` čini objekt sličnim nizu — podržavajući `len()`, indeksiranje, iteraciju i rezanje.

## Zašto je to važno

Dunder metode su način na koji Python postiže dosljedan, "sve je objekt" osjećaj — oni omogućavaju vašim prilagođenim klasama da se bezbrižno integriraju s operatorima jezika i ugrađenim funkcijama (`+`, `==`, `len()`, `for`, `[]`, `with`, `print`).

Ovo je temelj Python-ovog elegantan, polimorfnog dizajna ("duck typing" + data model).

Znanje ključnih dundera — posebno `__init__`, `__repr__`/`__str__`, operatora usporedbe i aritmetike, te protokola iteracije — omogućava vam izgradnju intuitivnih, Pythonskih klasa koje se ponašaju kao nativni tipovi i objašnjava kako se sintaksa jezika mapira na pozive metoda ispod pokrova.