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 标签的问题非常适合入门。