wadl 0.1.1

data/README

@@ -0,0 +1,75 @@
+= wadl - Ruby client for the Web Application Description Language.
+
+== VERSION
+
+This documentation refers to wadl version 0.1.1
+
+
+== DESCRIPTION
+
+This is a Ruby client for the Web Application Description Language. It
+hides the details of HTTP communication between a web service client
+and a REST or HTTP+POX web service.
+
+We hope that WADL descriptors and client libraries will replace
+one-off wrapper libraries specific to one service and one programming
+language -- or at least make such wrapper libraries much easier to
+write.
+
+=== Interesting Features:
+
+* Traversing the tree of resources is like traversing a data
+  structure. Here's code to get recent posts from del.icio.us:
+
+    WADL::Application.from_wadl(open("delicious.wadl")).v1.posts.recent.get
+
+* Faults are custom subclasses named after the fault ID. You can catch
+  specific faults.
+
+* You can bind some parameters (such as authentication parameters or
+  API keys) permanently to the WADL application, and leave others (such
+  as search queries) to be bound differently for each request.
+
+* This feature isn't in the WADL standard yet: you can define
+  "header"-style parameters to be included in the HTTP request
+  headers. See delicious.wadl for an example.
+
+=== Shortcomings:
+
+The 20060802 WADL standard is almost entirely supported. However,
+
+* XML grammars are more or less ignored
+* As are links
+
+
+== LINKS
+
+<b></b>
+Homepage::      <http://www.crummy.com/software/wadl.rb/>
+WADL::          <http://wadl.dev.java.net/>
+Documentation:: <http://rdoc.info/projects/blackwinter/wadl>
+Source code::   <http://github.com/blackwinter/wadl>
+
+
+== AUTHORS
+
+* Leonard Richardson <mailto:leonardr@segfault.org> (Original author)
+* Jens Wille <mailto:jens.wille@uni-koeln.de>
+
+
+== LICENSE AND COPYRIGHT
+
+Copyright (C) 2006-2008 Leonard Richardson
+Copyright (C) 2010 Jens Wille
+
+wadl is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, either version 3 of the License, or (at your option) any later
+version.
+
+wadl is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with
+wadl. If not, see <http://www.gnu.org/licenses/>.

data/Rakefile

@@ -0,0 +1,23 @@
+require %q{lib/wadl/version}
+
+begin
+  require 'hen'
+
+  Hen.lay! {{
+    :gem => {
+      :name         => %q{wadl},
+      :version      => WADL::VERSION,
+      :summary      => %q{Ruby client for the Web Application Description Language.},
+      :authors      => ['Leonard Richardson', 'Jens Wille'],
+      :email        => ['leonardr@segfault.org', 'jens.wille@uni-koeln.de'],
+      :homepage     => 'http://github.com/blackwinter/wadl',
+      :files        => FileList['lib/**/*.rb'].to_a,
+      :extra_files  => FileList['[A-Z]*', 'examples/*', 'test/**/*.rb'].to_a,
+      :dependencies => %w[rest-open-uri mime-types]
+    }
+  }}
+rescue LoadError
+  abort "Please install the 'hen' gem first."
+end
+
+### Place your custom Rake tasks here.

data/examples/YahooSearch.rb

@@ -0,0 +1,7 @@
+require 'wadl'
+
+yahoo = WADL::Application.from_wadl(open("YahooSearch.wadl"))
+expected_representation = yahoo.newsSearch.search.response.representations[0]
+result = yahoo.newsSearch.get(:query => {:appid => "selectric", :query => "bar"},
+                              :expected_representation => expected_representation)
+puts result.representation

data/examples/YahooSearch.wadl

