django-send-messages 1.0.1

A simple API to send messages, includes Yunpian backend and Wechat(weixin) backend.

# django-send-messages A simple API to send messages，follow django mail design. It includes Yunpian backend and Wechat(weixin) backend. You can easily send sms message and wechat message by it. [Yunpian](http://www.yunpian.com) is a great sms cloud service. And [Wechat](https://mp.weixin.qq.com/) is the most famous social network in china.

And it can easily be extended to other sms backend.

Install

`` pip install git+ssh://[e-mail]/hwbuluo/django-send-messages.git ``

Usage

Add sms to your INSTALLED_APPS setting and add an include('sms.urls') at any point in your url-conf.

You can see the testproj for detail.

Enjoy it!

# About Contribution

贡献代码指南

我们非常欢迎大家来贡献代码，我们会向贡献者致以最诚挚的敬意,让我们一起创造出好用的开源云消息接入服务产品。

目前我们只是引入了云片的短信服务，让Django开发者可以很容易的使用云片提供的服务进行短信发送，并提供了测试的mock backend，和接收云片的短信发送成功回执。但是还有一些云片的回调并未处理，具体可以参考[云片文档](http://www.yunpian.com/api/sms.html)，在view.py中进行添加。

我们计划下一步引入微信的sendbackend，可以通过微信公众平台提供的模版消息接口，给指定人员发送消息，欢迎大家参与进来。

一般可以通过在Github上提交[Pull Request](https://github.com/hwbuluo/django-send-messages)来贡献代码。

## Pull Request要求

• 代码规范 遵从pep8，pythonic。

• 代码格式 提交前 请按 pep8 进行格式化。

• 必须添加测试！ - 如果没有测试，那么提交的补丁是不会通过的。

• 创建feature分支 - 最好不要从你的master分支提交 pull request。

• 一个feature提交一个pull请求 - 如果你的代码变更了多个操作，那就提交多个pull请求吧。

• 清晰的commit历史 - 保证你的pull请求的每次commit操作都是有意义的。如果你开发中需要执行多次的即时commit操作，那么请把它们放到一起再提交pull请求。

## 运行测试(Run tests)

You can test the app:

1. setup a virtualenv,and activate it. `` virtualenv –distribute venv `` 2. install the dependency `` pip install -r test-requirements.py `` 3. test it use py.test `` py.test sms/tests.py ``