Skip to main content

XMPP implementation in Python for Jabber instant messaging.

Project description

Python 2/3 implementation of XMPP (RFC3920, RFC3921).


Documentation: http://xmpppy.sf.net/

Source Code: https://github.com/xmpppy/xmpppy

Status:

https://img.shields.io/badge/Python-2.7,%203.8-green.svg https://img.shields.io/pypi/v/xmpppy.svg https://img.shields.io/github/tag/xmpppy/xmpppy.svg

About

This library has been written to be compliant with RFC3920 and RFC3921.

Installation

If you are using Debian, you can simply run:

apt-get install python-xmpp

Otherwise, you might want to use pip:

pip install xmpppy

Usage

Regularly, the module is used as a library, like:

jabberid = "foobar@jabber.example.org"
password = "secret"
receiver = "bazqux@jabber.example.org"
message  = "☠☠☠ hello world ☠☠☠"

jid = xmpp.protocol.JID(jabberid)
connection = xmpp.Client(server=jid.getDomain(), debug=debug)
connection.connect()
connection.auth(user=jid.getNode(), password=password, resource=jid.getResource())
connection.send(xmpp.protocol.Message(to=receiver, body=message))

However, the module also installs a basic example program called xmpp-message, which can be invoked from the command line. Its synopsis is:

xmpp-message --debug \
    --jabberid foobar@jabber.example.org --password secret \
    --receiver bazqux@jabber.example.org --message '☠☠☠ hello world ☠☠☠'

Documentation

For learning about how to use this module, please have a look at these spots.

  • The xmpp/cli.py example program.

  • The doc/examples directory. You might want to look at basic.py and demo.py first before investigating the other examples.

  • The HTML pages on http://xmpppy.sf.net/.

  • The docstrings.

Support

If you have any questions about xmpppy usage or you have found a bug or want to share some ideas - you are welcome to join us on the issue tracker or on the xmpppy-devel mailing list.

Other projects

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xmpppy-0.6.1.tar.gz (66.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page