Metadata-Version: 1.1
Name: wechat-sender
Version: 0.0.3
Summary: 将程序运行结果及报警信息通过微信发送给你自己
Home-page: https://github.com/bluedazzle/wechat_sender
Author: RaPoSpectre
Author-email: rapospectre@gmail.com
License: BSD
Description: Wechat\_Sender
        ==============
        
        将程序运行结果及报警信息通过微信发送给你自己
        
        简介
        ----
        
        wechat\_sender 是基于 `wxpy`_ 和 `tornado`_
        实现的一个可以将你的网站、爬虫、脚本等其他应用中各种消息
        （日志、报警、运行结果等） 发给你的个人微信的工具
        
        初衷
        ----
        
        wxpy 基于 itchat 提供了较为完备的微信个人号 API
        ，而我想使用个人微信来接收我的网站的报警信息以及一些爬虫的结果，因此我写了这个工具。
        
        安装
        ----
        
        .. code:: python
        
            pip install wechat_sender
        
        运行环境
        --------
        
        | Python 2.7 及以上
        | Python 3 及以上
        
        使用
        ----
        
        如果你是 wxpy 的使用者，只需更改一句即可使用 wechat\_sender：
        
        例如这是你本来的代码：
        
        .. code:: python
        
            # coding: utf-8
            from __future__ import unicode_literals
        
            from wxpy import *
            bot = Bot('bot.pkl')
        
            my_friend = bot.friends().search('xxx')[0]
        
            my_friend.send('Hello WeChat!')
        
            @bot.register(Friend)
            def reply_test(msg):
                msg.reply('test')
        
            bot.join()
        
        使用 wechat\_sender：
        
        .. code:: python
        
            # coding: utf-8
            from __future__ import unicode_literals
        
            from wxpy import *
            from wechat_sender import listen
            bot = Bot('bot.pkl')
        
            my_friend = bot.friends().search('xxx')[0]
        
            my_friend.send('Hello WeChat!')
        
            @bot.register(Friend)
            def reply_test(msg):
                msg.reply('test')
        
            listen(bot) # 只需改变最后一行代码
        
        之后如果你想在其他地方发送微信消息给你自己，只需要：
        
        .. code:: python
        
            # coding: utf-8
            from wechat_sender import send
            send("test message")
        
        API
        ---
        
        **wechat\_sender.listen(bot, receiver, token, port)**
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        **参数**
        ~~~~~~~~
        
        -  bot(\ *必填*\ \|Bot对象)-wxpy 的 Bot 对象实例
        -  receiver(\ *可选*\ \|Chat 对象)-接收消息，wxpy 的 Chat 对象实例,
           不填为当前 bot 对象的文件接收者
        -  token(\ *可选*\ \|string)- 信令，防止 receiver 被非法滥用，建议加上
           token 防止非法使用，如果使用 token 请在 send 时也使用统一
           token，否则无法发送。token 建议为 32 位及以上的无规律字符串
        -  port(\ *可选*\ \|integer)- 监听端口, 监听端口默认为 10245
           ，如有冲突或特殊需要请自行指定，需要和 send 处统一
        
        **wechat\_sender.send(message, token, port)**
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        **参数**
        ~~~~~~~~
        
        -  message(\ *必填*\ \|string)-需要发送的消息，目前只支持文本消息
        -  token(\ *可选*\ \|string)-信令，如果不为空请保持和 listen 中的 token
           一致
        -  port(\ *可选*\ \|integer)-发送端口，如果不为空请保持和 listen 中的
           port 一致
        
        TODO LIST
        ---------
        
        -  [ ] wxpy 掉线邮件通知
        -  [ ] wxpy 掉线重连
        
        历史
        ----
        
        **当前版本： 0.0.2**
        
        2017.05.17 0.0.2:
        
        优化代码
        
        2017.05.11 0.0.1:
        
        发布初版
        
        .. _wxpy: https://github.com/youfou/wxpy
        .. _tornado: https://github.com/tornadoweb/tornado
Keywords: Wechat,微信,监控
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Operating System :: OS Independent
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Utilities
