微信機器人框架：WeRoBot

Hello World

最簡單的Hello World， 會給收到的每一條信息回復 Hello World

import werobot

robot = werobot.WeRoBot(token='tokenhere')

@robot.handler
def echo(message):
    return 'Hello World!'

robot.run()

Handlers

WeRoBot會將合法的請求發送給handlers依次執行。

如果某一個Handler返回了非空值，WeRoBot就會根據這個值創建回復，后面的handlers將不會被執行。

你可以通過兩種方式添加handler

import werobot

robot = werobot.WeRoBot(token='tokenhere')

# 通過修飾符添加handler
@robot.handler
def echo(message):
    return 'Hello World!'

# 通過`add_handler`添加handler
def echo(message):
    return 'Hello World!'
robot.add_handler(echo)

Messages

目前WeRoBot共有三種Message：TextMessage ， ImageMessage 和 LocationMessage 。他們都繼承自WeChatMessage。

TextMessage的屬性：

ImageMessage的屬性：

LocationMessage的屬性：

Replies

目前WeRoBot共有三種Reply： TextReply ， ArticlesReply 。他們都繼承自 WeChatReply 。

TextReply 是簡單的文本消息，構造函數的參數如下：

你可以在構建Reply時傳入一個合法的 Message 類來自動生成 source 和 target

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

如果你的handler返回了一個字符串， WeRoBot會自動將其轉化為一個文本消息。

ArticlesReply 是圖文消息，構造函數的參數如下：

你需要給 ArticlesReply 添加 Article 來增加圖文。 Article 類位于 werobot.reply.Article 。

Article 的構造函數的參數如下：

注意，微信公眾平臺對圖片鏈接有特殊的要求，詳情可以在消息接口使用指南 里看到。

在構造完一個 Article 后， 你需要通過 ArticlesReply 的 add_article 參數把它添加進去。就像這樣：

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

注意，每個ArticlesReply中 最多添加10個Article 。

不知道該用什么Token?

WeRoBot幫你準備了一個Token生成器：

import werobot.utils

print(werobot.utils.generate_token())

項目主頁：http://www.baiduhome.net/lib/view/home/1359893611439