🔥 remove cqhttp api self_id arg

This commit is contained in:
yanyongyu 2021-05-25 16:59:26 +08:00
parent 918b375ece
commit 27fe6e4fcb

View File

@ -68,8 +68,7 @@ class Bot(BaseBot):
async def handle_message(self, message: dict): async def handle_message(self, message: dict):
... ...
async def call_api(self, api: str, *, self_id: Optional[str], async def call_api(self, api: str, *, **data) -> Any:
**data) -> Any:
... ...
async def send(self, event: Event, message: Union[str, Message, async def send(self, event: Event, message: Union[str, Message,
@ -77,12 +76,13 @@ class Bot(BaseBot):
**kwargs) -> Any: **kwargs) -> Any:
... ...
async def send_private_msg(self, async def send_private_msg(
self,
*, *,
user_id: int, user_id: int,
message: Union[str, Message], message: Union[str, Message],
auto_escape: bool = ..., auto_escape: bool = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -93,16 +93,17 @@ class Bot(BaseBot):
* ``user_id``: 对方 QQ * ``user_id``: 对方 QQ
* ``message``: 要发送的内容 * ``message``: 要发送的内容
* ``auto_escape``: 消息内容是否作为纯文本发送即不解析 CQ 只在 ``message`` 字段是字符串时有效 * ``auto_escape``: 消息内容是否作为纯文本发送即不解析 CQ 只在 ``message`` 字段是字符串时有效
* ``self_id``: 机器人 QQ
""" """
... ...
async def send_group_msg(self, async def send_group_msg(
self,
*, *,
group_id: int, group_id: int,
message: Union[str, Message], message: Union[str, Message],
auto_escape: bool = ..., auto_escape: bool = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -113,18 +114,19 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``message``: 要发送的内容 * ``message``: 要发送的内容
* ``auto_escape``: 消息内容是否作为纯文本发送即不解析 CQ 只在 ``message`` 字段是字符串时有效 * ``auto_escape``: 消息内容是否作为纯文本发送即不解析 CQ 只在 ``message`` 字段是字符串时有效
* ``self_id``: 机器人 QQ
""" """
... ...
async def send_msg(self, async def send_msg(
self,
*, *,
message_type: Optional[str] = ..., message_type: Optional[str] = ...,
user_id: Optional[int] = ..., user_id: Optional[int] = ...,
group_id: Optional[int] = ..., group_id: Optional[int] = ...,
message: Union[str, Message], message: Union[str, Message],
auto_escape: bool = ..., auto_escape: bool = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -137,14 +139,15 @@ class Bot(BaseBot):
* ``group_id``: 群号消息类型为 ``group`` 时需要 * ``group_id``: 群号消息类型为 ``group`` 时需要
* ``message``: 要发送的内容 * ``message``: 要发送的内容
* ``auto_escape``: 消息内容是否作为纯文本发送即不解析 CQ 只在 ``message`` 字段是字符串时有效 * ``auto_escape``: 消息内容是否作为纯文本发送即不解析 CQ 只在 ``message`` 字段是字符串时有效
* ``self_id``: 机器人 QQ
""" """
... ...
async def delete_msg(self, async def delete_msg(
self,
*, *,
message_id: int, message_id: int,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -153,14 +156,15 @@ class Bot(BaseBot):
:参数: :参数:
* ``message_id``: 消息 ID * ``message_id``: 消息 ID
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_msg(self, async def get_msg(
self,
*, *,
message_id: int, message_id: int,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -169,14 +173,15 @@ class Bot(BaseBot):
:参数: :参数:
* ``message_id``: 消息 ID * ``message_id``: 消息 ID
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_forward_msg(self, async def get_forward_msg(
self,
*, *,
id: int, id: int,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -185,15 +190,16 @@ class Bot(BaseBot):
:参数: :参数:
* ``id``: 合并转发 ID * ``id``: 合并转发 ID
* ``self_id``: 机器人 QQ
""" """
... ...
async def send_like(self, async def send_like(
self,
*, *,
user_id: int, user_id: int,
times: int = ..., times: int = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -203,16 +209,17 @@ class Bot(BaseBot):
* ``user_id``: 对方 QQ * ``user_id``: 对方 QQ
* ``times``: 赞的次数每个好友每天最多 10 * ``times``: 赞的次数每个好友每天最多 10
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_kick(self, async def set_group_kick(
self,
*, *,
group_id: int, group_id: int,
user_id: int, user_id: int,
reject_add_request: bool = ..., reject_add_request: bool = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -223,16 +230,17 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``user_id``: 要踢的 QQ * ``user_id``: 要踢的 QQ
* ``reject_add_request``: 拒绝此人的加群请求 * ``reject_add_request``: 拒绝此人的加群请求
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_ban(self, async def set_group_ban(
self,
*, *,
group_id: int, group_id: int,
user_id: int, user_id: int,
duration: int = ..., duration: int = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -243,17 +251,18 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``user_id``: 要禁言的 QQ * ``user_id``: 要禁言的 QQ
* ``duration``: 禁言时长单位秒``0`` 表示取消禁言 * ``duration``: 禁言时长单位秒``0`` 表示取消禁言
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_anonymous_ban(self, async def set_group_anonymous_ban(
self,
*, *,
group_id: int, group_id: int,
anonymous: Optional[Dict[str, Any]] = ..., anonymous: Optional[Dict[str, Any]] = ...,
anonymous_flag: Optional[str] = ..., anonymous_flag: Optional[str] = ...,
duration: int = ..., duration: int = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -265,15 +274,16 @@ class Bot(BaseBot):
* ``anonymous``: 可选要禁言的匿名用户对象群消息上报的 ``anonymous`` 字段 * ``anonymous``: 可选要禁言的匿名用户对象群消息上报的 ``anonymous`` 字段
* ``anonymous_flag``: 可选要禁言的匿名用户的 flag需从群消息上报的数据中获得 * ``anonymous_flag``: 可选要禁言的匿名用户的 flag需从群消息上报的数据中获得
* ``duration``: 禁言时长单位秒无法取消匿名用户禁言 * ``duration``: 禁言时长单位秒无法取消匿名用户禁言
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_whole_ban(self, async def set_group_whole_ban(
self,
*, *,
group_id: int, group_id: int,
enable: bool = ..., enable: bool = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -283,16 +293,17 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``enable``: 是否禁言 * ``enable``: 是否禁言
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_admin(self, async def set_group_admin(
self,
*, *,
group_id: int, group_id: int,
user_id: int, user_id: int,
enable: bool = ..., enable: bool = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -303,15 +314,16 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``user_id``: 要设置管理员的 QQ * ``user_id``: 要设置管理员的 QQ
* ``enable``: ``True`` 为设置``False`` 为取消 * ``enable``: ``True`` 为设置``False`` 为取消
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_anonymous(self, async def set_group_anonymous(
self,
*, *,
group_id: int, group_id: int,
enable: bool = ..., enable: bool = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -321,16 +333,17 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``enable``: 是否允许匿名聊天 * ``enable``: 是否允许匿名聊天
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_card(self, async def set_group_card(
self,
*, *,
group_id: int, group_id: int,
user_id: int, user_id: int,
card: str = ..., card: str = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -341,15 +354,16 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``user_id``: 要设置的 QQ * ``user_id``: 要设置的 QQ
* ``card``: 群名片内容不填或空字符串表示删除群名片 * ``card``: 群名片内容不填或空字符串表示删除群名片
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_name(self, async def set_group_name(
self,
*, *,
group_id: int, group_id: int,
group_name: str, group_name: str,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -359,15 +373,16 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``group_name``: 新群名 * ``group_name``: 新群名
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_leave(self, async def set_group_leave(
self,
*, *,
group_id: int, group_id: int,
is_dismiss: bool = ..., is_dismiss: bool = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -377,17 +392,18 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``is_dismiss``: 是否解散如果登录号是群主则仅在此项为 True 时能够解散 * ``is_dismiss``: 是否解散如果登录号是群主则仅在此项为 True 时能够解散
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_special_title(self, async def set_group_special_title(
self,
*, *,
group_id: int, group_id: int,
user_id: int, user_id: int,
special_title: str = ..., special_title: str = ...,
duration: int = ..., duration: int = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -399,16 +415,17 @@ class Bot(BaseBot):
* ``user_id``: 要设置的 QQ * ``user_id``: 要设置的 QQ
* ``special_title``: 专属头衔不填或空字符串表示删除专属头衔 * ``special_title``: 专属头衔不填或空字符串表示删除专属头衔
* ``duration``: 专属头衔有效期单位秒-1 表示永久不过此项似乎没有效果可能是只有某些特殊的时间长度有效有待测试 * ``duration``: 专属头衔有效期单位秒-1 表示永久不过此项似乎没有效果可能是只有某些特殊的时间长度有效有待测试
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_friend_add_request(self, async def set_friend_add_request(
self,
*, *,
flag: str, flag: str,
approve: bool = ..., approve: bool = ...,
remark: str = ..., remark: str = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -419,17 +436,18 @@ class Bot(BaseBot):
* ``flag``: 加好友请求的 flag需从上报的数据中获得 * ``flag``: 加好友请求的 flag需从上报的数据中获得
* ``approve``: 是否同意请求 * ``approve``: 是否同意请求
* ``remark``: 添加后的好友备注仅在同意时有效 * ``remark``: 添加后的好友备注仅在同意时有效
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_group_add_request(self, async def set_group_add_request(
self,
*, *,
flag: str, flag: str,
sub_type: str, sub_type: str,
approve: bool = ..., approve: bool = ...,
reason: str = ..., reason: str = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -441,29 +459,25 @@ class Bot(BaseBot):
* ``sub_type``: ``add`` ``invite``请求类型需要和上报消息中的 ``sub_type`` 字段相符 * ``sub_type``: ``add`` ``invite``请求类型需要和上报消息中的 ``sub_type`` 字段相符
* ``approve``: 是否同意请求邀请 * ``approve``: 是否同意请求邀请
* ``reason``: 拒绝理由仅在拒绝时有效 * ``reason``: 拒绝理由仅在拒绝时有效
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_login_info(self, async def get_login_info(self) -> Dict[str, Any]:
*,
self_id: Optional[int] = ...) -> Dict[str, Any]:
""" """
:说明: :说明:
获取登录号信息 获取登录号信息
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_stranger_info(self, async def get_stranger_info(
self,
*, *,
user_id: int, user_id: int,
no_cache: bool = ..., no_cache: bool = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -473,30 +487,25 @@ class Bot(BaseBot):
* ``user_id``: QQ * ``user_id``: QQ
* ``no_cache``: 是否不使用缓存使用缓存可能更新不及时但响应更快 * ``no_cache``: 是否不使用缓存使用缓存可能更新不及时但响应更快
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_friend_list(self, async def get_friend_list(self) -> List[Dict[str, Any]]:
*,
self_id: Optional[int] = ...
) -> List[Dict[str, Any]]:
""" """
:说明: :说明:
获取好友列表 获取好友列表
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_group_info(self, async def get_group_info(
self,
*, *,
group_id: int, group_id: int,
no_cache: bool = ..., no_cache: bool = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -506,22 +515,16 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``no_cache``: 是否不使用缓存使用缓存可能更新不及时但响应更快 * ``no_cache``: 是否不使用缓存使用缓存可能更新不及时但响应更快
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_group_list(self, async def get_group_list(self) -> List[Dict[str, Any]]:
*,
self_id: Optional[int] = ...
) -> List[Dict[str, Any]]:
""" """
:说明: :说明:
获取群列表 获取群列表
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
@ -531,7 +534,7 @@ class Bot(BaseBot):
group_id: int, group_id: int,
user_id: int, user_id: int,
no_cache: bool = ..., no_cache: bool = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -542,7 +545,7 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``user_id``: QQ * ``user_id``: QQ
* ``no_cache``: 是否不使用缓存使用缓存可能更新不及时但响应更快 * ``no_cache``: 是否不使用缓存使用缓存可能更新不及时但响应更快
* ``self_id``: 机器人 QQ
""" """
... ...
@ -550,7 +553,7 @@ class Bot(BaseBot):
self, self,
*, *,
group_id: int, group_id: int,
self_id: Optional[int] = ...) -> List[Dict[str, Any]]: ) -> List[Dict[str, Any]]:
""" """
:说明: :说明:
@ -559,15 +562,15 @@ class Bot(BaseBot):
:参数: :参数:
* ``group_id``: 群号 * ``group_id``: 群号
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_group_honor_info(self, async def get_group_honor_info(
self,
*, *,
group_id: int, group_id: int,
type: str = ..., type: str = ...,
self_id: Optional[int] = ...
) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -578,14 +581,15 @@ class Bot(BaseBot):
* ``group_id``: 群号 * ``group_id``: 群号
* ``type``: 要获取的群荣誉类型可传入 ``talkative`` ``performer`` ``legend`` ``strong_newbie`` ``emotion`` 以分别获取单个类型的群荣誉数据或传入 ``all`` 获取所有数据 * ``type``: 要获取的群荣誉类型可传入 ``talkative`` ``performer`` ``legend`` ``strong_newbie`` ``emotion`` 以分别获取单个类型的群荣誉数据或传入 ``all`` 获取所有数据
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_cookies(self, async def get_cookies(
self,
*, *,
domain: str = ..., domain: str = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -594,28 +598,24 @@ class Bot(BaseBot):
:参数: :参数:
* ``domain``: 需要获取 cookies 的域名 * ``domain``: 需要获取 cookies 的域名
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_csrf_token(self, async def get_csrf_token(self) -> Dict[str, Any]:
*,
self_id: Optional[int] = ...) -> Dict[str, Any]:
""" """
:说明: :说明:
获取 CSRF Token 获取 CSRF Token
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_credentials(self, async def get_credentials(
self,
*, *,
domain: str = ..., domain: str = ...,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -624,15 +624,16 @@ class Bot(BaseBot):
:参数: :参数:
* ``domain``: 需要获取 cookies 的域名 * ``domain``: 需要获取 cookies 的域名
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_record(self, async def get_record(
self,
*, *,
file: str, file: str,
out_format: str, out_format: str,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -642,14 +643,15 @@ class Bot(BaseBot):
* ``file``: 收到的语音文件名CQ 码的 ``file`` 参数 ``0B38145AA44505000B38145AA4450500.silk`` * ``file``: 收到的语音文件名CQ 码的 ``file`` 参数 ``0B38145AA44505000B38145AA4450500.silk``
* ``out_format``: 要转换到的格式目前支持 ``mp3````amr````wma````m4a````spx````ogg````wav````flac`` * ``out_format``: 要转换到的格式目前支持 ``mp3````amr````wma````m4a````spx````ogg````wav````flac``
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_image(self, async def get_image(
self,
*, *,
file: str, file: str,
self_id: Optional[int] = ...) -> Dict[str, Any]: ) -> Dict[str, Any]:
""" """
:说明: :说明:
@ -658,70 +660,51 @@ class Bot(BaseBot):
:参数: :参数:
* ``file``: 收到的图片文件名CQ 码的 ``file`` 参数 ``6B4DE3DFD1BD271E3297859D41C530F5.jpg`` * ``file``: 收到的图片文件名CQ 码的 ``file`` 参数 ``6B4DE3DFD1BD271E3297859D41C530F5.jpg``
* ``self_id``: 机器人 QQ
""" """
... ...
async def can_send_image(self, async def can_send_image(self) -> Dict[str, Any]:
*,
self_id: Optional[int] = ...) -> Dict[str, Any]:
""" """
:说明: :说明:
检查是否可以发送图片 检查是否可以发送图片
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def can_send_record(self, async def can_send_record(self) -> Dict[str, Any]:
*,
self_id: Optional[int] = ...) -> Dict[str, Any]:
""" """
:说明: :说明:
检查是否可以发送语音 检查是否可以发送语音
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_status(self, async def get_status(self) -> Dict[str, Any]:
*,
self_id: Optional[int] = ...) -> Dict[str, Any]:
""" """
:说明: :说明:
获取插件运行状态 获取插件运行状态
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def get_version_info(self, async def get_version_info(self) -> Dict[str, Any]:
*,
self_id: Optional[int] = ...) -> Dict[str, Any]:
""" """
:说明: :说明:
获取版本信息 获取版本信息
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...
async def set_restart(self, async def set_restart(
self,
*, *,
delay: int = ..., delay: int = ...,
self_id: Optional[int] = ...) -> None: ) -> None:
""" """
:说明: :说明:
@ -730,18 +713,15 @@ class Bot(BaseBot):
:参数: :参数:
* ``delay``: 要延迟的毫秒数如果默认情况下无法重启可以尝试设置延迟为 2000 左右 * ``delay``: 要延迟的毫秒数如果默认情况下无法重启可以尝试设置延迟为 2000 左右
* ``self_id``: 机器人 QQ
""" """
... ...
async def clean_cache(self, *, self_id: Optional[int] = ...) -> None: async def clean_cache(self) -> None:
""" """
:说明: :说明:
清理数据目录 清理数据目录
:参数:
* ``self_id``: 机器人 QQ
""" """
... ...