mirror of
https://github.com/matrix-org/matrix-rust-sdk.git
synced 2026-05-15 19:45:34 -04:00
de09b781ec
Imagine the room list has the viewport set to the range `0..=19`. The user scrolls quickly to `50..=69` to see something below and immediately scrolls back to its initial position, without stopping the scroll at any moment in between. The app using this API might update the viewport from `0..=19` to… `0..=19`. Updating the viewport, updates the `visible_rooms` sliding sync list. Since a list is modified, the current sync-loop iteration is skipped over and a new one restarts, i.e. the current in-flight request is cancelled… for nothing. This patch prevents this situation. The current viewport ranges is stored in `RoomListService`. `RoomListService::apply_input` used to return `Result<(), Error>`, now it returns `Result<InputResult, Error>`. The `InputResult` enum is a new type. It represents whether an input has been applied or ignored, which must be differentiate from errors. So now, if the viewport changes and it's not different from the previous value, `InputResult::Ignored` is returned.
matrix-rust-sdk
matrix-rust-sdk is an implementation of a Matrix client-server library in Rust.
Project structure
The rust-sdk consists of multiple crates that can be picked at your convenience:
- matrix-sdk - High level client library, with batteries included, you're most likely interested in this.
- matrix-sdk-base - No (network) IO client state machine that can be used to embed a Matrix client in your project or build a full fledged network enabled client lib on top of it.
- matrix-sdk-crypto - No (network) IO encryption state machine that can be used to add Matrix E2EE support to your client or client library.
Minimum Supported Rust Version (MSRV)
These crates are built with the Rust language version 2021 and require a minimum compiler version of 1.70.
Status
The library is in an alpha state, things that are implemented generally work but the API will change in breaking ways.
If you are interested in using the matrix-sdk now is the time to try it out and provide feedback.
Bindings
Some crates of the matrix-rust-sdk can be embedded inside other
environments, like Swift, Kotlin, JavaScript, Node.js etc. Please,
explore the bindings/ directory to learn more.