@@ -0,0 +1,88 @@
+<?xml version="1.0"?>
+<!--
+ The contents of this file are subject to the terms
+ of the Common Development and Distribution License
+ (the "License").  You may not use this file except
+ in compliance with the License.
+ 
+ You can obtain a copy of the license at
+ http://www.opensource.org/licenses/cddl1.php
+ See the License for the specific language governing
+ permissions and limitations under the License.
+-->
+<application xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+  xmlns:yn="urn:yahoo:yn"
+  xmlns:ya="urn:yahoo:api"
+  xmlns:html="http://www.w3.org/1999/xhtml"
+  xmlns="http://research.sun.com/wadl/2006/07">
+
+  <grammars>
+    <include href="NewsSearchResponse.xsd"/>
+    <include href="NewsSearchError.xsd"/>
+  </grammars>
+  
+  <resources base="http://api.search.yahoo.com/NewsSearchService/V1/">
+    <resource path="newsSearch">
+      <doc xml:lang="en" title="Yahoo News Search Service">
+        The <html:i>Yahoo News Search</html:i> service provides online searching of news
+        stories from around the world.
+      </doc>
+      <param name="appid" type="xsd:string" required="true" style="form">
+        <doc>The application ID. See <html:a href="http://developer.yahoo.com/faq/index.html#appid">Application IDs</html:a> for more information.</doc>
+      </param>
+      <method href="#search"/>
+    </resource>
+  </resources>
+    
+  <method name="GET" id="search">
+    <doc xml:lang="en" title="Search news stories by keyword"/>
+    <request>
+      <param name="query" type="xsd:string" required="true">
+        <doc xml:lang="en" title="Space separated keywords to search for"/>
+      </param>
+      <param name="type" type="xsd:string" default="all">
+        <doc xml:lang="en" title="Keyword matching"/>
+        <option value="all">
+            <doc>All query terms.</doc>
+        </option>
+        <option value="any">
+            <doc>Any query terms.</doc>
+        </option>
+        <option value="phrase">
+            <doc>Query terms as a phrase.</doc>
+        </option>
+      </param>
+      <param name="results" type="xsd:int" default="10">
+        <doc xml:lang="en" title="Number of results"/>
+      </param>
+      <param name="start" type="xsd:int" default="1">
+        <doc xml:lang="en" title="Index of first result"/>
+      </param>
+      <param name="sort" type="xsd:string" default="rank">
+        <doc xml:lang="en" title="Sort by date or rank"/>
+        <option value="rank"/>
+        <option value="date"/>
+      </param>
+      <param name="language" type="xsd:string">
+        <doc xml:lang="en" title="Language filter, omit for any language"/>
+      </param>
+      <param name="output" type="xsd:string" default="xml">
+        <doc>The format for the output. If <html:em>json</html:em> is requested, the results will be returned in <html:a href="http://developer.yahoo.com/common/json.html">JSON</html:a> format. If <html:em>php</html:em> is requested, the results will be returned in <html:a href="http://developer.yahoo.com/common/phpserial.html">Serialized PHP</html:a> format.</doc>
+        <option value="xml"/>
+        <option value="json"/>
+        <option value="php"/>
+      </param>
+      <param name="callback" type="xsd:string">
+        <doc>The name of the callback function to wrap around the JSON data. The following characters are allowed: A-Z a-z 0-9 . [] and _. If output=json has not been requested, this parameter has no effect. More information on the callback can be found in the <html:a href="http://developer.yahoo.com/common/json.html#callbackparam">Yahoo! Developer Network JSON Documentation</html:a>.</doc>
+      </param>
+    </request>
+    <response>
+      <representation mediaType="application/xml" element="yn:ResultSet">
+        <doc xml:lang="en" title="A list of news items matching the query"/>
+      </representation>
+      <fault id="SearchError" status="400" mediaType="application/xml"
+        element="ya:Error"/>
+    </response>
+  </method>
+  
+</application>

data/examples/crummy.rb

@@ -0,0 +1,17 @@
+require 'wadl'
+
+crummy = WADL::Application.from_wadl(open("crummy.wadl"))
+add_resource = crummy.find_resource(:add)
+
+repr_format = add_resource.find_method(:add).request.representations[0]
+representation = repr_format % {:password => 'mypassword', 
+                                :entry => 'This is an entry',
+                                :title => 'The title!' }
+result = add_resource.post(:path => {:weblog => "personal"},
+                           :send_representation => representation)
+if format = result.format and format.id == 'CreatedAtURI'
+  puts "Success!"
+  puts result.headers['Location']
+else
+  puts result
+end

