GitHub adapter for nonebot2
Project description
NoneBot-Adapter-GitHub
✨ GitHub 协议适配 ✨
安装
poetry add nonebot-adapter-github
# 或者
pip install nonebot-adapter-github
加载适配器
import nonebot
from nonebot.adapters.github import Adapter
nonebot.init()
driver = nonebot.get_driver()
driver.register_adapter(Adapter)
配置
配置 APP
GITHUB_APPS='
[
{
"app_id": "123456", # GitHub App ID 必填
"private_key": [
"-----BEGIN RSA PRIVATE KEY-----"
"...",
"-----END RSA PRIVATE KEY-----"
], # GitHub App 私钥必填
"client_id": "123456", # OAuth App Client ID 必填,GitHub App 可选
"client_secret": "xxxxxx", # OAuth App Client Secret 必填,GitHub App 可选
"webhook_secret": "xxxxxx" # 可选
}
]'
其他配置
GITHUB_BASE_URL=https://api.github.com
GITHUB_ACCEPR_FORMAT=full+json
GITHUB_PREVIEWS=["starfox"]
使用
WebHook
URL: /github/webhooks/<app_id>
(GitHub APP) / /github/webhooks/<client_id>
(OAuth APP)
事件格式:
class Event(BaseModel):
id: str # 事件 ID
name: str # 事件名称
payload: Dict[str, Any] # 事件内容
to_me: bool = False # 是否 @ 了机器人或机器人昵称
具体事件类型及内容请参考 GitHub Developer
调用 API
可以直接通过 bot 调用 API,但是请注意 只能使用异步接口,参数必须是 keyword args。具体使用方法参考 githubkit。
async with bot.as_installation(installation_id=1):
resp = await bot.rest.issues.async_get(owner="owner", repo="repo", issue_number=1)
issue = resp.parsed_data
resp = await bot.async_graphql(query=query)
async for issue in bot.github.paginate(bot.rest.issues.async_list_for_repo, owner="owner", repo="repo"):
print(issue)
也可以直接使用 githubkit
,但是将绕过 NoneBot 的 call api hook
。
github = bot.github
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
Built Distribution
Close
Hashes for nonebot_adapter_github-0.2.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 43d03a2a35f1b6286318edc5d6e42523067716caf1e8adae82e26e74d0c26542 |
|
MD5 | 3ecbdecded7a6120187a5c1256d62d01 |
|
BLAKE2b-256 | 0343da87663d7b2edef857e0ee988d4b6f3189fc1aa74928f2223eca6e56dc19 |
Close
Hashes for nonebot_adapter_github-0.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7314e4283021d287f22f258bf6573ba243b5df1b59c7193f63d47a36d1fc8acd |
|
MD5 | 82e3ee5bcff3a3e1b988d28b5fa3e6b4 |
|
BLAKE2b-256 | 6c4761af83b0d112fac24f4879d5c0c5331832729e67220c8a9fd65129375b8c |