Что делает classmethod в этом коде?

Question

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

Я не знаю что classmethod делает в этом примере кода. Может кто-нибудь объяснить, что он делает и как его использовать?

Answer 1

classmethod является дескриптором, заключающим в себе функцию, и вы можете вызвать полученный объект в классе или (эквивалентно) его экземпляре:

>>> 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'>,)

Как видите, определяете ли вы это напрямую или с помощью синтаксиса декоратора, и вызываете ли вы его в классе или экземпляре, classmethod всегда получает класс в качестве первого аргумента.

Одним из основных применений метода класса является определение "альтернативных конструкторов":

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

Теперь, если вы подкласс yметод класса продолжает работать, например:

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

Answer 2

Это позволяет вызывать метод класса вместо объекта:

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

MyClass._new_instance("blah")