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

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

摘要

WeRoBot 1.5.0 是一个微信公众号开发框架，提供了丰富的功能组件，包括消息处理、自定义菜单、消息加解密、Session 管理等模块。框架支持与 Django 和 Flask 等其他 Web 框架集成，并提供了微信 API 操作类 Client 以便调用微信接口。新版本增加了多个事件处理模块，如卡券事件、地理位置异步推送等。框架核心对象 BaseRoBot 负责处理消息和事件，提供配置管理和扩展接口。

AI总结

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

### 1. **框架概述**
WeRoBot 是一个基于 Bottle 框架开发的微信公众号开发框架，支持消息处理、自定义菜单、会话管理、微信 API 操作等核心功能。它可以作为独立服务运行，也可以集成到其他 Web 框架（如 Django、Flask）中。

---

### 2. **核心功能**
#### **消息处理**
- **消息类型**：支持文本、图片、链接、位置、语音等消息类型，通过修饰器（如 `@robot.text`、`@robot.image`）实现特定消息的处理。
- **事件处理**：支持关注、扫码、卡券、支付等事件，通过特定装饰器（如 `@robot.scan`、`@robot.pay`）实现事件处理。
- **Handler 功能**：通过 `@robot.handler` 装饰器，可以定义处理所有消息类型的 Handler，支持规则匹配和过滤。

#### **会话管理**
- 提供 Session 功能，用于记录用户状态，支持 SQLite 和文件存储。
- 开启 Session 后，可以通过更改 Handler 实现 Session 数据的管理。

#### **API 操作**
- 提供 `WeRoBot.Client` 类，支持微信 API 操作，包括获取 Access Token、微信服务器 IP 地址等。
- 支持手动重写 Token 获取和刷新策略，适用于多进程或多机部署场景。

---

### 3. **配置与部署**
- **配置**：支持通过 `Config` 类或配置文件设置参数，包括 Token、App ID、App Secret、AES 密钥等。
- **部署**：支持独立服务器部署，也可集成到 Django（1.8+）和 Flask 框架中，通过 `make_view` 或自定义路由实现。

---

### 4. **版本更新**
- **1.5.0**：新增正则匹配 Handler 的 Match Object 参数。
- **1.4.1**：修复中文文件名 Bug。
- **1.4.0**：新增多种卡券事件和会员卡事件处理。
- **1.3.0**：新增商品扫码事件和会话事件处理。

---

### 5. **快速入门**
- 示例代码：

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

---

### 总结
WeRoBot 是一个功能全面的微信公众号开发框架，支持丰富的消息处理和事件监听功能，且易于集成到主流 Web 框架中，适合快速开发微信公众号应用。