Rust Telegram Bot 库

用于编写您自己的 Telegram 机器人的库。更多信息 这里。官方 API 这里。

示例

以下是一个简单的示例（见 example/simple.rs）

use std::env;

use futures::StreamExt;
use telegram_bot::*;

#[tokio::main]
async fn main() -> Result<(), Error> {
    let token = env::var("TELEGRAM_BOT_TOKEN").expect("TELEGRAM_BOT_TOKEN not set");
    let api = Api::new(token);

    // Fetch new updates via long poll method
    let mut stream = api.stream();
    while let Some(update) = stream.next().await {
        // If the received update contains a new message...
        let update = update?;
        if let UpdateKind::Message(message) = update.kind {
            if let MessageKind::Text { ref data, .. } = message.kind {
                // Print received text message to stdout.
                println!("<{}>: {}", &message.from.first_name, data);

                // Answer message with "Hi".
                api.send(message.text_reply(format!(
                    "Hi, {}! You just wrote '{}'",
                    &message.from.first_name, data
                )))
                .await?;
            }
        }
    }
    Ok(())
}

更大的示例可以在 examples 中找到。

使用方法

此库可通过 crates.io 获取。要使用它，只需将其添加到您的 Cargo.toml

telegram-bot = "0.7"

此库允许您轻松地进行机器人的端到端测试：只需指定 TELEGRAM_API_URL 环境变量，将其指向您的伪造 Telegram 测试服务器。可以使用 tracing 框架收集大量诊断信息，见 example/tracing.rs）。

协作

请！所有类型的贡献都受欢迎：创建问题、修改代码或提出建议。不知道从哪里开始？标记为 up for grab 的问题非常适合入门。