are - que es @classmethod en python

¿Qué hace classmethod en este código?

Question

En django.utils.tree.py:

def _new_instance(cls, children=None, connector=None, negated=False):
obj = Node(children, connector, negated)
obj.__class__ = cls
return obj
_new_instance = classmethod(_new_instance)

No sé lo que hace classmethod en este ejemplo de código. ¿Alguien puede explicar lo que hace y cómo usarlo?

Answer 1

Hace posible llamar al método en la clase en lugar de un objeto:

class MyClass(object):
def _new_instance(cls, blah):
pass
_new_instance = classmethod(_new_instance)
MyClass._new_instance("blah")

Answer 2

classmethod es un descriptor, que envuelve una función, y puede llamar al objeto resultante en una clase o (equivalentemente) a una instancia de la misma:

>>> class x(object):
... def c1(*args): print ''c1'', args
... c1 = classmethod(c1)
... @classmethod
... def c2(*args): print ''c2'', args
...
>>> inst = x()
>>> x.c1()
c1 (<class ''__main__.x''>,)
>>> x.c2()
c2 (<class ''__main__.x''>,)
>>> inst.c1()
c1 (<class ''__main__.x''>,)
>>> inst.c2()
c2 (<class ''__main__.x''>,)

Como puede ver, ya sea que lo defina directamente o con la sintaxis del decorador, y si lo llama en la clase o la instancia, el classmethod la clase siempre recibe la clase como su primer argumento.

Uno de los principales usos de classmethod es definir "constructores alternativos":

>>> class y(object):
... def __init__(self, astring):
... self.s = astring
... @classmethod
... def fromlist(cls, alist):
... x = cls('''')
... x.s = '',''.join(str(s) for s in alist)
... return x
... def __repr__(self):
... return ''y(%r)'' % self.s
...
>>> y1 = y(''xx'')
>>> y1
y(''xx'')
>>> y2 = y.fromlist(range(3))
>>> y2
y(''0,1,2'')

Ahora bien, si subclases y , el método de clase sigue funcionando, por ejemplo:

>>> class k(y):
... def __repr__(self):
... return ''k(%r)'' % self.s.upper()
...
>>> k1 = k.fromlist([''za'',''bu''])
>>> k1
k(''ZA,BU'')