Merge branch 'develop'

Author: whtsky

README.rst

@@ -2,14 +2,13 @@
 WeRoBot
 ====================================
 
-.. image:: https://api.travis-ci.org/whtsky/WeRoBot.png?branch=master
+.. image:: https://api.travis-ci.org/whtsky/WeRoBot.png?branch=develop
     :target: http://travis-ci.org/whtsky/WeRoBot
-.. image:: https://coveralls.io/repos/whtsky/WeRoBot/badge.png?branch=master
+.. image:: https://coveralls.io/repos/whtsky/WeRoBot/badge.png?branch=develop
     :target: https://coveralls.io/r/whtsky/WeRoBot
-.. image:: https://pypip.in/v/WeRoBot/badge.png
-   :target: https://crate.io/packages/WeRoBot/
-.. image:: https://pypip.in/d/WeRoBot/badge.png
-   :target: https://crate.io/packages/WeRoBot/
+.. image:: https://scrutinizer-ci.com/g/whtsky/WeRoBot/badges/quality-score.png?b=develop
+   :target: https://scrutinizer-ci.com/g/whtsky/WeRoBot/?branch=develop
+
 
 WeRoBot 是一个微信机器人框架，采用MIT协议发布。
 

docs/_templates/sidebarintro.html

@@ -1,7 +1,6 @@
 <h3>关于</h3>
 WeRoBot 是一个高中生利用闲暇时间写成的微信公共平台开发框架。如果你喜欢 WeRoBot ，请考虑捐助：
 <ul>
-  <li><a href="http://me.alipay.com/whtsky">支付宝</a></li>
   <li><a href="https://www.gittip.com/whtsky/">GitTip</a></li>
 </ul>
 

docs/changelog.rst

@@ -1,6 +1,15 @@
 Changelog
 =============
 
+Version 0.6.0
+----------------
+
++ Add ``@werobot.filter``
++ Add :class:`werobot.session.saekvstorage`
++ Add support for Weixin Pay ( :class:`werobot.pay.WeixinPayClient` )
++ Add ``werobot.reply.TransferCustomerServiceReply``
++ Fix FileStorage's bug
+
 Version 0.5.3
 ----------------
 

docs/deploy.rst

@@ -87,3 +87,5 @@ server 支持以下几种：
 -----------------
 
 参考： `示例仓库 <https://github.com/whtsky/WeRoBot-SAE-demo>`_
+
+如果你需要使用 Session ，最好使用 :class:`werobot.session.saekvstorage` 。

docs/handlers.rst

@@ -96,8 +96,8 @@ robot.unknown        未知类型
 
 .. note:: 通过 ``robot.handler`` 添加的 handler 将收到所有信息；只有在其他 handler 没有给出返回值的情况下， 通过 ``robot.handler`` 添加的 handler 才会被调用。
 
-robot.key_click 修饰符
--------------------------
+robot.key_click —— 回应自定义菜单
+---------------------------------
 
 ``@robot.key_click`` 是对 ``@robot.click`` 修饰符的改进。
 
@@ -114,3 +114,44 @@ robot.key_click 修饰符
         if message.key == "abort":
             return "I'm a robot"
 两者是等价的。
+
+robot.filter ——  回应有指定文本的消息
+-------------------------------------
+
+``@robot.filter`` 是对 ``@robot.text`` 修饰符的改进。
+
+现在你可以写这样的代码 ::
+
+    @robot.filter("a")
+    def a():
+        return "正文为 a "
+
+    import re
+
+
+    @robot.filter(re.compile(".*?bb.*?"))
+    def b():
+        return "正文中含有 b "
+
+    @robot.filter(re.compile(".*?c.*?"), "d")
+    def c():
+        return "正文中含有 c 或正文为 d"
+
+这段代码等价于 ::
+
+    @robot.text
+    def a(message):
+        if message.content == "a":
+            return "正文为 a "
+    import re
+
+
+    @robot.text
+    def b():
+        if re.compile(".*?bb.*?").match(message.content):
+            return "正文中含有 b "
+
+    @robot.text
+    def c():
+        if re.compile(".*?c.*?").match(message.content) or message.content == "d":
+            return "正文中含有 c 或正文为 d"

docs/index.rst

@@ -15,6 +15,7 @@ WeRoBot 是一个微信机器人框架，采用 MIT 协议发布。
     replies
     session
     client
+    pay
     deploy
     utils
     changelog

docs/pay.rst

@@ -0,0 +1,7 @@
+``WeRoBot.pay.WeixinPayClient`` —— 微信支付 API 操作类
+=================================
+
+.. module:: werobot.pay
+
+.. autoclass:: WeixinPayClient
+   :members:

docs/replies.rst

@@ -1,7 +1,7 @@
 回复
 ==============
 
-目前WeRoBot共有三种Reply： `TextReply` ， `ArticlesReply` 和 `MusicReply` 。他们都继承自 `WeChatReply` 。
+目前WeRoBot共有四种Reply： `TextReply` ， `ArticlesReply` ， `MusicReply` 和 `TransferCustomerServiceReply` 。他们都继承自 `WeChatReply` 。
 
 TextReply
 -----------
@@ -62,7 +62,7 @@ url           点击图片后跳转链接
     reply = ArticlesReply(message=message)
     article = Article(
         title="WeRoBot",
-        desription="WeRoBot是一个微信机器人框架",
+        description="WeRoBot是一个微信机器人框架",
         img="https://github.com/apple-touch-icon-144.png",
         url="https://github.com/whtsky/WeRoBot"
     )
@@ -142,4 +142,9 @@ flag              如果是True， WeRoBot会对这条消息进行星标。你
     robot.run()
 
 
-.. [3] 如果你省略了高质量音乐链接的地址， WeRoBot 会自动将音乐链接的地址用于高质量音乐链接。
+.. [3] 如果你省略了高质量音乐链接的地址， WeRoBot 会自动将音乐链接的地址用于高质量音乐链接。
+
+TransferCustomerServiceReply
+-----------------------------
+
+将消息转发到多客服

docs/session.rst

@@ -59,4 +59,8 @@ WeRoBot 0.4.0 中增加了功能强大的 Session 系统，你可以通过 Sessi
 
 .. module:: werobot.session.redisstorage
 
-.. autoclass:: RedisStorage
+.. autoclass:: RedisStorage
+
+.. module:: werobot.session.saekvstorage
+
+.. autoclass:: SaeKVDBStorage

example/hello_world.py

@@ -1,3 +1,5 @@
+# -*- coding: utf-8 -*-
+
 import werobot
 
 robot = werobot.WeRoBot(token='tokenhere')
@@ -6,4 +8,11 @@
 def hello_world(message):
     return 'Hello World!'
 
+@robot.filter("帮助")
+def show_help(message):
+    return """
+    帮助
+    XXXXX
+    """
+
 robot.run()