Aiotieba

贴吧接口层

新增特性

- 当无法在指定位置找到配置文件时， `aiotieba` 将尝试创建配置文件样例

bug修复

- `Client` 现在可以正确地分发 `websocket` 的返回数据。发送 `websocket` 请求时，一个 `client.WebsocketResponse` 实例将被构造并被添加至等待队列。 `_ws_dispatch` 会将返回数据根据唯一的 `request_id` 填充到对应的 `WebsocketResponse` 中。最后用户通过异步函数 `WebsocketResponse.read` 提取数据
- 修复了 `CommitPersonalMsgReqIdl.proto` 中一个字段编号错误的bug

应用层

新增特性

- 新增了一些教学案例
- `vote_stat` 指令现在需要至少3个参数

bug修复

- 修复了 `refuse_appeals` 指令的一个bug，现在不再由 `Reviewer.refuse_unblock_appeals` 的返回值判断指令是否执行成功

贴吧接口层

新增特性

- `types.UserInfo` 新增字段 `is_bawu` `ip` 用于判断用户是否吧务以及获取ip归属地
- `api.Client` 新增接口 `unlike_forum` 用于取关贴吧
- 优化 `Client` 的 `close` 流程
- 注释与命名细节的优化

已知bug

- `websocket` 的 `receive` 和 `reconnect` 流程仍存在bug

贴吧接口层

新增特性

- `tiebaBrowser` 更名 `aiotieba` ， `_api.Browser` 更名 `_api.Client`
- `_api.Client` 新增生成 `client_id` `cuid` `cuid_galaxy2` 的方法
- `_api.Sessions` 新增类属性 `latest_version` `main_version` `post_version` 用于集中管理版本号
- `_api.Client` 新增接口 `get_self_fan_list` `remove_fan` `get_self_follow_list` `follow` `unfollow` 用于操作粉丝列表和关注列表

贴吧接口层

新增特性

- 对 [`Python`](https://www.python.org/downloads/) 版本的最低要求降至 [`Python3.8`](https://www.python.org/downloads/release/python-3810/)
- 配置文件格式由 `json` 更换为 [`yaml`](https://yaml.org/)
- 使用 `requirements.txt` 指明依赖库
- 新增 `_types.NewThread` 用于支持新版字段命名，`_types.Thread` 不再尝试适配新版字段
- 新增 `_types.ShareThread` 用于支持分享主题帖，`_types.Thread` 不再尝试适配分享帖相关的字段
- 新增 `_api.get_self_threads` `_api.get_self_posts` `_api._get_self_contents` `_types.UserPost` `_types.UserPosts` 用于获取用户发帖历史

变化特性

- `_types` 中的类继承结构大幅优化
- `_Containers` 不再转发 `Page.has_more` 以及 `Page.has_prev` 属性
- 所有需要给出目标贴吧的接口现在均支持使用 `fid` 和 `fname` 中的任一种参数，而不是之前的仅允许 `fid` 或仅允许 `fname`
- 不需要自定义赋值流程的原生数据类型字段现在统一不使用 `property` 包装，非原生数据类型字段依然优先懒加载

应用接口层

新增特性

- `Database.get_user_id_list` 现在允许通过参数 `upper_permission` 设定获取用户列表的 `permission` 的上界

应用层

新增特性

- `get` `recom_status` 指令现在会尝试发送私信来反馈结果

贴吧接口层

新增特性

- 贴吧 `websocket` 封装完成，现在支持发送贴吧私信
- 新增 `UpdateClientInfoReqIdl.proto` `UpdateClientInfoResIdl.proto` `CommitPersonalMsgReqIdl.proto` `CommitPersonalMsgResIdl.proto` 用于支持 `websocket` 中的 `protobuf` 交互
- 新增库依赖 `pycrytodome` 用于支持 `websocket` 中的加密方法
- 新增 `Sessions._wrap_ws_bytes` 和 `Sessions._unwrap_ws_bytes` 用于对 `websocket` 信息做封装与解封装

变化特性

- `Browser.ip` 被移除
- `Browser.get_self_forum_list` 现在使用接口 `https://tieba.baidu.com/mg/o/getForumHome` 替换接口 `http://c.tieba.baidu.com/c/f/forum/like` ，每页可获取的关注贴吧数由50上升至200
- `Browser._app_sign` 被移动到 `Sessions._wrap_form` ， `Browser._get_tieba_multipart_writer` 被移动到 `Sessions._wrap_proto_bytes`
- 现在所有表单都以元组列表形式传参

bug修复

- 修复几处返回类型不明确的bug

贴吧接口层

新增特性

- 类方法 `Browser.refuse_appeals` 被拆分为 `Browser.get_unblock_appeal_list` 和 `Browser.handle_unblock_appeal` ，原实现被移动至 `Reviewer.refuse_unblock_appeals`
- 新增 `Browser.get_forum_detail` 用于从 `fid` 反查贴吧详细信息
- 新增 `Reviewer.get_tieba_name` 用于从 `fid` 反查贴吧名
- `_types.FragImage` 新增属性 `show_width` `show_width` 用于表示图像显示的宽和高

变化特性

- `Browser.get_self_forums` 现在可以控制页码翻页，直接返回列表而不是异步迭代，同时更名为 `Browser.get_self_forum_list`
- `Browser.get_forums` 现在直接返回列表而不是异步迭代，同时更名为 `Browser.get_forum_list`
- `Database.get_user_id_list` 的参数顺序调整， `permission` 现在是第一个参数

bug修复

- `Browser.get_homepage` 现在能正确获取主题帖的 `fid` 和 `tid`

应用层

新增特性

- 现在所有修改用户权限级别的指令都会将原有的 `note` 打印到日志