Metadata-Version: 2.0
Name: itchat
Version: 1.0.11
Summary: A complete wechat personal account api
Home-page: https://github.com/littlecodersh/ItChat
Author: LittleCoder
Author-email: i7meavnktqegm1b@qq.com
License: MIT
Keywords: wechat itchat api robot weixin personal extend
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: requests

itchat
======

itchat is a open souce wechat api project for personal account.

It enables you to access your personal wechat account through command line.

Here is the `document <https://itchat.readthedocs.org/zh/latest/>`__.

So enjoy:)

**Try:**

You may have a try of the robot based on this project first:

|QRCodeOfRobot|

Here is the `code <https://github.com/littlecodersh/ItChat/tree/robot>`__.

**Installation**

.. code:: bash

    pip install itchat

**Simple uses**

.. code:: python

    import itchat, time

    @itchat.msg_register(['Text', 'Map', 'Card', 'Note', 'Sharing'])
    def text_reply(msg):
        itchat.send('%s: %s'%(msg['Type'], msg['Text']), msg['FromUserName'])

    @itchat.msg_register(['Picture', 'Recording', 'Attachment', 'Video'])
    def download_files(msg):
        fileDir = '%s%s'%(msg['Type'], int(time.time()))
        msg['Text'](fileDir)
        itchat.send('%s received'%msg['Type'], msg['FromUserName'])
        itchat.send('@%s@%s'%('img' if msg['Type'] == 'Picture' else 'fil', fileDir), msg['FromUserName'])

    @itchat.msg_register('Friends')
    def add_friend(msg):
        itchat.add_friend(**msg['Text'])
        itchat.get_contract()
        itchat.send('Nice to meet you!', msg['RecommendInfo']['UserName'])

    @itchat.msg_register('Text', isGroupChat = True)
    def text_reply(msg):
        if msg['isAt']:
            itchat.send(u'@%s\u2005I received: %s'%(msg['ActualNickName'], msg['Content']), msg['FromUserName'])

    itchat.auto_login()
    itchat.run()

**FAQ**

Why I can't send files whose name is encoded in utf8?

That's because of the upload setting of requests, you can put `this file <https://github.com/littlecodersh/ItChat/blob/robot/plugin/config/fields.py>`__ 
into packages/urllib3 of requests package.

**Comments**

If you have any problems or suggestions, you can talk to me in this `issue <https://github.com/littlecodersh/ItChat/issues/1>`__

Or on `gitter <https://badges.gitter.im/littlecodersh/ItChat.svg>`__.

.. |QRCodeOfRobot| image:: http://7xrip4.com1.z0.glb.clouddn.com/ItChat%2FQRCode2.jpg?imageView/2/w/200/


