Metadata-Version: 2.1
Name: botoy
Version: 8.2.0
Summary: OPQBot/IOTQQ/IOTBot的Python开发助手
Home-page: https://github.com/xiyaowong/botoy
Author: wongxy
Author-email: xiyao.wong@foxmail.com
License: MIT
Keywords: iotbot,iotqq,OPQ,OPQBot
Platform: UNKNOWN
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: httpx
Requires-Dist: python-socketio (<5.0.0)
Requires-Dist: python-engineio (<4.0.0)
Requires-Dist: websocket-client
Requires-Dist: loguru
Requires-Dist: click
Requires-Dist: aiohttp
Requires-Dist: prettytable
Requires-Dist: apscheduler
Requires-Dist: pydantic
Requires-Dist: colorama

# botoy

[![QQ群](https://img.shields.io/badge/QQ%E7%BE%A4-757360354-important?style=flat-square&logo=tencentqq)](https://jq.qq.com/?_wv=1027&k=fBx8LvmA)
[![pypi](https://img.shields.io/pypi/v/botoy?style=flat-square 'pypi')](https://pypi.org/project/botoy/)
[![python](https://img.shields.io/badge/python-3.7+-blue 'python')](https://pypi.org/project/botoy/)
[![LICENSE](https://img.shields.io/github/license/opq-osc/botoy?style=flat-square)](https://github.com/opq-osc/botoy/blob/main/LICENSE)

对机器人框架[OPQ](https://github.com/OPQBOT/OPQ/)接口的 Python 封装,
因为功能模块耦合度低, 所以你可以完全使用该框架开发，也可以选取需要的内容到自己的项目中

---

## 安装

```shell
pip install botoy -i https://pypi.org/simple --upgrade
```

## 示例

如果你配置好了 OPQ，并且配置保持默认(bot 连接地址`http://127.0.0.1:8888`)，
下面一行代码即可监听消息，并在收到群消息或好友消息内容为 test 时回复 ok

```python
__import__('botoy').Botoy().on_group_msg(lambda ctx: __import__('botoy').Action(ctx.CurrentQQ).sendGroupText(ctx.FromGroupId, 'ok') if ctx.Content == 'test' else None).on_friend_msg(lambda ctx: __import__('botoy').Action(ctx.CurrentQQ).sendFriendText(ctx.FromUin, 'ok') if ctx.Content == 'test' else None).run()
```

当然上面的写法明显不常规，要实现和上面相同的功能，一般这样写

```python
from botoy import Botoy, S
from botoy.decorators import equal_content


@equal_content("test")
def test(_):
    S.text("ok")


Botoy().on_group_msg(test).on_friend_msg(test).run()
```

# [文档](https://botoy.readthedocs.io/)

# [简单例子](https://github.com/opq-osc/botoy-plugins)

# [插件模板](https://github.com/opq-osc/botoy-plugin-template)

# 感谢

[yuban10703](https://github.com/yuban10703)
[milkice](https://github.com/milkice233)

# LICENSE

MIT

# CHANGE LOG

# See [releases](https://github.com/xiyaowong/botoy/releases)

## 0.0.2

- 修复模块导入错误

## V0.0.1

初次发布


