WeRoBot

WeRoBot: a robot framework for wechat

These details have not been verified by PyPI

Project links

Homepage

Development Status
- 4 - Beta
License
- OSI Approved :: MIT License
Operating System
Programming Language

Project description

WeRoBot是一个微信机器人框架，采用MIT协议发布。

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 ， EventMessage 和 UnknownMessage 。他们都继承自 WeChatMessage 。

TextMessage

TextMessage的属性：

name	value
type	‘text’ 或 ‘hello’ [1]
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。
content	信息的内容

ImageMessage

ImageMessage的属性：

name	value
type	‘image’
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。
img	图片网址。你可以从这个网址下到图片

LocationMessage

LocationMessage的属性：

name	value
type	‘location’
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。
location	一个元组。(纬度, 经度)
scale	地图缩放大小
label	地理位置信息

EventMessage

EventMessage的属性：

name	value
type	‘enter’ 或 ‘location’ [2]
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。
location	一个元组。(纬度, 经度)。 type 为 ‘location’ 时存在。
precision	地理位置精度。 type 为 ‘location’ 时存在。

UnknownMessage

UnknownMessage的属性：

name	value
type	‘unknown’
content	请求的正文部分。标准的XML格式。

类型过滤

WeRoBot 一共有5类 Message ， 6种 type 。显然，一个 handler 不可能把这6种 type 都支持全。

幸运的是， WeRoBot 可以帮你过滤收到的消息。

只想处理被新用户关注的消息？:

import werobot

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

@robot.hello
def hello(message):
    return 'Hello My Friend!'

robot.run()

或者，你的 handler 只能处理文本？

import werobot

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

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

robot.run()

你也可以使用 robot.image 修饰符来只接受图像信息； robot.location 修饰符来只接受位置信息； robot.enter 修饰符来只接受进入会话信息。

当然，还有 robot.unknown —— 如果你想收到未知属性的信息的话。

额，这个 handler 想处理文本信息和地理位置信息？

import werobot

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

@robot.text
@robot.location
def handler(message):
    # Do what you love to do
    pass

robot.run()

当然，你也可以用 add_handler 函数添加handler，就像这样:

import werobot

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

def handler(message):
    # Do what you love to do
    pass

robot.add_handler(handler, types=['text', 'location'])

robot.run()

Replies

目前WeRoBot共有三种Reply： TextReply ， ArticlesReply 和 MusicReply 。他们都继承自 WeChatReply 。

TextReply

TextReply 是简单的文本消息，构造函数的参数如下：

name	value
content	信息正文。
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。默认情况下会使用当前时间。
flag	如果是True， WeRoBot会对这条消息进行星标。你可以在公众平台后台看到所有的星标消息。

你可以在构建Reply时传入一个合法的 Message 对象来自动生成 source 和 target

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

ArticlesReply

ArticlesReply 是图文消息，构造函数的参数如下：

name	value
content	信息正文。可为空。
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。默认情况下会使用当前时间。
flag	如果是True， WeRoBot会对这条消息进行星标。你可以在公众平台后台看到所有的星标消息。

你需要给 ArticlesReply 添加 Article 来增加图文。 Article 类位于 werobot.reply.Article 。

Article 的构造函数的参数如下：

name	value
title	标题
description	描述
img	图片链接
url	点击图片后跳转链接

注意，微信公众平台对图片链接有特殊的要求，详情可以在消息接口使用指南里看到。

在构造完一个 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)

你也可以让你的 handler 返回一个列表，里面每一个元素都是一个长度为四的列表，

WeRoBot 会将其自动转为 ArticlesReply 。就像这样：

import werobot

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

@robot.text
def articles(message):
    return [
        [
            "title",
            "description",
            "img",
            "url"
        ],
        [
            "whtsky",
            "I wrote WeRoBot",
            "https://secure.gravatar.com/avatar/0024710771815ef9b74881ab21ba4173?s=420",
            "http://whouz.com/"
        ]
    ]

robot.run()

MusicReply

MusicReply 是音乐消息，构造函数的参数如下：

name	value
target	信息的目标用户。通常是机器人用户。
source	信息的来源用户。通常是发送信息的用户。
time	信息发送的时间，一个UNIX时间戳。默认情况下会使用当前时间。
title	标题
description	描述
url	音乐链接
hq_url	高质量音乐链接，WIFI环境优先使用该链接播放音乐。可为空 [3]
flag	如果是True， WeRoBot会对这条消息进行星标。你可以在公众平台后台看到所有的星标消息。

你也可以让你的 handler 返回一个长度为三或四的列表， [3]

WeRoBot 会将其自动转为 MusicReply 。就像这样：

import werobot

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

@robot.text
def music(message):
    return [
        "title",
        "description",
        "music_url",
        "hq_music_url"
        ]

@robot.text
def music2(message):
    return [
        "微信你不懂爱",
        "龚琳娜最新力作",
        "http://weixin.com/budongai.mp3",
        ]

robot.run()

部署

在独立服务器上部署

当你运行 werobot.run 的时候，你可以通过传递 server 参数来手动指定使用的服务器

import werobot

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

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

robot.run(server='tornado')

server 支持以下几种：

cgi
flup
wsgiref
waitress
cherrypy
paste
fapws3
tornado
gae
twisted
diesel
meinheld
gunicorn
eventlet
gevent
rocket
bjoern
auto

当 server 为 auto 时， WeRoBot 会自动依次尝试以下几种服务器：

Waitress
Paste
Twisted
CherryPy
WSGIRef

