Crate trovo

Expand description

A Rust api & chat client for Trovo.

It currently doesn’t support all of the trovo api, feel free to open a PR adding new endpoints.

Example

Find a user by username and then connect to their chat.

use futures::prelude::*;
use std::{env, error::Error};
use trovo::ClientId;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let client_id = env::var("CLIENT_ID").expect("missing CLIENT_ID env var");
    let username = env::var("USER_NAME").expect("missing USER_NAME env var");

    let client = trovo::Client::new(ClientId::new(client_id));

    println!("looking up user '{}'", username);
    let user = client
        .user(username)
        .await?
        .expect("no user found for the given username");
    println!("found user {:#?}", user);

    let mut messages = client.chat_messages_for_channel(&user.channel_id).await?;
    println!("listening for chat messages");
    while let Some(msg) = messages.next().await {
        let msg = msg?;
        println!("[{}] {}", msg.nick_name, msg.content);
    }

    Ok(())
}

Modules

chat

Chat

Structs

AccessTokenExpired

Error returned by AccessTokenOnly when refresh_token is called.

AccessTokenOnly

A simple access token provider that errors if refreshing is attempted. It is strongly advised that you implement your own AccessTokenProvider so that you can handle refreshing.

ApiError

Struct representing errors that trovo api responds with.

ChannelEmotes

Channel id and its emotes

ChannelInfo

Response for the get users api

ChannelUpdate

Fields to update on a channel

ChannelUpdatePayload

Payload for the channel update endpoint

Client

Entrypoint for making requests to the Trovo api.