Python 3.x 如何获取Python类的列表';变量及其docstring文档

Python 3.x 如何获取Python类的列表';变量及其docstring文档,python-3.x,class,introspection,Python 3.x,Class,Introspection,如何从Python类或数据类中获取类成员变量及其docstring描述的列表 我有这个数据类 @dataclass class MyDataClass(BaseDataClass): """ :param var1: Description for var1 :param var2: Description for var2 """ var1: int var2: int 我希望能够获得

如何从Python类或数据类中获取类成员变量及其docstring描述的列表

我有这个数据类

@dataclass
class MyDataClass(BaseDataClass):
    """
    :param var1: Description for var1
    :param var2: Description for var2
    """
    var1: int
    var2: int
我希望能够获得这方面的信息:

{
  'var1': ('int', 'Description for var1'), 
  'var2': ('int', 'Description for var2')
}

为了获得类成员变量及其描述的列表,我使用classmethod创建了一个空dataclass

get_user_parameters_dict(cls)
它解析类docstring并返回包含成员名称、类型和描述的风管。 由于docstring不是自动生成的,因此需要遵循下面代码中的示例。主要部分的输出是

输出:

This does not work for a class without properties
This class is probably BaseDataClass. Is it? Actual name: BaseDataClass

var1: int - Description for var1
var2: int - Description for var2


from dataclasses import dataclass
from typing import Dict, Tuple
import re
代码:

@dataclass
class BaseDataClass:
    """
    Example of how to docstring var1 and var2, so reflection works here
    :param var1: Description for var1
    :param var2: Description for var2
    """

    # Example of declaring properties var1 and var2
    # var1: int
    # var2: int

    @classmethod
    def get_user_parameters_dict(cls) -> Dict[str, Tuple[str, str]]:
        properties_descriptions: Dict[str, str] = {}
        regex = r":param *(.*): *(.*)"
        from typing import Generator
        matches: Generator[re.Match, None, None] = re.finditer(regex, cls.__doc__, re.MULTILINE)
        for match in matches:
            prop_name: str = match.groups()[0]
            prop_description: str = match.groups()[1]
            properties_descriptions[prop_name] = prop_description

        dataclass_properties: Dict[str, Tuple[str, str]] = {}
        try:
            dataclass_annotations: Dict[str, object] = cls.__dict__['__annotations__']
            for prop_name, property_type in dataclass_annotations.items():
                dataclass_properties[prop_name] = (property_type.__name__, properties_descriptions[prop_name])

            return dataclass_properties
        except KeyError as ke:
            print('This does not work for a class without properties')



@dataclass
class MyDataClass(BaseDataClass):
    """
    :param var1: Description for var1
    :param var2: Description for var2
    """
    var1: int
    var2: int


if __name__ == '__main__':
    a = BaseDataClass
    try:
        for property_name, property_metadata in BaseDataClass.get_user_parameters_dict().items():
            print(f'{property_name}: {property_metadata[0]} - {property_metadata[1]}')
    except AttributeError as ae:
        print(f'This class is probably TestuserProperties. Is it? Actual name: {BaseDataClass.__name__}')

    print()

    for property_name, property_metadata in MyDataClass.get_user_parameters_dict().items():
        print(f'{property_name}: {property_metadata[0]} - {property_metadata[1]}')