WeRoBot 0.2.0 微信公众号开发框架文档

• 语言: 英语
• 格式: .epub
• 来源: werobot.readthedocs.io

摘要

WeRoBot是一个基于MIT协议的微信机器人框架，支持通过修饰符或add_handler函数添加处理器，处理多种消息类型，包括文本、图片、位置和未知消息。框架提供TextReply和ArticlesReply两种回复类型，支持自动转换字符串为文本消息，并允许通过列表或Article对象创建图文消息。框架还支持类型过滤和多消息类型处理，提供Token生成工具，鼓励社区贡献代码并通过flake8检测。

AI总结

### WeRoBot 0.2.0 微信公众号开发框架文档总结

WeRoBot是一个开源的微信机器人框架，遵循MIT协议，旨在帮助开发者快速构建微信公众号应用。

#### 1. **安装与基本使用**
- **Hello World**: 可通过以下代码快速实现基本功能：

     import werobot
     robot = werobot.WeRoBot(token='tokenhere')
     @robot.handler
     def echo(message):
         return 'Hello World!'
     robot.run()

- 通过`werobot.utils.generate_token()`可以生成Token。

#### 2. **消息处理器（Handlers）**
- Handler用于处理用户发送的消息，支持两种添加方式：
- **修饰符方式**：`@robot.handler`
- **函数方式**：`robot.add_handler()`
- Handler类型包括：
- `@robot.text`：处理文本消息。
- `@robot.image`：处理图片消息。
- `@robot.location`：处理地理位置消息。
- `@robot.hello`：处理用户关注事件。

#### 3. **消息类型（Messages）**
- **TextMessage**：文本消息，属性包括`content`。
- **ImageMessage**：图片消息，提供图片URL。
- **LocationMessage**：地理位置消息，包含纬度、经度、缩放级别等信息。
- **UnknownMessage**：未知消息类型。

#### 4. **回复（Replies）**
- **TextReply**：文本回复，支持星标功能。

     reply = TextReply(message=message, content='Hello!')

- **ArticlesReply**：图文回复，需添加`Article`对象：

     from werobot.reply import ArticlesReply, Article
     reply = ArticlesReply(message=message)
     article = Article(
         title="WeRoBot",
         description="WeRoBot是一个微信机器人框架",
         img="https://github.com/apple-touch-icon-144.png",
         url="https://github.com/whtsky/WeRoBot"
     )
     reply.add_article(article)

#### 5. **贡献代码**
- 欢迎开发者贡献代码，需确保代码符合PEP8规范，并通过flake8和nosetests测试。

#### 6. **捐助**
- 作者接受捐助，可通过支付宝([e-mail])支持。

WeRoBot框架简单易用，适合快速搭建微信公众号应用，支持丰富的消息类型和灵活的回复方式。