This document describes how to create a Wave robot that integrates with the Johns Hopkins University library catalog. It provides instructions for setting up a Python application on Google App Engine to host the robot. The robot uses the Wave API to search the library catalog based on text in Wave conversations and return results to users. Code snippets are provided for key functions like handling when a blip is submitted and performing the catalog search. Potential improvements and debugging tips are also discussed.

1. You Either Surf or You Fight: Integrating Library Services With Google WaveSean HannanSheridan LibrariesJohns Hopkins University

2. Google Wavehttp://wave.google.comCollaborative platform

3. Why Library Services there?You can’t always force users to come to youGo where they are

4. Wave AppsTwo types GadgetsLike existing iGoogle gadgetsRobotsReal-time interactionLet’s go for the real-time interaction

5. Already on Wave?Invite uncle-milty@appspot.com to a conversation

6. Creating a Wave RobotLibraries for Java and PythonDeployment using Google AppEngine

7. App Enginehttp://appengine.google.comGoogle’s cloud-computing platformFree for up to 1.3 million requests per day

8. Set up the ApplicationCreate an application at appengine.google.comSet up an application identifier <app>.appspot.com

9. App Engine SDKDownload the App Engine SDK from http://code.google.com/appengine/downloads.htmlStart the App Engine Launcher and create a new application

10. Set up the app.yamlapplication: uncle-miltyversion: 2runtime: pythonapi_version: 1handlers:- url: /_wave/.* script: uncle-milty.py- url: /assetsstatic_dir: assets

11. Wave Robot APIDownload the files from svn:svn checkout http://wave-robot-python-client.googlecode.com/svn/trunk/src/waveapi waveapiDrop it in the application directory

12. Wave ConceptsWaveletThe conversation taking place within Google WaveBlipEvery message as part of the waveletHierarchical Each of these have unique identifiers that can be used to programmatically address them

13. Project OverviewA simple chat botSearches the library catalog for results

14. Code it up!Available on github: http://github.com/MrDys/uncle-milty

15. External LibrariesExternal libraries are a-okayJust drop it in the project directoryGoing to use BeautifulSoup to scrape the OPAC

16. Importsfrom waveapi import eventsfrom waveapi import modelfrom waveapi import robotfrom waveapi import documentfrom waveapi.ops import OpBuilderimport loggingimport urllib2from BeautifulSoup import BeautifulSoup

17. OnRobotAdded Functiondef OnRobotAdded(properties, context): """Invoked when the robot has been added."""logging.debug("created")root_wavelet = context.GetRootWavelet()root_wavelet.CreateBlip().GetDocument().SetText("Hi, I'm Milton S. Eisenhower and I'd be happy to help you with your research. I will search the JHU catalog for anything that you say to me and I'll let you know if I find anything.")

18. OnBlip Submitted Functiondef OnBlipSubmitted(properties, context): blip = context.GetBlipById(properties['blipId']) page = urllib2.urlopen("https://catalog.library.jhu.edu/ipac20/ipac.jsp?menu=search&aspect=subtab22&npp=5&ipp=20&spp=20&profile=general&ri=&index=ALTITLE&term=" + blip.GetDocument().GetText() + "&x=0&y=0&aspect=subtab22")

19. OnBlipSubmitted Function con’t soup = BeautifulSoup(page) results = soup.findAll(title="View more information")sub_blip = context.GetRootWavelet().CreateBlip()sub_blipdoc = sub_blip.GetDocument()

20. OnBlipSumitted Function con’toutputstr = "" count = 0 for i in results: if count >= 5: break else:itemstr = str(i)itemstr = itemstr.replace('class="smallBoldAnchor"', '')outputstr = outputstr + itemstr + "<br/>" count = count + 1

21. OnBlipSubmitted Function con’tlogging.debug(outputstr)sub_blipdoc.SetText(" ") builder = OpBuilder(context)builder.DocumentAppendMarkup(sub_blip.waveId, sub_blip.waveletId, sub_blip.blipId, outputstr)logging.debug(sub_blip.waveId + " " + sub_blip.waveletId + " " + sub_blip.blipId)

22. Register Event Handlersif __name__ == '__main__':myRobot = robot.Robot('Milton S. Eisenhower', image_url='http://uncle-milty.appspot.com/assets/milty.png', version='2',profile_url='http://uncle-milty.appspot.com/')myRobot.RegisterHandler(events.BLIP_SUBMITTED, OnBlipSubmitted)myRobot.RegisterHandler(events.WAVELET_SELF_ADDED, OnRobotAdded)myRobot.Run()

23. GotchasCSSDoesn’t really like it, so keep it simpleHTML LinksWon’t let you do it directly, must use OpBuilder

24. DeploymentJust hit ‘Deploy’ in the App Engine Launcher

25. DebuggingUse the logging libraryView the log results in realtime on http://appengine.google.com

26. What next?Could be improved in a lot of waysMore services integratedCreate a menu-like system to select options

27. Q&AQuestions?