A set of Rust libraries to interact with Telegram's API, hence the name (tele)gramme.rs.
It works! You can access Telegram's API and handle updates, but the internals are a bit rough and need a lot of work. We're still looking for a nice solid interface on all the public methods.
For an up-to-date taste on how the library looks like, refer to the client examples folder.
For more documentation, please refer to https://docs.rs/grammers-client/.
The following libraries under lib/ can be used to work with Telegram in some way:
- grammers-client: high-level API.
- grammers-crypto: cryptography-related methods.
- grammers-mtproto: implementation of the Mobile Transport Protocol.
- grammers-mtsender: network connection to Telegram.
- grammers-session: session storages for the client.
- grammers-tl-gen: Rust code generator from TL definitions.
- grammers-tl-parser: a Type Language parser.
- grammers-tl-types: generated Rust types for a certain layer.
The following auxiliary CLI tools are available in the bin/ folder:
- scrape-docs: scrape Telegram's website to obtain raw API documentation.
- tl-to-json: tool to read
.tland output.json, equivalent to Telegram's JSON schema.
All the libraries and binaries contained in this repository are licensed under either of
-
Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
-
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.