MediaWiki RecentChanges into text line while keeping track of changes seen
Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
README.md
wikirc2text.py

README.md

wikirc2text

wikirc2text is a simple Python script to dump MediaWiki RecentChanges as single text line. The script is able to keep the state of the already seen lines avoiding to output the same changes again.

The idea behind the script is to have a simple command-line interface to dump Wiki RecentChanges feed into other program like sendxmpp (http://sendxmpp.platon.sk/). As I didn't want to flood the XMPP conference room with the same output, I made wikirc2text to track the already seen lines.

Usage

    Usage: wikirc2text.py url(s)

    Options:
      -h, --help            show this help message and exit
      -s, --state           keep state of existing rcline seen and don't output
                            them
      -c STATESEC, --cleanstate=STATESEC
                            expire states existing more than number of seconds
                            specified
      -t, --tail            tail-like operation by continuously appending new
                            changes (--state option is enable)
      -w WAIT, --wait=WAIT  number of seconds to wait before refreshing (default
                    is 60)

Sample usage

% python wikirc2text.py "http://en.ekopedia.org/w/index.php?title=Special:RecentChanges&feed=atom" --state | head -4
Ekopedia  - Recent changes [en]
http://en.ekopedia.org/w/index.php?title=Ecological_rucksack&diff=8004&oldid=prev by Wibil @ Sun, 09 Jan 2011 08:09:03 +0000
http://en.ekopedia.org/w/index.php?title=User:Wibil/to_do_list&diff=8003&oldid=prev by Wibil @ Sun, 09 Jan 2011 06:31:28 +0000
http://en.ekopedia.org/User:Social_Networking by Social Networking @ Sat, 08 Jan 2011 20:19:42 +0000

If you do a second request, just after. As there is no changes, there is no output. If you don't use the --state option, you'll get all the latest changes without checking the state cache.

% python wikirc2text.py "http://en.ekopedia.org/w/index.php?title=Special:RecentChanges&feed=atom" --state

You can clear the state following an interval specified in seconds.

% python wikirc2text.py -c 60
29 states deleted

You can also use the tail-like interface to have a continuous update of the new recent changes.

% python wikirc2text.py "http://en.ekopedia.org/w/index.php?title=Special:RecentChanges&feed=atom" --tail

Usage with sendxmpp

% python wikirc2text.py --state "http://www.hackerspace.lu/w/index.php?title=Special:RecentChanges&feed=atom" | head -5 |sendxmpp -u yourbotname -p yourbotpassword -r yourbotressource -j an.xmpp.server -t -c aconference@conference.somewhere

Software required