所以，只要你安装了相应的服务器软件，就可以使用 werobot.run 直接跑在生产环境下。

使用 Supervisor 管理守护进程

请注意， werobot.run 是跑在 非守护进程模式下 的——也就是说，一旦你关闭终端，进程就会自动退出。

我们建议您使用 Supervisor 来管理 WeRoBot 的进程。

配置文件样例：

[program:wechat_robot]
command = python /home/whtsky/robot.py
user = whtsky
redirect_stderr = true
stdout_logfile = /home/whtsky/logs/robot.log

使用 Nginx 进行反向代理

微信服务器只支持80端口的机器人——显然，你的服务器上不会只跑着一个微信机器人。对于这种情况，我们建议您使用 Nginx 来进行反向代理。

配置文件样例：

server {
    server_name example.com;
    listen 80;

    location / {
        proxy_pass_header Server;
        proxy_redirect off;
        proxy_pass http://127.0.0.1:8888;
    }
}

在SAE上部署

werobot.app 是一个标准的 WSGI Application 。如果你想在 SAE 上部署 WeRoBot ，可以参考以下代码

import werobot

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

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

application = sae.create_wsgi_app(robot.app)

不知道该用什么Token?

WeRoBot帮你准备了一个Token生成器：

import werobot.utils

print(werobot.utils.generate_token())

贡献代码

WeRoBot欢迎每个人贡献代码。

在提交Pull Request前请注意，我有pep8强迫症。。请确定自己的代码通过flake8检测。

另外，不能自动merge的和不能通过测试的代码不会被接受。你可以在安装nose（pip install nose）之后运行`nosetests`来进行测试。

捐助

Buy me a cup of coffee :)

Via Alipay（支付宝）

"whtsky#gmail.com".replace("#", "@")

Changelog

Version 0.3.1

Add server param in werobot.run

Version 0.3.0

Add new messages and replies support for WeChat 4.5

Project details

These details have not been verified by PyPI

Project links

Homepage

Development Status
- 4 - Beta
License
- OSI Approved :: MIT License
Operating System
Programming Language

Release history Release notifications | RSS feed

1.13.1

Jan 26, 2021

1.13.0

Nov 4, 2020

1.12.0

Mar 3, 2020

1.11.0

Feb 28, 2020

1.10.1

Oct 20, 2019

1.10.0

Oct 20, 2019

1.9.0

Mar 30, 2019

1.8.0

Feb 17, 2019

1.7.0

Jan 10, 2019

1.6.0

Jun 18, 2018

1.5.0

Jun 16, 2018

1.4.1

May 9, 2018

1.4.0

Apr 20, 2018

1.3.0

Apr 10, 2018

1.2.0

Dec 11, 2017

1.1.1

Feb 13, 2017

1.1.0

Feb 8, 2017

1.0.0

Nov 24, 2016

0.6.1

Aug 16, 2015

0.6.0

Jul 21, 2014

0.5.3

Feb 14, 2014

0.5.2

Feb 11, 2014

0.5.1

Feb 10, 2014

0.5.0

Feb 8, 2014

0.4.1

Aug 31, 2013

0.4.0

Jul 16, 2013

0.3.5

Apr 20, 2013

0.3.4

Apr 8, 2013

0.3.3

Mar 23, 2013

0.3.2

Feb 20, 2013

This version

0.3.1

Feb 14, 2013

0.3.0

Feb 6, 2013

0.2.0

Feb 4, 2013

0.1.1

Feb 3, 2013

0.1

Feb 2, 2013

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

WeRoBot-0.3.1.tar.gz (21.1 kB view details)

Uploaded Feb 14, 2013 Source

Built Distribution

WeRoBot-0.3.1-py2.7.egg (20.9 kB view details)

Uploaded Feb 14, 2013 Source

File details

Details for the file WeRoBot-0.3.1.tar.gz.

File metadata

Download URL: WeRoBot-0.3.1.tar.gz
Upload date: Feb 14, 2013
Size: 21.1 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for WeRoBot-0.3.1.tar.gz
Algorithm	Hash digest
SHA256	`c6321cbfa05d90638327a9433fc013981683f8bb0194e753df57c1efdeac28c1`
MD5	`453e3ada474e0803890c0e4deb3eacd3`
BLAKE2b-256	`2f6ebd0d8cb92cf3cf272efc955acfd8e4285da40a3357e1001c9d631a4a86ad`

See more details on using hashes here.

File details

Details for the file WeRoBot-0.3.1-py2.7.egg.

File metadata

Download URL: WeRoBot-0.3.1-py2.7.egg
Upload date: Feb 14, 2013
Size: 20.9 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for WeRoBot-0.3.1-py2.7.egg
Algorithm	Hash digest
SHA256	`66837f3e0da2d4f26848d437cc31ffb0daa88d3b17fafdc077083aa795846e78`
MD5	`1a30775fc03ac3fbdeb490c696d495d4`
BLAKE2b-256	`3dd3e23fd19b22dd9bbbf6182be57c9dbfbcb3ba105c7f27aca542a0f381ce58`

See more details on using hashes here.

WeRoBot 0.3.1

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Hello World

Handlers

Messages

TextMessage

ImageMessage

LocationMessage

EventMessage

UnknownMessage

类型过滤

Replies

TextReply

ArticlesReply

MusicReply

部署

在独立服务器上部署

使用 Supervisor 管理守护进程

使用 Nginx 进行反向代理

在SAE上部署

不知道该用什么Token?

贡献代码

捐助

Changelog

Version 0.3.1

Version 0.3.0

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes