2`,GddZGddZy)ceZdZdZdZddZy)NonDataPropertyaMuch like the property builtin, but only implements __get__, making it a non-data property, and can be subsequently reset. See http://users.rcn.com/python/download/Descriptor.htm for more information. >>> class X(object): ... @NonDataProperty ... def foo(self): ... return 3 >>> x = X() >>> x.foo 3 >>> x.foo = 4 >>> x.foo 4 '...' below should be 'jaraco.classes' but for pytest-dev/pytest#3396 >>> X.foo <....properties.NonDataProperty object at ...> cH|Jdt|sJd||_y)Nzfget cannot be nonezfget must be callable)callablefget)selfrs ;/usr/lib/python3/dist-packages/jaraco/classes/properties.py__init__zNonDataProperty.__init__s-6!66~666~ Nc,||S|j|SN)r)robjobjtypes r__get__zNonDataProperty.__get__s ;Kyy~r r )__name__ __module__ __qualname____doc__r rr rrrs, r rcReZdZdZGddeZd dZd dZdZdZ e d Z y) classpropertya Like @property but applies at the class level. >>> class X(metaclass=classproperty.Meta): ... val = None ... @classproperty ... def foo(cls): ... return cls.val ... @foo.setter ... def foo(cls, val): ... cls.val = val >>> X.foo >>> X.foo = 3 >>> X.foo 3 >>> x = X() >>> x.foo 3 >>> X.foo = 4 >>> x.foo 4 Setting the property on an instance affects the class. >>> x.foo = 5 >>> x.foo 5 >>> X.foo 5 >>> vars(x) {} >>> X().foo 5 Attempting to set an attribute where no setter was defined results in an AttributeError: >>> class GetOnly(metaclass=classproperty.Meta): ... @classproperty ... def foo(cls): ... return 'bar' >>> GetOnly.foo = 3 Traceback (most recent call last): ... AttributeError: can't set attribute It is also possible to wrap a classmethod or staticmethod in a classproperty. >>> class Static(metaclass=classproperty.Meta): ... @classproperty ... @classmethod ... def foo(cls): ... return 'foo' ... @classproperty ... @staticmethod ... def bar(): ... return 'bar' >>> Static.foo 'foo' >>> Static.bar 'bar' *Legacy* For compatibility, if the metaclass isn't specified, the legacy behavior will be invoked. >>> class X: ... val = None ... @classproperty ... def foo(cls): ... return cls.val ... @foo.setter ... def foo(cls, val): ... cls.val = val >>> X.foo >>> X.foo = 3 >>> X.foo 3 >>> x = X() >>> x.foo 3 >>> X.foo = 4 >>> x.foo 4 Note, because the metaclass was not specified, setting a value on an instance does not have the intended effect. >>> x.foo = 5 >>> x.foo 5 >>> X.foo # should be 5 4 >>> vars(x) # should be empty {'foo': 5} >>> X().foo # should be 5 4 ceZdZfdZxZS)classproperty.Metac|jj|d}t|tur|j ||St |||Sr )__dict__gettyper__set__super __setattr__)rkeyvaluer __class__s rrzclassproperty.Meta.__setattr__sH--##C.CCyM){{4//7&sE2 2r )rrrr __classcell__)r"s@rMetars  3 3r r$Ncl|j||_||_|xr|j|yyr ) _fix_functionrfsetsetter)rrr's rr zclassproperty.__init__s/&&t,   "T""r cD|jjd|Sr )rr)rinstanceowners rrzclassproperty.__get__s-tyy  u-//r c|js tdt|tjur t|}|jj d||S)Nzcan't set attribute)r'AttributeErrorrrr$r)rr+r!s rrzclassproperty.__set__sNyy !67 7 ;m00 0KE-tyy  u-e44r c2|j||_|Sr )r&r')rr's rr(zclassproperty.setters&&t,  r cHt|ttfs t|S|S)z= Ensure fn is a classmethod or staticmethod. ) isinstance classmethod staticmethod)clsfns rr&zclassproperty._fix_functions" "{L9:r? " r r ) rrrrrr$r rrr(r1r&rr rrr#s=dL3t3# 05r rN)rrrr rr5sDHHr