Aiotieba

贴吧接口层

变化特性

- 将 `client.Sessions` 的对应功能并入 `client.Client`
- 使用 `weakref` 优化 `client.WebsocketResponse` 的等待方法
- 大量细节优化

bug修复

- `types.ShareThread` 现在可以正确组装 `text` 属性

应用层

变化特性

- 现在指令 `img_set` `img_reset` 在 `index` 参数缺省时会默认将封锁级别应用到指令所在位置的父级的所有图片上，即允许批量设置

贴吧接口层

新增特性

- 新增属性 `is_ws_aviliable` 来判断 `websocket` 是否可用，避免长连接 `keep-alive` 超时的问题
- `Clinet` 新增函数 `get_user_threads` 来获取用户发表的处于公开状态的主题帖
- `types.FragLink` 新增属性 `url` 用于解析外链。原 `link` 属性更名为 `raw_url`
- `ThreadInfo.proto` 新增字段 `fname` ， `types._BasicContainer` 新增属性 `fname` 用于记录贴吧名

bug修复

- 由于长连接 `keep-alive` 超时的问题被解决，现在基于 `websocket` 的私信功能已经完全稳定
- 此前 `Client.get_image` 会在 `cv2.imdecode` 中 `libpng` 的 `CRC` 校验失败时返回 `None` ，现在该函数会始终返回 `numpy.ndarray` 实例
- `types.Reply` 现在会正确执行空构造

贴吧接口层

新增特性

- 当无法在指定位置找到配置文件时， `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` 指令现在会尝试发送私信来反馈结果