XMPP-OTR logging handler for Python

This is a Python library for logging to XMPP destinations using OTR (Off-the-Record Messaging) encryption.

Features

• OTRv2
• Pure python (no libotr dependency)
• Log to multiple destinations
• Optionally check log destinations' OTR fingerprints

Installation

$ sudo pip install --pre xmpppy  # xmpppy is tagged as an "rc" version
$ sudo pip install otrxmpplogger

Example

from otrxmpplogger import OTRXMPPLogger
import logging
import time
log = logging.getLogger()
privkey = open('.otrprivkey', 'r').read()
handler = OTRXMPPLogger(
    '[email protected]/datadiode',
    'supersecret',
    [
        (
            '[email protected]',
            '33eb6b01c97ceba92bd6b5e3777189c43f8d6f03'
        ),
        '[email protected]'
    ],
    privkey
)

log.addHandler(handler)
log.debug('setting up OTR')  # Trigger OTR setup
time.sleep(3)  # Give OTR a little while to go active
log.critical('@6 is a rat!')

Notes

• XMPP invitations are not handled
• It seems to take roughly 3 seconds to set up an OTR session. Messages logged before the session is ready may be lost.

Dependencies

• xmpppy (>= 0.4.1)
• pure-python-otr (>= 1.0.0)
• otrxmppchannel (>= 1.0.3)

Author

• Mike Gogulski - https://github.com/mikegogulski

Donations

If you found this software useful and would like to encourage its maintenance and further development, please consider making a donation to the Bitcoin address 13RrGMM1YUduzSrw5BhE7BXFGPtBDQYnpQ.

License

This is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.