Telegram client for rust.
This crate use td to call telegram client api. support async api.
[dependencies]
telegram-client = "1.7.*"
Version mapping
telegram-client | td |
---|---|
0.* | master@5587f10 |
The version 1.3
, 1.4
, 1.5
, 1.6
, 1.7
is outdated. the reason you can read
Therefore, if tdlib has not had a new release version, the telegram-client 1.x
version will no longer be maintained. Please use 0.x
and if you used 1.x
you can change your dependency to 0.x
.
A fixed version is recommended, you can read Comparison requirements about the fixed version. Because of cargo's dependency mechanism, if you don't specify a specific version, it will be automatically upgraded, but there is usually a dependency between t and a, and the new version cannot be applied. The current dependencies are as follows:
telegram-client | rtdlib |
---|---|
=0.7.2 | =0.7.2 |
Note that you need tdjson dylib file in your path for building and running your application. See also rtdlib-sys for more details.
fn main() {
let api = Api::default();
let mut client = Client::new(api.clone());
let listener = client.listener();
listener.on_receive(|(api, json)| {
debug!("receive {}", json);
Ok(())
});
client.daemon("telegram-rs");
}
#[tokio::main]
async fn main() {
let api = Api::rasync();
let mut client = Client::new(api.api().clone());
let listener = client.listener();
// listener.on_update_authorization_state...
client.start();
let chat = api.get_chat(GetChat::builder().chat_id(1)).await;
println!("{:#?}", chat);
}
more examples
Most of the events are from td, two events of particular concern.
This event is receive everything from td, returned data type is a json string.
When td returned json can not deserialize, or your event handler returned error. will be call is event.
a sample of event handler returned error
listener.on_proxy(|(api, pxy)| {
debug!("Proxy info => {:?}", pxy);
Err(TGError::new("some error"))
});