https://github.com/tesaguri/twitter-stream-rs
A Rust library for listening on Twitter Streaming API.
https://github.com/tesaguri/twitter-stream-rs
rust rust-library twitter twitter-api twitter-streaming-api
Last synced: 3 months ago
JSON representation
A Rust library for listening on Twitter Streaming API.
- Host: GitHub
- URL: https://github.com/tesaguri/twitter-stream-rs
- Owner: tesaguri
- License: mit
- Created: 2016-12-22T12:57:53.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-11-14T10:28:05.000Z (over 3 years ago)
- Last Synced: 2024-11-24T09:28:44.473Z (8 months ago)
- Topics: rust, rust-library, twitter, twitter-api, twitter-streaming-api
- Language: Rust
- Homepage:
- Size: 578 KB
- Stars: 69
- Watchers: 3
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Twitter Stream
[](https://github.com/tesaguri/twitter-stream-rs/actions)
[](https://crates.io/crates/twitter-stream)
[](https://docs.rs/twitter-stream/)A Rust library for listening on Twitter Streaming API.
## Usage
Add this to your `Cargo.toml`:
```toml
[dependencies]
futures = "0.3"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
twitter-stream = "0.13"
```Here is a basic example that prints public mentions to @Twitter in JSON format:
```rust no_run
use futures::prelude::*;
use twitter_stream::{Token, TwitterStream};#[tokio::main]
async fn main() {
let token = Token::from_parts("consumer_key", "consumer_secret", "access_key", "access_secret");TwitterStream::track("@Twitter", &token)
.try_flatten_stream()
.try_for_each(|json| {
println!("{}", json);
future::ok(())
})
.await
.unwrap();
}
```## Alternatives
[`egg-mode`], a Twitter API client crate, implements a Streaming API client as well. The following table shows key differences between `twitter-stream` and `egg-mode`.
[`egg-mode`]: https://crates.io/crates/egg-mode
| | `twitter-stream` | `egg-mode` |
| ------------------------ | ------------------------------------------------ | -------------------------------------- |
| Streaming message type | `string::String` (raw JSON string) | `StreamMessage` (deserialized message) |
| REST API integration | No | Yes |
| Customizable HTTP client | Yes | No |If your application don't require explicit control over the raw JSON strings or underlying HTTP client, `egg-mode` may be a better choice.
## License
This project is licensed under the MIT license ([LICENSE](LICENSE) or https://opensource.org/licenses/MIT) unless explicitly stated otherwise.