mattrasband / littlebird

Modern TwitterClient supporting the latest Python3.6+ features

littlebird

LittleBird is a Python 3.6+ asynchronous library for accessing twitter utilizing new python features: async generators, type hinting, etc.

Usage

Currently only the oauth1 methods are supported (application only authentication, user account access).

import asyncio
import contextlib

from littlebird import LittleBird

little_bird = LittleBird(
    # required for oauth1 signing:
    consumer_key: str,
    consumer_secret: str,
    # optionally necessary for endpoints requiring a user's scope:
    access_token: Optional[str] = None,
    access_token_secret: Optional[str] = None
)

async def main(little_bird):
    # watch the random sampling of tweets chosen by twitter
    async for tweet in little_bird.sample():
        print(tweet)

if __name__ == '__main__':
    loop = asyncio.get_event_loop()
    with contextlib.suppress(KeyboardInterrupt):
        loop.run_until_complete(main(little_bird))