Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gabrielfalcao/xmpp

stateless and concurrency-agnostic XMPP implementation in python
https://github.com/gabrielfalcao/xmpp

concurrency coroutines gevent gplv3 networking python threads xmpp

Last synced: 12 days ago
JSON representation

stateless and concurrency-agnostic XMPP implementation in python

Awesome Lists containing this project

README

        

XMPP Toolkit for python
=======================

+---------+--------+
| version | 0.1.10 |
+---------+--------+
| license | LGPLv3 |
+---------+--------+

Simplistic and stateless XMPP implementation for python. A building
block for non-blocking XMPP clients, components, gateways and servers.

.. image:: https://readthedocs.org/projects/xmpp/badge/?version=latest
:target: http://xmpp.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://travis-ci.org/gabrielfalcao/xmpp.svg?branch=master
:target: https://travis-ci.org/gabrielfalcao/xmpp
.. image:: https://img.shields.io/pypi/pyversions/xmpp.svg
:target: https://pypi.python.org/pypi/xmpp
.. image:: https://badges.gitter.im/gabrielfalcao/xmpp.svg
:target: https://gitter.im/gabrielfalcao/xmpp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
.. image:: https://img.shields.io/badge/pydoc-web-ff69b4.svg
:target: http://pydoc.net/xmpp

Documentation
=============

Available at `xmpp.readthedocs.io `_

Client Bot Examples
===================

You can find some in the examples folder:

* `Echo Bot `_: Auto Replies to anyone who messages it
* `Service Discovery `_: How to use the Disco (xep 0030)
* `Presence Bot `_: Client that automatically sends presence and befriends anyone who sends it presence

Component Examples
==================

You can find some in the examples folder:

* `Presence Proxy notifier `_: Component that befriends a specific JID and sends present to it, in behalf of many jids

Extending
=========

The XMPP Toolkit library allows you to easily implement your own
**XEPs** and keep the extensions inside of your own application.

If you are implementing a generic XEP, please consider sending a
pull-request with the change, preferabbly along with its test cases.

Acknowledgements
================

This library was mostly written from scratch, except for the
``xmpp.sasl`` which is a modified copy of the contents of the
`pyxmpp2 `_ library by `Jacek Konieczny `_.

The modified files can be found at:

::

xmpp/sasl/__init__.py
xmpp/sasl/core.py
xmpp/sasl/digest_md5.py
xmpp/sasl/external.py
xmpp/sasl/gssapi.py
xmpp/sasl/plain.py
xmpp/sasl/saslprep.py
xmpp/sasl/scram.py
xmpp/sasl/xfacebookplatform.py