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

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

摘要

WeRoBot 是一个用于微信公众号开发的框架，提供了消息处理、自定义菜单创建、会话管理等功能。文档详细介绍了其核心组件，包括消息加解密、部署方法、Handler 类型过滤、Session 管理以及与 Django、Flask 等框架的集成。版本更新部分列出了功能改进和修复内容，如支持 Python 3.6+ 的随机生成 token 和修复中文编码问题。

AI总结

《WeRoBot 1.8.0 微信公众号开发框架文档》总结如下：

### 核心功能
WeRoBot 是一个用于微信公众号开发的框架，提供以下核心功能：
1. **消息处理**：支持文本、图片、链接、位置、语音、视频等消息类型。
2. **自定义菜单**：支持创建和管理自定义菜单。
3. **会话管理**：支持使用 Session 记录用户状态。
4. **消息加解密**：支持微信消息的加密和解密。
5. **部署支持**：支持在独立服务器和 SAE 上部署。
6. **Handler 模块**：支持类型过滤和自定义处理逻辑。
7. **API 操作**：提供微信 API 操作类，支持消息管理、用户管理、素材管理等。

### 版本更新
- **1.8.0**：
- 修复了 `Client.get media list()` 的调用参数错误。
- 修复了中文编码问题。
- Handler 中的异常记录到日志中。
- 支持 Django 2.0 测试。
- 支持视频和短视频消息。
- 支持 `werobot.session.saekvstorage.SaeKVDBStorage` 测试。

- **1.1.1**：
- 修复 `create menu()` 和 `send_music_message()` 文档错误。

- **1.1.0**：
- 增加 `client` 属性，允许传入 `Config`。
- 支持惰性加载 Session。
- 修复打包时 `error.html` 被忽略的问题。
- 支持 `reply.time` 快速读取属性。

- **1.0.0**：
- 增加消息加解密支持。
- 完善 `werobot.messages` 对 `Event` 的支持。
- 增加 `SuccessReply`、`ImageReply`、`VoiceReply`、`VideoReply`。
- 删除 `create_reply()` 方法。

### API 概览
- **BaseRoBot**：核心对象，负责消息处理和 Handler 管理。
- 参数：`token`、`logger`、`config` 等。
- 方法：`add_filter`、`add_handler`、`parse_message`、`get_encrypted_reply` 等。

- **Config**：配置管理类，支持从对象或文件读取配置。
- 方法：`from_object`、`from_pyfile`。

- **Session 存储**：
- `SQLiteStorage`：使用 SQLite 数据库存储 Session。
- `FileStorage`：使用文件存储 Session。

### 入门示例
- **Hello World**：

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

- **消息处理**：

  @robot.text
  def echo(message):
      return message.content

### 框架集成
- **Django**：

  from werobot.contrib.Django import make_view
  urlpatterns = patterns('', url(r'^robot/', make_view(myrobot)),)

- **Flask**：

  from werobot.contrib.Flask import make_view
  app.add_url_rule('/robot/', view_func=make_view(myrobot))

### 总结
WeRoBot 是一个功能全面的微信公众号开发框架，支持消息处理、自定义菜单、会话管理等核心功能，并提供丰富的 API 和灵活的配置选项。文档详细介绍了版本更新、API 使用方法以及与其他 Web 框架的集成方式，适合开发者快速上手和深入使用。