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

Project details


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 details)

Uploaded Source

File details

Details for the file xmpppy-0.6.1.tar.gz.

File metadata

  • Download URL: xmpppy-0.6.1.tar.gz
  • Upload date:
  • Size: 66.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.6

File hashes

Hashes for xmpppy-0.6.1.tar.gz
Algorithm Hash digest
SHA256 48549adb7493facd85114c5cab9312e680417281a08038378306d371d791ea31
MD5 d189ce0c590fba82a0c2ab78a9fd4bb8
BLAKE2b-256 253442f1966f5c2ec33dc201d70ae71c255d510ef32288112e1b4c801aa9c011

See more details on using hashes here.

Provenance

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