attrs

attrs 是一个Python库，它帮助开发者简化并加强类的创建。它允许你以声明式的方式定义类，自动为你处理属性的类型注解、默认值、初始化方法、比较方法、 repr 实现、属性验证等。这使得代码更加简洁、可读，并且减少了样板代码的编写。 以下是 attrs 的一些关键特点和用法：

关键特点

1. 声明式类定义：通过装饰器和类型注解，可以简洁地定义类的属性。

2. 自动生成方法：自动为类生成 __init__, __repr__, __eq__, __ne__, __lt__, __le__, __gt__, __ge__ 等方法。

3. 类型注解：支持类型注解，有助于静态类型检查和文档化。

4. 属性验证：可以在属性赋值时进行类型检查和自定义验证。

5. 转换器：可以将输入值转换为所需的类型或格式。

安装

可以通过pip安装attrs：

pip install attrs

基本用法

下面是一个简单的例子，展示了如何使用attrs来定义一个类：

import attr
@attr.s
class Person:
    name = attr.ib(default="John Doe")
    age = attr.ib(default=18, validator=attr.validators.instance_of(int))
    @age.validator
    def check_age(self, attribute, value):
        if value < 0:
            raise ValueError("Age must be positive")
# 创建一个Person实例
person = Person(name="Alice", age=30)
print(person)

在这个例子中，attr.s装饰器用于标记一个类为attrs类，attr.ib用于定义属性。default参数为属性提供了默认值，validator参数用于对属性值进行验证。

参数说明

• attr.ib：用于定义属性，可以接受多个参数，如default, validator, converter等。

• attr.validators：提供了一系列内置的验证器，如instance_of, optional, in_等。

• attr.s：装饰器，用于转换一个普通的类为attrs类。

高级用法

attrs还支持更高级的特性，如：

• 继承：可以创建继承自其他attrs类的子类。

• 转换器：可以将输入值转换为所需的类型或格式。

• 冻结：可以将类的实例冻结，使其属性不可变。

使用场景

• 数据类：当需要定义包含数据的类时，attrs非常有用。

• 配置类：用于定义配置项，可以自动生成文档字符串和比较方法。

• API模型：在构建Web API时，attrs可以用于定义请求和响应模型。 attrs库在Python社区中非常受欢迎，因为它提高了代码的可读性和维护性，同时减少了冗余代码的编写。它被许多其他流行的库和框架所使用，如SQLAlchemy和Tornado。