Metadata-Version: 1.2
Name: fbchat-asyncio
Version: 0.6.6
Summary: Facebook Messenger library for Python/Asyncio.
Home-page: https://github.com/tulir/fbchat-asyncio
Author: Tulir Asokan
Author-email: tulir@maunium.net
License: UNKNOWN
Description: ``fbchat`` - Facebook Messenger for Python
        ==========================================
        
        .. image:: https://badgen.net/pypi/v/fbchat-asyncio
            :target: https://pypi.python.org/pypi/fbchat-asyncio
            :alt: Project version
        
        .. image:: https://badgen.net/badge/python/3.6,3.7,3.8?list=|
            :target: https://pypi.python.org/pypi/fbchat
            :alt: Supported python versions: 3.6, 3.7 and 3.8
        
        .. image:: https://badgen.net/pypi/license/fbchat
            :target: https://github.com/tulir/fbchat-asyncio/tree/master/LICENSE
            :alt: License: BSD 3-Clause
        
        A powerful and efficient library to interact with
        `Facebook's Messenger <https://www.facebook.com/messages/>`__, using just your email and password.
        This is an asyncio fork of the `fbchat <https://github.com/carpedm20/fbchat>`__ library.
        
        This is *not* an official API, Facebook has that `over here <https://developers.facebook.com/docs/messenger-platform>`__ for chat bots. This library differs by using a normal Facebook account instead.
        
        ``fbchat`` currently support:
        
        - Sending many types of messages, with files, stickers, mentions, etc.
        - Fetching all messages, threads and images in threads.
        - Searching for messages and threads.
        - Creating groups, setting the group emoji, changing nicknames, creating polls, etc.
        - Listening for, an reacting to messages and other events in real-time.
        - Type hints, and it has a modern codebase (e.g. only Python 3.5 and upwards).
        - ``async``/``await`` (COMING).
        
        Essentially, everything you need to make an amazing Facebook bot!
        
        
        Version Warning
        ---------------
        ``v2`` is currently being developed at the ``master`` branch and it's highly unstable. If you want to view the old ``v1``, go `here <https://github.com/carpedm20/fbchat/tree/v1>`__.
        
        Additionally, you can view the project's progress `here <https://github.com/carpedm20/fbchat/projects/2>`__.
        
        
        Caveats
        -------
        
        ``fbchat`` works by imitating what the browser does, and thereby tricking Facebook into thinking it's accessing the website normally.
        
        However, there's a catch! **Using this library may not comply with Facebook's Terms Of Service!**, so be responsible Facebook citizens! We are not responsible if your account gets banned!
        
        Additionally, **the APIs the library is calling is undocumented!** In theory, this means that your code could break tomorrow, without the slightest warning!
        If this happens to you, please report it, so that we can fix it as soon as possible!
        
        .. inclusion-marker-intro-end
        .. This message doesn't make sense in the docs at Read The Docs, so we exclude it
        
        With that out of the way, you may go to `Read The Docs <https://fbchat.readthedocs.io/>`__ to see the full documentation!
        
        .. inclusion-marker-installation-start
        
        
        Installation
        ------------
        
        .. code-block::
        
            $ pip install fbchat
        
        If you don't have `pip <https://pip.pypa.io/>`_, `this guide <http://docs.python-guide.org/en/latest/starting/installation/>`_ can guide you through the process.
        
        You can also install directly from source, provided you have ``pip>=19.0``:
        
        .. code-block::
        
            $ pip install git+https://github.com/carpedm20/fbchat.git
        
        .. inclusion-marker-installation-end
        
        
        Example Usage
        -------------
        
        .. code-block::
        
            import getpass
            import fbchat
            session = fbchat.Session.login("<email/phone number>", getpass.getpass())
            user = fbchat.User(session=session, id=session.user_id)
            user.send_text("Test message!")
        
        More examples are available `here <https://github.com/carpedm20/fbchat/tree/master/examples>`__.
        
        
        Maintainer
        ----------
        
        - Mads Marquart / `@madsmtm <https://github.com/madsmtm>`__
        
        
        Acknowledgements
        ----------------
        
        This project was originally inspired by `facebook-chat-api <https://github.com/Schmavery/facebook-chat-api>`__.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Framework :: AsyncIO
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: ~=3.6