data/examples/crummy.wadl

@@ -0,0 +1,34 @@
+<?xml version="1.0"?> 
+
+<!--Example of WADL being used to turn a not-particularly-RESTful CGI
+    application into a web service.-->
+
+<application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
+             xsi:schemaLocation="http://research.sun.com/wadl wadl.xsd"  
+             xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
+             xmlns:nb="urn:newsbruiser:nb"
+             xmlns="http://research.sun.com/wadl">
+
+ <resources base="http://www.crummy.com/nb/nb.cgi/">
+  <resource path="add" id="add">
+   <param name="weblog" type="xsd:string" />
+   <method href="#add"/>
+  </resource>
+ </resources>
+
+ <method name="POST" id="add">
+  <request>
+   <representation mediaType="application/x-www-form-encoded">
+    <param name="password" type="xsd:string" required="true" />
+    <param name="entry" type="xsd:string" required="true" />
+    <param name="title" type="xsd:string" />
+    <param name="make_change" type="xsd:string" fixed="true" />
+    <param name="Button" type="xsd:string" fixed="Publish" />
+   </representation>
+  </request>
+
+  <response>
+   <fault id="CreatedAtURI" status="302" />
+  </response>
+ </method>
+</application>

data/examples/delicious.rb

@@ -0,0 +1,24 @@
+require 'wadl'
+
+delicious = WADL::Application.from_wadl(open("delicious.wadl")).v1
+delicious = delicious.with_basic_auth('username', 'password' )
+
+query_args = { :url => 'https://wadl.dev.java.net/',
+               :description => 'WADL homepage',
+               :extended => 'Posted with Ruby WADL client' }
+begin
+  delicious.posts.add.get(:query => query_args)
+rescue WADL::Faults::AuthorizationRequired
+  puts "Invalid authentication information!"
+end
+
+#delicious.posts.add.addPost(:query => query_args)
+#delicious.posts.addPost(:query => query_args)
+
+begin
+  delicious.posts.recent.get.representation.each_element("post") do |e|
+    puts "#{e.attributes['description']}: #{e.attributes['href']}"
+  end
+rescue WADL::Faults::AuthorizationRequired
+  puts "Invalid authentication information!"
+end

data/examples/delicious.wadl

