Co jsou dunder (magic) metody?

Question

Accepted Answer

**Dunder metody** ("double underscore", také nazývané magic/special metody) jsou speciálně pojmenované metody jako `__init__`, `__str__`, `__len__`, které umožňují vašim objektům integraci s Pythonovými **vestavěnými operátory a funkcemi**. Python je volá automaticky v odpovědi na syntaxi — např. `len(obj)` volá `obj.__len__()`.

## Fungování objektů jako vestavěné funkce

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

Definování těchto metod umožňuje vašim vlastním objektům pracovat s nativní syntaxí (`+`, `==`, `print`) stejně jako vestavěné typy.

## Běžné dunder metody

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

## Příklad: vytvoření objektu, který je iterable a 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
    ...
```

Implementace `__len__` a `__getitem__` způsobí, že se objekt chová jako sekvence — podporuje `len()`, indexování, iteraci a slicing.

## Proč na tom záleží

Dunder metody jsou způsob, jak Python dosahuje konzistentního pocitu "všechno je objekt" — umožňují vašim vlastním třídám bezproblémovou integraci s operátory jazyka a vestavěnými funkcemi (`+`, `==`, `len()`, `for`, `[]`, `with`, `print`).

Toto je základ Pythonova elegantního, polymorfního designu ("duck typing" + datový model).

Znalost klíčových dunders — zejména `__init__`, `__repr__`/`__str__`, operátory porovnávání a aritmetických operací a iteračního protokolu — vám umožňuje vytvářet intuitivní, pythonovské třídy, které se chovají jako nativní typy, a vysvětluje, jak se syntaxe jazyka mapuje na volání metod pod kapotou.