https://github.com/jpopesculian/twitter-v2-rs

Rust bindings for Twitter API v2
https://github.com/jpopesculian/twitter-v2-rs

authentication oauth2 rust twitter twitter-api

Last synced: about 2 months ago
JSON representation

Rust bindings for Twitter API v2

• Host: GitHub
• URL: https://github.com/jpopesculian/twitter-v2-rs
• Owner: jpopesculian
• Created: 2022-03-12T20:14:06.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-12-13T04:41:59.000Z (over 1 year ago)
• Last Synced: 2024-04-16T15:12:35.986Z (3 months ago)
• Topics: authentication, oauth2, rust, twitter, twitter-api
• Language: Rust
• Homepage: https://docs.rs/twitter-v2/latest
• Size: 140 KB
• Stars: 95
• Watchers: 4
• Forks: 25
• Open Issues: 9
• Metadata Files:
  • Readme: README.md

Lists

• awesome-modern-twitter-api - twitter-v2-rs - Rust bindings for Twitter API v2. (Libraries / Rust)
• awesome-stars - jpopesculian/twitter-v2-rs - Rust bindings for Twitter API v2 (Rust)

README

        
# twitter-v2

[![v2](https://img.shields.io/endpoint?url=https%3A%2F%2Ftwbadges.glitch.me%2Fbadges%2Fv2)](https://developer.twitter.com/en/docs/twitter-api)

Supports all of the Twitter v2 API endpoints, but many remain fairly untested

due to the complexity of the API and time restraints. PRs and Issues are very welcome!

As this repo currently has limited documentation, please check out the amazing [Twitter API v2

Docs](https://developer.twitter.com/en/docs/api-reference-index#twitter-api-v2) for information.

## Features

* **oauth2**: Included by default. See the examples for how to use.

* **native-tls**: Use `native-tls` as TLS backend (default)

* **rustls-tls**: Use `rustls` as TLS backend

## Example

```rust

use twitter_v2::TwitterApi;

use twitter_v2::authorization::{Oauth2Token, BearerToken};

use twitter_v2::query::{TweetField, UserField};

let auth = BearerToken::new(std::env::var("APP_BEARER_TOKEN").unwrap());

let tweet = TwitterApi::new(auth)

    .get_tweet(1261326399320715264)

    .tweet_fields([TweetField::AuthorId, TweetField::CreatedAt])

    .send()

    .await?

    .into_data()

    .expect("this tweet should exist");

assert_eq!(tweet.id, 1261326399320715264);

assert_eq!(tweet.author_id.unwrap(), 2244994945);

assert_eq!(tweet.created_at.unwrap(), datetime!(2020-05-15 16:03:42 UTC));

let auth: Oauth2Token = serde_json::from_str(&stored_oauth2_token)?;

let my_followers = TwitterApi::new(auth)

    .with_user_ctx()

    .await?

    .get_my_followers()

    .user_fields([UserField::Username])

    .max_results(20)

    .send()

    .await?

    .into_data();

```

License: MIT OR Apache-2.0