Aiotieba

新增特性

- 允许自定义函数实现异常转发 [使用例子](https://github.com/Starry-OvO/aiotieba/issues/82#issuecomment-1398345702) 82

变化特性

- `Client.set_privacy` 功能拆分为 `set_thread_privacy` 和 `set_thread_public`

bug修复

- 修复了部分api未启用tls的bug

新增特性

- 新增 `Client.sign_growth` 支持用户成长等级签到
- 支持在 `Client` 级别设置http代理

变化特性

- 底层http库由 [`httpx`](https://github.com/encode/httpx) 变更回 [`aiohttp`](https://github.com/aio-libs/aiohttp)

bug修复

- 修复了 `Page_blacklist.total_page` 缺失的bug
- 修复了 `Forum_detail.fname` 缺失的bug

新增特性

- 新增对Python3.8的支持
- 使用 `typing.TYPE_CHECKING` 减少加载时间和运行时大小。得益于这一改进，现在 `opencv-contrib-python` 不再是必需依赖
- `Comment` `Comment_p` 新增 `floor` 属性用于表示所在楼层
- `Appeal` 现在会携带更丰富的信息，包括申诉者个人信息、封禁理由、申诉理由等

变化特性

- `reviewer` 和 `database` 被移除，相应的审查功能被迁移至 [`aiotieba-reviewer`](https://github.com/Starry-OvO/aiotieba-reviewer) 进行重构，大量特性被修改为模块级，以提供对函数式编程的更好支持
- 日志现在需要通过 `aiotieba.LOG().info(...)` 而不是 `aiotieba.LOG.info(...)` 的形式调用
- 由于protobuf的自动生成代码的限制，目前尚无法对mypy提供有效支持， `py.typed` 被移除
- 由于贴吧服务端对rps的限制， `Client.get_posts` 默认的 `comment_rn` 参数由30减少至4
- `Appeal.aid` 变更为 `Appeal.appeal_id`

bug修复

- `Comments._init_null` 现在会正确地将 `_objs` 置为空
- `Fan` `Follow` 中 `user_name` 和 `user_id` 位置颠倒的bug被修复
- 修复了 `Client.get_user_contents.UserInfo_u` 的 `portrait` 因为protobuf字段名填写错误导致的赋值异常
- 修复了 `Client.get_uinfo_getUserInfo_web` 中用户名可能为空并导致的赋值异常
- 修复了一些类型注解问题

贴吧接口层

新增特性

- 支持通过 `aiotieba.LOG.set_logger` 更换日志记录器，通过 `aiotieba.LOG.set_formatter` 更换日志格式 73
- `TiebaLogger` 现在可以默认构造名称，自定义日志保留天数、日志路径、记录级别

变化特性

- 不再自动生成配置文件模板

bug修复

- `Client.tieba_uid2user_info` 未使用版本号作为参数导致无法获取新版用户昵称的bug
- `Comment.__repr__` 现在会输出 `ppid`
- `Client._get_uinfo_getUserInfo` 中 `UserInfo_guinfo_web()._init_null()` 报错的bug
- `Client.get_threads` 中 `Contents_t()._init_null()` 报错的bug
- `UserInfo_c` 的 `is_bawu` 属性被遗漏的bug
- 适配因为长期未更换头像而不包含query_string的portrait值

应用接口层

新增特性

- `MySQLDB` 现在可以自动创建数据表

bug修复

- `Reviewer._exce_delete` 中因为 `user.level` 不存在而报错的bug
- `SQLiteDB` 中异常捕获的bug

贴吧接口层

新增特性

- 新增 `Client.get_blocks` 用于获取封禁用户列表。在大规模误删帖后，该接口有助于快速回滚操作
- `Client.get_homepage` 现在可以通过 `user.is_blocked` 得知用户是否被永久封禁屏蔽
- 使用 [`pysimdjson`](https://github.com/TkTech/pysimdjson) 增强 `json` 解析性能

变化特性

- 通过内部数据容器的大面积重构，现在用户访问那些服务端不提供的字段将直接触发 `AttributeError` 而不是得到一个缺省的默认值，这将有助于用户判断各个接口返回数据的覆盖范围
- 为了避免重复赋值和分支判断对性能的影响，以及允许原地清空数据的操作，大多数不用于外部接口参数的内部数据容器的 `__init__` 方法被悬空，并使用 `_init` 和 `_init_null` 两种初始化方法作为替代，这意味着用户在大多数情况下都不应手动初始化包含后两种初始化方法的内部数据容器
- `Client.get_recovers` 现在还会返回操作者名称以及被删除的内容
- 现在与 `PostInfoList.proto` 相关的数据结构 `ShareThread` (关联接口 `get_threads` `get_posts` ) 和 `Thread_home` (关联接口 `get_homepage`) 以及 `UserThread` (关联接口 `get_user_threads` `get_self_threads` `get_self_public_threads` ) 都会使用 `Media.proto` 而不是 `PbContent.proto` 获取图像信息，这意味着以上接口可以获取小图、大图、原图三种尺寸的图片链接，而不是先前的仅原图链接
- 由于官方变更， `Client.get_posts` 现在最多能为每条回复获取至多**50**条楼中楼 (变更前为10条)，且这些随附的楼中楼都提供了用户的 `level` 和 `glevel` 。因此 `get_posts` 参数 `comment_rn` 的默认值被调整为 `30` 以匹配 `get_comments` 接口允许的最大 `rn`
- 内部命名习惯变更， `typedef` 变更为 `classdef` ， `Fragments` 变更为 `Contents`
- 由于官方变更， `VoteOption` 不再包含 `image` 字段
- 由于不规范的 `json` 结构难以处理， `Client.get_recom_threads` 现已被移除
- 移除不必要的列表生成式. by kifuan

bug修复

- 67 68 描述的bug的产生原因是 `/pb/page` 接口新增了对 `_client_type` 参数的依赖，缺失该参数会导致获取的数据归属于默认的远古版本，表现出的具体特征有: 返回用户昵称为旧版， `user_list` 不包含数据，无法识别音频内容等。因此在添加上 `_client_type` 参数后， `2.10.1` 的以下变化可以被安全地回滚: `FragImage.big_src` 被重新添加， `FragLink.is_external` 恢复由 `/mo/q/checkurl` 前缀判断， `Posts` 和 `Threads` 的解析流程仅保留【同时使用 `user_list` + `author_id` 字段】而弃用【直接使用 `author` 字段】
- 通过添加 `_client_type` 参数， `get_posts` 接口现在可以获取小图、大图、原图三种尺寸的图片链接，而不是远古版本的仅原图链接
- 由于官方变更，如果在调用 `Client.get_posts` 时设置了 `with_comments=True` 参数，那么当前账号的 `BDUSS` 也需要作为参数发送，否则服务端不会返回楼中楼列表

应用接口层

变化特性

- 由于现在 `Client.get_posts` 能获取更多的楼中楼，默认的 `Reviewer.loop_get_comments` `Reviewer.multi_get_comments` 得到了可预见的性能改进，因为 `Client.get_comments` 的触发次数被大大降低

贴吧接口层

变化特性

- 由于贴吧服务端发生变更， `FragImage.big_src` 被移除
- 由于贴吧服务端发生变更， `FragLink.is_external` 的判定方式由是否包含 `/mo/q/checkurl` 前缀变更为是否以 `tieba.baidu.com` 作为host

bug修复

- 修复了 `Client.get_posts` 因贴吧服务端发生变更而无法解析用户信息的问题。现在 `typedef.Posts` 和 `typedef.Threads` 的解析流程会同时兼顾两种模式，即【新模式：直接使用 `author` 字段】以及【旧模式：同时使用 `user_list` + `author_id` 字段】. 67 68