pyiks 0.6.0

A Python binding for the iksemel XML/XMPP library.

pyiks

Copyright (c) 2025-2026 Gurer Ozen

pyiks is a Python binding for the iksemel which is an XML parser library for Jabber/XMPP and general XML processing applications written in Rust. Iksemel aims to be easy to use, fast, and usable in resource-constrained environments.

Features

pyiks only provides the DOM and XMPP client interfaces of iksemel at this time.

Usage

Here is a simple example showing parsing and editing:

xml_text = "<doc><a>123</a><b><a>456</a><a>789</a></b></doc>"

doc = pyiks.parse(xml_text)

doc.find_tag("b").first_tag().remove()
doc.find_tag("a").set_attribute("x", "1")

assert str(doc) == '<doc><a x="1">123</a><b><a>789</a></b></doc>'

A basic XMPP client example:

client = pyiks.XmppClient(my_jid, my_password)

# Will complete the negotiation and login process.
# The channel bind response will be returned as the first stanza.
stanza = client.wait_for_stanza()

client.send_message(to_jid, "hello!")

License

Iksemel is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Iksemel is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with Iksemel. If not, see https://www.gnu.org/licenses/.