Question

我正在编写一个提供卷的存储自动化模块。我没有传递实际在存储控制器上创建卷所需的半打或更多参数，而是使用__slots__创建了一个参数类，该参数类传递给create方法，如下所示：

from mock import Mock
from six import with_metaclass

class VolumeParameterMeta(type):
    def __new__(mcs, name, bases, dct):
        # set __slots__ docstrings here?
        return super(VolumeParameterMeta, mcs).__new__(mcs, name, bases, dct)

class VolumeParameter(with_metaclass(VolumeParameterMeta, object)):
    __slots__ = ('name', 'size', 'junctionPath', 'svmName', 'securityStyle'
                 'spaceReserve')

    def __init__(self, name):
        self.name = name

class Volume(object):
    def __init__(self, driver, name):
        self.driver = driver
        self.name = name

    @classmethod
    def create(cls, driver, param):
        # do sanity check on param (volume not too large, etc)
        driver.provision(param)
        return cls(driver, param.name)

if __name__ == '__main__':
    param = VolumeParameter('volume1')
    param.svmName = 'vserver1'
    param.junctionPath = '/some/path'
    param.size = 2 ** 30
    param.spaceReserve = param.size * 0.1
    param.securityStyle = 'mixed'
    volume = Volume.create(driver=Mock(), param=param)

以上示例适用于一个小例外。如何将docstrings添加到参数类中的描述符并不明显。似乎就像使用元类一样，但是在实例化元类时没有定义描述符。

我敏锐地意识到有些人可能不同意我使用__slots__的副作用，但我喜欢它有助于消除拼写错误。尝试设置一个不存在且繁荣的参数，AttributeError被引发。所有没有任何样板代码。可以说更多Pythonic让它在创建卷时失败，但结果是使用默认值而不是拼写错误的参数。它实际上是一种无声的失败。

我意识到可以简单地扩展参数类docstring，但pydoc和其他文档构建脚本的结果是类的大型自由格式文档字符串，为空 docstrings。

当然必须有一种方法来为__slots__创建的描述符定义文档字符串？也许除了老虎机之外还有另外一种方式？可变的namedtuple或类似的？

Answer 1

不，没有选项可以将文档字符串添加到为__slots__中定义的名称生成的描述符对象中。在这方面，它们就像常规的非描述符属性。

在没有插槽的常规对象上，您最多可以添加注释并设置默认值：

class VolumeParameter(object):
     # the name of the volume (str)
     name = ''
     # volume size in bytes (int)
     size = 0
     # ...

即使您将所有这些属性声明为__slots__，

仍然适用。

您可以以property对象的形式“封装”另一个描述符中的每个插槽：

class VolumeParameterMeta(type):
    @staticmethod
    def _property_for_name(name, docstring):
        newname = '_' + name
        def getter(self):
            return getattr(self, newname)
        def setter(self, value):
            setattr(self, newname, value)
        def deleter(self):
            delattr(self, newname)
        return newname, property(getter, setter, deleter, docstring)

    def __new__(mcs, name, bases, dct):
        newslots = []
        clsslots = dct.pop('__slots__', ())
        slotdocs = dct.pop('__slot_docs__', {})
        if isinstance(clsslots, str):
            clsslots = clsslots.split()
        for name in clsslots:
            newname, prop = mcs._property_for_name(name, slotdocs.get(name))
            newslots.append(newname)
            dct[name] = prop
        if newslots:
            dct['__slots__'] = tuple(newslots)
        return super(VolumeParameterMeta, mcs).__new__(mcs, name, bases, dct)

class VolumeParameter(with_metaclass(VolumeParameterMeta, object)):
    __slots__ = ('name', 'size', 'junctionPath', 'svmName', 'securityStyle'
                 'spaceReserve')
    __slot_docs__ = {
        'name': 'the name of the volume (str)',
        # ...
    }

请注意，这几乎使该类中的描述符数量加倍：

>>> pprint(VolumeParameter.__dict__)
mappingproxy({'__doc__': None,
              '__module__': '__main__',
              '__slots__': ('_name',
                            '_size',
                            '_junctionPath',
                            '_svmName',
                            '_securityStylespaceReserve'),
              '_junctionPath': <member '_junctionPath' of 'securityStylespaceReserve' objects>,
              '_name': <member '_name' of 'securityStylespaceReserve' objects>,
              '_securityStylespaceReserve': <member '_securityStylespaceReserve' of 'securityStylespaceReserve' objects>,
              '_size': <member '_size' of 'securityStylespaceReserve' objects>,
              '_svmName': <member '_svmName' of 'securityStylespaceReserve' objects>,
              'junctionPath': <property object at 0x105edbe08>,
              'name': <property object at 0x105edbd68>,
              'securityStylespaceReserve': <property object at 0x105edb098>,
              'size': <property object at 0x105edbdb8>,
              'svmName': <property object at 0x105edb048>})

但现在你的属性至少有文档字符串：

>>> VolumeParameter.name.__doc__
'the name of the volume (str)'

将docstring添加到slots描述符？

1 个答案:

将docstring添加到__slots__描述符？

1 个答案:

将docstring添加到slots描述符？