"Official" RAA SOAP WSDL

The "official" RAA SOAP WSDL is at the following URI:

http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/

Why am I posting this here? Because I had a hell of a time finding it. The old raa-xml.xml and raa-rdf.rdf links were broken, the RAA sample code included with Ruby 1.8 wasn't undocumented (and didn't work for me the first time around), and googling for the answer didn't turn up squat. Here's a brief example of how to use the WSDL URI above with the WSDLDriverFactory class included with Ruby 1.8:


require 'soap/wsdlDriver'

WSDL_URI = 'http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/'

# connect to RAA and create SOAP proxy object
raa = SOAP::WSDLDriverFactory.new(WSDL_URI).create_driver

# get a list of packages
pkg_list = raa.names

# get a tree of packages grouped by major/minor category
pkg_tree = raa.tree_by_category

# get information about a specific package (gem)
info = raa.gem('rubilicious')

  

If you're interested, this post to the RubyGems Developers mailing list has a more detailed summary of the problems I had tracking down this simple bit of information.