如何使用attrs定义数组的对象？

attrs 是 Python 中的一个库，用于简化类属性的定义和管理。它特别适用于定义具有默认值和验证规则的属性。下面是如何使用 attrs 定义一个包含数组对象属性的示例：

基础概念

attrs 是一个第三方库，提供了声明式的方式来定义类的属性。通过使用装饰器和类装饰器，可以轻松地为类添加属性，并指定这些属性的默认值、类型检查和其他行为。

类型与应用场景

attrs 可以用于定义各种类型的属性，包括基本类型、复杂类型（如列表、字典）以及自定义对象。它广泛应用于需要定义具有默认值和验证规则的类属性的场景，例如配置类、数据模型类等。

示例代码

下面是一个使用 attrs 定义包含数组对象属性的示例：

import attr

@attr.s(auto_attribs=True)
class MyClass:
    name: str
    scores: list[int] = attr.Factory(list)

# 创建实例
obj = MyClass(name="Alice", scores=[95, 88, 92])

# 访问属性
print(obj.name)    # 输出: Alice
print(obj.scores)  # 输出: [95, 88, 92]

# 修改属性
obj.scores.append(99)
print(obj.scores)  # 输出: [95, 88, 92, 99]

解释

导入库：首先导入 attrs 库。
定义类：使用 @attr.s(auto_attribs=True) 装饰器来自动将类中的变量转换为属性。
属性定义：
- name 是一个字符串类型的属性。
- scores 是一个整数列表类型的属性，默认值为空列表（通过 attr.Factory(list) 指定）。

创建实例：通过传递参数创建 MyClass 的实例。
访问和修改属性：可以直接访问和修改实例的属性。

遇到的问题及解决方法

问题：如何为数组对象添加验证规则？

解决方法：可以使用 validator 装饰器为属性添加自定义验证逻辑。

import attr

def validate_scores(instance, attribute, value):
    if any(score < 0 or score > 100 for score in value):
        raise ValueError("Scores must be between 0 and 100.")

@attr.s(auto_attribs=True)
class MyClass:
    name: str
    scores: list[int] = attr.Factory(list, validator=validate_scores)

# 创建实例
obj = MyClass(name="Alice", scores=[95, 88, 92])

# 尝试添加无效分数
try:
    obj.scores.append(101)
except ValueError as e:
    print(e)  # 输出: Scores must be between 0 and 100.

在这个示例中，validate_scores 函数用于验证 scores 列表中的每个元素是否在 0 到 100 之间。如果发现无效值，将抛出 ValueError 异常。

通过这种方式，可以灵活地为数组对象属性添加各种验证规则，确保数据的完整性和有效性。