---
date: "2004-10-25T03:34:30Z"
title: '"Official" RAA SOAP WSDL'
---

<p>
The "official" <a href='http://raa.ruby-lang.org'><acronym title='Ruby
Application Archive'>RAA</acronym></a> <acronym title='Simple Object Access Protocol'>SOAP</acronym> <acronym title='Web Services Description Language'>WSDL</acronym> is at the following <acronym title='Uniform Resource Identifier'>URI</acronym>:
</p>

<blockquote cite='Email from nakahiro@sarion.co.jp'>
<code>
<a href='http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/'>http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/</a></code>
</blockquote>

<p>
Why am I posting this here?  Because I had a <em>hell</em> of a time finding it.  The old <code>raa-xml.xml</code> and <code>raa-rdf.rdf</code> links were broken, the <a href='http://raa.ruby-lang.org/'><acronym title='Ruby Application Archive'>RAA</acronym></a> sample code included with <a href='http://ruby-lang.org/'>Ruby</a> 1.8 wasn't undocumented (and didn't work for me the first time around), and <a href='http://google.com/'>googling</a> for the answer didn't turn up squat.  Here's a brief example of how to use the <acronym title='Web Services Description Language'>WSDL</acronym> <acronym title='Uniform Resource Identifier'>URI</acronym> above with the <code>WSDLDriverFactory</code> class included with <a href='http://ruby-lang.org/'>Ruby</a> 1.8:
</p>

<blockquote>
  <pre><code>
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')

  </code></pre>
</blockquote>

<p>
If you're interested, <a href='http://rubyforge.org/pipermail/rubygems-developers/2004-October/001140.html'>this post</a> to the <a href='http://rubyforge.org/pipermail/rubygems-developers/'>RubyGems Developers mailing list</a> has a more detailed summary of the problems I had tracking down this simple bit of information.
</p>