Metadata-Version: 2.1
Name: nonebot-adapter-milky
Version: 0.1.4
Summary: Nonebot Adapter of Milky Protocol
Author-Email: RF-Tar-Railt <rf_tar_railt@qq.com>
License: MIT
Requires-Python: >=3.9
Requires-Dist: nonebot2>=2.4.2
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://nonebot.dev/"><img src="https://nonebot.dev/logo.png" width="200" height="200" alt="nonebot"></a>
</p>

<div align="center">

# NoneBot-Adapter-Milky

_✨ NoneBot2 Milky 协议适配 / Milky Protocol Adapter for NoneBot2 ✨_

</div>

## 协议介绍

[Milky 协议](https://milky.ntqqrev.org/)

### 协议端

[Lagrange,Milky (WIP)](https://github.com/LagrangeDev/LagrangeV2/)

## 配置

修改 NoneBot 配置文件 `.env` 或者 `.env.*`。

### Driver

参考 [driver](https://nonebot.dev/docs/appendices/config#driver) 配置项，添加 `HTTPClient` 和 `WebSocketClient` 支持。

如：

```dotenv
DRIVER=~httpx+~websockets
```

或

```dotenv
DRIVER=~aiohttp
```

如果你使用的是 Webhook 模式，则可以移除 `WebSocketClient` 支持，并添加 `ASGI` 支持。

如：

```dotenv
DRIVER=~httpx+~fastapi
```

或

```dotenv
DRIVER=~aiohttp+~fastapi
```

### MILKY_CLIENTS

配置连接配置，如：

```dotenv
MILKY_CLIENTS='
[
  {
    "host": "localhost",
    "port": "8080",
    "access_token": "xxx"
  }
]
'
```

`host` 与 `port` 为 Milky 协议端设置的监听地址与端口，

`access_token` 为可选项，具体情况以 Milky 协议端为准。

### MILKY_WEBHOOK

如果你使用的是 Webhook 模式，则需要配置 `MILKY_WEBHOOK`。

```dotenv
MILKY_WEBHOOK='
{
  "host": "localhost",
  "port": "8081",
  "access_token": "xxx"
}
```

`host` 与 `port` 为 Milky 协议端设置的监听地址与端口，

`access_token` 为可选项，具体情况以 Milky 协议端为准。

## 示例

```python
from nonebot import on_command
from nonebot.adapters.milky import Bot
from nonebot.adapters.milky.event import MessageEvent
from nonebot.adapters.milky.message import MessageSegment


matcher = on_command("test")

@matcher.handle()
async def handle_receive(bot: Bot, event: MessageEvent):
    if event.is_private:
        await bot.send(event, MessageSegment.text("Hello, world!"))
```
