Metadata-Version: 2.1
Name: xmpppy
Version: 0.7.1
Summary: XMPP implementation in Python
Home-page: https://github.com/xmpppy/xmpppy
Author: Alexey Nezhdanov
Author-email: snakeru@users.sourceforge.net
License: GPL
Download-URL: https://pypi.org/project/xmpppy/
Keywords: jabber,xmpp,RFC3920,RFC3921
Platform: All
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Telecommunications Industry
Classifier: Topic :: Communications
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Database
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Networking
Classifier: Topic :: Text Processing
Classifier: Topic :: Utilities
License-File: LICENSE
######
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 `_
and
`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::
jabberid = "foobar@xmpp.domain.tld"
password = "secret"
receiver = "bazqux@xmpp.domain.tld"
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))
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 `_
or on the
`xmpppy-devel mailing list `_.
**************
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