15 unstable releases (7 breaking)

0.8.0 Nov 14, 2020
0.7.0 Mar 21, 2020
0.6.3 Jul 17, 2019
0.6.1 Feb 17, 2018
0.1.2 Jul 30, 2015

#2 in #chat

Download history 327/week @ 2020-10-02 688/week @ 2020-10-09 257/week @ 2020-10-16 474/week @ 2020-10-23 326/week @ 2020-10-30 352/week @ 2020-11-06 316/week @ 2020-11-13 343/week @ 2020-11-20 298/week @ 2020-11-27 333/week @ 2020-12-04 309/week @ 2020-12-11 179/week @ 2020-12-18 169/week @ 2020-12-25 245/week @ 2021-01-01 267/week @ 2021-01-08 215/week @ 2021-01-15

1,481 downloads per month
Used in 8 crates (7 directly)

MIT license

250KB
6K SLoC

Rust Telegram Bot Library

Build Status Tests Tests License Crates.io

Documentation: Latest crates.io version master

A library for writing your own Telegram bots. More information here. Official API here.

Example

Here is a simple example (see 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(())
}

You can find a bigger examples in the examples.

Usage

This library is available via crates.io. In order to use it, just add this to your Cargo.toml:

telegram-bot = "0.7"

The library allows you to do E2E-testing of your bot easily: just specify TELEGRAM_API_URL environment variable to point to your fake Telegram test server. A lot of diagnostic information can be collected with tracing framework, see example/tracing.rs).

Collaboration

Yes please! Every type of contribution is welcome: Create issues, hack some code or make suggestions. Don't know where to start? Good first issues are tagged with up for grab.

Dependencies

~7–11MB
~217K SLoC