- Rust 99.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
The Client::send_stanza method blocks on the stanza actually being sent over the stream. Without this change, the method will never return on streams without XEP-0198 Stream Management because `sm_state` is then None and thus the StanzaToken's state is never advanced: it would be stuck in Queued state. In addition, a lack of advancement to Sent state may cause a deadlock on XEP-0198-enabled streams if data is received so fast that the frontend_tx mpsc::Sender in the stanzastream::Worker is filled up. In such a case, the Worker cannot obtain a permit and will only service writes. However, that will mean that no StanzaTokens can be advanced beyond Queued state, because for that, reads need to be serviced (to receive the SM acks). If a burst of stanzas is then received while Client::send_stanza is being awaited, send_stanza can only return if something reads from the frontend mpsc in the meantime. We do not want to require user code to drive the Client in full-duplex mode, hence this is a bug. skip-changelog, because this fixes an unreleased feature. |
||
| .forgejo/workflows | ||
| jid | ||
| minidom | ||
| parsers | ||
| sasl | ||
| tokio-xmpp | ||
| xmpp | ||
| xso | ||
| xso-proc | ||
| .gitea | ||
| .github | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| Cargo.toml | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.md | ||
xmpp-rs
What's this?
A very much WIP set of rust XMPP library with the goals of being type-safe and well-tested.
xmpp-rsprovides a high-level API for the protocol. You shouldn't need to know about the protocol to use it.tokio-xmppis a lower-level library that handles the XMPP stream(s).xmpp-parsersparses XML into Rust and back.minidomis a DOM library quite specific for XMPPjidis a Jid parsing library.
Contact
There is an XMPP MUC for the discussion of this library, feel free to join! :)
Community
A Code of Conduct is available as CODE_OF_CONDUCT.md in the repository for the well-being of the community. Please refer to it in case of a possible conflict in any of the xmpp-rs venues (channel, forge, etc.).
License
Mozilla Public License 2 (MPL2). See the LICENSE file.
Building
Dependencies should be provided by crates if you use the default features. If
you use tokio-xmpp's tls-native feature you will need an ssl library
(openssl, libressl, etc.).
cargo build
The various features available should be explained in the crates themselves.
Contributing
Thank you for your interest in the project!
Contributing rules are available as CONTRIBUTING.md in the repository.