Metadata-Version: 1.0
Name: peony-twitter
Version: 0.5.4
Summary: An asynchronous Twitter API client for Python
Home-page: https://github.com/odrling/peony-twitter
Author: Florian Badie
Author-email: florianbadie@gmail.com
License: MIT License
Description: Peony
        =====
        
        An asynchronous Twitter API client for Python
        
        Installation
        ------------
        
        To install this module simply run::
        
            pip install peony-twitter
        
        .. highlighting: python
        
        Getting started
        ---------------
        
        .. highlighting: python
        
        You can easily create a client using the class `PeonyClient`.
        Make sure to get your api keys and access tokens from
        `Twitter's application management page`_ and/or to `Authorize your client`_
        
        *Note: the package name is peony and not peony-twitter*
        
        .. code-block:: python
        
            import asyncio
        
            # Note: the package name is peony and not peony-twitter
            from peony import PeonyClient
        
            loop = asyncio.get_event_loop()
        
            # create the client using your api keys
            client = PeonyClient(consumer_key=YOUR_CONSUMER_KEY,
                                 consumer_secret=YOUR_CONSUMER_SECRET,
                                 access_token=YOUR_ACCESS_TOKEN,
                                 access_token_secret=YOUR_ACCESS_TOKEN_SECRET)
        
            # this is a coroutine
            req = client.api.statuses.update.post(status="I'm using Peony!!")
        
            # run the coroutine
            loop.run_until_complete(req)
        
        .. _Twitter's application management page: https://apps.twitter.com
        
        .. _Authorize your client: #authorize-your-client
        
        Authorize your client
        ---------------------
        
        You can use ``peony.oauth_dance`` to authorize your client:
        
        .. code-block:: python
        
            >>> from peony.oauth_dance import oauth_dance
            >>> tokens = oauth_dance(YOUR_CONSUMER_KEY, YOUR_CONSUMER_SECRET)
            >>> from peony import PeonyClient
            >>> client = PeonyClient(**tokens)
        
        This should open a browser to get a pin to authorize your application.
        
        Documentation
        -------------
        
        Read Peony's documentation at https://peony-twitter.readthedocs.io.
        
Keywords: twitter,asyncio,asynchronous
Platform: UNKNOWN