@@ -0,0 +1,348 @@
+<?xml version="1.0"?>
+<!-- This is a bootleg WADL file for the del.icio.us API. -->
+
+<application xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+  xmlns:html="http://www.w3.org/1999/xhtml"
+  xmlns="http://research.sun.com/wadl/2006/07">
+
+ <resources base="https://api.del.icio.us/">
+  <doc xml:lang="en" title="The del.icio.us API v1">
+   Post or retrieve your bookmarks from the social networking website.
+   Limit requests to one per second.
+  </doc>
+
+  <resource path="v1">
+   <param name="Authorization" style="header" required="true">
+    <doc xml:lang="en">All del.icio.us API calls must be authenticated
+    using Basic HTTP auth.</doc>
+   </param>
+
+   <resource path="update"><method href="#getLastUpdateTime" /></resource>
+
+   <resource path="tags">
+    <resource path="get"><method href="#getTags" /></resource>
+    <resource path="rename"><method href="#renameTag" /></resource>
+   </resource>
+
+   <resource path="posts">
+    <resource path="get"><method href="#getPosts" /></resource>
+    <resource path="recent"><method href="#getRecentPosts" /></resource>
+    <resource path="all"><method href="#getAllPosts" /></resource>
+    <resource path="dates"><method href="#getDates" /></resource>
+
+    <resource path="add"><method href="#addPost" /></resource>
+    <resource path="delete"><method href="#deletePost" /></resource>
+   </resource>
+
+   <resource path="bundles">
+    <resource path="all"><method href="#getBundles" /></resource>
+    <resource path="set"><method href="#makeBundle" /></resource>
+    <resource path="delete"><method href="#deleteBundle" /></resource>
+   </resource>
+  </resource>
+ </resources>
+
+ <!-- Methods -->
+
+ <!-- "update" method -->
+
+ <method id="getLastUpdateTime" name="GET">
+  <response>
+   <representation mediaType="application/xml" element="update">
+    <doc xml:lang="en" title="A note on structure">
+     The "time" attribute contains the last update time for the
+     authenticated user, in ISO8661 format.
+    </doc>   
+   </representation>
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <!-- "tags" methods -->
+
+ <method id="getTags" name="GET">
+  <response>
+   <representation mediaType="application/xml" element="tags">
+    <doc xml:lang="en" title="Schema description">
+     Contains "tag" tags, each with "count" and "tag" attributes.
+    </doc>
+   </representation>
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <method id="renameTag" name="POST">
+  <request>
+   <param name="old" required="true" style="form">
+    <doc xml:lang="en" title="Tag to rename." />
+   </param>
+   <param name="new" required="true" style="form">
+    <doc xml:lang="en" title="New name." />
+   </param>
+  </request>
+ 
+  <response>
+   <representation href="#resultCodeDone" />
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <!-- "posts" methods part I: ways of getting posts -->
+
+ <method id="getPosts" name="GET">
+  <doc xml:lang="en" title="Returns posts matching the arguments.">
+   If no date or url is given, most recent date will be used.
+  </doc>
+
+  <request>
+   <param name="tag" style="form">
+    <doc xml:lang="en" title="Filter by this tag." />
+   </param>
+   <param name="dt" style="form">
+    <doc xml:lang="en" title="Filter by this date (CCYY-MM-DDThh:mm:ssZ)." />
+   </param>
+   <param name="url" style="form">
+    <doc xml:lang="en" title="Filter by this URL." />
+   </param>
+  </request>
+  <response>
+   <representation mediaType="application/xml" element="posts">
+    <doc xml:lang="en" title="Sample response">
+     &lt;posts dt=&quot;2005-11-28&quot; tag=&quot;webdev&quot; user=&quot;user&quot;&gt;
+      &lt;post href=&quot;http://www.howtocreate.co.uk/tutorials/texterise.php?dom=1&quot; 
+       description=&quot;JavaScript DOM reference&quot; 
+       extended=&quot;dom reference&quot; 
+       hash=&quot;c0238dc0c44f07daedd9a1fd9bbdeebd&quot; 
+       others=&quot;55&quot; tag=&quot;dom javascript webdev&quot; time=&quot;2005-11-28T05:26:09Z&quot; /&gt;
+     &lt;/posts&gt;
+    </doc>
+   </representation>
+  </response>
+ </method>
+
+ <method id="getRecentPosts" name="GET">
+
+  <doc xml:lang="en" title="Returns a list of the most recent posts.">
+   Filtered by argument. Maximum 100.
+  </doc>
+
+  <request>
+   <param name="tag" style="form">
+    <doc xml:lang="en" title="Filter by this tag." />
+   </param>
+   <param name="count" style="form" default="15">
+    <doc xml:lang="en" title="Number of items to retrieve.">Maximum: 100</doc>
+   </param>
+  </request>
+
+  <response>
+   <representation href="#postList" />
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <method id="getAllPosts" name="GET">
+  <doc xml:lang="en" title="Returns all posts">
+   Please use sparingly. Call the update function to see if you need
+   to fetch this at all.
+  </doc>
+
+  <request>
+   <param name="tag" style="form">
+    <doc xml:lang="en" title="Filter by this tag." />
+   </param>
+  </request>
+
+  <response>
+   <representation href="#postList" />
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <method id="getDates" name="GET">
+  <doc xml:lang="en" 
+   title="Returns a list of dates with the number of posts at each date." />
+
+  <request>
+   <param name="tag" style="form">
+    <doc xml:lang="en" title="Filter by this tag." />
+   </param>
+  </request>
+  <response>
+   <representation mediaType="application/xml">
+    <doc xml:lang="en" title="Sample">
+     &lt;dates tag=&quot;&quot; user=&quot;user&quot;&gt;
+       &lt;date count=&quot;5&quot; date=&quot;2005-11-29&quot; /&gt;
+       &lt;date count=&quot;15&quot; date=&quot;2005-11-28&quot; /&gt;
+       &lt;date count=&quot;2&quot; date=&quot;2005-11-26&quot; /&gt;
+       &lt;date count=&quot;2&quot; date=&quot;2005-11-25&quot; /&gt;
+       &lt;date count=&quot;7&quot; date=&quot;2005-11-23&quot; /&gt;
+       &lt;date count=&quot;20&quot; date=&quot;2005-11-22&quot; /&gt;
+       &lt;date count=&quot;16&quot; date=&quot;2005-11-21&quot; /&gt;
+       &lt;date count=&quot;4&quot; date=&quot;2005-11-19&quot; /&gt;
+     &lt;/dates&gt;
+    </doc>
+   </representation>
+  </response>
+ </method>
+
+ <!-- "posts" methods part II: ways of manipulating posts -->
+
+ <method id="addPost" name="GET">
+  <doc xml:lang="en" title="Add a post to del.icio.us" />
+  <request>
+   <param name="url" required="true" style="form">
+    <doc xml:lang="en" title="The URL of the item." />
+   </param>
+
+   <param name="description" required="true" style="form">
+    <doc xml:lang="en" title="The description of the item." />
+   </param>
+
+   <param name="extended" style="form">
+    <doc xml:lang="en" title="Notes for the item." />
+   </param>
+
+   <param name="tags" style="form">
+    <doc xml:lang="en" title="Tags for the item.">Space delimited</doc>
+   </param>
+
+   <param name="dt" style="form"> 
+   <doc xml:lang="en" title="Datestamp of the item.">
+     Format: "CCYY-MM-DDThh:mm:ssZ". Requires a LITERAL "T" and "Z"
+     like in 
+     <html:a href="http://www.cl.cam.ac.uk/~mgk25/iso-time.html">ISO8601</html:a>.
+     For example: "1984-09-01T14:21:31Z"
+    </doc>
+   </param>
+
+   <param name="replace" default="" style="form"> 
+    <doc xml:lang="en" 
+     title="Unless set to &quot;no&quot;, a post will overwrite an
+            earlier post with the same URL." />
+    <option value="" />
+    <option value="no" />
+   </param>
+
+   <param name="shared" style="form"> 
+    <doc xml:lang="en" title="Set to &quot;no&quot; to make the item private." />
+    <option value="" />
+    <option value="no" />
+   </param>
+
+  </request>
+ 
+  <response>
+   <representation href="#resultCode" />
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <method id="deletePost" name="GET">
+  <doc xml:lang="en" title="Delete a post from del.icio.us" />
+
+  <request>
+   <param name="url" required="true" style="form">
+    <doc xml:lang="en" title="The URL of the item." />
+   </param>
+  </request>
+
+  <response>
+   <representation href="#resultCodeDone" />
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <!-- "bundles" methods -->
+
+ <method id="getBundles" name="GET">
+  <doc xml:lang="en" title="Retrieve all of a user's bundles." />
+
+  <response>
+   <representation mediaType="application/xml" element="bundles">
+    <doc xml:lang="en" title="Sample">
+     &lt;bundles&gt;
+       &lt;bundle name=&quot;music&quot; tags=&quot;ipod mp3 music&quot; /&gt;
+     &lt;/bundles&gt;
+    </doc>
+   </representation>
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+ 
+ <method id="makeBundle" name="GET">
+  <doc xml:lang="en" title="Assign a set of tags to a single bundle.">
+   Wipes away previous settings for bundle.
+  </doc>
+
+  <request>
+   <param name="bundle" style="form">
+    <doc xml:lang="en" title="The bundle name." />
+   </param>
+   <param name="tags" required="true" style="form">
+    <doc xml:lang="en" title="List of tags.">Space-separated.</doc>
+   </param>
+  </request>
+
+  <response>
+   <representation mediaType="application/xml" element="result">
+    <doc xml:lang="en" title="A note on structure">
+     On success, contents are &quot;done&quot; On failure,
+     contents are &quot;you must supply a bundle name and at least one
+     tag&quot;
+    </doc>
+   </representation>
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method>
+
+ <method id="deleteBundle" name="GET">
+  <doc xml:lang="en" title="Deletes a bundle." />
+  <request>
+   <param name="bundle" style="form">
+    <doc xml:lang="en" title="The bundle name." />
+   </param>
+  </request>
+
+  <response>
+   <representation href="#resultCodeDone" />
+   <fault href="#AuthorizationRequired" />
+  </response>
+ </method> 
+
+ <!-- Commonly used representations -->
+
+ <representation id="postList" mediaType="text/xml" element="posts">
+  <doc xml:lang="en" title="Sample">
+    &lt;posts tag=&quot;&quot; user=&quot;user&quot;&gt;
+      &lt;post href=&quot;http://www.weather.com/&quot; description=&quot;weather.com&quot; 
+      hash=&quot;6cfedbe75f413c56b6ce79e6fa102aba&quot; tag=&quot;weather reference&quot; 
+      time=&quot;2005-11-29T20:30:47Z&quot; /&gt;
+      &lt;post href=&quot;http://www.nytimes.com/&quot; 
+      description=&quot;The New York Times - Breaking News, World News &amp; Multimedia&quot; 
+      extended=&quot;requires login&quot; hash=&quot;ca1e6357399774951eed4628d69eb84b&quot; 
+      tag=&quot;news media&quot; time=&quot;2005-11-29T20:30:05Z&quot; /&gt;
+    &lt;/posts&gt;
+  </doc>
+ </representation>
+
+ <representation id="resultCode" mediaType="application/xml" element="result">
+  <doc xml:lang="en" title="A note on structure">
+   This representation has the same structure whether or not the
+   operation succeeded. If it succeeded, the value of the 'code'
+   attribute is "done". Otherwise, it's "something went wrong".
+  </doc>
+ </representation>
+
+ <representation id="resultCodeDone" mediaType="application/xml" element="result">
+  <doc xml:lang="en" title="A note on structure">
+   Allegedly, this representation has a "code" attribute whose value
+   is always "done". I think it might actually be the same as the
+   resultCode representation.
+  </doc>
+ </representation>
+
+ <fault id="AuthorizationRequired" status="401" />
+
+
+</application>

