Satori Protocol SDK for python, specify common part
Project description
satori-python
基于 Satori 协议的 Python 开发工具包
协议介绍
协议端
目前提供了 satori
协议实现的有:
- Chronocat
- Koishi (搭配
@koishijs/plugin-server
)
使用该 SDK 的框架
安装
安装完整体:
pip install satori-python
只安装基础部分:
pip install satori-python-core
只安装客户端部分:
pip install satori-python-client
只安装服务端部分:
pip install satori-python-server
使用
客户端:
from satori import EventType, WebsocketsInfo
from satori.event import MessageEvent
from satori.client import Account, App
app = App(WebsocketsInfo(port=5140))
@app.register_on(EventType.MESSAGE_CREATED)
async def on_message(account: Account, event: MessageEvent):
if event.user.id == "xxxxxxxxxxx":
await account.send(event, "Hello, World!")
app.run()
服务端:
from satori import Api
from satori.server import Server
server = Server(port=5140)
@server.route(Api.MESSAGE_CREATE)
async def on_message_create(*args, **kwargs):
return [{"id": "1234", "content": "example"}]
server.run()
文档
请阅读 仓库文档
示例
- 客户端:client.py
- 服务端:server.py
- 服务端(使用适配器):server_with_adapter.py
- 客户端(webhook):client_webhook
- 服务端(webhook):server_webhook
- 适配器:adapter.py
架构
graph LR
subgraph Server
server -- run --> asgi
server -- register --> router -- mount --> asgi
server -- apply --> provider -- mount --> asgi
provider -- event,logins --> server
end
subgraph Client
config -- apply --> app -- run --> network
app -- register --> listener
network -- account,event --> listener
listener -- handle --> account -- session --> api
end
api -- request --> asgi -- response --> api
server -- raw-event --> asgi -- websocket/webhook --> network
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
satori_python_core-0.13.2.tar.gz
(16.3 kB
view hashes)
Built Distribution
Close
Hashes for satori_python_core-0.13.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 292182ba1fe98193748e21ccb46ef16ca7ad42db91a8ac20850b08cc30c6f120 |
|
MD5 | 89d763944ea55caf53016dbc80e615ab |
|
BLAKE2b-256 | c8dc9ff1734aa2f8e6622f2bb98405db6aeeb768bcdf7e411b9a5cc528e172e9 |
Close
Hashes for satori_python_core-0.13.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 29ae839eb38f82d885a5b5726c8300ba85c89537d447a348351255d7d26d79c2 |
|
MD5 | b6dfb0db70f46835bcbf932269c5f4f8 |
|
BLAKE2b-256 | 9db9ebe5ed4315be446f4c6ceb9f3fbc626a088b0fb605e0b9fa48a3d260cdd0 |