headstock

If you're looking for a Python library to handle XMPP protocol and extensions, headstock might be worth checking out. Not only does the library offer a range of useful features, but the source code also comes with a simple chat example to show how to use headstock effectively.

It's worth highlighting that the chat example is not GUI bound, it's just there to demonstrate how to set up and use headstock. Assuming you've installed the required dependencies, you can register a new user or sign in by using the simplechat.py script. The following command can register a new user if the server supports XEP-0077 of in-band registration:

python simplechat.py -u username -p password -d XMPPdomain -a hostname:port --register

Alternatively, to sign in, use the following command:

python simplechat.py -u username -p password -d XMPPdomain -a hostname:port

While installing ejabberd before can be beneficial, as headstock recommends, it's good to note that the library can be even run as a regular user in a home directory. Finally, you might want to try to connect to Google Talk and send a message to a contact by typing the console: contact_email a message.

Overall, headstock proves to be a powerful library for handling XMPP protocol and extensions. Its simple chat example particularly stands out, clearly illustrating how to start using the library effectively.