Python XMPP admin 'bots' based on the SleekXMPP library
Whats this?
Suppose you are away from your server or workstation, somewhere on the run having only a tablet and an instant messaging client. Wouldn't it be cool to do tasks on your computer without logging in via ssh or some other remote access program?
innoxmpp solves this problem by creating bots who have specific tasks. These bots connect themselves to a XMPP server and are then reachable via your instant messaging client from wherever you are.
Currently there is a GitBot, a bot who can perform tasks related to the distributed version control system git. It can clone repositories, perform push and pull operations and commit changes on local files.
One scenario where this comes in handy is when you are only with your tablet and you want to perform some changes on data on e.g. GitHub. Set up GitBot on a box that is reachable via WebDAV, clone your repositories there and access the files from your tablet with WebDAV (e.g. with Textastic on the iPad). When you are done with the changes, put the files back on the server and commit them to GitHub using your GitBot via your instant messenger. It's as easy as that.
Further bots and actions will be added in the future if some missing function scratches my itch.
Requirements
- Python >= 3.2.3 (Python2 is not supported, get over it)
- SleekXMPP >= 1.1 (development version, 1.0 will not work)
- DNSPython3
Issues
The development was done with the dev versions of both SleekXMPP and DNSPython3. Using SleekXMPP 1.0 (current stable version as of Sep 2013) throws an error when starting a bot. This is caused by an API change not present in SleekXMPP 1.0. There is a quick fix to get the bot up and running, but there will be further errors!
DEBUG ==== TRANSITION disconnected -> connected
Traceback (most recent call last):
File "git_bot.py", line 13, in <module>
gitBot.run()
File "/home/wonder/scripts/innoxmpp/bots/GenericBot.py", line 109, in run
self.process(block=True)
File "/usr/lib/python3/dist-packages/sleekxmpp/basexmpp.py", line 148, in process
return XMLStream.process(self, *args, **kwargs)
TypeError: process() got an unexpected keyword argument 'block'
Using the latest version from the (cloned) Git repository doesn't show this behaviour. As an alternative you can download the development tarball from the SleekXMPP homepage.
Getting the code
The code of this project is available at GitHub at https://github.com/egoexpress/innoxmpp