nonebot2/archive/2.0.0a16/advanced/publish-plugin.md
2021-10-03 11:00:17 +08:00

2.9 KiB
Raw Blame History

发布插件

前注

本章节仅包含插件发布流程指导,插件开发请查阅 创建插件 章节与 Plugin API 文档

插件发布流程

发布到 PyPI

您可以选择任意自己喜欢的方式将您的插件发布到 PyPI ,如使用 setuptoolspoetry 进行 PyPI 发布。

发布时,请您为自己的插件取一个清晰易懂的名字。通常而言,一款 NoneBot2 插件名称使用 nonebot-plugin- 作为前缀(如nonebot-plugin-foo),以 nonebotplugin 作为导入名的前缀(如nonebot_plugin_foo),这并非是强制规范, 而是为了防止与其他 PyPI 包产生冲突, 所以我们推荐您在没有特殊需求的情况下这样做。

发布后,请确保您的插件已能公开的从 PyPI 访问到,请检查您的插件在 PyPI 的地址:https://pypi.org/project/<您的Nonebot2插件项目名>

托管您的插件源代码

将插件源代码及相关构建文件(如pyproject.tomlsetup.py等与 PyPI 包构建相关的文件)托管在公开代码仓。

请确保您的代码仓地址能够被正确的访问,检查您的插件在代码仓的地址,如 https://github.com/<您的Github用户名>/<您的插件Github项目名>

申请发布到 Nonebot2 插件商店

完成在 PyPI 的插件发布流程与源代码托管流程后,请您前往 NoneBot2 商店 页面,切换到插件页签,点击 发布插件 按钮。

插件发布界面

如图所示,在弹出的插件信息提交表单内,填入您所要发布的相应插件信息。

插件信息填写

完成填写后,请点击 发布 按钮,这将自动在 NoneBot2 代码仓内创建发布您的插件的对应 Issue。

等待插件发布处理

您的插件发布 Issue 创建后,将会经过Nonebot2 Publish Bot的检查,以确保插件信息正确无误。

之后NoneBot2 的维护者们将会对插件进行进一步的检查,以确保用户能够正常安装并使用该插件。

完成这些步骤后,您的插件将会被合并到 NoneBot2 商店 ,而您也将成为 NoneBot2 贡献者 的一员。

完成

恭喜您,经过上述的发布流程,您的插件已经成功发布到 Nonebot2 商店了。

此时,您可以在 NoneBot2 商店 的插件页签查找到您的插件。同时,欢迎您成为 NoneBot2 贡献者

Congratulations!