💡 概述

本库包含 3 个工具，这里简要介绍它们的用途，详细用法请查看使用方法章节。

各个工具有着相同的使用逻辑：创建对象 -> 添加数据 -> 记录数据。

无论何时何地，只要往对象中添加数据即可，其余工作它会自动完成。并且都支持多线程。

由于逻辑简单，可灵活地应用于多种场景。

from DrissionRecord import Recorder

r = Recorder('data.csv')  # 创建对象
r.add_data('abc')  # 添加数据
r.record()  # 记录数据

✅️ `Recorder`

Recorder是功能最多的记录器，支持 csv、xlsx、json、jsonl、txt 五种格式文件。

基本工作就是批量接收数据，按顺序往文件里添加。可以接收单行数据，或二维数据一次写入多行。

对于 xlsx 和 csv 格式，还能绑定表头、指定坐标填写、设置样式、筛选读取指定数据。

💡 基本记录数据功能：

from DrissionRecord import Recorder

r = Recorder('data.csv')
r.add_data(((1, 2), (3, 4)))  # 用二维数据一次添加多行
r.add_data('abc')  # 添加单行数据
r.record()  # 记录数据

💡 向指定坐标数据：

from DrissionRecord import Recorder

r = Recorder('data.csv')
r.add_data('abc', coord='A3')  # 把数据填写到A3单元格
r.add_data((('a', 'b'), ('c', 'd')), coord=(3, 5))  # 把二维数据填写到以三行五列为左上角的矩形区域
r.record()  # 记录数据

💡 设置单元格格式：

from DrissionRecord import Recorder, CellStyle

c = CellStyle().set_bgColor('yellow')  # 创建单元格样式对象
r = Recorder('data.xlsx')
r.add_styles(c, 'A3')  # 对指定单元格设置样式
r.add_styles(c, 'A5:C3')  # 对指定范围单元格设置样式
r.add_styles(c, '4:5')  # 对指定行设置样式
r.record()

💡 读取并筛选指定数据：

from DrissionRecord import Recorder

r = Recorder('data.csv')
for row in r.rows(sign_col='性别', signs='男'):  # 筛选出文件中所有性别是男的数据
    print(row)

✅️ `ByteRecorder`

ByteRecorder用法最简单，它只接收二进制数据，每次add_data()只能传入一条数据，没有行的概念。

可指定每个数据写入文件中的位置，以支持多线程下载文件。

支持任意文件格式。

from DrissionRecord import ByteRecorder

b = ByteRecorder('data.file')
b.add_data(b'xxxxxxxxxxx')  # 向文件写入二进制数据
b.record()

✅️ `DBRecorder`

用于向 sqlite 写入数据，用法和Recorder一致，支持自动创建数据库、数据表、数据列。

支持 db 格式文件。

from DrissionRecord import DBRecorder

d = DBRecorder('data.db')
d.add_data({'name': '张三', 'age': 25}, table='user')  # 插入数据到user表
d.record()

✅️ Recorder​

✅️ ByteRecorder​

✅️ DBRecorder​

✅️ `Recorder`

✅️ `ByteRecorder`

✅️ `DBRecorder`