Skip to content

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

License

Notifications You must be signed in to change notification settings

winkidney/weixin2py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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二进制包(图形化测试工具)

##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依赖:

apt-get install python-pip
pip install django

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

cd weixin2py
python setup.py install

接下来,打开你的bash,切换到应用根目录,执行

cd demo
python rebuild_db.py

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

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文本 消息回复规则

添加文本->文本消息回复规则 添加文本->文本消息回复规则2

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

使用包含插件功能的文本2文本消息回复规则

插件消息使用django模板语法进行编写,参见django模板语法
插件编写参见插件编写

##流程说明 工作流程图

##APIS

####插件 插件目前仅工作在文本回复阶段,在匹配到消息回复之后,会对回复消息进行以此渲染,渲染所用的信息字典就是插件返回的字典。 每一个插件所返回的字典内容都会被自动合并到一个字典,然后在你的消息回复定义中使用你所返回的字典中的变量即可(当然可以是动态) ####目录结构 插件目录位于weixin2py/plugins/
目录结构如下

weixin2py/plugins/    
    |- setting.py - 插件配置文件    
    |- activity.py - 插件实现 (名字可以任意)    

####编写 1.在插件目录下新建一个任意名字的py文件,然后根据如下格式写一个名为processor函数,这个函数会接收用户的消息对象作为参数,你可以根据用户的消息动态定义消息回复。

#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元组。

import activity
plugin_text = ( activity,
             )

3.在消息回复中使用插件定义的内容 使用包含插件功能的文本2文本消息回复规则

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

#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文件,示例内容如下

#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 - 仅展现关键逻辑,详情参考具体文件

# 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类

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. 更改插件工作流(因为未收集到任何意见暂时搁置)

博客

My-github

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages