Merge branch 'develop'

Author: whtsky

.bumpversion.cfg

@@ -0,0 +1,7 @@
+[bumpversion]
+current_version = 1.3.0
+commit = True
+tag = True
+
+[bumpversion:file:werobot/__init__.py]
+

.gitignore

@@ -63,3 +63,4 @@ pip-selfcheck.json
 venv
 
 *.sqlite3
+.pytest_cache

.travis.yml

@@ -1,6 +1,6 @@
 os: osx
 language: generic
-osx_image: xcode8.2
+osx_image: xcode8.3
 matrix:
   include:
   - env:
@@ -14,7 +14,7 @@ matrix:
     - PYTHON_VERSION="2.7.12"
   - env:
     - PYTHON_MAJOR=pypy
-    - PYTHON_VERSION="pypy-5.0.0"
+    - PYTHON_VERSION="pypy2.7-5.10.0"
 cache:
   directories:
   - $HOME/.pyenv

dev-requirements.txt

@@ -2,3 +2,4 @@
 flake8==3.5.0
 tox
 django
+bumpversion

docs/changelog.rst

@@ -1,6 +1,17 @@
 Changelog
 =============
 
+Version 1.3.0
+----------------
++ 增加 :class:`werobot.messages.events.UserScanProductEvent`
++ 增加 :class:`werobot.messages.events.UserScanProductEnterSessionEvent`
++ 增加 :class:`werobot.messages.events.UserScanProductAsyncEvent`
++ 增加 :class:`werobot.messages.events.UserScanProductVerifyActionEvent`
++ 增加 :class:`werobot.messages.events.PicSysphotoEvent`
++ 增加 :class:`werobot.messages.events.PicPhotoOrAlbumEvent`
++ 增加 :class:`werobot.messages.events.PicWeixinEvent`
++ 增加 :class:`werobot.messages.events.LocationSelectEvent`
+
 Version 1.2.0
 ----------------
 + 增加 :class:`werobot.session.mysqlstorage.MySQLStorage`

docs/events.rst

@@ -24,7 +24,7 @@ SubscribeEvent 的属性:
 ======== ===================================
 name      value
 ======== ===================================
-type      'subscribe'
+type      'subscribe_event'
 key       事件 key 值。 当且仅当未关注公众号扫描二维码时存在
 ticket    二维码的 ticket。 当且仅当未关注公众号扫描二维码时存在
 ======== ===================================
@@ -37,7 +37,7 @@ UnSubscribeEvent 的属性:
 ======== ===================================
 name      value
 ======== ===================================
-type      'unsubscribe'
+type      'unsubscribe_event'
 ======== ===================================
 
 ScanEvent
@@ -75,11 +75,70 @@ ScanCodeWaitMsgEvent 的属性:
 ============ ===================================
 name          value
 ============ ===================================
-type          'scancode_waitmsg'
+type          'scancode_waitmsg_event'
 scan_type     扫描类型，一般是qrcode
 scan_result   扫描结果，即二维码对应的字符串信息
 ============ ===================================
 
+PicSysphotoEvent
+--------------------
+
+弹出系统拍照发图的事件推送的 Event。属性:
+
+============ =========================================
+name          value
+============ =========================================
+type          'pic_sysphoto_event'
+key           事件KEY值，由开发者在创建菜单时设定
+count         发送的图片数量
+pic_list      图片列表，例如 [{'pic_md5_sum': '123'}]
+============ =========================================
+
+PicPhotoOrAlbumEvent
+--------------------
+
+弹出拍照或者相册发图的事件推送的 Event。属性:
+
+============ =========================================
+name          value
+============ =========================================
+type          'pic_photo_or_album_event'
+key           事件KEY值，由开发者在创建菜单时设定
+count         发送的图片数量
+pic_list      图片列表，例如 [{'pic_md5_sum': '123'}]
+============ =========================================
+
+PicWeixinEvent
+--------------------
+
+弹出微信相册发图器的事件推送的 Event。属性:
+
+============ =========================================
+name          value
+============ =========================================
+type          'pic_weixin_event'
+key           事件KEY值，由开发者在创建菜单时设定
+count         发送的图片数量
+pic_list      图片列表，例如 [{'pic_md5_sum': '123'}]
+============ =========================================
+
+LocationSelectEvent
+--------------------
+
+弹出地理位置选择器的事件推送的 Event。属性:
+
+============ ==================================================
+name          value
+============ ==================================================
+type          'location_select_event'
+key           事件KEY值，由开发者在创建菜单时设定
+location_x    X坐标信息
+location_y    Y坐标信息
+scale         精度，可理解为精度或者比例尺、越精细的话 scale 越高
+label         地理位置的字符串信息
+poi_name      朋友圈POI的名字，可能为 None
+============ ==================================================
+
 ClickEvent
 ----------
 
@@ -88,7 +147,7 @@ ClickEvent 的属性:
 ======== ===================================
 name      value
 ======== ===================================
-type      'click'
+type      'click_event'
 key       事件 key 值。
 ======== ===================================
 
@@ -100,7 +159,7 @@ ViewEvent 的属性:
 ======== ===================================
 name      value
 ======== ===================================
-type      'view'
+type      'view_event'
 key       事件 key 值。
 ======== ===================================
 
@@ -112,7 +171,7 @@ LocationEvent 的属性:
 =========== ===================================
 name        value
 =========== ===================================
