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

《WeRoBot 1.0.0 微信公众号开发框架文档》主要涵盖了以下内容： ### 1. **版本更新日志** - **Version 1.0.0**： - 增加了对消息加解密的支持。 - 重构了部分模块，如`werobot.messages`、`werobot.reply`等。 - 新增了`Session`系统，支持用户状态记录。 - 新增了与Django 1.6+、Flask、Bottle、Tornado等框架的集成支持。 - 删除了过时的功能，如`werobot.reply.create_reply()`。 - 默认将`SessionBackend`切换为`SQLiteStorage`。 - 取消了对Python 2.6、3.3的支持。 - **Version 0.6.1**： - 修复了媒体上传的URL错误。 - 新增了`VideoMessage`支持。 - **Version 0.6.0**： - 新增了`@werobot.filter`装饰器。 - 新增了`werobot.session.saekvstorage`模块。 - 支持微信支付（`werobot.pay.WeixinPayClient`）。 - 新增了`werobot.reply.TransferCustomerServiceReply`。 - **Version 0.3.0**： - 未提供详细更新内容。 ### 2. **入门指南** - **Hello World**： - 提供了最简单的微信机器人示例代码，实现对收到的消息进行回复。 - **消息加密**： - 支持消息加密功能，需在微信公众平台启用安全模式并配置`EncodingAESKey`。 ### 3. **功能模块** - **Handlers**： - 提供了多种消息类型的处理器，如`robot.key_click`、`robot.filter`等，用于回应自定义菜单和特定文本消息。 - **消息与事件**： - 支持多种消息类型（如文本、图片、链接、位置、语音、视频等）和事件（如订阅、取消订阅、扫码、点击、位置、模板发送完成等）。 - **回复**： - 提供了多种回复类型，如`TextReply`、`ImageReply`、`VoiceReply`、`VideoReply`等。特别支持`SuccessReply`，用于告诉微信服务器不需要进一步处理。 - **Session系统**： - 从版本0.4.0起增加了会话管理功能，方便记录用户状态。 - 提供了多种存储方式，如`FileStorage`、`SQLiteStorage`等。 - **微信API操作**： - 提供了`werobot.client.Client`类，支持通过微信API进行操作，如创建分组、自定义菜单、主动发送消息等。 ### 4. **与其他框架集成** - **Django**： - 支持在Django 1.6+中集成，通过`werobot.contrib.django.make_view()`实现。 - **Flask**： - 提供了`werobot.contrib.flask.make_view()`，方便在Flask中挂载微信机器人。 - **Bottle**： - 通过`werobot.contrib.bottle.make_view()`实现集成。 - **Tornado**： - 提供了`werobot.contrib.tornado.make_handler()`，方便在Tornado中使用。 ### 5. **其他信息** - **测试**： - 提供了测试工具`tox`，并要求开发者为新添加的模块或功能编写测试代码，所有测试文件存放在`tests`文件夹中。 - **版权与支持**： - 版权信息：2016, whtsky。 - 文档由Sphinx 1.4.5生成。 - 开发者可以通过GitHub Issues或邮箱反馈问题。 --- 该文档详细介绍了WeRoBot框架的功能、更新日志、入门指南、功能模块和与其他框架的集成方式，适合开发者快速了解和使用该框架进行微信公众号开发。