weixin2py

KO | EN

gitlite — search

#python #hacktoberfest #typescript #llm #go #golang #rust #macos #nodejs #windows #cli #vue #security #open-source

(★ 123)

weixin2py-腾讯微信公众平台自动消息处理程序+SDK（python+django）

weixin2py Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

weixin2py--微信公众平台web服务器-0.1.3
---------------------------

##Summary

* 使用python2.7和django(**Demo仅支持大于1.7版本的Django**)开发的微信公众平台服务端程序，可以自动回复用户发来微信的消息。
* 最初的启发来自“武大助手”，类似的平台，提供消息智能回复功能。
* 完全重构了代码，虽然还有很多缺陷但已经完美了很多：）欢迎提出pull request。

##Feature
* 支持可视化的自定义消息回复规则和程序性的消息回复规则 - 使用接口编写即可，通过简单的过程，你也可以集成你的聊天机器人：）
* 文本路由((数据库路由和文件路由) - 使用正则表达式对回复进行匹配。
* 插件支持，你可以用django模板语法定义动态消息回复
* 易于集成 - 单独对django app `weixin2py`，里面有大部分可能用到的工具类和工具函数，需要的时候，新建你的django app，并且在app中使用WeiLib。
* 消息模版 - WeiLil.lib中包含了text_response和pic_text_response函数，传入参数可以在任意view或者handler中使用.
* 缓存session - 为增加诸如“谁是卧底”类的应用提供基础，更改你的缓存后端或者更改缓存接口即可.

##FAQ
* 交流QQ群？ - （于是就信手建了一个）416407192
* 调试和测试？ - [下载wei-dev二进制包](https://github.com/winkidney/wei-dev/releases)（图形化测试工具）

##Change Log
* 2015-05-31 - 为Django1.8升级，修改setup.py中的Django版本要求
* 2015-03-05 - 修改所有代码结构，分离weixin2py和demo应用，更新setup.py，现在可以单独安装weixin2py
* 2014-10-10 - 修改版本号为0.0.1，增加setup.py，修改代码结构和说明文档，修改管理界面项目名称
* 2014-06-10 - 修复小bug，更新文档。    
* 2014.05.09 - 2014.05.15 增加路由功能，插件功能。
* 2014.05.08 - 全面重构中
* 2013.xx.xx - first release,多么幼稚的代码

##How To
###INSTALL
+ Requires
  + django >= 1.5
  + python > 2.6

你可以使用如下方式安装python依赖：

```bash
apt-get install python-pip
pip install django
```

yum系系统类似方法安装依赖即可～～    
或

```bash
cd weixin2py
python setup.py install
```
    
接下来,打开你的bash，切换到应用根目录,执行

```bash
cd demo
python rebuild_db.py
```

然后在你的settings.py中编辑TOKEN，改为你自己的TOKEN    
将会自动生成数据库并添加超级用户，用户名admin,密码admin，你可以自行去这个脚本修改默认设定，数据库为了方便起见使用了sqlite    
```bash
sh runserver.sh
```

运行测试服务器（默认工作在80端口）。   
配置完毕后,登陆你的微信公众平台,设定访问地址为:http://yourhost:port/admin/    
微信公众平台的接口URL为http://yourhost:port/weichat/
也可以使用nginx+*cgi,任何你喜欢的方式。提供了脚本ctrl8020.sh来控制fcig模式的启动和关闭。

###Basic Usage
访问http://youhost:port/admin/    
登录，添加消息回复规则即可。    
例如 想对用户发来的文本消息进行匹配，并回复一条文本消息，在管理面板中选择“文本>文本消息回复规则”，根据各个字段的提示进行填写即可。
如下示例图    
用户发来的消息类型 2 回复的消息类型    
####示例：文本2文本 消息回复规则

![添加文本->文本消息回复规则](https://raw.githubusercontent.com/winkidney/weixin2py/master/res/home.jpg)
![添加文本->文本消息回复规则2](https://raw.githubusercontent.com/winkidney/weixin2py/master/res/text2text_1.jpg)

####示例：添加使用插件的   文本2文本  消息回复规则

![使用包含插件功能的文本2文本消息回复规则](https://raw.githubusercontent.com/winkidney/weixin2py/master/res/plugin_test.jpg)

插件消息使用django模板语法进行编写，参见[django模板语法](http://django-14-tkliuxing.readthedocs.org/en/latest/topics/templates.html)    
插件编写参见[插件编写](#插件编写)

##流程说明
![工作流程图](https://raw.githubusercontent.com/winkidney/weixin2py/master/res/flow.jpg)

##APIS

####[插件](id:插件编写)
插件目前仅工作在文本回复阶段，在匹配到消息回复之后，会对回复消息进行以此渲染，渲染所用的信息字典就是插件返回的字典。
每一个插件所返回的字典内容都会被自动合并到一个字典，然后在你的消息回复定义中使用你所返回的字典中的变量即可（当然可以是动态）
####目录结构
插件目录位于weixin2py/plugins/    
目录结构如下
```bash
weixin2py/plugins/    
    |- setting.py - 插件配置文件    
    |- activity.py - 插件实现 （名字可以任意）    
```
####编写
1.在插件目录下新建一个任意名字的py文件，然后根据如下格式写一个名为processor函数，这个函数会接收用户的消息对象作为参数，你可以根据用户的消息动态定义消息回复。  
 
```python
#coding:utf-8

def processor(recv_msg):
    """A processor must return a dict.
       If not ,program will throw the returned result.
    """
    from_user = recv_msg.from_user
    return {'test_plugin': 'only_the test plugin output',
            'from_user': from_user
            }
```    
          
2.启用插件     
打开setting.py，将你的插件导入并编辑plugin_text元组。

```python
import activity
plugin_text = ( activity,
             )
```

3.在消息回复中使用插件定义的内容
![使用包含插件功能的文本2文本消息回复规则](https://raw.githubusercontent.com/winkidney/weixin2py/master/res/plugin_test.jpg)

###handler
handler是拓展这个应用功能的另一种方式，最初开发使用的是这种方式，在没有数据库的情况下也可以正常运作，缺点是数据一旦写死修改很麻烦，适合用来生成动态内容，例如聊天机器人接口，查询接口之类的.
####结构
目前应用内置了两个router，file_router和db_router，执行的优先级是file_router->db_router，handler是file_router才有的结构。    
####编写一个handler
在任意应用目录新建一个handlers.py（只是约定，可以自定义名称），将handler书写到其中。一个典型的handler如下.
  
```python
#coding:utf-8

from weixin2py.utils import text_response

def default_handler(recv_msg):
    #do something
    return text_response(recv_msg, "没有匹配操作，返回默认信息")
```

handler 返回一个text_response或者一个pic_text_response(图文消息回复)，也可以是你自定义的response，要求必须是一个django的HttpResponse实例。   
 
####启用handler
为了启用handler，你需要增加一个匹配模式，打开应用目录下的sample/router.py文件,示例内容如下

```python
#coding:utf-8

import re

from sample.handlers import (help_handler,about_handler,
                            test_handler)

"""
参考信息：
消息类型：text ,event,image, video, link , location,
"""
router_patterns =[
         # 消息类型  消息文字（非文字类型消息留空）  操作函数
         ('text', re.compile('^help$'), help_handler),
         #('text', re.compile('^about$'), about_handler),
         #('text', re.compile('^test$'), test_handler),
         ]
```

将你的handler导入。然后如注释一样添加模式。

####在view中使用handler和router
示例文件：sample/views.py - 仅展现关键逻辑，详情参考具体文件

```python
# coding:utf-8
from django.http import HttpResponse
from django.views.decorators.csrf import csrf_exempt

from weixin2py.routers import base_router, db_router
from .router import router_patterns
from weixin2py import WeiMsg, check_signature
from weixin2py.handlers import default_handler

try:
    from wei_demo.localsettings import TOKEN
except ImportError:
    from wei_demo.settings import TOKEN

# router must be a list of router instance
routers = [base_router, db_router]

@csrf_exempt
def home(request):
    if request.method == 'GET':
        response = HttpResponse()
        if check_signature(request, TOKEN):
            response.write(request.GET.get('echostr'))
            return response
        else:
            response.write('不提供直接访问！')
            return response

if request.method == 'POST':
        # warning: test demo wil not check signature.
        # check_signature(request, TOKEN)
        recv_msg = WeiMsg(request.body)
        for router in routers:
            result = router(recv_msg, router_patterns)
            if isinstance(result, HttpResponse):
                return result
        return default_handler(recv_msg)
```

###Session
使用CPickle和缓存接口实现的一个Session类
```python
class WeiSession(object):
    '''微信助手会话类，用来存储用户的会话状态'''
    def __init__(self, openid): #使用openid获得session，如果已存在则获得现有session，如果没有则生成的新session,缓存键的名称是openid
    
    def set_key(self, key , value): #设定一个键值，类似python字典操作，将会自动保存到会话当中
    
    def get_key(self, key): #取得key，如果不存在则返回空
```

具体的使用请自由发挥

###其他接口/工具类
weixin2py - class: WeiMsg - 从用户发送的消息从获得一个消息实例，自动识别类型并生成相应属性    
weixin2py - function:check_signature(request, token) - 从一个request对象和指定token中验证消息是否合法，合法返回True，不合法返回False    
weixin2py - function:get_token(appid, secretkey) - 返回一个access_token，用于腾讯的其他接口的必要验证

##To Do List
1. 写一个谁是卧底的插件（因为懒散暂时搁置）
2. 更改插件工作流（因为未收集到任何意见暂时搁置）

[博客](http://blog.winkidney.com/)

[My-github](http://github.com/winkidney)

weixin2py

weixin2py Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

weixin2py

weixin2py Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README