Um conjunto de caixas Rust (bibliotecas) para interagir com a rede de bate-papo Matrix.
website • chat • documentação (instável)
Se você deseja construir um cliente ou bot Matrix, dê uma olhada em Matrix-Rust-sdk. Ele se baseia no ruma e inclui gerenciamento de armazenamento de estado, criptografia ponta a ponta e muitas outras coisas úteis.
Para servidores domésticos, pontes e softwares difíceis de categorizar que funcionam com Matrix, você está no lugar certo. Para começar, adicione ruma
às suas dependências:
# crates.io release
ruma = { version = " 0.11.0 " , features = [ " ... " ] }
# git dependency
ruma = { git = " https://github.com/ruma/ ruma " , branch = " main " , features = [ " ... " ] }
ruma
reexporta todas as outras caixas, então você não precisa se preocupar com elas como usuário. Confira a documentação em docs.rs (ou em docs. ruma .dev se você usar a dependência git).
Você também pode encontrar um pequeno número de exemplos em nosso repositório de exemplos dedicado.
ruma 0.11.0 suporta todos os eventos e endpoints REST do Matrix 1.12.
Várias alterações de MSCs em andamento ou finalizados também são implementadas, protegidas pelos recursos de carga unstable-mscXXXX
(onde XXXX
é o número do MSC).
Algumas coisas menos formalizadas estão protegidas pelo recurso Cargo unstable-unspecified
.
Consulte CONTRIBUTING.md.
ruma atualmente requer Rust 1.75. Em geral, nunca exigiremos beta ou noturno para lançamentos de nossas caixas no crates.io e tentaremos evitar o lançamento de caixas que dependem de recursos que acabaram de ser estabilizados.
ruma -signatures
é uma exceção: ele usa bibliotecas criptográficas que geralmente usam recursos relativamente novos e dos quais não queremos usar versões desatualizadas. É garantido que funcionará com qualquer que seja a versão estável mais recente.
MIT