Co z Pythonu dělá tak užitečný jazyk?
Z velké části je to zaměření na čitelnost kódu. Pythonu se někdy říká „spustitelný pseudokód“: syntaxe je inspirovaná zápisem abstraktních algoritmů v matematice, používá se málo speciálních znaků jako $, <<, &&, ?.
Čitelnosti je podřízena expresivita (proto v Pythonu nenajdeme makra jako v Lispu) i délka zápisu (některé věci se nedají napsat na jeden řádek).
Návrh jazyka (a knihoven pro něj) se řídí mimo jiné poučkou „There should be one– and preferably only one –obvious way to do it.“ Existuje ideálně jeden zjevně nejlepší způsob, jak dosáhnout určité funkčnosti. Úkolem programátora je tento způsob najít a použít. Náš cíl by měl být kód, který ostatní programátoři pochopí na první pohled. A pokud je to možné, měli by ho pochopit i neprogramátoři. Není mezi nimi pevná hranice – váš kód můžou číst lidi, kteří programovací jazyk v životě neviděli; programátoři silní v jiných jazycích; průměrní Pythonisté; nebo ostřílení veteráni. Čím víc jich dokáže kód pochopit, tím bude váš kód udržovatelnější.
S tím souvisí koncept „magie“. Magie je něco, co funguje, ačkoli tomu nerozumíme. Pro každého čtenáře kódu může být magie něco jiného: pro začátečníka bude nepochopitelný zápis zip(*args), matematik nemusí chápat princip dědičnosti tříd, ostřílený Pythonista nemusí chápat maticovou matematiku, neprogramátor netuší, jak funguje mobil nebo webová aplikace. Je to tedy subjektivní pojem, ale lze ho zobjektivnit: čím méně lidí váš kód pochopí, tím je kód magičtější.
Magie, která funguje, nevadí. Věci které nechápu, můžu stále používat – jen nevím jak fungují, a tudíž je neumím opravit. Problém nastane až v momentě, kdy se něco pokazí.
Přehlednost a udržitelnost kódu je samozřejmě potřeba vyvážit s ostatními aspekty. Kód musí být například dostatečně rychlý a optimalizace ho často znepřehlední. Proto je dobré optimalizovat až potom, co vím, že je kód správný a řeší opravdu problém, který potřebuji vyřešit. V ten moment napíšu testy a potom, když je potřeba, můžu optimalizovat – trochu přehlednosti vyměnit za rychlost.
Na jiný důvod, proč použít méně pochopitelné techniky, narazíme při psaní knihoven a frameworků. To je kód, který používá hodně programátorů – a často jsou to programátoři s méně zkušenostmi, než mají autoři knihovny. Tady proto bývá dobré občas použít nějakou tu magii – znepřehlednit kód knihovny, aby kód který knihovnu používá, mohl být přehlednější.
Typický příklad jsou dekorátory ve Flasku. Napsat dekorátor není úplně triviální, ale velice to zjednodušuje práci všem, co ve Flasku píšou web. Konstrukce @app.route je pro většinu lidí magická – nevíme přesně, co to dělá, ale to nám nebrání ji použít.
Druhý možný význam slova magie je něco, co neodpovídá „normálnímu“ chování podobných věcí.
Jazyk Python standardizuje syntaxi relativně malého počtu operací (operátory, volání funkcí, atributy, ...), způsobů řízení toku programu (cykly, with, ...) a strukturování kódu (moduly, def, class).
To, že je jich relativně málo, má dvě výhody: zaprvé fungují s ostatními části jazyka a zadruhé nebývá problém rozhodnout, který způsob je pro daný problém nejlepší.
Téměř všechno v Pythonu ale jde předefinovat. Operátor / nemusí jen dělit: můžu si napsat třídu pro jméno souboru, která umí pomocí / oddělovat adresáře *.
Cyklus for nemusí iterovat přes předem danou sekvenci prvků; iterovatelný objekt může poskytovat jakékoli hodnoty podle jakýchkoli pravidel.
Příkaz class dokonce vůbec nemusí vytvořit třídu, jak uvidíme později.
Ačkoliv si ale můžeme dovolit téměř cokoli, je dobré mít na paměti, že odchylky od „normálního“ chování jsou magické. Jakmile někdo použije divnou třídu, která předefinovává dělení, ve svém kódu, musí každý čtenář toho kódu nejen opustit představu o tom, co operátor / dělá, ale hlavně si předtím uvědomit, že / může dělat něco divného. To samé platí u „divných“ iterovatelných objektů nebo tříd. Odchylka od normálního chování, je-li nezbytná, by měla být dobře promyšlená a zdokumentovaná.
Nadefinujeme-li vlastní nestandardní – „magické“ – chování některých objektů, často se stane, že nebudou fungovat s ostatními prvky jazyka tak dobře, jako to co je zabudované. Předefinujeme-li < tak, že nebude mít nic společného s porovnáváním, bude se funkce sorted chovat podivně. Když u svých objektů předefinuji přístup k atributům, musím si dávat zvlášť pozor na to, aby fungovala funkce dir().
Následující principy (kromě jiných) je proto dobré při psaní knihoven používat jen po pečlivém zvážení, jestli by to nešlo i bez magie.
* Taková třída dokonce existuje ve standardní knihovně.
Základní způsob, jak přizpůsobit chování objektů, jsou speciální metody. Asi už víte, že všechny atributy, které začínají a končí dvojitým podtržítkem, jsou rezervované pro samotný Python, který je používá podle svých pravidel – například danou metodu volá, když je potřeba sečíst dvě čísla.
Speciální metody jsou popsané v dokumentaci. Zde uvedu jen přehled, který pokročilý Pythonista nosí v hlavě, aby věděl co je všechno možné. Doporučuji si předtím, než nějakou naimplementujete, dokumentaci přečíst.
Metody pro předefinování aritmetických operátorů:
__add__, __sub__, __mul__, __div__, __floordiv__, __pow__, __matmul__, __lshift__, __rshift__, __or__, __xor__ a varianty s r a i (__radd__, __iadd__, atd.);
__neg__, __pos__, __abs__, __invert__.
Metody pro předefinování porovnávání:
__eq__, __ne__, __lt__, __gt__, __le__, __ge__, __hash__.
Metoda pro zavolání objektu jako funkce:
__call__.
Metody pro funkčnost sekvencí a kontejnerů:
__len__, __iter__, __next__, __reversed__; __contains__ pro operátor in.
Metody pro „hranaté závorky“:
__getitem__, __setitem__, __delitem__.
Převádění na řetězce:
__repr__, __str__, __format__.
Převádění na čísla:
__complex__, __float__, __index__, __round__, __floor__, __ceil__.
Převádění na bool (např. i v if):
__bool__.
Vytváření a rušení objektů:
__new__ (konstruktor – vytvoří objekt dané třídy), __init__ (inicializuje objekt dané třídy), __del__ (zavoláno před zrušením objektu).
Předefinování přístupu k atributům:
__getattr__ (zavolá se, pokud se atribut nenajde), __getattribute__ (zavolá se pro každý přístup k atributu), __setattr__, __delattr__, __dir__.
Implementace context manageru (pro with):
__enter__, __exit__.
Implementace deskriptoru (viz níže):
__get__, __set__, __delete__.
Implementace asynchronní funkcionality:
__await__, __aiter__, __anext__, __aenter__, __aexit__.
Předefinování hierarchie dědičnosti:
__instancecheck__, __subclasscheck__.
Další věc, na kterou se podíváme, jsou dekorátory – způsob, jak si přizpůsobovat funkce.
Nejjednodušší použití dekorátorů je registrace:
k funkci přidáme dekorátor a funkce se někam zaregistruje, uloží,
aby se dala zavolat později.
Typický příklad je @app.route ve Flasku.
My si pro příklad budeme chtít udělat dekorátor pro kalkulačku,
@register_operator, aby fungoval tento kód:
operators = {}
@register_operator
def add(a, b):
return a + b
@register_operator
def mul(a, b):
return a * b
a = int(input('First number: '))
operator_name = input('Operation: ')
b = int(input('Second number: '))
func = operators[operator_name]
print(func(a, b))
Bez použití dekorátorů by se to dalo napsat takto:
def register_operator(func):
operators[func.__name__] = func
def add(a, b):
return a + b
register_operator(add)
S použitím dekorátoru je funkce register_operator téměř stejná,
jen použijeme speciální syntaxi se zavináčem.
def register_operator(func):
operators[func.__name__] = func
return func
@register_operator
def add(a, b):
return a + b
Použití dekorátoru je jen zkrácený zápis pro volání dekorátoru jako funkce – poslední tři řádky předchozího příkladu jsou ekvivalentní tomuto:
def add(a, b):
return a + b
add = register_operator(add)
Chování samotného @ je tedy celkem triviální.
Magie (složitost) spočívá v tom, že dekorátor je většinou funkce vyššího řádu:
bere jinou funkci jako argument a taky jinou funkci vrací.
V případě registrace vrací stejnou funkci jako dostala – ale to není povinné.
Často se setkáme s dekorátory, které dekorovanou funkci nějak modifikují. Například můžeme napsat dekorátor, který v naší kalkulačce převede vstup na reálná čísla. Dělá to tak, že definuje novou funkci, která volá tu původní – ale před nebo po tomto volání může dělat i něco jiného.
def to_floats(func):
def outer_function(a, b):
a = float(a)
b = float(b)
return func(a, b)
return outer_function
@to_floats
def add(a, b):
"""Adds two numbers"""
return a + b
print(add(1, '2'))
Takto funguje většina dekorátorů, které mění chování dekorované funkce. Naráží s tím ale na jeden problém: nově nadefinovaná funkce má vlastní jméno (a dokumentační řetězec a podobné informace), což kazí iluzi, že jsme původní funkci jen trošku změnili:
print(add)
help(add)
Řešení je jednoduché – zkopírovat jméno, dokumentační řetězec atd. z jedné
funkce na druhou.
Na to ve standardní knihovně existuje dekorátor jménem functools.wraps:
import functools
def to_floats(func):
@functools.wraps(func)
def outer_function(a, b):
a = float(a)
b = float(b)
return func(a, b)
return outer_function
S wraps bude help(add) fungovat správně – ukáže původní jméno
a dokumentační řetězec.
Z volání wraps(func) je vidět, že jako dekorátor můžeme použít i volání
funkce, ne jen funkci samotnou.
Budeme-li chtít napsat dekorátor, který tohle umí, potřebujeme napsat
funkci ještě vyššího řádu – totiž funkci, která po zavolání vrátí dekorátor:
operators = {}
def register_operator(name):
def decorator(func):
operators[name] = func
return func
return decorator
@register_operator('+')
def add(a, b):
return a + b
@register_operator('*')
def mul(a, b):
return a * b
a = int(input('First number: '))
operator_name = input('Operation: ')
b = int(input('Second number: '))
func = operators[operator_name]
print(func(a, b))
Řádek @register_operator('+') dělá (jak už víme) to stejné, jako bychom hned
za funkcí napsali add = register_operator('+')(add).
Budete-li chtít napsat dekorátor, který bere argumenty, a přitom ještě „mění“ dekorovanou funkci, dostanete se na tři funkce zanořené v sobě:
import functools
operators = {}
def register_operator(name):
def to_floats(func):
@functools.wraps(func)
def outer_function(a, b):
a = float(a)
b = float(b)
return func(a, b)
operators[name] = outer_function
return outer_function
return to_floats
@register_operator('+')
def add(a, b):
return a + b
func = operators['+']
print(func(1, '2'))
Dekorátorů se na jedné funkci dá použít víc:
@register_operator('×')
@register_operator('*')
def mul(a, b):
return a * b
Úplně stejně jako funkce se dají dekorovat i třídy. Dekorátor dostane třídu jako první argument a třída se nahradí tím, co dekorátor vrátí.
Jeden z nejmagičtějších operátorů v Pythonu je ., tečka.
Je magický v obou významech – většina lidí ho používá, ačkoli nemá tušení, co přesně dělá, a dá se předefinovat tolika různými způsoby, že to vydá na celou přednášku.
Pomocí tečky zapisujeme tři operace: čtení atributu (print(foo.bar)), zapisování (foo.bar = 3) a mazání (del foo.bar).
Tady se zaměříme hlavně na nejmagičtější z nich, čtení.
Kdykoli atribut čteme pomocí tečky, hledá se několika místech:
AttributeError.To je trochu zjednodušený, ale užitečný model.
Speciální metody, které se nevolají pomocí tečky, přeskakují první krok: metoda __add__ tedy musí být definována na třídě, aby se zavolala pro a + b.
(Poznámka navíc pro ty, kdo čtou tento text podruhé: na metatřídě se atribut nehledá; např. existuje-li
type.mro, najde sestr.mro, ale už ne"".mro)
Podívejme se teď na získávání atributu trošku podrobněji. Je to poměrně komplikovaný proces a existuje několik způsobů, jak ho přizpůsobit. Nejjednodušší je dvojice speciálních metod:
__getattribute__, která kompletně předefinuje funkci . pro čtení atributu, a__getattr__, která se zavolá, až když se atribut nenajde normálním způsobem.První z nich nedoporučuji používat, protože je příliš obecná (pokusy se z ní dostat ke stavu objektu končívají nekonečnou rekurzí). Příklad druhé:
class Palette:
red = 255, 0, 0
green = 0, 255, 0
def __getattr__(self, attr_name):
prefix, sep, suffix = attr_name.partition('_')
if prefix == 'dark':
original_color = getattr(self, suffix)
return tuple(c//2 for c in original_color)
else:
raise AttributeError(attr_name)
palette = Palette()
print(palette.dark_red)
(Předpokládám že znáte funkci getattr; kdyby ne: getattr(foo, "bar") dělá totéž co foo.bar – jen je jméno atributu předáno jako řetězec, takže může být např. v proměnné. Podobně existují setattr(instance, attr_name, new_value) a delattr(setattr(instance, attr_name).)
Metoda __getattr__ je většinou tak trochu kanón na vrabce: ve většině případů nepotřebujeme nastavit chování všech neexistujících atributů, ale jenom jednoho nebo několika konkrétních.
Například máme třídu pro 2D bod s atributy x a y a potřebujeme i atribut pro dvojici (x, y).
Toto se často dělá pomocí dekorátoru property:
class Point:
def __init__(self, x, y):
self.x = x
self.y = y
@property
def pos(self):
return self.x, self.y
point = Point(41, 8)
print(point.pos)
Jak to ale funguje? Dekorátor property je třída, jakou můžete teoreticky napsat sami v Pythonu.
Je to deskriptor, objekt, který v rámci nějaké třídy popisuje jak přistupovat k nějakému atributu.
Nejlépe se deskriptory vysvětlí na příkladu:
# (Omluvte prosím češtinu v kódu)
class Descriptor2D:
"""Popisuje atribut, který kombinuje dva jiné atributy do dvojice"""
def __init__(self, name1, name2):
self.name1 = name1
self.name2 = name2
def __get__(self, instance, cls=None):
"""Volá se, když je třeba načíst atribut dané `instance` na dané třídě `cls`.
"""
if instance is not None:
# Je-li instance nastavena, čteme atribut z ní.
return getattr(instance, self.name1), getattr(instance, self.name2)
else:
# Je-li instance None, čteme atribut přímo ze třídy `cls`;
# v tomto případě slušné deskriptory většinou vrací deskriptor samotný.
return self
class Rect:
def __init__(self, x, y, w, h):
self.x = x
self.y = y
self.w = w
self.h = h
pos = Descriptor2D('x', 'y')
size = Descriptor2D('w', 'h')
rect = Rect(1, 2, 3, 4)
print(rect.pos)
print(rect.size)
# Čtení atributu přímo ze třídy:
print(Rect.pos)
Deskriptory jsou tedy součást třídy – atributy s nějakým jménem. Popisují, jak se bude přistupovat k atributu daného jména.
Existují dva druhy deskriptorů: data descriptor a non-data descriptor. Liší se v tom, jestli popisují jen, jak se daný atribut čte, nebo i jak se do něj zapisuje. Výše uvedený deskriptor je non-data: ovládá jen čtení. Zápis funguje jako u normálních atributů: přepíše aktuální hodnotu – a nová hodnota se pak použije místo volání deskriptoru:
rect.pos = 'haha'
print(rect.pos)
Abychom tomu zabránili, můžeme na deskriptoru nadefinovat speciální metodu __set__ (nebo __delete__), která popisuje,
jak se atribut nastavuje (resp. maže).
Tím vznikne data descriptor:
class Descriptor2D:
def __init__(self, name1, name2):
self.name1 = name1
self.name2 = name2
def __get__(self, instance, cls=None):
if instance is not None:
return getattr(instance, self.name1), getattr(instance, self.name2)
else:
return self
def __set__(self, instance, new_value):
a, b = new_value
setattr(instance, self.name1, a)
setattr(instance, self.name2, b)
def __delete__(self, instance):
delattr(instance, self.name1)
delattr(instance, self.name2)
class Rect:
# jako předtím
rect = Rect(1, 2, 3, 4)
rect.pos = 123, 456
print(rect.pos)
Už zmíněný vestavěný deskriptor property je data descriptor.
Popisuje jak čtení, tak zápis atributu. Pokud mu nenastavíme funkci pro zápis, vyhodí ze své metody __set__ výjimku AttributeError se zprávou, že do atributu se zapisovat nedá. (To je trochu magická odchylka od normálního chování Pythonu, kdy atributy zapisovat jdou.)
Nejčastější příklad non-data deskriptoru je obyčejná funkce.
Každá funkce totiž funguje jako deskriptor: má speciální metodu __get__, která zajišťuje, že pokud je nastavena na třídě, daným atributem nedostaneme funkci, ale metodu (s „předvyplněným“ parametrem self).
def foo(self):
return 4
class C:
foo = foo
c = C()
# Obyčejná funkce
print(C.foo)
print(foo)
# Metoda
print(C().foo)
print(foo.__get__(c))
Protože je to non-data deskriptor, můžeme v jednotlivých instancích třídy daný atribut přepsat něčím jiným, čímž metodu znepřístupníme.
Jako zajímavost uvedu non-data deskriptor, který přepisuje svůj vlastní atribut.
Funguje podobně jako @property, jen se výsledek vypočítá pouze jednou a uloží se jako normální atribut.
Při dalším přístupu k atributu už se použije uložená hodnota.
class reify:
def __init__(self, func):
self.func = func
def __get__(self, instance, cls=None):
if instance is None:
return self
val = self.func(instance)
setattr(instance, self.func.__name__, val)
return val
class Vector:
def __init__(self, x, y):
self.x = x
self.y = y
@reify
def length(self):
print('Running expensive computation...')
return (self.x ** 2 + self.y ** 2) ** 0.5
vect = Vector(3, 4)
print(vect.length)
print(vect.length)
print(vect.length)
Kompletní implementace je např. ve frameworku Pyramid jako pyramid.decorator.reify.
Třídy v Pythonu můžou mít konstruktor – funkci, která se zavolá, aby
vytvořila objekt daného typu.
Toto není známá metoda __init__ – ta objekt nevytváří, ta dostane už
předpřipravený self, který jen naplní atributy.
Opravdový konstruktor se jmenuje __new__ a chová se jako classmethod:
místo self bere třídu, jejíž instanci má vytvořit.
Opravdový konstruktor se „hodí“ pro vytváření singletonů, tříd, které mají jen jednu instanci:
class Singleton:
def __new__(cls):
try:
return cls._instance
except AttributeError:
cls._instance = super().__new__(cls)
return cls._instance
assert Singleton() is Singleton()
Podobný trik lze použít pro třídu podobnou bool, která má pouze dvě instance:
bool(1) is bool(2).
Metoda __new__ se hodí, když chceme dědit z neměnitelné (immutable)
třídy jako tuple.
Metoda __init__ sice dostane self, ale cokoli z nadtřídy už nemůže měnit.
Je ale možné předefinovat __new__.
Normálně bere tuple jediný argument, tuple([1, 2]).
Chceme-li brát dva, dá se to udělat takto:
class Point(tuple):
def __new__(cls, x, y):
return super().__new__(cls, (x, y))
print(Point(3, 4))
Poslední věc, na kterou se podíváme, jsou metatřídy.
Začneme zlehka: pokud při definici třídy zadáme nějakou funkci jako pojmenovaný
parametr metaclass, funkce se zavolá s informacemi potřebnými pro vytvoření
třídy.
Ty můžeme použít, nebo úplně ignorovat a vrátit něco jiného:
def fake_metaclass(name, bases, namespace):
return 42
class NotAClass(metaclass=fake_metaclass):
pass
print(NotAClass)
Argumenty, které „metatřída” dostane, jsou tři: jméno třídy, n-tice
nadtříd a jmenný prostor – slovník s proměnnými, které vznikly vykonáním
těla příkazu class.
(Ve jmenném prostoru jsou implicitně nastavené záznamy __module__
a __qualname__, které přidává samotný příkaz class.)
def fake_metaclass(name, bases, namespace):
print('name:', name)
print('bases:', bases)
print('namespace:', namespace)
return 42
class NotAClass(int, metaclass=fake_metaclass):
foo = 123
def inc(self):
return self + 1
Když metaclass nezadáme, použije se výchozí metatřída, tedy třída třídy.
V Pythonu je to type.
Pokud ji zavoláme s vhodnými argumenty, dostaneme normální třídu:
MyInt = type('MyInt', (int, ), {'foo': 123, 'inc': lambda self: self + 1})
three = MyInt(3)
print(three.inc())
Kromě toho se type dá zavolat i s jedním argumentem; v tom případě vrátí
typ (třídu) daného argumentu.
(Tohle chování – funkce, která dělá úplně různé věci v závislosti na počtu
argumentů – v Pythonu často nevidíme.
Je to nešťastná výjimka, která přežívá z historických důvodů.)
Pojďme se podívat na třídy několika základních objektů:
# Třída základních objektů
print(type(1))
print(type("abc"))
# Třída třídy – metatřída.
# Třída většiny tříd v Pythonu je `type`
print(type(int))
print(type(type(1)))
# Třída třídy třídy
# Samotná `type` je jedna z té většiny tříd; její třída je `type`
print(type(type))
print(type(type(type(1))))
Objekty třídy type (tedy třídy) se normálně tvoří příkazem class.
Explicitně to můžeme napsat takto:
class NormalClass(metaclass=type):
foo = 123
Když budeme chtít chování třídy změnit, budeme postupovat podobně jako
u jiných objektů.
Kdybych chtěl celé číslo, přes které jde iterovat, podědím z int
a předefinuji __iter__.
Pokud chci třídu, přes kterou jde iterovat (tedy ne přes objekty dané
třídy – přes třídu samotnou!), podědím z type a předefinuji __iter__:
class IterableMeta(type):
def __init__(cls, name, bases, namespace):
cls.items = sorted(n for n in namespace
if not n.startswith('__'))
super().__init__(name, bases, namespace)
def __iter__(cls):
return iter(cls.items)
class SimpleEnum(metaclass=IterableMeta):
a = 1
b = 2
c = 3
d = 4
print(SimpleEnum.a)
print(list(SimpleEnum))
(V metatřídě se většinou používá cls místo self, aby bylo jasné, že
instance, se kterou pracujeme, je třída – ale to je jen konvence.)
Metatřídy se dědí.
Pokud v příkazu class nezadám explicitně metaclass, použije
se metatřída nadtřídy:
class AnotherEnum(SimpleEnum):
x = 10
y = 20
z = 30
print(AnotherEnum.a)
print(list(AnotherEnum))
Tímto způsobem lze vnuknout třídám magické schopnosti bez toho, aby
uživatel naší knihovny musel použít metaclass – stačí mu podědit z námi
připravené třídy.
Další věc, kterou metatřídy umí, je připravit počáteční jmenný prostor.
Metoda __init__ (nebo __new__) v metatřídě normálně dostane slovník,
což nemusí být vždy to, co potřebuji.
Můžu si chtít třeba „zapamatovat” pořadí, v jakém byly jednotlivé atributy
vytvořeny – a slovník toto pořadí neuchovává.
Na to existuje speciální metoda __prepare__, která se, když na metatřídě
existuje, zavolá pro vytvoření jmenného prostoru:
from collections import OrderedDict
class OrderRememberingMeta(type):
def __prepare__(cls, name):
return OrderedDict()
def __init__(cls, name, bases, namespace):
cls.items = list(namespace)
super().__init__(name, bases, namespace)
def __iter__(cls):
return iter(cls.items)
class OrderedEnum(metaclass=OrderRememberingMeta):
first = 1
second = 2
third = 3
fourth = 4
fifth = 5
print(list(OrderedEnum))
Toho se dá využít třeba v mapování objektů na databázi (např. v Django Models nebo SQLAlchemy), kdy chceme, aby pořadí sloupců tabulky odpovídalo tomu, jak jsou sloupce/atributy nadefinovány ve třídě.
Další (bohužel?) oblíbený trik je vnuknutí magických schopností modulu.
Naimportované moduly Python ukládá do slovníku sys.modules, aby při dalším
importu nemusel načítat znovu – sys.modules tedy slouží jako cache.
A tuto cache můžeme změnit (tzv. cache poisoning) – přidat si do ní
vlastní „modul“, který ovšem vůbec nemusí být modul, a tudíž může umět věci,
které moduly normálně neumí:
import sys
sys.modules['fake'] = 'a string'
...
import fake
print(fake[2])
Když toto uděláme přímo z modulu, uživatel naší knihovny dostane podstrčený
objekt hned při prvním importu.
K tomu se hodí proměnná __name__, jméno aktuálního modulu:
sys.modules[__name__] = ReplacementModule()
Jiný trik je registrace „built-in“ („superglobální”) proměnné:
import builtins
builtins.ANSWER = 42
...
# Třeba v jiném modulu
print(ANSWER)Tímto způsobem se dají i předefinovat vestavěné funkce, což může být někdy užitečné pro ladění. V produkčním kódu to ale, prosím, nedělejte.
Úkol není!
Budete-li chtít některé techniky z této lekce ve svém kódu (včetně semestrálky) použít, zamyslete se, jestli se problém nedá vyřešit jednodušeji, čitelněji, přehledněji, udržovatelněji. Dobrý mág ví, kdy magii nepoužít.
{
"data": {
"sessionMaterial": {
"id": "session-material:2017/mipyt-zima:magic:0",
"title": "Magie",
"html": "\n \n \n\n <h1>Magie</h1>\n<p>Co z Pythonu dělá tak užitečný jazyk?\nZ velké části je to zaměření na čitelnost kódu. Pythonu se někdy říká „spustitelný pseudokód“: syntaxe je inspirovaná zápisem abstraktních algoritmů v matematice, používá se málo speciálních znaků jako <code>$</code>, <code><<</code>, <code>&&</code>, <code>?</code>.\nČitelnosti je podřízena expresivita (proto v Pythonu nenajdeme makra jako v Lispu) i délka zápisu (některé věci se nedají napsat na jeden řádek).</p>\n<p>Návrh jazyka (a knihoven pro něj) se řídí mimo jiné poučkou „There should be one– and preferably only one –obvious way to do it.“\nExistuje ideálně jeden <em>zjevně nejlepší</em> způsob, jak dosáhnout určité funkčnosti.\nÚkolem programátora je tento způsob najít a použít. Náš cíl by měl být kód, který ostatní programátoři pochopí na první pohled. A pokud je to možné, měli by ho pochopit i neprogramátoři. Není mezi nimi pevná hranice – váš kód můžou číst lidi, kteří programovací jazyk v životě neviděli; programátoři silní v jiných jazycích; průměrní Pythonisté; nebo ostřílení veteráni. Čím víc jich dokáže kód pochopit, tím bude váš kód udržovatelnější.</p>\n<p>S tím souvisí koncept „magie“. Magie je něco, co funguje, ačkoli tomu nerozumíme. Pro každého čtenáře kódu může být magie něco jiného: pro začátečníka bude nepochopitelný zápis <code>zip(*args)</code>, matematik nemusí chápat princip dědičnosti tříd, ostřílený Pythonista nemusí chápat maticovou matematiku, neprogramátor netuší, jak funguje mobil nebo webová aplikace. Je to tedy subjektivní pojem, ale lze ho zobjektivnit: čím méně lidí váš kód pochopí, tím je kód magičtější.</p>\n<p>Magie, která <em>funguje</em>, nevadí. Věci které nechápu, můžu stále používat – jen nevím jak fungují, a tudíž je neumím <em>opravit</em>. Problém nastane až v momentě, kdy se něco pokazí.</p>\n<p>Přehlednost a udržitelnost kódu je samozřejmě potřeba vyvážit s ostatními aspekty. Kód musí být například dostatečně rychlý a optimalizace ho často znepřehlední. Proto je dobré optimalizovat až potom, co vím, že je kód <em>správný</em> a řeší opravdu problém, který potřebuji vyřešit. V ten moment napíšu testy a potom, když je potřeba, můžu optimalizovat – trochu přehlednosti vyměnit za rychlost.</p>\n<p>Na jiný důvod, proč použít méně pochopitelné techniky, narazíme při psaní knihoven a frameworků. To je kód, který používá hodně programátorů – a často jsou to programátoři s méně zkušenostmi, než mají autoři knihovny. Tady proto bývá dobré občas použít nějakou tu magii – znepřehlednit kód knihovny, aby kód který knihovnu <em>používá</em>, mohl být přehlednější.</p>\n<p>Typický příklad jsou dekorátory ve Flasku. Napsat dekorátor není úplně triviální, ale velice to zjednodušuje práci všem, co ve Flasku píšou web. Konstrukce <code>@app.route</code> je pro většinu lidí magická – nevíme přesně, co to dělá, ale to nám nebrání ji použít.</p>\n<h2>Velká moc a velká zodpovědnost</h2>\n<p>Druhý možný význam slova <em>magie</em> je něco, co neodpovídá „normálnímu“ chování podobných věcí.</p>\n<p>Jazyk Python standardizuje syntaxi relativně malého počtu operací (operátory, volání funkcí, atributy, ...), způsobů řízení toku programu (cykly, <code>with</code>, ...) a strukturování kódu (moduly, <code>def</code>, <code>class</code>).\nTo, že je jich relativně málo, má dvě výhody: zaprvé fungují s ostatními části jazyka a zadruhé nebývá problém rozhodnout, který způsob je pro daný problém nejlepší.</p>\n<p>Téměř všechno v Pythonu ale jde předefinovat. Operátor <code>/</code> nemusí jen dělit: můžu si napsat třídu pro jméno souboru, která umí pomocí <code>/</code> oddělovat adresáře *.\nCyklus <code>for</code> nemusí iterovat přes předem danou sekvenci prvků; iterovatelný objekt může poskytovat jakékoli hodnoty podle jakýchkoli pravidel.\nPříkaz <code>class</code> dokonce vůbec nemusí vytvořit třídu, jak uvidíme později.</p>\n<p>Ačkoliv si ale můžeme dovolit téměř cokoli, je dobré mít na paměti, že odchylky od „normálního“ chování jsou <em>magické</em>. Jakmile někdo použije divnou třídu, která předefinovává dělení, ve svém kódu, musí každý čtenář toho kódu nejen opustit představu o tom, co operátor <code>/</code> dělá, ale hlavně si předtím uvědomit, že <code>/</code> <em>může</em> dělat něco divného. To samé platí u „divných“ iterovatelných objektů nebo tříd. Odchylka od normálního chování, je-li nezbytná, by měla být dobře promyšlená a zdokumentovaná.</p>\n<p>Nadefinujeme-li vlastní nestandardní – „magické“ – chování některých objektů, často se stane, že nebudou fungovat s ostatními prvky jazyka tak dobře, jako to co je zabudované. Předefinujeme-li <code><</code> tak, že nebude mít nic společného s porovnáváním, bude se funkce <code>sorted</code> chovat podivně. Když u svých objektů předefinuji přístup k atributům, musím si dávat zvlášť pozor na to, aby fungovala funkce <code>dir()</code>.</p>\n<p>Následující principy (kromě jiných) je proto dobré při psaní knihoven používat jen po pečlivém zvážení, jestli by to nešlo i bez magie.</p>\n<p>* <em>Taková třída dokonce <a href=\"https://docs.python.org/3/library/pathlib.html\">existuje ve standardní knihovně</a>.</em></p>\n<h2>Speciální metody</h2>\n<p>Základní způsob, jak přizpůsobit chování objektů, jsou <em>speciální metody</em>.\nAsi už víte, že všechny atributy, které začínají a končí dvojitým podtržítkem, jsou rezervované pro samotný Python, který je používá podle svých pravidel – například danou metodu volá, když je potřeba sečíst dvě čísla.</p>\n<p>Speciální metody jsou popsané v <a href=\"https://docs.python.org/3/reference/datamodel.html#special-method-names\">dokumentaci</a>. Zde uvedu jen přehled, který pokročilý Pythonista nosí v hlavě, aby věděl co je všechno možné.\nDoporučuji si předtím, než nějakou naimplementujete, dokumentaci přečíst.</p>\n<p>Metody pro předefinování aritmetických operátorů:\n<code>__add__</code>, <code>__sub__</code>, <code>__mul__</code>, <code>__div__</code>, <code>__floordiv__</code>, <code>__pow__</code>, <code>__matmul__</code>, <code>__lshift__</code>, <code>__rshift__</code>, <code>__or__</code>, <code>__xor__</code> a varianty s <code>r</code> a <code>i</code> (<code>__radd__</code>, <code>__iadd__</code>, atd.);\n<code>__neg__</code>, <code>__pos__</code>, <code>__abs__</code>, <code>__invert__</code>.</p>\n<p>Metody pro předefinování porovnávání:\n<code>__eq__</code>, <code>__ne__</code>, <code>__lt__</code>, <code>__gt__</code>, <code>__le__</code>, <code>__ge__</code>, <code>__hash__</code>.</p>\n<p>Metoda pro zavolání objektu jako funkce:\n<code>__call__</code>.</p>\n<p>Metody pro funkčnost sekvencí a kontejnerů:\n<code>__len__</code>, <code>__iter__</code>, <code>__next__</code>, <code>__reversed__</code>; <code>__contains__</code> pro operátor <code>in</code>.</p>\n<p>Metody pro „hranaté závorky“:\n<code>__getitem__</code>, <code>__setitem__</code>, <code>__delitem__</code>.</p>\n<p>Převádění na řetězce:\n<code>__repr__</code>, <code>__str__</code>, <code>__format__</code>.</p>\n<p>Převádění na čísla:\n<code>__complex__</code>, <code>__float__</code>, <code>__index__</code>, <code>__round__</code>, <code>__floor__</code>, <code>__ceil__</code>.</p>\n<p>Převádění na <code>bool</code> (např. i v <code>if</code>):\n<code>__bool__</code>.</p>\n<p>Vytváření a rušení objektů:\n<code>__new__</code> (konstruktor – <em>vytvoří</em> objekt dané třídy), <code>__init__</code> (<em>inicializuje</em> objekt dané třídy), <code>__del__</code> (zavoláno před <em>zrušením</em> objektu).</p>\n<p>Předefinování přístupu k atributům:\n<code>__getattr__</code> (zavolá se, pokud se atribut nenajde), <code>__getattribute__</code> (zavolá se pro <em>každý</em> přístup k atributu), <code>__setattr__</code>, <code>__delattr__</code>, <code>__dir__</code>.</p>\n<p>Implementace <em>context manageru</em> (pro <code>with</code>):\n<code>__enter__</code>, <code>__exit__</code>.</p>\n<p>Implementace deskriptoru (viz níže):\n<code>__get__</code>, <code>__set__</code>, <code>__delete__</code>.</p>\n<p>Implementace asynchronní funkcionality:\n<code>__await__</code>, <code>__aiter__</code>, <code>__anext__</code>, <code>__aenter__</code>, <code>__aexit__</code>.</p>\n<p>Předefinování hierarchie dědičnosti:\n<code>__instancecheck__</code>, <code>__subclasscheck__</code>.</p>\n<h2>Dekorátory</h2>\n<p>Další věc, na kterou se podíváme, jsou <em>dekorátory</em> – způsob, jak si\npřizpůsobovat funkce.</p>\n<p>Nejjednodušší použití dekorátorů je <em>registrace</em>:\nk funkci přidáme dekorátor a funkce se někam zaregistruje, uloží,\naby se dala zavolat později.\nTypický příklad je <code>@app.route</code> ve Flasku.</p>\n<p>My si pro příklad budeme chtít udělat dekorátor pro kalkulačku,\n<code>@register_operator</code>, aby fungoval tento kód:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"n\">operators</span> <span class=\"o\">=</span> <span class=\"p\">{}</span>\n\n<span class=\"nd\">@register_operator</span>\n<span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n\n<span class=\"nd\">@register_operator</span>\n<span class=\"k\">def</span> <span class=\"nf\">mul</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">*</span> <span class=\"n\">b</span>\n\n<span class=\"n\">a</span> <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span><span class=\"nb\">input</span><span class=\"p\">(</span><span class=\"s1\">'First number: '</span><span class=\"p\">))</span>\n<span class=\"n\">operator_name</span> <span class=\"o\">=</span> <span class=\"nb\">input</span><span class=\"p\">(</span><span class=\"s1\">'Operation: '</span><span class=\"p\">)</span>\n<span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span><span class=\"nb\">input</span><span class=\"p\">(</span><span class=\"s1\">'Second number: '</span><span class=\"p\">))</span>\n\n<span class=\"n\">func</span> <span class=\"o\">=</span> <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"n\">operator_name</span><span class=\"p\">]</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">))</span>\n</pre></div><p>Bez použití dekorátorů by se to dalo napsat takto:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">register_operator</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">):</span>\n <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"n\">func</span><span class=\"o\">.</span><span class=\"vm\">__name__</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"n\">func</span>\n\n<span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n\n<span class=\"n\">register_operator</span><span class=\"p\">(</span><span class=\"n\">add</span><span class=\"p\">)</span>\n</pre></div><p>S použitím dekorátoru je funkce <code>register_operator</code> téměř stejná,\njen použijeme speciální syntaxi se zavináčem.</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">register_operator</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">):</span>\n <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"n\">func</span><span class=\"o\">.</span><span class=\"vm\">__name__</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"n\">func</span>\n <span class=\"k\">return</span> <span class=\"n\">func</span>\n\n<span class=\"nd\">@register_operator</span>\n<span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n</pre></div><p>Použití dekorátoru je jen zkrácený zápis pro volání dekorátoru jako\nfunkce – poslední tři řádky předchozího příkladu jsou ekvivalentní tomuto:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n\n<span class=\"n\">add</span> <span class=\"o\">=</span> <span class=\"n\">register_operator</span><span class=\"p\">(</span><span class=\"n\">add</span><span class=\"p\">)</span>\n</pre></div><p>Chování samotného <code>@</code> je tedy celkem triviální.\nMagie (složitost) spočívá v tom, že dekorátor je většinou funkce vyššího řádu:\nbere jinou funkci jako argument a taky jinou funkci vrací.\nV případě registrace vrací stejnou funkci jako dostala – ale to není povinné.</p>\n<p>Často se setkáme s dekorátory, které dekorovanou funkci nějak modifikují.\nNapříklad můžeme napsat dekorátor, který v naší kalkulačce převede vstup\nna reálná čísla.\nDělá to tak, že definuje <em>novou funkci</em>, která volá tu původní – ale před nebo\npo tomto volání může dělat i něco jiného.</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">to_floats</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">):</span>\n <span class=\"k\">def</span> <span class=\"nf\">outer_function</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"n\">a</span> <span class=\"o\">=</span> <span class=\"nb\">float</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">)</span>\n <span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"nb\">float</span><span class=\"p\">(</span><span class=\"n\">b</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"n\">func</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"n\">outer_function</span>\n\n<span class=\"nd\">@to_floats</span>\n<span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"sd\">"""Adds two numbers"""</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">add</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">,</span> <span class=\"s1\">'2'</span><span class=\"p\">))</span>\n</pre></div><p>Takto funguje většina dekorátorů, které mění chování dekorované funkce.\nNaráží s tím ale na jeden problém: nově nadefinovaná funkce má vlastní jméno\n(a dokumentační řetězec a podobné informace), což kazí iluzi, že jsme\npůvodní funkci jen trošku změnili:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">add</span><span class=\"p\">)</span>\n<span class=\"n\">help</span><span class=\"p\">(</span><span class=\"n\">add</span><span class=\"p\">)</span>\n</pre></div><p>Řešení je jednoduché – zkopírovat jméno, dokumentační řetězec atd. z jedné\nfunkce na druhou.\nNa to ve standardní knihovně existuje dekorátor jménem <code>functools.wraps</code>:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"kn\">import</span> <span class=\"nn\">functools</span>\n\n<span class=\"k\">def</span> <span class=\"nf\">to_floats</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">):</span>\n <span class=\"nd\">@functools.wraps</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">)</span>\n <span class=\"k\">def</span> <span class=\"nf\">outer_function</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"n\">a</span> <span class=\"o\">=</span> <span class=\"nb\">float</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">)</span>\n <span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"nb\">float</span><span class=\"p\">(</span><span class=\"n\">b</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"n\">func</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"n\">outer_function</span>\n</pre></div><p>S <code>wraps</code> bude <code>help(add)</code> fungovat správně – ukáže původní jméno\na dokumentační řetězec.</p>\n<p>Z volání <code>wraps(func)</code> je vidět, že jako dekorátor můžeme použít i volání\nfunkce, ne jen funkci samotnou.\nBudeme-li chtít napsat dekorátor, který tohle umí, potřebujeme napsat\nfunkci ještě vyššího řádu – totiž funkci, která po zavolání vrátí dekorátor:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"n\">operators</span> <span class=\"o\">=</span> <span class=\"p\">{}</span>\n\n<span class=\"k\">def</span> <span class=\"nf\">register_operator</span><span class=\"p\">(</span><span class=\"n\">name</span><span class=\"p\">):</span>\n <span class=\"k\">def</span> <span class=\"nf\">decorator</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">):</span>\n <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"n\">name</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"n\">func</span>\n <span class=\"k\">return</span> <span class=\"n\">func</span>\n <span class=\"k\">return</span> <span class=\"n\">decorator</span>\n\n<span class=\"nd\">@register_operator</span><span class=\"p\">(</span><span class=\"s1\">'+'</span><span class=\"p\">)</span>\n<span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n\n<span class=\"nd\">@register_operator</span><span class=\"p\">(</span><span class=\"s1\">'*'</span><span class=\"p\">)</span>\n<span class=\"k\">def</span> <span class=\"nf\">mul</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">*</span> <span class=\"n\">b</span>\n\n<span class=\"n\">a</span> <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span><span class=\"nb\">input</span><span class=\"p\">(</span><span class=\"s1\">'First number: '</span><span class=\"p\">))</span>\n<span class=\"n\">operator_name</span> <span class=\"o\">=</span> <span class=\"nb\">input</span><span class=\"p\">(</span><span class=\"s1\">'Operation: '</span><span class=\"p\">)</span>\n<span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span><span class=\"nb\">input</span><span class=\"p\">(</span><span class=\"s1\">'Second number: '</span><span class=\"p\">))</span>\n\n<span class=\"n\">func</span> <span class=\"o\">=</span> <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"n\">operator_name</span><span class=\"p\">]</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">))</span>\n</pre></div><p>Řádek <code>@register_operator('+')</code> dělá (jak už víme) to stejné, jako bychom hned\nza funkcí napsali <code>add = register_operator('+')(add)</code>.</p>\n<p>Budete-li chtít napsat dekorátor, který bere argumenty, a přitom ještě\n„mění“ dekorovanou funkci, dostanete se na tři funkce zanořené v sobě:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"kn\">import</span> <span class=\"nn\">functools</span>\n<span class=\"n\">operators</span> <span class=\"o\">=</span> <span class=\"p\">{}</span>\n\n<span class=\"k\">def</span> <span class=\"nf\">register_operator</span><span class=\"p\">(</span><span class=\"n\">name</span><span class=\"p\">):</span>\n <span class=\"k\">def</span> <span class=\"nf\">to_floats</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">):</span>\n\n <span class=\"nd\">@functools.wraps</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">)</span>\n <span class=\"k\">def</span> <span class=\"nf\">outer_function</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"n\">a</span> <span class=\"o\">=</span> <span class=\"nb\">float</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">)</span>\n <span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"nb\">float</span><span class=\"p\">(</span><span class=\"n\">b</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"n\">func</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">)</span>\n\n <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"n\">name</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"n\">outer_function</span>\n <span class=\"k\">return</span> <span class=\"n\">outer_function</span>\n\n <span class=\"k\">return</span> <span class=\"n\">to_floats</span>\n\n<span class=\"nd\">@register_operator</span><span class=\"p\">(</span><span class=\"s1\">'+'</span><span class=\"p\">)</span>\n<span class=\"k\">def</span> <span class=\"nf\">add</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">+</span> <span class=\"n\">b</span>\n\n<span class=\"n\">func</span> <span class=\"o\">=</span> <span class=\"n\">operators</span><span class=\"p\">[</span><span class=\"s1\">'+'</span><span class=\"p\">]</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">func</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">,</span> <span class=\"s1\">'2'</span><span class=\"p\">))</span>\n</pre></div><p>Dekorátorů se na jedné funkci dá použít víc:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"nd\">@register_operator</span><span class=\"p\">(</span><span class=\"s1\">'×'</span><span class=\"p\">)</span>\n<span class=\"nd\">@register_operator</span><span class=\"p\">(</span><span class=\"s1\">'*'</span><span class=\"p\">)</span>\n<span class=\"k\">def</span> <span class=\"nf\">mul</span><span class=\"p\">(</span><span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">a</span> <span class=\"o\">*</span> <span class=\"n\">b</span>\n</pre></div><p>Úplně stejně jako funkce se dají dekorovat i třídy.\nDekorátor dostane třídu jako první argument a třída se nahradí tím,\nco dekorátor vrátí.</p>\n<h2>Deskriptory</h2>\n<p>Jeden z nejmagičtějších operátorů v Pythonu je <code>.</code>, tečka.\nJe magický v obou významech – většina lidí ho používá, ačkoli nemá tušení, co přesně dělá, a dá se předefinovat tolika různými způsoby, že to vydá na <a href=\"https://www.youtube.com/watch?v=NiSqG6s8skA\">celou přednášku</a>.</p>\n<p>Pomocí tečky zapisujeme tři operace: čtení atributu (<code>print(foo.bar)</code>), zapisování (<code>foo.bar = 3</code>) a mazání (<code>del foo.bar</code>).\nTady se zaměříme hlavně na nejmagičtější z nich, čtení.</p>\n<p>Kdykoli atribut čteme pomocí tečky, hledá se několika místech:</p>\n<ul>\n<li>na samotné instanci objektu,</li>\n<li>pokud se tam nenajde, tak na třídě,</li>\n<li>pokud se nenajde ani tam, tak na rodičovských třídách (v případě vícenásobné dědičnosti podle <a href=\"https://www.python.org/download/releases/2.3/mro/\">MRO</a>),</li>\n<li>a pokud stále není k nalezení, vyhodí se <code>AttributeError</code>.</li>\n</ul>\n<p>To je trochu zjednodušený, ale užitečný model.</p>\n<p>Speciální metody, které se nevolají pomocí tečky, přeskakují první krok: metoda <code>__add__</code> tedy musí být definována na <em>třídě</em>, aby se zavolala pro <code>a + b</code>.</p>\n<blockquote><p><em>(Poznámka navíc pro ty, kdo čtou tento text podruhé: na metatřídě se atribut nehledá; např. existuje-li <code>type.mro</code>, najde se <code>str.mro</code>, ale už ne <code>"".mro</code>)</em></p>\n</blockquote>\n<p>Podívejme se teď na získávání atributu trošku podrobněji. Je to poměrně komplikovaný proces a existuje několik způsobů, jak ho přizpůsobit. Nejjednodušší je dvojice speciálních metod:</p>\n<ul>\n<li><code>__getattribute__</code>, která <em>kompletně předefinuje</em> funkci <code>.</code> pro čtení atributu, a</li>\n<li><code>__getattr__</code>, která se zavolá, až když se atribut nenajde normálním způsobem.</li>\n</ul>\n<p>První z nich nedoporučuji používat, protože je <em>příliš</em> obecná (pokusy se z ní dostat ke stavu objektu končívají nekonečnou rekurzí).\nPříklad druhé:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">Palette</span><span class=\"p\">:</span>\n <span class=\"n\">red</span> <span class=\"o\">=</span> <span class=\"mi\">255</span><span class=\"p\">,</span> <span class=\"mi\">0</span><span class=\"p\">,</span> <span class=\"mi\">0</span>\n <span class=\"n\">green</span> <span class=\"o\">=</span> <span class=\"mi\">0</span><span class=\"p\">,</span> <span class=\"mi\">255</span><span class=\"p\">,</span> <span class=\"mi\">0</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__getattr__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">attr_name</span><span class=\"p\">):</span>\n <span class=\"n\">prefix</span><span class=\"p\">,</span> <span class=\"n\">sep</span><span class=\"p\">,</span> <span class=\"n\">suffix</span> <span class=\"o\">=</span> <span class=\"n\">attr_name</span><span class=\"o\">.</span><span class=\"n\">partition</span><span class=\"p\">(</span><span class=\"s1\">'_'</span><span class=\"p\">)</span>\n <span class=\"k\">if</span> <span class=\"n\">prefix</span> <span class=\"o\">==</span> <span class=\"s1\">'dark'</span><span class=\"p\">:</span>\n <span class=\"n\">original_color</span> <span class=\"o\">=</span> <span class=\"nb\">getattr</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">suffix</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"nb\">tuple</span><span class=\"p\">(</span><span class=\"n\">c</span><span class=\"o\">//</span><span class=\"mi\">2</span> <span class=\"k\">for</span> <span class=\"n\">c</span> <span class=\"ow\">in</span> <span class=\"n\">original_color</span><span class=\"p\">)</span>\n <span class=\"k\">else</span><span class=\"p\">:</span>\n <span class=\"k\">raise</span> <span class=\"ne\">AttributeError</span><span class=\"p\">(</span><span class=\"n\">attr_name</span><span class=\"p\">)</span>\n\n<span class=\"n\">palette</span> <span class=\"o\">=</span> <span class=\"n\">Palette</span><span class=\"p\">()</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">palette</span><span class=\"o\">.</span><span class=\"n\">dark_red</span><span class=\"p\">)</span>\n</pre></div><p>(Předpokládám že znáte funkci <code>getattr</code>; kdyby ne: <code>getattr(foo, "bar")</code> dělá totéž co <code>foo.bar</code> – jen je jméno atributu předáno jako řetězec, takže může být např. v proměnné. Podobně existují <code>setattr(instance, attr_name, new_value)</code> a <code>delattr(setattr(instance, attr_name)</code>.)</p>\n<p>Metoda <code>__getattr__</code> je většinou tak trochu kanón na vrabce: ve většině případů nepotřebujeme nastavit chování <em>všech</em> neexistujících atributů, ale jenom jednoho nebo několika konkrétních.\nNapříklad máme třídu pro 2D bod s atributy <code>x</code> a <code>y</code> a potřebujeme i atribut pro dvojici <code>(x, y)</code>.\nToto se často dělá pomocí dekorátoru <code>property</code>:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">Point</span><span class=\"p\">:</span>\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"p\">,</span> <span class=\"n\">y</span><span class=\"p\">):</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">x</span> <span class=\"o\">=</span> <span class=\"n\">x</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">y</span> <span class=\"o\">=</span> <span class=\"n\">y</span>\n\n <span class=\"nd\">@property</span>\n <span class=\"k\">def</span> <span class=\"nf\">pos</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">x</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">y</span>\n\n<span class=\"n\">point</span> <span class=\"o\">=</span> <span class=\"n\">Point</span><span class=\"p\">(</span><span class=\"mi\">41</span><span class=\"p\">,</span> <span class=\"mi\">8</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">point</span><span class=\"o\">.</span><span class=\"n\">pos</span><span class=\"p\">)</span>\n</pre></div><p>Jak to ale funguje? Dekorátor <code>property</code> je třída, jakou můžete teoreticky napsat sami v Pythonu.\nJe to <em>deskriptor</em>, objekt, který v rámci nějaké třídy <em>popisuje</em> jak přistupovat k nějakému atributu.</p>\n<p>Nejlépe se deskriptory vysvětlí na příkladu:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"c1\"># (Omluvte prosím češtinu v kódu)</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">Descriptor2D</span><span class=\"p\">:</span>\n <span class=\"sd\">"""Popisuje atribut, který kombinuje dva jiné atributy do dvojice"""</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">name1</span><span class=\"p\">,</span> <span class=\"n\">name2</span><span class=\"p\">):</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name1</span> <span class=\"o\">=</span> <span class=\"n\">name1</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name2</span> <span class=\"o\">=</span> <span class=\"n\">name2</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__get__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">cls</span><span class=\"o\">=</span><span class=\"bp\">None</span><span class=\"p\">):</span>\n <span class=\"sd\">"""Volá se, když je třeba načíst atribut dané `instance` na dané třídě `cls`.</span>\n<span class=\"sd\"> """</span>\n\n <span class=\"k\">if</span> <span class=\"n\">instance</span> <span class=\"ow\">is</span> <span class=\"ow\">not</span> <span class=\"bp\">None</span><span class=\"p\">:</span>\n <span class=\"c1\"># Je-li instance nastavena, čteme atribut z ní.</span>\n <span class=\"k\">return</span> <span class=\"nb\">getattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name1</span><span class=\"p\">),</span> <span class=\"nb\">getattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name2</span><span class=\"p\">)</span>\n <span class=\"k\">else</span><span class=\"p\">:</span>\n <span class=\"c1\"># Je-li instance None, čteme atribut přímo ze třídy `cls`;</span>\n <span class=\"c1\"># v tomto případě slušné deskriptory většinou vrací deskriptor samotný.</span>\n <span class=\"k\">return</span> <span class=\"bp\">self</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">Rect</span><span class=\"p\">:</span>\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"p\">,</span> <span class=\"n\">y</span><span class=\"p\">,</span> <span class=\"n\">w</span><span class=\"p\">,</span> <span class=\"n\">h</span><span class=\"p\">):</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">x</span> <span class=\"o\">=</span> <span class=\"n\">x</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">y</span> <span class=\"o\">=</span> <span class=\"n\">y</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">w</span> <span class=\"o\">=</span> <span class=\"n\">w</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">h</span> <span class=\"o\">=</span> <span class=\"n\">h</span>\n\n <span class=\"n\">pos</span> <span class=\"o\">=</span> <span class=\"n\">Descriptor2D</span><span class=\"p\">(</span><span class=\"s1\">'x'</span><span class=\"p\">,</span> <span class=\"s1\">'y'</span><span class=\"p\">)</span>\n <span class=\"n\">size</span> <span class=\"o\">=</span> <span class=\"n\">Descriptor2D</span><span class=\"p\">(</span><span class=\"s1\">'w'</span><span class=\"p\">,</span> <span class=\"s1\">'h'</span><span class=\"p\">)</span>\n\n<span class=\"n\">rect</span> <span class=\"o\">=</span> <span class=\"n\">Rect</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">,</span> <span class=\"mi\">2</span><span class=\"p\">,</span> <span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"mi\">4</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">rect</span><span class=\"o\">.</span><span class=\"n\">pos</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">rect</span><span class=\"o\">.</span><span class=\"n\">size</span><span class=\"p\">)</span>\n\n<span class=\"c1\"># Čtení atributu přímo ze třídy:</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">Rect</span><span class=\"o\">.</span><span class=\"n\">pos</span><span class=\"p\">)</span>\n</pre></div><p>Deskriptory jsou tedy součást třídy – atributy s nějakým jménem. Popisují, jak se bude přistupovat k atributu daného jména.</p>\n<p>Existují dva druhy deskriptorů: <em>data descriptor</em> a <em>non-data descriptor</em>.\nLiší se v tom, jestli popisují jen, jak se daný atribut <em>čte</em>, nebo i jak se do něj <em>zapisuje</em>.\nVýše uvedený deskriptor je <em>non-data</em>: ovládá jen čtení. Zápis funguje jako u normálních atributů:\npřepíše aktuální hodnotu – a nová hodnota se pak použije místo volání deskriptoru:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"n\">rect</span><span class=\"o\">.</span><span class=\"n\">pos</span> <span class=\"o\">=</span> <span class=\"s1\">'haha'</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">rect</span><span class=\"o\">.</span><span class=\"n\">pos</span><span class=\"p\">)</span>\n</pre></div><p>Abychom tomu zabránili, můžeme na deskriptoru nadefinovat speciální metodu <code>__set__</code> (nebo <code>__delete__</code>), která popisuje,\njak se atribut nastavuje (resp. maže).\nTím vznikne <em>data descriptor</em>:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">Descriptor2D</span><span class=\"p\">:</span>\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">name1</span><span class=\"p\">,</span> <span class=\"n\">name2</span><span class=\"p\">):</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name1</span> <span class=\"o\">=</span> <span class=\"n\">name1</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name2</span> <span class=\"o\">=</span> <span class=\"n\">name2</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__get__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">cls</span><span class=\"o\">=</span><span class=\"bp\">None</span><span class=\"p\">):</span>\n <span class=\"k\">if</span> <span class=\"n\">instance</span> <span class=\"ow\">is</span> <span class=\"ow\">not</span> <span class=\"bp\">None</span><span class=\"p\">:</span>\n <span class=\"k\">return</span> <span class=\"nb\">getattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name1</span><span class=\"p\">),</span> <span class=\"nb\">getattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name2</span><span class=\"p\">)</span>\n <span class=\"k\">else</span><span class=\"p\">:</span>\n <span class=\"k\">return</span> <span class=\"bp\">self</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__set__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"n\">new_value</span><span class=\"p\">):</span>\n <span class=\"n\">a</span><span class=\"p\">,</span> <span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"n\">new_value</span>\n <span class=\"nb\">setattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name1</span><span class=\"p\">,</span> <span class=\"n\">a</span><span class=\"p\">)</span>\n <span class=\"nb\">setattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name2</span><span class=\"p\">,</span> <span class=\"n\">b</span><span class=\"p\">)</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__delete__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">instance</span><span class=\"p\">):</span>\n <span class=\"nb\">delattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name1</span><span class=\"p\">)</span>\n <span class=\"nb\">delattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">name2</span><span class=\"p\">)</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">Rect</span><span class=\"p\">:</span>\n <span class=\"c1\"># jako předtím</span>\n\n<span class=\"n\">rect</span> <span class=\"o\">=</span> <span class=\"n\">Rect</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">,</span> <span class=\"mi\">2</span><span class=\"p\">,</span> <span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"mi\">4</span><span class=\"p\">)</span>\n<span class=\"n\">rect</span><span class=\"o\">.</span><span class=\"n\">pos</span> <span class=\"o\">=</span> <span class=\"mi\">123</span><span class=\"p\">,</span> <span class=\"mi\">456</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">rect</span><span class=\"o\">.</span><span class=\"n\">pos</span><span class=\"p\">)</span>\n</pre></div><p>Už zmíněný vestavěný deskriptor <code>property</code> je <em>data descriptor</em>.\nPopisuje jak čtení, tak zápis atributu. Pokud mu nenastavíme funkci pro zápis, vyhodí ze své metody <code>__set__</code> výjimku <code>AttributeError</code> se zprávou, že do atributu se zapisovat nedá. (To je trochu magická odchylka od normálního chování Pythonu, kdy atributy zapisovat jdou.)</p>\n<p>Nejčastější příklad <em>non-data</em> deskriptoru je obyčejná funkce.\nKaždá funkce totiž funguje jako deskriptor: má speciální metodu <code>__get__</code>, která zajišťuje, že pokud je nastavena na třídě, daným atributem nedostaneme <em>funkci</em>, ale <em>metodu</em> (s „předvyplněným“ parametrem <code>self</code>).</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">foo</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"mi\">4</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">C</span><span class=\"p\">:</span>\n <span class=\"n\">foo</span> <span class=\"o\">=</span> <span class=\"n\">foo</span>\n\n<span class=\"n\">c</span> <span class=\"o\">=</span> <span class=\"n\">C</span><span class=\"p\">()</span>\n\n<span class=\"c1\"># Obyčejná funkce</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">C</span><span class=\"o\">.</span><span class=\"n\">foo</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">foo</span><span class=\"p\">)</span>\n\n<span class=\"c1\"># Metoda</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">C</span><span class=\"p\">()</span><span class=\"o\">.</span><span class=\"n\">foo</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">foo</span><span class=\"o\">.</span><span class=\"fm\">__get__</span><span class=\"p\">(</span><span class=\"n\">c</span><span class=\"p\">))</span>\n</pre></div><p>Protože je to <em>non-data</em> deskriptor, můžeme v jednotlivých instancích třídy\ndaný atribut přepsat něčím jiným, čímž metodu znepřístupníme.</p>\n<p>Jako zajímavost uvedu <em>non-data</em> deskriptor, který přepisuje svůj vlastní atribut.\nFunguje podobně jako <code>@property</code>, jen se výsledek vypočítá pouze jednou a uloží se jako normální atribut.\nPři dalším přístupu k atributu už se použije uložená hodnota.</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">reify</span><span class=\"p\">:</span>\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">func</span><span class=\"p\">):</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">func</span> <span class=\"o\">=</span> <span class=\"n\">func</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__get__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">cls</span><span class=\"o\">=</span><span class=\"bp\">None</span><span class=\"p\">):</span>\n <span class=\"k\">if</span> <span class=\"n\">instance</span> <span class=\"ow\">is</span> <span class=\"bp\">None</span><span class=\"p\">:</span>\n <span class=\"k\">return</span> <span class=\"bp\">self</span>\n <span class=\"n\">val</span> <span class=\"o\">=</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">func</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">)</span>\n <span class=\"nb\">setattr</span><span class=\"p\">(</span><span class=\"n\">instance</span><span class=\"p\">,</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">func</span><span class=\"o\">.</span><span class=\"vm\">__name__</span><span class=\"p\">,</span> <span class=\"n\">val</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"n\">val</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">Vector</span><span class=\"p\">:</span>\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"p\">,</span> <span class=\"n\">y</span><span class=\"p\">):</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">x</span> <span class=\"o\">=</span> <span class=\"n\">x</span>\n <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">y</span> <span class=\"o\">=</span> <span class=\"n\">y</span>\n\n <span class=\"nd\">@reify</span>\n <span class=\"k\">def</span> <span class=\"nf\">length</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n <span class=\"k\">print</span><span class=\"p\">(</span><span class=\"s1\">'Running expensive computation...'</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">x</span> <span class=\"o\">**</span> <span class=\"mi\">2</span> <span class=\"o\">+</span> <span class=\"bp\">self</span><span class=\"o\">.</span><span class=\"n\">y</span> <span class=\"o\">**</span> <span class=\"mi\">2</span><span class=\"p\">)</span> <span class=\"o\">**</span> <span class=\"mf\">0.5</span>\n\n<span class=\"n\">vect</span> <span class=\"o\">=</span> <span class=\"n\">Vector</span><span class=\"p\">(</span><span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"mi\">4</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">vect</span><span class=\"o\">.</span><span class=\"n\">length</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">vect</span><span class=\"o\">.</span><span class=\"n\">length</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">vect</span><span class=\"o\">.</span><span class=\"n\">length</span><span class=\"p\">)</span>\n</pre></div><p>Kompletní implementace je např. ve frameworku Pyramid jako <a href=\"http://docs.pylonsproject.org/projects/pyramid/en/latest/_modules/pyramid/decorator.html\">pyramid.decorator.reify</a>.</p>\n<h2>Konstruktor</h2>\n<p>Třídy v Pythonu můžou mít <em>konstruktor</em> – funkci, která se zavolá, aby\nvytvořila objekt daného typu.\nToto není známá metoda <code>__init__</code> – ta objekt nevytváří, ta dostane už\npředpřipravený <code>self</code>, který jen naplní atributy.\nOpravdový konstruktor se jmenuje <code>__new__</code> a chová se jako <code>classmethod</code>:\nmísto <code>self</code> bere třídu, jejíž instanci má vytvořit.</p>\n<p>Opravdový konstruktor se „hodí“ pro vytváření <em>singletonů</em>, tříd, které mají jen\njednu instanci:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">Singleton</span><span class=\"p\">:</span>\n <span class=\"k\">def</span> <span class=\"fm\">__new__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">):</span>\n <span class=\"k\">try</span><span class=\"p\">:</span>\n <span class=\"k\">return</span> <span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">_instance</span>\n <span class=\"k\">except</span> <span class=\"ne\">AttributeError</span><span class=\"p\">:</span>\n <span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">_instance</span> <span class=\"o\">=</span> <span class=\"nb\">super</span><span class=\"p\">()</span><span class=\"o\">.</span><span class=\"fm\">__new__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">_instance</span>\n\n<span class=\"k\">assert</span> <span class=\"n\">Singleton</span><span class=\"p\">()</span> <span class=\"ow\">is</span> <span class=\"n\">Singleton</span><span class=\"p\">()</span>\n</pre></div><p>Podobný trik lze použít pro třídu podobnou <code>bool</code>, která má pouze dvě instance:\n<code>bool(1) is bool(2)</code>.</p>\n<p>Metoda <code>__new__</code> se hodí, když chceme dědit z neměnitelné (<em>immutable</em>)\ntřídy jako <code>tuple</code>.\nMetoda <code>__init__</code> sice dostane <code>self</code>, ale cokoli z nadtřídy už nemůže měnit.\nJe ale možné předefinovat <code>__new__</code>.</p>\n<p>Normálně bere <code>tuple</code> jediný argument, <code>tuple([1, 2])</code>.\nChceme-li brát dva, dá se to udělat takto:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">Point</span><span class=\"p\">(</span><span class=\"nb\">tuple</span><span class=\"p\">):</span>\n <span class=\"k\">def</span> <span class=\"fm\">__new__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"p\">,</span> <span class=\"n\">y</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"nb\">super</span><span class=\"p\">()</span><span class=\"o\">.</span><span class=\"fm\">__new__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">,</span> <span class=\"p\">(</span><span class=\"n\">x</span><span class=\"p\">,</span> <span class=\"n\">y</span><span class=\"p\">))</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">Point</span><span class=\"p\">(</span><span class=\"mi\">3</span><span class=\"p\">,</span> <span class=\"mi\">4</span><span class=\"p\">))</span>\n</pre></div><h2>Metatřídy</h2>\n<p>Poslední věc, na kterou se podíváme, jsou metatřídy.</p>\n<p>Začneme zlehka: pokud při definici třídy zadáme nějakou funkci jako pojmenovaný\nparametr <code>metaclass</code>, funkce se zavolá s informacemi potřebnými pro vytvoření\ntřídy.\nTy můžeme použít, nebo úplně ignorovat a vrátit něco jiného:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">fake_metaclass</span><span class=\"p\">(</span><span class=\"n\">name</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"mi\">42</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">NotAClass</span><span class=\"p\">(</span><span class=\"n\">metaclass</span><span class=\"o\">=</span><span class=\"n\">fake_metaclass</span><span class=\"p\">):</span>\n <span class=\"k\">pass</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">NotAClass</span><span class=\"p\">)</span>\n</pre></div><p>Argumenty, které „metatřída” dostane, jsou tři: jméno třídy, <em>n</em>-tice\nnadtříd a jmenný prostor – slovník s proměnnými, které vznikly vykonáním\ntěla příkazu <code>class</code>.\n(Ve jmenném prostoru jsou implicitně nastavené záznamy <code>__module__</code>\na <code>__qualname__</code>, které přidává samotný příkaz <code>class</code>.)</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">def</span> <span class=\"nf\">fake_metaclass</span><span class=\"p\">(</span><span class=\"n\">name</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">):</span>\n <span class=\"k\">print</span><span class=\"p\">(</span><span class=\"s1\">'name:'</span><span class=\"p\">,</span> <span class=\"n\">name</span><span class=\"p\">)</span>\n <span class=\"k\">print</span><span class=\"p\">(</span><span class=\"s1\">'bases:'</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">)</span>\n <span class=\"k\">print</span><span class=\"p\">(</span><span class=\"s1\">'namespace:'</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">)</span>\n <span class=\"k\">return</span> <span class=\"mi\">42</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">NotAClass</span><span class=\"p\">(</span><span class=\"nb\">int</span><span class=\"p\">,</span> <span class=\"n\">metaclass</span><span class=\"o\">=</span><span class=\"n\">fake_metaclass</span><span class=\"p\">):</span>\n <span class=\"n\">foo</span> <span class=\"o\">=</span> <span class=\"mi\">123</span>\n <span class=\"k\">def</span> <span class=\"nf\">inc</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"bp\">self</span> <span class=\"o\">+</span> <span class=\"mi\">1</span>\n</pre></div><p>Když <code>metaclass</code> nezadáme, použije se výchozí <em>metatřída</em>, tedy třída třídy.\nV Pythonu je to <code>type</code>.\nPokud ji zavoláme s vhodnými argumenty, dostaneme normální třídu:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"n\">MyInt</span> <span class=\"o\">=</span> <span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"s1\">'MyInt'</span><span class=\"p\">,</span> <span class=\"p\">(</span><span class=\"nb\">int</span><span class=\"p\">,</span> <span class=\"p\">),</span> <span class=\"p\">{</span><span class=\"s1\">'foo'</span><span class=\"p\">:</span> <span class=\"mi\">123</span><span class=\"p\">,</span> <span class=\"s1\">'inc'</span><span class=\"p\">:</span> <span class=\"k\">lambda</span> <span class=\"bp\">self</span><span class=\"p\">:</span> <span class=\"bp\">self</span> <span class=\"o\">+</span> <span class=\"mi\">1</span><span class=\"p\">})</span>\n\n<span class=\"n\">three</span> <span class=\"o\">=</span> <span class=\"n\">MyInt</span><span class=\"p\">(</span><span class=\"mi\">3</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">three</span><span class=\"o\">.</span><span class=\"n\">inc</span><span class=\"p\">())</span>\n</pre></div><p>Kromě toho se <code>type</code> dá zavolat i s jedním argumentem; v tom případě vrátí\ntyp (třídu) daného argumentu.\n(Tohle chování – funkce, která dělá úplně různé věci v závislosti na počtu\nargumentů – v Pythonu často nevidíme.\nJe to nešťastná výjimka, která přežívá z historických důvodů.)</p>\n<p>Pojďme se podívat na třídy několika základních objektů:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"c1\"># Třída základních objektů</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">))</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"s2\">"abc"</span><span class=\"p\">))</span>\n\n<span class=\"c1\"># Třída třídy – metatřída.</span>\n<span class=\"c1\"># Třída většiny tříd v Pythonu je `type`</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"nb\">int</span><span class=\"p\">))</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">)))</span>\n\n<span class=\"c1\"># Třída třídy třídy</span>\n<span class=\"c1\"># Samotná `type` je jedna z té většiny tříd; její třída je `type`</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">))</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">(</span><span class=\"mi\">1</span><span class=\"p\">))))</span>\n</pre></div><p>Objekty třídy <code>type</code> (tedy třídy) se normálně tvoří příkazem <code>class</code>.\nExplicitně to můžeme napsat takto:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">NormalClass</span><span class=\"p\">(</span><span class=\"n\">metaclass</span><span class=\"o\">=</span><span class=\"nb\">type</span><span class=\"p\">):</span>\n <span class=\"n\">foo</span> <span class=\"o\">=</span> <span class=\"mi\">123</span>\n</pre></div><p>Když budeme chtít chování třídy změnit, budeme postupovat podobně jako\nu jiných objektů.\nKdybych chtěl celé číslo, přes které jde iterovat, podědím z <code>int</code>\na předefinuji <code>__iter__</code>.\nPokud chci třídu, přes kterou jde iterovat (tedy ne přes objekty dané\ntřídy – přes třídu samotnou!), podědím z <code>type</code> a předefinuji <code>__iter__</code>:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">IterableMeta</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">):</span>\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">,</span> <span class=\"n\">name</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">):</span>\n <span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">items</span> <span class=\"o\">=</span> <span class=\"nb\">sorted</span><span class=\"p\">(</span><span class=\"n\">n</span> <span class=\"k\">for</span> <span class=\"n\">n</span> <span class=\"ow\">in</span> <span class=\"n\">namespace</span>\n <span class=\"k\">if</span> <span class=\"ow\">not</span> <span class=\"n\">n</span><span class=\"o\">.</span><span class=\"n\">startswith</span><span class=\"p\">(</span><span class=\"s1\">'__'</span><span class=\"p\">))</span>\n <span class=\"nb\">super</span><span class=\"p\">()</span><span class=\"o\">.</span><span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"n\">name</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">)</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__iter__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"nb\">iter</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">items</span><span class=\"p\">)</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">SimpleEnum</span><span class=\"p\">(</span><span class=\"n\">metaclass</span><span class=\"o\">=</span><span class=\"n\">IterableMeta</span><span class=\"p\">):</span>\n <span class=\"n\">a</span> <span class=\"o\">=</span> <span class=\"mi\">1</span>\n <span class=\"n\">b</span> <span class=\"o\">=</span> <span class=\"mi\">2</span>\n <span class=\"n\">c</span> <span class=\"o\">=</span> <span class=\"mi\">3</span>\n <span class=\"n\">d</span> <span class=\"o\">=</span> <span class=\"mi\">4</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">SimpleEnum</span><span class=\"o\">.</span><span class=\"n\">a</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">list</span><span class=\"p\">(</span><span class=\"n\">SimpleEnum</span><span class=\"p\">))</span>\n</pre></div><p>(V metatřídě se většinou používá <code>cls</code> místo <code>self</code>, aby bylo jasné, že\ninstance, se kterou pracujeme, je třída – ale to je jen konvence.)</p>\n<p>Metatřídy se dědí.\nPokud v příkazu <code>class</code> nezadám explicitně <code>metaclass</code>, použije\nse metatřída nadtřídy:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"k\">class</span> <span class=\"nc\">AnotherEnum</span><span class=\"p\">(</span><span class=\"n\">SimpleEnum</span><span class=\"p\">):</span>\n <span class=\"n\">x</span> <span class=\"o\">=</span> <span class=\"mi\">10</span>\n <span class=\"n\">y</span> <span class=\"o\">=</span> <span class=\"mi\">20</span>\n <span class=\"n\">z</span> <span class=\"o\">=</span> <span class=\"mi\">30</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">AnotherEnum</span><span class=\"o\">.</span><span class=\"n\">a</span><span class=\"p\">)</span>\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">list</span><span class=\"p\">(</span><span class=\"n\">AnotherEnum</span><span class=\"p\">))</span>\n</pre></div><p>Tímto způsobem lze vnuknout třídám magické schopnosti bez toho, aby\nuživatel naší knihovny musel použít <code>metaclass</code> – stačí mu podědit z námi\npřipravené třídy.</p>\n<p>Další věc, kterou metatřídy umí, je připravit počáteční jmenný prostor.\nMetoda <code>__init__</code> (nebo <code>__new__</code>) v metatřídě normálně dostane slovník,\ncož nemusí být vždy to, co potřebuji.\nMůžu si chtít třeba „zapamatovat” pořadí, v jakém byly jednotlivé atributy\nvytvořeny – a slovník toto pořadí neuchovává.</p>\n<p>Na to existuje speciální metoda <code>__prepare__</code>, která se, když na metatřídě\nexistuje, zavolá pro vytvoření jmenného prostoru:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"kn\">from</span> <span class=\"nn\">collections</span> <span class=\"kn\">import</span> <span class=\"n\">OrderedDict</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">OrderRememberingMeta</span><span class=\"p\">(</span><span class=\"nb\">type</span><span class=\"p\">):</span>\n <span class=\"k\">def</span> <span class=\"nf\">__prepare__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">,</span> <span class=\"n\">name</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"n\">OrderedDict</span><span class=\"p\">()</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">,</span> <span class=\"n\">name</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">):</span>\n <span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">items</span> <span class=\"o\">=</span> <span class=\"nb\">list</span><span class=\"p\">(</span><span class=\"n\">namespace</span><span class=\"p\">)</span>\n <span class=\"nb\">super</span><span class=\"p\">()</span><span class=\"o\">.</span><span class=\"fm\">__init__</span><span class=\"p\">(</span><span class=\"n\">name</span><span class=\"p\">,</span> <span class=\"n\">bases</span><span class=\"p\">,</span> <span class=\"n\">namespace</span><span class=\"p\">)</span>\n\n <span class=\"k\">def</span> <span class=\"fm\">__iter__</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"p\">):</span>\n <span class=\"k\">return</span> <span class=\"nb\">iter</span><span class=\"p\">(</span><span class=\"bp\">cls</span><span class=\"o\">.</span><span class=\"n\">items</span><span class=\"p\">)</span>\n\n<span class=\"k\">class</span> <span class=\"nc\">OrderedEnum</span><span class=\"p\">(</span><span class=\"n\">metaclass</span><span class=\"o\">=</span><span class=\"n\">OrderRememberingMeta</span><span class=\"p\">):</span>\n <span class=\"n\">first</span> <span class=\"o\">=</span> <span class=\"mi\">1</span>\n <span class=\"n\">second</span> <span class=\"o\">=</span> <span class=\"mi\">2</span>\n <span class=\"n\">third</span> <span class=\"o\">=</span> <span class=\"mi\">3</span>\n <span class=\"n\">fourth</span> <span class=\"o\">=</span> <span class=\"mi\">4</span>\n <span class=\"n\">fifth</span> <span class=\"o\">=</span> <span class=\"mi\">5</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"nb\">list</span><span class=\"p\">(</span><span class=\"n\">OrderedEnum</span><span class=\"p\">))</span>\n</pre></div><p>Toho se dá využít třeba v mapování objektů na databázi (např. v Django Models\nnebo SQLAlchemy), kdy chceme, aby pořadí sloupců tabulky odpovídalo\ntomu, jak jsou sloupce/atributy nadefinovány ve třídě.</p>\n<h2>A další</h2>\n<p>Další (bohužel?) oblíbený trik je vnuknutí magických schopností modulu.</p>\n<p>Naimportované moduly Python ukládá do slovníku <code>sys.modules</code>, aby při dalším\nimportu nemusel načítat znovu – <code>sys.modules</code> tedy slouží jako cache.\nA tuto cache můžeme změnit (tzv. <em>cache poisoning</em>) – přidat si do ní\nvlastní „modul“, který ovšem vůbec nemusí být modul, a tudíž může umět věci,\nkteré moduly normálně neumí:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"kn\">import</span> <span class=\"nn\">sys</span>\n\n<span class=\"n\">sys</span><span class=\"o\">.</span><span class=\"n\">modules</span><span class=\"p\">[</span><span class=\"s1\">'fake'</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"s1\">'a string'</span>\n\n<span class=\"o\">...</span>\n\n<span class=\"kn\">import</span> <span class=\"nn\">fake</span>\n\n<span class=\"k\">print</span><span class=\"p\">(</span><span class=\"n\">fake</span><span class=\"p\">[</span><span class=\"mi\">2</span><span class=\"p\">])</span>\n</pre></div><p>Když toto uděláme přímo z modulu, uživatel naší knihovny dostane podstrčený\nobjekt hned při prvním importu.\nK tomu se hodí proměnná <code>__name__</code>, jméno aktuálního modulu:</p>\n<div class=\"highlight\"><pre><span></span><span class=\"n\">sys</span><span class=\"o\">.</span><span class=\"n\">modules</span><span class=\"p\">[</span><span class=\"vm\">__name__</span><span class=\"p\">]</span> <span class=\"o\">=</span> <span class=\"n\">ReplacementModule</span><span class=\"p\">()</span>\n</pre></div><p>Jiný trik je registrace „built-in“ („superglobální”) proměnné:</p>\n<div class=\"highlight\"><pre><code>import builtins\nbuiltins.ANSWER = 42\n\n...\n\n# Třeba v jiném modulu\nprint(ANSWER)</code></pre></div><p>Tímto způsobem se dají i předefinovat vestavěné funkce, což může být někdy\nužitečné pro ladění. V produkčním kódu to ale, prosím, nedělejte.</p>\n<h2>Úkol</h2>\n<p>Úkol není!</p>\n<p>Budete-li chtít některé techniky z této lekce ve svém kódu (včetně semestrálky) použít, zamyslete se, jestli se problém nedá vyřešit jednodušeji, čitelněji, přehledněji, udržovatelněji.\nDobrý mág ví, kdy magii <em>nepoužít</em>.</p>\n\n\n "
}
}
}