data/examples/yahoo.rb

@@ -0,0 +1,14 @@
+require 'wadl'
+
+yahoo = WADL::Application.from_wadl(open("yahoo.wadl"))
+search_resource = yahoo.find_resource(:newsSearch)
+expected_representation = search_resource.find_method(:search).response.representations[0]
+result = search_resource.get({:appid => "selectric", :query => "bar"},
+                             expected_representation)
+puts result.representation
+
+begin
+  search_resource.get(:query => "bar")
+rescue ArgumentError
+  puts "Couldn't call method without providing value for required variable. (Good)"
+end

data/examples/yahoo.wadl

@@ -0,0 +1,37 @@
+<?xml version="1.0"?> 
+<application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
+             xsi:schemaLocation="http://research.sun.com/wadl wadl.xsd"  
+             xmlns:tns="urn:yahoo:yn" 
+             xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
+             xmlns:yn="urn:yahoo:yn" 
+             xmlns:ya="urn:yahoo:api" 
+             xmlns="http://research.sun.com/wadl">
+ <grammars>
+  <include href="NewsSearchResponse.xsd"/>
+  <include href="http://api.search.yahoo.com/Api/V1/error.xsd"/>
+ </grammars>
+
+ <resources base="http://api.search.yahoo.com/NewsSearchService/V1/">
+  <resource uri="newsSearch">
+   <method href="#search"/>
+  </resource>
+ </resources>
+
+ <method name="GET" id="search">
+  <request>
+   <query.variable name="appid" type="xsd:string" required="true"/>
+   <query.variable name="query" type="xsd:string" required="true"/>
+   <query.variable name="type" type="xsd:string"/>
+   <query.variable name="results" type="xsd:int"/>
+   <query.variable name="start" type="xsd:int"/>
+   <query.variable name="sort" type="xsd:string"/>
+   <query.variable name="language" type="xsd:string"/>
+  </request>
+
+  <response>
+   <representation mediaType="application/xml" element="yn:ResultSet"/>
+   <fault id="SearchError" status="400" mediaType="text/xml" 
+    element="ya:Error"/>
+  </response>
+ </method>
+</application>