Eine Reihe von Rust-Kisten (Bibliotheken) für die Interaktion mit dem Matrix-Chat-Netzwerk.
Website • Chat • Dokumentation (instabil)
Wenn Sie einen Matrix-Client oder -Bot erstellen möchten, schauen Sie sich Matrix-Rust-SDK an. Es baut auf ruma auf und umfasst die Verwaltung der Statusspeicherung, die Ende-zu-Ende-Verschlüsselung und viele andere nützliche Dinge.
Für Homeserver, Bridges und schwieriger zu kategorisierende Software, die mit Matrix funktioniert, sind Sie hier richtig. Fügen Sie zunächst ruma
zu Ihren Abhängigkeiten hinzu:
# crates.io release
ruma = { version = " 0.11.0 " , features = [ " ... " ] }
# git dependency
ruma = { git = " https://github.com/ruma/ ruma " , branch = " main " , features = [ " ... " ] }
Alle anderen Kisten werden ruma
wieder exportiert, so dass Sie sich als Nutzer keine Sorgen darüber machen müssen. Sehen Sie sich die Dokumentation zu docs.rs an (oder zu docs. ruma , wenn Sie die Git-Abhängigkeit verwenden).
Eine kleine Anzahl von Beispielen finden Sie auch in unserem speziellen Beispiel-Repository.
ruma 0.11.0 unterstützt alle Ereignisse und REST-Endpunkte von Matrix 1.12.
Verschiedene Änderungen gegenüber in Bearbeitung befindlichen oder abgeschlossenen MSCs werden ebenfalls implementiert und hinter den Cargo-Funktionen unstable-mscXXXX
(wobei XXXX
die MSC-Nummer ist) eingeblendet.
Hinter der unstable-unspecified
Cargo-Funktion verbergen sich ein paar weniger formalisierte Dinge.
Siehe CONTRIBUTING.md.
ruma benötigt derzeit Rust 1.75. Im Allgemeinen werden wir niemals Beta- oder Nightly-Versionen für crates.io-Releases unserer Crates benötigen, und wir werden versuchen, die Veröffentlichung von Crates zu vermeiden, die von Funktionen abhängen, die gerade erst stabilisiert wurden.
Eine Ausnahme bildet ruma -signatures
: Es verwendet kryptografische Bibliotheken, die häufig relativ neue Funktionen verwenden und von denen wir keine veralteten Versionen verwenden möchten. Es ist jedoch garantiert, dass es mit der neuesten stabilen Version funktioniert.
MIT