Advanced-Descriptors 3.0.3

分离法

可以使用标准的decorator语法设置此描述符。 使用参数创建实例：

defimeth(instance):returninstance.valuedefcmeth(owner):returnowner.valueclassTarget(object):value=1def__init__(self):self.value=2getval=advanced_descriptors.SeparateClassMethod(imeth,cmeth)

创建实例包装作为装饰符：

classTarget(object):value=1def__init__(self):self.value=2@advanced_descriptors.SeparateClassMethoddefgetval(self):returnself.value@getval.class_methoddefgetval(cls):returncls.value

只使用方法和只使用类方法的情况是无用的： 在相应的情况下，应使用“原样方法”和“类方法”。

高级属性

当除了普通的属性api之外，还需要类getter时，应该使用这个描述符。 如果还需要类范围的setter和deleter，则应在元类中使用标准属性。

用法示例：

1. 除了普通属性api之外：

classTarget(object):_value=777def__init__(self):self._value=42@advanced_descriptors.AdvancedPropertydefval(self):returnself._value@val.setterdefval(self,value):self._value=value@val.deleterdefval(self):self._value=0@val.cgetterdefval(cls):returncls._value

1. 例如，也可以使用类范围的getter：

classTarget(object):_value=1val=advanced_descriptors.AdvancedProperty()@val.cgetterdefval(cls):returncls._value

登录访问

属性的这种特殊情况在某些情况下非常有用，在这种情况下，许多属性应该以类似的方式记录，而不必编写大量代码。

basic api符合属性，但除此之外，还可以自定义日志记录器、日志级别和日志条件。

用法示例：

1. 简单的用法。 全部默认。 logger可从实例中重新使用，如果名称为logger或log则使用内部高级描述符。logu on\u accesslogger:

importloggingclassTarget(object):definit(self,val='ok')self.val=valself.logger=logging.get_logger(self.__class__.__name__)# Single for class, follow subclassingdef__repr__(self):return"{cls}(val={self.val})".format(cls=self.__class__.__name__,self=self)@advanced_descriptors.LogOnAccessdefok(self):returnself.val@ok.setterdefok(self,val):self.val=val@ok.deleterdefok(self):self.val=""

1. 与全局记录器一起用于类：

classTarget(object):definit(self,val='ok')self.val=valdef__repr__(self):return"{cls}(val={self.val})".format(cls=self.__class__.__name__,self=self)@advanced_descriptors.LogOnAccessdefok(self):returnself.val@ok.setterdefok(self,val):self.val=val@ok.deleterdefok(self):self.val=""ok.logger='test_logger'ok.log_level=logging.INFOok.exc_level=logging.ERRORok.log_object_repr=True# As by defaultok.log_success=True# As by defaultok.log_failure=True# As by defaultok.log_traceback=True# As by defaultok.override_name=None# As by default: use original name