A general help lister for nonebot2 plugins
Project description
开发者接入此插件列表方法
包级别接入
使用python包形态的插件(已发布/自行开发皆可),并在插件包的__init__.py文件内增加如下代码:
# 若此文本不存在,将显示包的__doc__
__usage__ = '您想在使用命令/help <your plugin package name>时提供的帮助文本'
# 您的插件版本号,将在/help list中显示
__help__version__ = '0.1.6'
# 此名称有助于美化您的插件在/help list中的显示
# 但使用/help xxx查询插件用途时仍必须使用包名
__help__plugin_name__ = "您的插件名称(有别于nonebot-plugin-xxx的包名)"
Matcher级别接入
Matcher级别帮助请为Matcher添加如下代码:
default_start = list(nonebot.get_driver().config.command_start)[0]
helper = on_command("help", priority=1, aliases={"帮助"})
helper.__help_name__ = '您的命令触发指令名'
helper.__help_info__ = f'您为此命令提供的帮助文本'
helper.__doc__ = f'您为此命令提供的帮助文本, 当您不希望使用__help_info__提供时,可以使用__doc__提供'
请注意:当您未提供__help_name__
或__help_info__
与__doc__
中的一个时,此Matcher不会列入Matcher级别帮助!
实际使用
此部分介绍以使用'/'作为command_start为例。
获取本插件帮助
指令: /help
返回示例:
@<user_who_send_command> 欢迎使用Nonebot 2 Help Plugin
支持使用的前缀:/
/help # 获取本插件帮助
/help list # 展示已加载插件列表
/help <plugin_name> # 调取目标插件帮助信息
查看已加载插件列表
指令:/help list
返回示例:
@<user_who_send_command> 已加载插件:
nonebot.plugins.echo
nonebot_guild_patch
nonebot_plugin_cloverdata | 四叶草魔物娘属性计算插件 0.1.0
nonebot_plugin_help | XZhouQD's Help Menu 0.1.5
查看已加载某一插件用途
指令:/help <plugin_package_name> 示例:
/help nonebot_plugin_help
@<user_who_send_command> 欢迎使用Nonebot 2 Help Plugin
本插件提供公共帮助菜单能力
此Bot配置的命令前缀:/
序号. 命令名: 命令用途
1. help: /help # 获取本插件帮助
/help list # 展示已加载插件列表
/help <plugin_name> # 调取目标插件帮助信息
若插件未提供__usage__,则会显示__doc__,示例:
/help nonebot_plugin_help
@<user_who_send_command>
Nonebot 2 Help Plugin
Author: XZhouQD
Since: 16 May 2021
序号. 命令名: 命令用途
1. help: /help # 获取本插件帮助
/help list # 展示已加载插件列表
/help <plugin_name> # 调取目标插件帮助信息
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nonebot-plugin-help-0.2.1.tar.gz
(16.8 kB
view hashes)
Built Distribution
Close
Hashes for nonebot-plugin-help-0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d9ddcd26e72458a19d5294cf4f22129cf0dd40fce64fbd9e91746deda5c2f0f5 |
|
MD5 | 1e9fbbd70d2c8169c2e25cbb04fe101b |
|
BLAKE2b-256 | c6ad8a131a5a6176832be7eea9f4b916ca5feec913d7415edca4e99457059860 |
Close
Hashes for nonebot_plugin_help-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2a669e1147c423a890ef4dc990c5296844d5be6cba0454e6699ba1097411d7f1 |
|
MD5 | 8a974b2ac3eab42669649f1060798013 |
|
BLAKE2b-256 | 396503ad97163bd7a56cc18f2d47b7cd5dec8340fb71aa9f97b2349f2087249c |