A type-safe Rust XMPP library.

Find a file

Maxime “pep” Buquet a39a2330aa Some checks are pending Build / lint (push) Waiting to run Details Build / test-stable (push) Blocked by required conditions Details Build / test-nightly (push) Blocked by required conditions Details Revert "tokio-xmpp: rustfmt pass in examples" This reverts commit `46fdd9cdfa`.		2024-06-18 20:32:46 +02:00
.forgejo/workflows
jid	Add more specific `into_*` conversion functions to specific JID subtypes	2024-05-14 17:53:53 +02:00
minidom	xso: create library for streamed XML parsing	2024-06-18 16:54:11 +02:00
parsers	xmpp-parsers: Simplify DataForm creation using constructors	2024-06-18 18:03:09 +02:00
sasl	Fix typos across the codebase (thanks codespell!)	2024-05-14 05:46:02 +00:00
tokio-xmpp	Revert "tokio-xmpp: rustfmt pass in examples"	2024-06-18 20:32:46 +02:00
xmpp	Ignore missing disco#info feature in disco#info responses	2024-06-16 10:52:51 +02:00
xso	xso: make newlines after module comments consistent with other crates	2024-06-18 17:27:27 +02:00
.gitea	Support Github Actions (for a migration to forgejo)	2023-12-03 14:20:51 +00:00
.github	Deny warnings in github/gitea/forgejo CI and act local runner	2024-01-21 13:55:39 +01:00
.gitignore	Hello world!	2019-03-21 18:43:27 +01:00
.gitlab-ci.yml	tokio-xmpp: allow docs build with --all-features	2024-04-23 19:22:04 +02:00
Cargo.toml	parsers: add streamable parsing	2024-06-18 16:54:11 +02:00
CODE_OF_CONDUCT.md	Code of Conduct	2024-01-21 21:50:31 +01:00
CONTRIBUTING.md	CONTRIBUTING: Split in categories	2024-02-02 22:26:00 +01:00
LICENSE	Readd global LICENSE file	2020-02-25 22:13:34 +01:00
README.md	CONTRIBUTING: Split in categories	2024-02-02 22:26:00 +01:00

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-rs provides a high-level API for the protocol. You shouldn't need to know about the protocol to use it.
tokio-xmpp is a lower-level library that handles the XMPP stream(s).
xmpp-parsers parses XML into Rust and back.
minidom is a DOM library quite specific for XMPP
jid is a Jid parsing library.

Contact

There is an XMPP MUC for the discussion of this library, feel free to join! :)

chat@xmpp.rs

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.