Un ensemble de caisses Rust (bibliothèques) pour interagir avec le réseau de discussion Matrix.
site web • chat • documentation (instable)
Si vous souhaitez créer un client ou un bot Matrix, jetez un œil à Matrix-rust-sdk. Il s'appuie sur ruma et inclut la gestion du stockage d'état, le cryptage de bout en bout et bien d'autres choses utiles.
Pour les serveurs domestiques, les ponts et les logiciels plus difficiles à catégoriser qui fonctionnent avec Matrix, vous êtes au bon endroit. Pour commencer, ajoutez ruma
à vos dépendances :
# crates.io release
ruma = { version = " 0.11.0 " , features = [ " ... " ] }
# git dependency
ruma = { git = " https://github.com/ruma/ ruma " , branch = " main " , features = [ " ... " ] }
ruma
réexporte toutes les autres caisses, vous n'avez donc pas à vous en soucier en tant qu'utilisateur. Consultez la documentation sur docs.rs (ou sur ruma .dev si vous utilisez la dépendance git).
Vous pouvez également trouver un petit nombre d’exemples dans notre référentiel d’exemples dédié.
ruma 0.11.0 prend en charge tous les événements et points de terminaison REST de Matrix 1.12.
Diverses modifications apportées aux MSC en cours ou terminés sont également implémentées, protégées par les fonctionnalités Cargo unstable-mscXXXX
(où XXXX
est le numéro MSC).
Quelques éléments moins formalisés sont cachés derrière la fonctionnalité Cargo unstable-unspecified
.
Voir CONTRIBUTION.md.
ruma nécessite actuellement Rust 1.75. En général, nous n'exigerons jamais la version bêta ou nocturne pour les versions crates.io de nos caisses, et nous essaierons d'éviter de publier des caisses qui dépendent de fonctionnalités qui viennent tout juste d'être stabilisées.
ruma -signatures
est une exception : il utilise des bibliothèques cryptographiques qui utilisent souvent des fonctionnalités relativement nouvelles et dont nous ne voulons pas utiliser de versions obsolètes. Il est cependant garanti qu'il fonctionnera avec la dernière version stable.
MIT