######
xmpppy
######
*Python 2/3 implementation of XMPP (RFC3920, RFC3921).*
----
**Documentation**: http://xmpppy.sf.net/
**Source Code**: https://github.com/xmpppy/xmpppy
**Status**:
.. image:: https://img.shields.io/pypi/pyversions/xmpppy.svg
:target: https://pypi.org/project/xmpppy/
.. image:: https://img.shields.io/pypi/v/xmpppy.svg
:target: https://pypi.org/project/xmpppy/
.. image:: https://img.shields.io/pypi/l/xmpppy.svg
:target: https://pypi.org/project/xmpppy/
.. image:: https://img.shields.io/pypi/dm/xmpppy.svg
:target: https://pypi.org/project/xmpppy/
----
*****
About
*****
This library has been written to be compliant with
`RFC3920 <https://datatracker.ietf.org/doc/rfc3920/>`_
and
`RFC3921 <https://datatracker.ietf.org/doc/rfc3921/>`_.
************
Installation
************
Using ``pip``, you can install the package with::
pip install xmpppy --upgrade
*****
Usage
*****
As a library
============
Regularly, the module is used as a library, like::
import xmpp
jabberid = "foobar@xmpp.domain.tld"
password = "secret"
receiver = "bazqux@xmpp.domain.tld"
message = "hello world"
def main():
jid = xmpp.protocol.JID(jabberid)
connection = xmpp.Client(server=jid.getDomain(), debug=True)
connection.connect()
connection.auth(user=jid.getNode(), password=password, resource=jid.getResource())
connection.send(xmpp.protocol.Message(to=receiver, body=message))
if __name__ == "__main__":
main()
Command line interface
======================
The package also installs a command line program called ``xmpp-message``.
Its synopsis is::
xmpp-message --debug \
--jabberid foobar@xmpp.domain.tld --password secret \
--receiver bazqux@xmpp.domain.tld --message 'hello world'
You can also put your credentials into an ``~/.xsend`` file, like::
JID=foobar@xmpp.domain.tld
PASSWORD=secret
and then invoke ``xmpp-message`` omitting the ``--jabberid`` and ``--password`` options, like::
xmpp-message --receiver bazqux@xmpp.domain.tld --message 'hello world'
*************
Documentation
*************
The canonical documentation is hosted at https://xmpppy.github.io/ and
http://xmpppy.sourceforge.net/.
For learning about how to use this module, please have a look at these spots
within the code base.
- The ``xmpp-message`` program, located at ``xmpp/cli.py``, for sending a single XMPP message.
- The other programs within the ``doc/examples`` directory.
- The docstrings within the library itself.
*******
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 <https://github.com/xmpppy/xmpppy/issues>`_
or on the
`xmpppy-devel mailing list <http://lists.sourceforge.net/lists/listinfo/xmpppy-devel>`_.
**************
Other projects
**************
- https://github.com/poezio/slixmpp
- https://github.com/horazont/aioxmpp
- https://github.com/Jajcus/pyxmpp2
- https://github.com/fritzy/SleekXMPP
- https://dev.gajim.org/gajim/python-nbxmpp
- https://github.com/xmpppy/xmpppy/files/4346179/xmpp_libs.xlsx
Raw data
{
"_id": null,
"home_page": "https://github.com/xmpppy/xmpppy",
"name": "xmpppy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "jabber, xmpp, RFC3920, RFC3921",
"author": "Alexey Nezhdanov",
"author_email": "snakeru@users.sourceforge.net",
"download_url": "https://files.pythonhosted.org/packages/22/bc/393e277f6d24675a741f795747fcb74f240ffa01c81e02b2e2678c415d16/xmpppy-0.7.2.tar.gz",
"platform": "All",
"description": "######\nxmpppy\n######\n\n *Python 2/3 implementation of XMPP (RFC3920, RFC3921).*\n\n----\n\n**Documentation**: http://xmpppy.sf.net/\n\n**Source Code**: https://github.com/xmpppy/xmpppy\n\n**Status**:\n\n.. image:: https://img.shields.io/pypi/pyversions/xmpppy.svg\n :target: https://pypi.org/project/xmpppy/\n\n.. image:: https://img.shields.io/pypi/v/xmpppy.svg\n :target: https://pypi.org/project/xmpppy/\n\n.. image:: https://img.shields.io/pypi/l/xmpppy.svg\n :target: https://pypi.org/project/xmpppy/\n\n.. image:: https://img.shields.io/pypi/dm/xmpppy.svg\n :target: https://pypi.org/project/xmpppy/\n\n\n----\n\n*****\nAbout\n*****\nThis library has been written to be compliant with\n`RFC3920 <https://datatracker.ietf.org/doc/rfc3920/>`_\nand\n`RFC3921 <https://datatracker.ietf.org/doc/rfc3921/>`_.\n\n\n************\nInstallation\n************\n\nUsing ``pip``, you can install the package with::\n\n pip install xmpppy --upgrade\n\n\n*****\nUsage\n*****\n\nAs a library\n============\n\nRegularly, the module is used as a library, like::\n\n import xmpp\n\n jabberid = \"foobar@xmpp.domain.tld\"\n password = \"secret\"\n receiver = \"bazqux@xmpp.domain.tld\"\n message = \"hello world\"\n\n def main():\n jid = xmpp.protocol.JID(jabberid)\n connection = xmpp.Client(server=jid.getDomain(), debug=True)\n connection.connect()\n connection.auth(user=jid.getNode(), password=password, resource=jid.getResource())\n connection.send(xmpp.protocol.Message(to=receiver, body=message))\n\n if __name__ == \"__main__\":\n main()\n\n\nCommand line interface\n======================\n\nThe package also installs a command line program called ``xmpp-message``.\nIts synopsis is::\n\n xmpp-message --debug \\\n --jabberid foobar@xmpp.domain.tld --password secret \\\n --receiver bazqux@xmpp.domain.tld --message 'hello world'\n\nYou can also put your credentials into an ``~/.xsend`` file, like::\n\n JID=foobar@xmpp.domain.tld\n PASSWORD=secret\n\nand then invoke ``xmpp-message`` omitting the ``--jabberid`` and ``--password`` options, like::\n\n xmpp-message --receiver bazqux@xmpp.domain.tld --message 'hello world'\n\n\n*************\nDocumentation\n*************\n\nThe canonical documentation is hosted at https://xmpppy.github.io/ and\nhttp://xmpppy.sourceforge.net/.\n\nFor learning about how to use this module, please have a look at these spots\nwithin the code base.\n\n- The ``xmpp-message`` program, located at ``xmpp/cli.py``, for sending a single XMPP message.\n- The other programs within the ``doc/examples`` directory.\n- The docstrings within the library itself.\n\n\n*******\nSupport\n*******\nIf you have any questions about xmpppy usage or you have found a bug or want\nto share some ideas - you are welcome to join us on the\n`issue tracker <https://github.com/xmpppy/xmpppy/issues>`_\nor on the\n`xmpppy-devel mailing list <http://lists.sourceforge.net/lists/listinfo/xmpppy-devel>`_.\n\n\n\n**************\nOther projects\n**************\n- https://github.com/poezio/slixmpp\n- https://github.com/horazont/aioxmpp\n- https://github.com/Jajcus/pyxmpp2\n- https://github.com/fritzy/SleekXMPP\n- https://dev.gajim.org/gajim/python-nbxmpp\n- https://github.com/xmpppy/xmpppy/files/4346179/xmpp_libs.xlsx\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "XMPP implementation in Python",
"version": "0.7.2",
"project_urls": {
"Download": "https://pypi.org/project/xmpppy/",
"Homepage": "https://github.com/xmpppy/xmpppy"
},
"split_keywords": [
"jabber",
" xmpp",
" rfc3920",
" rfc3921"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "22bc393e277f6d24675a741f795747fcb74f240ffa01c81e02b2e2678c415d16",
"md5": "4808db027a68ea61767f1c9964ac8b4f",
"sha256": "449bb158f99fd6cdd1e33dd52bc5a09aa79b7e4cc39fcd14f501ca3ecdec0f4e"
},
"downloads": -1,
"filename": "xmpppy-0.7.2.tar.gz",
"has_sig": false,
"md5_digest": "4808db027a68ea61767f1c9964ac8b4f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 88040,
"upload_time": "2025-08-09T12:28:18",
"upload_time_iso_8601": "2025-08-09T12:28:18.108279Z",
"url": "https://files.pythonhosted.org/packages/22/bc/393e277f6d24675a741f795747fcb74f240ffa01c81e02b2e2678c415d16/xmpppy-0.7.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-09 12:28:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xmpppy",
"github_project": "xmpppy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "xmpppy"
}
JSON
