https://github.com/egoexpress/innoxmpp

Python XMPP admin 'bots' based on the SleekXMPP library
https://github.com/egoexpress/innoxmpp

Last synced: about 2 months ago
JSON representation

Python XMPP admin 'bots' based on the SleekXMPP library

• Host: GitHub
• URL: https://github.com/egoexpress/innoxmpp
• Owner: egoexpress
• Archived: true
• Created: 2012-09-01T20:10:36.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2013-09-19T18:57:38.000Z (about 11 years ago)
• Last Synced: 2024-07-27T06:39:04.144Z (about 2 months ago)
• Language: Python
• Size: 430 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
innoxmpp

========

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](http://www.git-scm.com). 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](http://www.textastic.com) 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](http://www.python.org) >= 3.2.3 (Python2 is not supported, get over it)

* [SleekXMPP](http://sleekxmpp.com/) >= 1.1 (development version, 1.0 will not work)

* [DNSPython3](http://www.dnspython.com/)

**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 

        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](https://github.com/egoexpress/SleekXMPP) doesn't show this 

behaviour. As an alternative you can download the [development tarball](http://github.com/fritzy/SleekXMPP/zipball/develop) from the SleekXMPP homepage.

**Getting the code**

The code of this project is available at GitHub at