-type        'location'
+type        'location_event'
 latitude    地理位置纬度
 longitude   地理位置经度
 precision   地理位置精度
@@ -129,6 +188,69 @@ name         value
 status       发送是否成功。为 'success' 或失败原因
 =========== ===================================
 
+UserScanProductEvent
+--------------------
+
+打开商品主页事件推送的 Event。属性:
+
+=============   ======================================================================
+name             value
+=============   ======================================================================
+type            'user_scan_product_event'
+key_standard    商品编码标准。
+key_str         商品编码内容。
+country         用户在微信内设置的国家。
+province        用户在微信内设置的省份。
+city            用户在微信内设置的城市。
+sex             用户的性别，1为男性，2为女性，0代表未知。
+scene           打开商品主页的场景，1为扫码，2为其他打开场景（如会话、收藏或朋友圈）。
+ext_info        调用“获取商品二维码接口”时传入的 extinfo，为标识参数。
+=============   ======================================================================
+
+UserScanProductEnterSessionEvent
+--------------------------------
+
+当用户从商品主页进入公众号会话时推送的 Event。属性:
+
+=============   ======================================================================
+name             value
+=============   ======================================================================
+type            'user_scan_product_enter_session_event'
+key_standard     商品编码标准。
+key_str          商品编码内容。
+ext_info         调用“获取商品二维码接口”时传入的 extinfo，为标识参数。
+=============   ======================================================================
+
+UserScanProductAsyncEvent
+-------------------------
+
+当用户打开商品主页，微信会将该用户实时的地理位置信息以异步事件的形式推送的 Event。属性:
+
+=============   ============================================================================================================================================
+name             value
+=============   ============================================================================================================================================
+type            'user_scan_product_async_event'
+key_standard     商品编码标准。
+key_str          商品编码内容。
+ext_info         调用“获取商品二维码接口”时传入的 extinfo，为标识参数。
+region_code      用户的实时地理位置信息（目前只精确到省一级），可在国家统计局网站查到对应明细： http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201504/t20150415_712722.html
+=============   ============================================================================================================================================
+
+UserScanProductVerifyActionEvent
+--------------------------------
+
+提交审核的商品，完成审核后，微信会将审核结果以事件的形式推送的 Event。属性:
+
+=============   ======================================================================
+name             value
+=============   ======================================================================
+type            'user_scan_product_verify_action_event'
+key_standard     商品编码标准。
+key_str          商品编码内容。
+result           审核结果。verify_ok表示审核通过，verify_not_pass表示审核未通过。
+reason_msg       审核未通过的原因。
+=============   ======================================================================
+
 UnknownEvent
 ------------
 
@@ -137,7 +259,7 @@ UnknownEvent 的属性:
 ========= =====================================
 name       value
 ========= =====================================
-type       'unknown'
+type       'unknown_event'
 raw        请求的正文部分。标准的XML格式。
 ========= =====================================
 

docs/handlers.rst

@@ -53,24 +53,33 @@ WeRoBot会将合法的请求发送给 handlers 依次执行。
 
 在 WeRobot 中我们把请求分成了 Message 和 Event 两种类型,针对两种类型的请求分别有不同的 Handler。
 
-======================  =================
-修饰符                   类型
-======================  =================
-robot.text              文本 (Message)
-robot.image             图像 (Message)
-robot.location          位置 (Message)
-robot.link              链接 (Message)
-robot.voice             语音 (Message)
-robot.unknown           未知类型 (Message)
-robot.subscribe         被关注 (Event)
-robot.unsubscribe       被取消关注 (Event)
-robot.click             自定义菜单事件 (Event)
-robot.view              链接 (Event)
-robot.scancode_push     扫描推送 (Event)
-robot.scancode_waitmsg  扫描弹消息 (Event)
-robot.location_event    上报位置 (Event)
-robot.unknown_event     未知类型 (Event)
-======================  =================
+======================================  =================
+修饰符                                   类型
+======================================  =================
+robot.text                              文本 (Message)
+robot.image                             图像 (Message)
+robot.location                          位置 (Message)
+robot.link                              链接 (Message)
+robot.voice                             语音 (Message)
+robot.unknown                           未知类型 (Message)
+robot.subscribe                         被关注 (Event)
+robot.unsubscribe                       被取消关注 (Event)
+robot.click                             自定义菜单事件 (Event)
+robot.view                              链接 (Event)
+robot.scancode_push                     扫描推送 (Event)
+robot.scancode_waitmsg                  扫描弹消息 (Event)
+robot.pic_sysphoto                      弹出系统拍照发图（Event）
+robot.pic_photo_or_album                弹出拍照或者相册发图（Event）
+robot.pic_weixin                        弹出微信相册发图器（Event）
+robot.location_select                   弹出地理位置选择器（Event）
+robot.scan                              已关注扫描二维码（Event）
+robot.user_scan_product                 打开商品主页事件推送（Event）
+robot.user_scan_product_enter_session   进入公众号事件推送（Event）
+robot.user_scan_product_async           地理位置信息异步推送（Event)
+robot.user_scan_product_verify_action   商品审核结果推送（Event）
+robot.location_event                    上报位置 (Event)
+robot.unknown_event                     未知类型 (Event)
+======================================  =================
 
 额，这个 handler 想处理文本信息和地理位置信息？ ::