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.14.5.tar.gz
(17.0 kB
view hashes)
Built Distribution
Close
Hashes for satori_python_core-0.14.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 418c9c6d86ce8a34c5b8a8d3fe5e83c521ae02b1bb196d92dc0d23c534b2c7d7 |
|
MD5 | 7ebbbdb8c76436b81adc069b3b0443ff |
|
BLAKE2b-256 | 648c2e3d171074ce46410c5f216f929e573a3ad52acbb7d45d16885a9829585c |
Close
Hashes for satori_python_core-0.14.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e04369f6180349fe6616f3d29df8f61d9c704564f63800edfe8fa89e3899e69f |
|
MD5 | 98a7cd3937204dd677421efdffdca78f |
|
BLAKE2b-256 | 8bcea8207c027199ae74e33850cfadd7aa84c80b06de39eb9130078d058d0ad2 |