https://github.com/rob-blackbourn/jetblack-tweeter

A Python 3.8 asyncio twitter api client supporting multiple HTTP client libraries.
https://github.com/rob-blackbourn/jetblack-tweeter

asyncio python python3 twitter twitter-api

Last synced: 24 days ago
JSON representation

A Python 3.8 asyncio twitter api client supporting multiple HTTP client libraries.

• Host: GitHub
• URL: https://github.com/rob-blackbourn/jetblack-tweeter
• Owner: rob-blackbourn
• Created: 2020-10-03T11:57:35.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2023-05-30T05:34:53.000Z (over 1 year ago)
• Last Synced: 2024-09-16T01:55:17.999Z (about 2 months ago)
• Topics: asyncio, python, python3, twitter, twitter-api
• Language: Python
• Homepage: https://rob-blackbourn.github.io/jetblack-tweeter/
• Size: 938 KB
• Stars: 3
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# jetblack-tweeter

A Python 3.8 asyncio twitter client.

This Twitter client is designed to support arbitrary HTTP clients. There is

currently support for

[bareClient](https://rob-blackbourn.github.io/bareClient/api/bareclient/)

and [aiohttp](https://docs.aiohttp.org/en/stable/index.html).

## Status

This is work in progress, but functional.

There is currently limited support for streaming, statuses and accounts. Only the 1.1 api is currently implemented.

## Installation

Install with `pip`, specifying the HTTP backend you wish to use.

For bareClient:

```bash

pip install jetblack-tweeter[bareclient]

```

For aiohttp:

```bash

pip install jetblack-tweeter[aiohttp]

```

## Usage

Here is an example:

```python

import asyncio

import os

from jetblack_tweeter import Tweeter

from jetblack_tweeter.clients.bareclient import BareTweeterSession

# Get the secrets from environment variables.

APP_KEY = os.environ["APP_KEY"]

APP_KEY_SECRET = os.environ["APP_KEY_SECRET"]

ACCESS_TOKEN = os.environ["ACCESS_TOKEN"]

ACCESS_TOKEN_SECRET = os.environ["ACCESS_TOKEN_SECRET"]

async def main():

    tweeter = Tweeter(

        BareTweeterSession(),

        APP_KEY,

        APP_KEY_SECRET,

        # Optional for user authentication.

        access_token=ACCESS_TOKEN,

        access_token_secret=ACCESS_TOKEN_SECRET

    )

    user_timeline = await tweeter.statuses.user_timeline()

    print(user_timeline)

    account_settings = await tweeter.account.settings()

    print(account_settings)

    account_verify_credentials = await tweeter.account.verify_credentials()

    print(account_verify_credentials)

    # Watch the random sampling of tweets chosen by twitter

    async for tweet in tweeter.stream.sample():

        print(tweet)

    # Stream tweets which have the tag "#python" from New York

    # and San Francisco.

    async for tweet in tweeter.stream.filter(

            track=['#python'],

            locations=[

                ((-122.75, 36.8), (-121.75, 37.8)),

                ((-74, 40), (-73, 41))

            ]

    ):

        print(tweet)

    result = await tweeter.statuses.update('Hello from jetblack-tweeter')

    print(result)

if __name__ == '__main__':

    asyncio.run(main())

```