tele 0.1.14

Ergonomic Telegram Bot API SDK for Rust, built on reqx
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# tele

Ergonomic Telegram Bot API SDK and bot runtime toolkit for Rust, powered by `reqx`.

## Recommended Stable Surface

- `client.app()` / `context.app()`: primary runtime surface for business code such as text/media sends, replies, callbacks, Web App replies, moderation flows, and membership/capability checks.
- `client.control()`: startup/setup/orchestration surface for bootstrap, router preparation, and outbox management.
- `client.raw()` / `client.typed()` / `client.advanced()`: lower-level escape hatches when the high-level facades are intentionally not enough.

## Minimal Async Example

```rust,no_run
use tele::Client;
use tele::types::ParseMode;

#[tokio::main]
async fn main() -> Result<(), tele::Error> {
    let client = Client::builder("https://api.telegram.org")?
        .bot_token("123456:telegram-bot-token")?
        .build()?;

    let _sent = client
        .app()
        .text(123456789_i64, "hello from tele")?
        .parse_mode(ParseMode::MarkdownV2)
        .send()
        .await?;

    Ok(())
}
```

With `feature = "bot"`, prefer `context.app()` inside handlers and `client.control()` for startup/bootstrap/outbox orchestration.

For richer runtime flows, prefer `client.app().photo()/document()/video()` for media sends and `client.app().membership()` for install/bind capability checks before reaching for raw request structs.

Project guide, full API layer examples, and bot runtime examples are in the workspace root `README.md` and the `examples/` directory.