python-wave-surfer aka “a simple wave API”

Outdated! Please refer to the wiki in Bitbucket

Here is my simple implementation for a google wave API — deeply inspired by hiroshi‘s work and from a folengo‘s idea.

The API module, wave.py, implements only the login and two functions to retrieve your waves. The API module uses the Python Standard Library so just import it (on GNU/Linux, mac os, win and… Symbian maybe?) and play :)

>>> import wave
>>> wave.login('user@gmail.com', 'password')
>>> wave.get_unread_waves()
[{'url': u'googlewave.com!w+xxxxxxx', 'total': 37, 'unread': 5, 'title': u'OT'}, {'url': u'googlewave.com!w+xxxxxxx', 'total': 26, 'unread': 3, 'title': u'ciao pythonisti!'}, {'url': u'googlewave.com!w+xxxxxxx', 'total': 2, 'unread': 2, 'title': u'Automation in InDesign'}]

You can clone the repo from Bitbucket or download the tarball.

On top of this minimal API I wrote a notifier using pynotify (so it runs on Gnome and KDE without any problem), this is the code:

import sys
import time
import getpass
import pynotify
import wave

pynotify.init('pywave-notifier')

if len(sys.argv) != 2:
    print 'usage: notifier.py youraccount@gmail.com'
    sys.exit(0)

wave.login(sys.argv[1], getpass.getpass("password: "))
lastmsg = u''

while True:
    unread = wave.get_unread_waves()
    msg = u''

    for item in unread:
        msg += '%(title)s (%(unread)s/%(total)s)\n'\
            % item

    # yep, not so perfect (:
    if msg != lastmsg:
        n = pynotify.Notification(
            "%s unread waves" % len(unread), msg)
        n.show()
        lastmsg = msg

    time.sleep(3*60)