Merge lp:~jamalta/launchpad/515761 into lp:launchpad/db-devel

Proposed by Jamal Fanaian
Status: Work in progress
Proposed branch: lp:~jamalta/launchpad/515761
Merge into: lp:launchpad/db-devel
Diff against target: 28317 lines (+28227/-3) (has conflicts)
4 files modified
lib/canonical/launchpad/apidoc/wadl-testrunner.xml (+28134/-2)
lib/canonical/launchpad/security.py (+67/-1)
lib/lp/bugs/stories/webservice/xx-bug.txt (+12/-0)
lib/lp/registry/stories/webservice/xx-project-registry.txt (+14/-0)
Text conflict in lib/canonical/launchpad/security.py
To merge this branch: bzr merge lp:~jamalta/launchpad/515761
Reviewer Review Type Date Requested Status
Jamal Fanaian (community) Disapprove
Paul Hummer Pending
Review via email: mp+18638@code.launchpad.net

Commit message

Created View classes for IMessage, IProductRelease, and IBugSubscription to allow anonymous API access to these interfaces. Fixed misspelling of 'permission' attribute for ViewProductSeries.

To post a comment you must log in.
Jamal Fanaian (jamalta) wrote :

= Summary =

Anonymous API Access to some collections returns nothing.

== Proposed fix ==

Create View classes in security.py for the interfaces that need anonymous access.

== Pre-implementation notes ==

Decision to make these collections available to everyone needs to be considered during review.

== Implementation details ==

Created ViewBugMessage, ViewProductRelease, and ViewBugSubscription in security.py with checkUnauthorized and checkAuthorized both returning True.

== Tests ==

% bin/test -vvct webservice/xx-bug.txt
% bin/test -vvct xx-project-registry

== Demo and Q/A ==

>>> from launchpadlib.launchpad import Launchpad
>>> launchpad = Launchpad.login('test', '', '', 'https://api.launchpad.dev/beta/')
>>> list(launchpad.projects['alsa-utils'].series)
[<project_series at https://api.launchpad.dev/beta/alsa-utils/trunk>]
>>> list(launchpad.bugs[1].messages)
[<message at https://api.launchpad.dev/beta/firefox/+bug/1/comments/0>, <message at https://api.launchpad.dev/beta/firefox/+bug/1/comments/1>]
>>> list(launchpad.bugs[1].subscriptions)
[<bug_subscription at https://api.launchpad.dev/beta/bugs/1/+subscription/stevea>, <bug_subscription at https://api.launchpad.dev/beta/bugs/1/+subscription/name12>]

== Launchpad lint ==

Checking for conflicts. and issues in doctests and templates.
Running jslint, xmllint, pyflakes, and pylint.
Using normal rules.

Linting changed files:
  lib/canonical/launchpad/security.py
  lib/canonical/launchpad/apidoc/wadl-testrunner.xml
  lib/lp/bugs/stories/webservice/xx-bug.txt
  lib/lp/registry/stories/webservice/xx-project-registry.txt

Jamal Fanaian (jamalta) wrote :

Oops, I need to fix this branch first. Sorry about that.

review: Disapprove
Paul Hummer (rockstar) wrote :

I'm going to set this branch as "Work in progress" since it doesn't seem to be ready for review.

Unmerged revisions

10251. By Jamal Fanaian on 2010-02-04

Fixed duplicate imports of IProductRelease in security.py

10250. By Jamal Fanaian on 2010-02-04

Created tests for product series and releases, and fixed tests in bugs

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'lib/canonical/launchpad/apidoc/wadl-testrunner.xml'
2--- lib/canonical/launchpad/apidoc/wadl-testrunner.xml 2009-12-10 16:41:34 +0000
3+++ lib/canonical/launchpad/apidoc/wadl-testrunner.xml 2010-02-04 21:05:33 +0000
4@@ -1,10 +1,28142 @@
5 <?xml version="1.0"?>
6+<!DOCTYPE application [
7+ <!ENTITY nbsp "\&#160;">
8+]>
9 <wadl:application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
10 xmlns="http://research.sun.com/wadl/2006/10"
11+ xmlns:xsd="http://www.w3.org/2001/XMLSchema"
12 xmlns:wadl="http://research.sun.com/wadl/2006/10"
13 xsi:schemaLocation="http://research.sun.com/wadl/2006/10/wadl.xsd">
14
15- <!--This file is for testing purposes only. See
16- canonical/launcpad/pagetests/webservice/xx-wadl.txt -->
17+ <!--There is one "service root" resource, located (as you'd expect)
18+ at the service root. This very document is the WADL
19+ representation of the "service root" resource.-->
20+ <wadl:resources base="http://api.launchpad.dev/beta/">
21+ <wadl:resource path="" type="#service-root"/>
22+ </wadl:resources>
23+
24+ <!--A "service root" resource responds to GET.-->
25+ <wadl:resource_type id="service-root">
26+ <wadl:doc>The root of the web service.</wadl:doc>
27+ <wadl:method name="GET" id="service-root-get">
28+ <wadl:response>
29+ <wadl:representation href="#service-root-json"/>
30+ <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="service-root-wadl"/>
31+ </wadl:response>
32+ </wadl:method>
33+ </wadl:resource_type>
34+
35+ <!--The JSON representation of a "service root" resource contains a
36+ number of links to collection-type resources.-->
37+ <wadl:representation mediaType="application/json" id="service-root-json">
38+
39+ <wadl:param style="plain" path="$['me_link']"
40+ name="me_link">
41+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
42+ </wadl:param>
43+
44+
45+ <wadl:param style="plain"
46+ path="$['cves_collection_link']"
47+ name="cves_collection_link">
48+ <wadl:link resource_type="http://api.launchpad.dev/beta/#cves"/>
49+ </wadl:param>
50+
51+
52+ <wadl:param style="plain"
53+ path="$['branches_collection_link']"
54+ name="branches_collection_link">
55+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branches"/>
56+ </wadl:param>
57+
58+
59+ <wadl:param style="plain"
60+ path="$['packagesets_collection_link']"
61+ name="packagesets_collection_link">
62+ <wadl:link resource_type="http://api.launchpad.dev/beta/#packagesets"/>
63+ </wadl:param>
64+
65+
66+ <wadl:param style="plain"
67+ path="$['distributions_collection_link']"
68+ name="distributions_collection_link">
69+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distributions"/>
70+ </wadl:param>
71+
72+
73+ <wadl:param style="plain"
74+ path="$['projects_collection_link']"
75+ name="projects_collection_link">
76+ <wadl:link resource_type="http://api.launchpad.dev/beta/#projects"/>
77+ </wadl:param>
78+
79+
80+ <wadl:param style="plain"
81+ path="$['project_groups_collection_link']"
82+ name="project_groups_collection_link">
83+ <wadl:link resource_type="http://api.launchpad.dev/beta/#project_groups"/>
84+ </wadl:param>
85+
86+
87+ <wadl:param style="plain" path="$['pillars_link']"
88+ name="pillars_link">
89+ <wadl:link resource_type="http://api.launchpad.dev/beta/#pillars"/>
90+ </wadl:param>
91+
92+
93+ <wadl:param style="plain"
94+ path="$['translation_import_queue_entries_collection_link']"
95+ name="translation_import_queue_entries_collection_link">
96+ <wadl:link resource_type="http://api.launchpad.dev/beta/#translation_import_queue_entries"/>
97+ </wadl:param>
98+
99+
100+ <wadl:param style="plain"
101+ path="$['people_collection_link']"
102+ name="people_collection_link">
103+ <wadl:link resource_type="http://api.launchpad.dev/beta/#people"/>
104+ </wadl:param>
105+
106+
107+ <wadl:param style="plain"
108+ path="$['bugs_collection_link']"
109+ name="bugs_collection_link">
110+ <wadl:link resource_type="http://api.launchpad.dev/beta/#bugs"/>
111+ </wadl:param>
112+
113+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
114+ <wadl:doc>The link to the WADL description of this resource.</wadl:doc>
115+ <wadl:link/>
116+ </wadl:param>
117+ </wadl:representation>
118+
119+ <!--In addition to the service root, this document describes all the
120+ types of resources you might encounter as you browse this web
121+ service.-->
122+
123+ <!--Begin resource_type definitions for collection resources.-->
124+
125+ <wadl:resource_type id="branches">
126+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
127+Interface representing the set of branches.
128+</wadl:doc>
129+ <wadl:method name="GET" id="branches-get">
130+ <wadl:response>
131+ <wadl:representation
132+ href="http://api.launchpad.dev/beta/#branch-page"/>
133+ <wadl:representation
134+ mediaType="application/vnd.sun.wadl+xml"
135+ id="branches-wadl"/>
136+ </wadl:response>
137+ </wadl:method>
138+
139+ <wadl:method id="branches-getByUrls" name="GET">
140+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
141+<p>Finds branches by URL.</p>
142+<p>Either from the external specified in Branch.url, from the URL on
143+<a class="rst-reference external" href="http://bazaar.launchpad.net/" target="_top">http://bazaar.launchpad.net/</a>, or from the lp: URL.</p>
144+<p>This is a frontend shim to IBranchLookup.getByUrls to allow it to be
145+exported over the API. If you want to call this from within the
146+Launchpad app, use the IBranchLookup version instead.</p>
147+<table class="rst-docutils field-list" frame="void" rules="none">
148+<col class="field-name" />
149+<col class="field-body" />
150+<tbody valign="top">
151+<tr class="rst-field"><th class="rst-field-name">param urls:</th><td class="rst-field-body">An iterable of URLs expressed as strings.</td>
152+</tr>
153+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A dictionary mapping URLs to branches. If the URL has no
154+associated branch, the URL will map to None.</td>
155+</tr>
156+</tbody>
157+</table>
158+
159+</wadl:doc>
160+ <wadl:request>
161+
162+ <wadl:param style="query" name="ws.op"
163+ required="true" fixed="getByUrls">
164+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
165+ </wadl:param>
166+ <wadl:param style="query" required="true"
167+ name="urls">
168+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
169+<p>A list of URLs of branches</p>
170+<p>These can be URLs external to Launchpad, lp: URLs, or <a class="rst-reference external" href="http://bazaar.launchpad.net/" target="_top">http://bazaar.launchpad.net/</a> URLs, or any mix of all these different kinds.</p>
171+
172+</wadl:doc>
173+
174+ </wadl:param>
175+
176+ </wadl:request>
177+
178+ </wadl:method>
179+ <wadl:method id="branches-getByUniqueName" name="GET">
180+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
181+<p>Find a branch by its ~owner/product/name unique name.</p>
182+<p>Return None if no match was found.</p>
183+
184+</wadl:doc>
185+ <wadl:request>
186+
187+ <wadl:param style="query" name="ws.op"
188+ required="true"
189+ fixed="getByUniqueName">
190+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
191+ </wadl:param>
192+ <wadl:param style="query" required="true"
193+ name="unique_name">
194+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
195+Branch unique name
196+</wadl:doc>
197+
198+ </wadl:param>
199+
200+ </wadl:request>
201+ <wadl:response>
202+
203+ <wadl:representation
204+ href="http://api.launchpad.dev/beta/#branch-full"/>
205+ </wadl:response>
206+ </wadl:method>
207+ <wadl:method id="branches-getByUrl" name="GET">
208+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
209+<p>Find a branch by URL.</p>
210+<p>Either from the external specified in Branch.url, from the URL on
211+<a class="rst-reference external" href="http://bazaar.launchpad.net/" target="_top">http://bazaar.launchpad.net/</a> or the lp: URL.</p>
212+<p>This is a frontend shim to IBranchLookup.getByUrl to allow it to be
213+exported over the API. If you want to call this from within the
214+Launchpad app, use the IBranchLookup version instead.</p>
215+<p>Return None if no match was found.</p>
216+
217+</wadl:doc>
218+ <wadl:request>
219+
220+ <wadl:param style="query" name="ws.op"
221+ required="true" fixed="getByUrl">
222+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
223+ </wadl:param>
224+ <wadl:param style="query" required="true"
225+ name="url">
226+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
227+Branch URL
228+</wadl:doc>
229+
230+ </wadl:param>
231+
232+ </wadl:request>
233+ <wadl:response>
234+
235+ <wadl:representation
236+ href="http://api.launchpad.dev/beta/#branch-full"/>
237+ </wadl:response>
238+ </wadl:method>
239+ </wadl:resource_type>
240+
241+
242+
243+ <wadl:resource_type id="cves">
244+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
245+The set of ICve objects.
246+</wadl:doc>
247+ <wadl:method name="GET" id="cves-get">
248+ <wadl:response>
249+ <wadl:representation
250+ href="http://api.launchpad.dev/beta/#cve-page"/>
251+ <wadl:representation
252+ mediaType="application/vnd.sun.wadl+xml" id="cves-wadl"/>
253+ </wadl:response>
254+ </wadl:method>
255+
256+ </wadl:resource_type>
257+
258+
259+
260+ <wadl:resource_type id="distributions">
261+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
262+Interface for DistrosSet
263+</wadl:doc>
264+ <wadl:method name="GET" id="distributions-get">
265+ <wadl:response>
266+ <wadl:representation
267+ href="http://api.launchpad.dev/beta/#distribution-page"/>
268+ <wadl:representation
269+ mediaType="application/vnd.sun.wadl+xml"
270+ id="distributions-wadl"/>
271+ </wadl:response>
272+ </wadl:method>
273+
274+ </wadl:resource_type>
275+
276+
277+
278+ <wadl:resource_type id="bugs">
279+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
280+Application root for malone.
281+</wadl:doc>
282+ <wadl:method name="GET" id="bugs-get">
283+ <wadl:response>
284+ <wadl:representation
285+ href="http://api.launchpad.dev/beta/#bug-page"/>
286+ <wadl:representation
287+ mediaType="application/vnd.sun.wadl+xml" id="bugs-wadl"/>
288+ </wadl:response>
289+ </wadl:method>
290+
291+ <wadl:method id="bugs-createBug" name="POST">
292+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
293+<p>Create a bug (with an appropriate bugtask) and return it.</p>
294+<table class="rst-docutils field-list" frame="void" rules="none">
295+<col class="field-name" />
296+<col class="field-body" />
297+<tbody valign="top">
298+<tr class="rst-field"><th class="rst-field-name">param target:</th><td class="rst-field-body">The Product, Distribution or DistributionSourcePackage
299+affected by this bug.</td>
300+</tr>
301+</tbody>
302+</table>
303+<p>Things to note when using this factory:</p>
304+<blockquote>
305+<ul class="rst-simple">
306+<li>the owner will be subscribed to the bug</li>
307+<li>distribution, product and package contacts (whichever ones are
308+applicable based on the bug report target) will bug subscribed to
309+all <em>public bugs only</em></li>
310+<li>for public upstreams bugs where there is no upstream bug contact,
311+the product owner will be subscribed instead</li>
312+</ul>
313+</blockquote>
314+
315+</wadl:doc>
316+ <wadl:request>
317+ <wadl:representation
318+ mediaType="application/x-www-form-urlencoded">
319+ <wadl:param style="query" name="ws.op"
320+ required="true" fixed="createBug">
321+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
322+ </wadl:param>
323+ <wadl:param style="query" required="false"
324+ name="security_related">
325+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
326+This bug is a security vulnerability
327+</wadl:doc>
328+
329+ </wadl:param>
330+ <wadl:param style="query" required="true"
331+ name="target">
332+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
333+The project, distribution or source package that has this bug.
334+</wadl:doc>
335+ <wadl:link resource_type="http://api.launchpad.dev/beta/#bug_target"/>
336+ </wadl:param>
337+ <wadl:param style="query" required="false"
338+ name="tags">
339+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
340+<p>Tags</p>
341+<p>Separated by whitespace.</p>
342+
343+</wadl:doc>
344+
345+ </wadl:param>
346+ <wadl:param style="query" required="true"
347+ name="title">
348+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
349+<p>Summary</p>
350+<p>A one-line summary of the problem.</p>
351+
352+</wadl:doc>
353+
354+ </wadl:param>
355+ <wadl:param style="query" required="false"
356+ name="private">
357+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
358+<p>This bug report should be private</p>
359+<p>Private bug reports are visible only to their subscribers.</p>
360+
361+</wadl:doc>
362+
363+ </wadl:param>
364+ <wadl:param style="query" required="true"
365+ name="description">
366+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
367+<p>Description</p>
368+<dl class="rst-docutils">
369+<dt>A detailed description of the problem,</dt>
370+<dd>including the steps required to reproduce it.</dd>
371+</dl>
372+
373+</wadl:doc>
374+
375+ </wadl:param>
376+ </wadl:representation>
377+ </wadl:request>
378+ <wadl:response>
379+ <wadl:param name="Location" style="header">
380+ <wadl:link resource_type="http://api.launchpad.dev/beta/#bug"/>
381+ </wadl:param>
382+
383+ </wadl:response>
384+ </wadl:method>
385+ </wadl:resource_type>
386+
387+
388+
389+ <wadl:resource_type id="packagesets">
390+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
391+An interface for multiple package sets.
392+</wadl:doc>
393+ <wadl:method name="GET" id="packagesets-get">
394+ <wadl:response>
395+ <wadl:representation
396+ href="http://api.launchpad.dev/beta/#packageset-page"/>
397+ <wadl:representation
398+ mediaType="application/vnd.sun.wadl+xml"
399+ id="packagesets-wadl"/>
400+ </wadl:response>
401+ </wadl:method>
402+
403+ <wadl:method id="packagesets-setsIncludingSource"
404+ name="GET">
405+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
406+<p>Get the package sets that include this source package.</p>
407+<p>Return all package sets that directly or indirectly include the
408+given source package name.</p>
409+<table class="rst-docutils field-list" frame="void" rules="none">
410+<col class="field-name" />
411+<col class="field-body" />
412+<tbody valign="top">
413+<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
414+<tr><td>&nbsp;</td><td class="rst-field-body">the included source package name; can be
415+either a string or a ISourcePackageName.</td>
416+</tr>
417+<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_inclusion:</th></tr>
418+<tr><td>&nbsp;</td><td class="rst-field-body">if this flag is set to True, then only
419+package sets that directly include this source package name will
420+be considered.</td>
421+</tr>
422+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
423+<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the given
424+name cannot be found.</td>
425+</tr>
426+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A (potentially empty) sequence of IPackageset instances.</td>
427+</tr>
428+</tbody>
429+</table>
430+
431+</wadl:doc>
432+ <wadl:request>
433+
434+ <wadl:param style="query" name="ws.op"
435+ required="true"
436+ fixed="setsIncludingSource">
437+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
438+ </wadl:param>
439+ <wadl:param style="query" required="true"
440+ name="sourcepackagename">
441+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
442+Source package name
443+</wadl:doc>
444+
445+ </wadl:param>
446+ <wadl:param style="query" required="false"
447+ name="direct_inclusion">
448+
449+
450+ </wadl:param>
451+
452+ </wadl:request>
453+ <wadl:response>
454+
455+ <wadl:representation
456+ href="http://api.launchpad.dev/beta/#packageset-page"/>
457+ </wadl:response>
458+ </wadl:method>
459+ <wadl:method id="packagesets-getByName" name="GET">
460+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
461+<p>Return the single package set with the given name (if any).</p>
462+<table class="rst-docutils field-list" frame="void" rules="none">
463+<col class="field-name" />
464+<col class="field-body" />
465+<tbody valign="top">
466+<tr class="rst-field"><th class="rst-field-name">param name:</th><td class="rst-field-body">the name of the package set sought.</td>
467+</tr>
468+<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
469+<tr><td>&nbsp;</td><td class="rst-field-body">the distroseries to which the new packageset
470+is related. Defaults to the current Ubuntu series.</td>
471+</tr>
472+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An IPackageset instance or None.</td>
473+</tr>
474+</tbody>
475+</table>
476+
477+</wadl:doc>
478+ <wadl:request>
479+
480+ <wadl:param style="query" name="ws.op"
481+ required="true" fixed="getByName">
482+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
483+ </wadl:param>
484+ <wadl:param style="query" required="false"
485+ name="distroseries">
486+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
487+<p>Distroseries</p>
488+<p>The distribution series to which the packageset is related.</p>
489+
490+</wadl:doc>
491+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_series"/>
492+ </wadl:param>
493+ <wadl:param style="query" required="true"
494+ name="name">
495+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
496+Package set name
497+</wadl:doc>
498+
499+ </wadl:param>
500+
501+ </wadl:request>
502+ <wadl:response>
503+
504+ <wadl:representation
505+ href="http://api.launchpad.dev/beta/#packageset-full"/>
506+ </wadl:response>
507+ </wadl:method>
508+ <wadl:method id="packagesets-new" name="POST">
509+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
510+<p>Create a new package set.</p>
511+<table class="rst-docutils field-list" frame="void" rules="none">
512+<col class="field-name" />
513+<col class="field-body" />
514+<tbody valign="top">
515+<tr class="rst-field"><th class="rst-field-name">param name:</th><td class="rst-field-body">the name of the package set to be created.</td>
516+</tr>
517+<tr class="rst-field"><th class="rst-field-name" colspan="2">param description:</th></tr>
518+<tr><td>&nbsp;</td><td class="rst-field-body">the description for the package set to be created.</td>
519+</tr>
520+<tr class="rst-field"><th class="rst-field-name">param owner:</th><td class="rst-field-body">the owner of the package set to be created.</td>
521+</tr>
522+<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
523+<tr><td>&nbsp;</td><td class="rst-field-body">the distroseries to which the new packageset
524+is related. Defaults to the current Ubuntu series.</td>
525+</tr>
526+<tr class="rst-field"><th class="rst-field-name" colspan="2">param related_set:</th></tr>
527+<tr><td>&nbsp;</td><td class="rst-field-body">the newly created package set is to be related to
528+related_set (by being placed in the same package group).</td>
529+</tr>
530+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises DuplicatePackagesetName:</th></tr>
531+<tr><td>&nbsp;</td><td class="rst-field-body">if a package set with the same name
532+exists in distroseries already.</td>
533+</tr>
534+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a newly created IPackageset.</td>
535+</tr>
536+</tbody>
537+</table>
538+
539+</wadl:doc>
540+ <wadl:request>
541+ <wadl:representation
542+ mediaType="application/x-www-form-urlencoded">
543+ <wadl:param style="query" name="ws.op"
544+ required="true" fixed="new">
545+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
546+ </wadl:param>
547+ <wadl:param style="query" required="true"
548+ name="owner">
549+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
550+<p>Person</p>
551+<p>The person who owns this package set.</p>
552+
553+</wadl:doc>
554+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
555+ </wadl:param>
556+ <wadl:param style="query" required="false"
557+ name="distroseries">
558+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
559+<p>Distroseries</p>
560+<p>The distribution series to which the packageset is related.</p>
561+
562+</wadl:doc>
563+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_series"/>
564+ </wadl:param>
565+ <wadl:param style="query" required="true"
566+ name="description">
567+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
568+Package set description
569+</wadl:doc>
570+
571+ </wadl:param>
572+ <wadl:param style="query" required="true"
573+ name="name">
574+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
575+Valid package set name
576+</wadl:doc>
577+
578+ </wadl:param>
579+ <wadl:param style="query" required="false"
580+ name="related_set">
581+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
582+<p>Related package set</p>
583+<p>The new package set will share the package set group with this one.</p>
584+
585+</wadl:doc>
586+ <wadl:link resource_type="http://api.launchpad.dev/beta/#packageset"/>
587+ </wadl:param>
588+ </wadl:representation>
589+ </wadl:request>
590+ <wadl:response>
591+ <wadl:param name="Location" style="header">
592+ <wadl:link resource_type="http://api.launchpad.dev/beta/#packageset"/>
593+ </wadl:param>
594+
595+ </wadl:response>
596+ </wadl:method>
597+ </wadl:resource_type>
598+
599+
600+
601+ <wadl:resource_type id="people">
602+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
603+The set of Persons.
604+</wadl:doc>
605+ <wadl:method name="GET" id="people-get">
606+ <wadl:response>
607+ <wadl:representation
608+ href="http://api.launchpad.dev/beta/#person-page"/>
609+ <wadl:representation
610+ mediaType="application/vnd.sun.wadl+xml"
611+ id="people-wadl"/>
612+ </wadl:response>
613+ </wadl:method>
614+
615+ <wadl:method id="people-findPerson" name="GET">
616+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
617+<p>Return all non-merged Persons with at least one email address whose
618+name, displayname or email address match &lt;text&gt;.</p>
619+<p>If text is an empty string, all persons with at least one email
620+address will be returned.</p>
621+<p>The results will be ordered using the default ordering specified in
622+Person._defaultOrder.</p>
623+<p>If exclude_inactive_accounts is True, any accounts whose
624+account_status is any of INACTIVE_ACCOUNT_STATUSES will not be in the
625+returned set.</p>
626+<p>If must_have_email is True, only people with one or more email
627+addresses are returned.</p>
628+<p>While we don't have Full Text Indexes in the emailaddress table, we'll
629+be trying to match the text only against the beginning of an email
630+address.</p>
631+<p>If created_before or created_after are not None, they are used to
632+restrict the search to the dates provided.</p>
633+
634+</wadl:doc>
635+ <wadl:request>
636+
637+ <wadl:param style="query" name="ws.op"
638+ required="true" fixed="findPerson">
639+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
640+ </wadl:param>
641+ <wadl:param style="query" required="true"
642+ name="text">
643+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
644+Search text
645+</wadl:doc>
646+
647+ </wadl:param>
648+ <wadl:param style="query" required="false"
649+ type="xsd:dateTime"
650+ name="created_before">
651+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
652+Created before
653+</wadl:doc>
654+
655+ </wadl:param>
656+ <wadl:param style="query" required="false"
657+ type="xsd:dateTime"
658+ name="created_after">
659+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
660+Created after
661+</wadl:doc>
662+
663+ </wadl:param>
664+
665+ </wadl:request>
666+ <wadl:response>
667+
668+ <wadl:representation
669+ href="http://api.launchpad.dev/beta/#person-page"/>
670+ </wadl:response>
671+ </wadl:method>
672+ <wadl:method id="people-getByEmail" name="GET">
673+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
674+<p>Return the person with the given email address.</p>
675+<p>Return None if there is no person with the given email address.</p>
676+
677+</wadl:doc>
678+ <wadl:request>
679+
680+ <wadl:param style="query" name="ws.op"
681+ required="true" fixed="getByEmail">
682+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
683+ </wadl:param>
684+ <wadl:param style="query" required="true"
685+ name="email">
686+
687+
688+ </wadl:param>
689+
690+ </wadl:request>
691+ <wadl:response>
692+
693+ <wadl:representation
694+ href="http://api.launchpad.dev/beta/#person-full"/>
695+ </wadl:response>
696+ </wadl:method>
697+ <wadl:method id="people-find" name="GET">
698+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
699+<p>Return all non-merged Persons and Teams whose name, displayname or
700+email address match &lt;text&gt;.</p>
701+<p>The results will be ordered using the default ordering specified in
702+Person._defaultOrder.</p>
703+<p>While we don't have Full Text Indexes in the emailaddress table, we'll
704+be trying to match the text only against the beginning of an email
705+address.</p>
706+
707+</wadl:doc>
708+ <wadl:request>
709+
710+ <wadl:param style="query" name="ws.op"
711+ required="true" fixed="find">
712+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
713+ </wadl:param>
714+ <wadl:param style="query" required="true"
715+ name="text">
716+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
717+Search text
718+</wadl:doc>
719+
720+ </wadl:param>
721+
722+ </wadl:request>
723+ <wadl:response>
724+
725+ <wadl:representation
726+ href="http://api.launchpad.dev/beta/#person-page"/>
727+ </wadl:response>
728+ </wadl:method>
729+ <wadl:method id="people-findTeam" name="GET">
730+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
731+<p>Return all Teams whose name, displayname or email address
732+match &lt;text&gt;.</p>
733+<p>The results will be ordered using the default ordering specified in
734+Person._defaultOrder.</p>
735+<p>While we don't have Full Text Indexes in the emailaddress table, we'll
736+be trying to match the text only against the beginning of an email
737+address.</p>
738+
739+</wadl:doc>
740+ <wadl:request>
741+
742+ <wadl:param style="query" name="ws.op"
743+ required="true" fixed="findTeam">
744+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
745+ </wadl:param>
746+ <wadl:param style="query" required="true"
747+ name="text">
748+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
749+Search text
750+</wadl:doc>
751+
752+ </wadl:param>
753+
754+ </wadl:request>
755+ <wadl:response>
756+
757+ <wadl:representation
758+ href="http://api.launchpad.dev/beta/#person-page"/>
759+ </wadl:response>
760+ </wadl:method>
761+ <wadl:method id="people-newTeam" name="POST">
762+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
763+Create and return a new Team with given arguments.
764+</wadl:doc>
765+ <wadl:request>
766+ <wadl:representation
767+ mediaType="application/x-www-form-urlencoded">
768+ <wadl:param style="query" name="ws.op"
769+ required="true" fixed="newTeam">
770+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
771+ </wadl:param>
772+ <wadl:param style="query" required="true"
773+ name="display_name">
774+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
775+<p>Display Name</p>
776+<p>Your name as you would like it displayed throughout Launchpad. Most people use their full name here.</p>
777+
778+</wadl:doc>
779+
780+ </wadl:param>
781+ <wadl:param style="query" required="true"
782+ name="name">
783+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
784+<p>Name</p>
785+<p>A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.</p>
786+
787+</wadl:doc>
788+
789+ </wadl:param>
790+ <wadl:param style="query" required="false"
791+ name="default_membership_period">
792+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
793+<p>Subscription period</p>
794+<p>Number of days a new subscription lasts before expiring. You can customize the length of an individual subscription when approving it. Leave this empty or set to 0 for subscriptions to never expire.</p>
795+
796+</wadl:doc>
797+
798+ </wadl:param>
799+ <wadl:param style="query" required="false"
800+ name="team_description">
801+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
802+<p>Team Description</p>
803+<p>Include information on how to get involved with development. Use plain text; URLs will be linkified.</p>
804+
805+</wadl:doc>
806+
807+ </wadl:param>
808+ <wadl:param style="query" required="false"
809+ name="default_renewal_period">
810+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
811+<p>Renewal period</p>
812+<p>Number of days a subscription lasts after being renewed. You can customize the lengths of individual renewals, but this is what's used for auto-renewed and user-renewed memberships.</p>
813+
814+</wadl:doc>
815+
816+ </wadl:param>
817+ <wadl:param style="query" required="false"
818+ name="subscription_policy">
819+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
820+Subscription policy
821+</wadl:doc>
822+
823+ <wadl:option value="Moderated Team"/>
824+ <wadl:option value="Open Team"/>
825+ <wadl:option value="Restricted Team"/>
826+ </wadl:param>
827+ </wadl:representation>
828+ </wadl:request>
829+ <wadl:response>
830+ <wadl:param name="Location" style="header">
831+ <wadl:link resource_type="http://api.launchpad.dev/beta/#team"/>
832+ </wadl:param>
833+
834+ </wadl:response>
835+ </wadl:method>
836+ </wadl:resource_type>
837+
838+
839+
840+ <wadl:resource_type id="projects">
841+
842+ <wadl:method name="GET" id="projects-get">
843+ <wadl:response>
844+ <wadl:representation
845+ href="http://api.launchpad.dev/beta/#project-page"/>
846+ <wadl:representation
847+ mediaType="application/vnd.sun.wadl+xml"
848+ id="projects-wadl"/>
849+ </wadl:response>
850+ </wadl:method>
851+
852+ <wadl:method id="projects-search" name="GET">
853+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
854+Search through the Registry database for products that match the
855+query terms. text is a piece of text in the title / summary /
856+description fields of product. soyuz, bazaar, malone etc are
857+hints as to whether the search should be limited to products
858+that are active in those Launchpad applications.
859+</wadl:doc>
860+ <wadl:request>
861+
862+ <wadl:param style="query" name="ws.op"
863+ required="true" fixed="search">
864+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
865+ </wadl:param>
866+ <wadl:param style="query" required="false"
867+ name="text">
868+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
869+Search text
870+</wadl:doc>
871+
872+ </wadl:param>
873+
874+ </wadl:request>
875+ <wadl:response>
876+
877+ <wadl:representation
878+ href="http://api.launchpad.dev/beta/#project-page"/>
879+ </wadl:response>
880+ </wadl:method>
881+ <wadl:method id="projects-licensing_search" name="GET">
882+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
883+Return an iterator over products that need to be reviewed.
884+</wadl:doc>
885+ <wadl:request>
886+
887+ <wadl:param style="query" name="ws.op"
888+ required="true"
889+ fixed="licensing_search">
890+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
891+ </wadl:param>
892+ <wadl:param style="query" required="false"
893+ name="license_reviewed">
894+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
895+Is the project license reviewed
896+</wadl:doc>
897+
898+ </wadl:param>
899+ <wadl:param style="query" required="false"
900+ name="license_info_is_empty">
901+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
902+License info is empty
903+</wadl:doc>
904+
905+ </wadl:param>
906+ <wadl:param style="query" required="false"
907+ name="search_text">
908+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
909+Search text
910+</wadl:doc>
911+
912+ </wadl:param>
913+ <wadl:param style="query" required="false"
914+ name="has_zero_licenses">
915+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
916+Has zero licenses
917+</wadl:doc>
918+
919+ </wadl:param>
920+ <wadl:param style="query" required="false"
921+ type="xsd:date"
922+ name="subscription_expires_after">
923+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
924+Subscription expires after
925+</wadl:doc>
926+
927+ </wadl:param>
928+ <wadl:param style="query" required="false"
929+ name="active">
930+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
931+Is the project active
932+</wadl:doc>
933+
934+ </wadl:param>
935+ <wadl:param style="query" required="false"
936+ type="xsd:date"
937+ name="subscription_modified_after">
938+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
939+Subscription modified after
940+</wadl:doc>
941+
942+ </wadl:param>
943+ <wadl:param style="query" required="false"
944+ type="xsd:date" name="created_after">
945+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
946+Created after date
947+</wadl:doc>
948+
949+ </wadl:param>
950+ <wadl:param style="query" required="false"
951+ name="licenses">
952+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
953+Licenses
954+</wadl:doc>
955+
956+ </wadl:param>
957+ <wadl:param style="query" required="false"
958+ type="xsd:date"
959+ name="subscription_expires_before">
960+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
961+Subscription expired before
962+</wadl:doc>
963+
964+ </wadl:param>
965+ <wadl:param style="query" required="false"
966+ type="xsd:date"
967+ name="created_before">
968+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
969+Created before date
970+</wadl:doc>
971+
972+ </wadl:param>
973+ <wadl:param style="query" required="false"
974+ type="xsd:date"
975+ name="subscription_modified_before">
976+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
977+Subscription modified before
978+</wadl:doc>
979+
980+ </wadl:param>
981+
982+ </wadl:request>
983+ <wadl:response>
984+
985+ <wadl:representation
986+ href="http://api.launchpad.dev/beta/#project-page"/>
987+ </wadl:response>
988+ </wadl:method>
989+ <wadl:method id="projects-latest" name="GET">
990+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
991+<p>Return the latest projects registered in Launchpad.</p>
992+<p>If the quantity is not specified or is a value that is not 'None'
993+then the set of projects returned is limited to that value (the
994+default quantity is 5). If quantity is 'None' then all projects are
995+returned. For the web service it is not possible to specify the
996+quantity, so all projects are returned, latest first.</p>
997+
998+</wadl:doc>
999+ <wadl:request>
1000+
1001+ <wadl:param style="query" name="ws.op"
1002+ required="true" fixed="latest">
1003+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
1004+ </wadl:param>
1005+
1006+ </wadl:request>
1007+ <wadl:response>
1008+
1009+ <wadl:representation
1010+ href="http://api.launchpad.dev/beta/#project-page"/>
1011+ </wadl:response>
1012+ </wadl:method>
1013+ <wadl:method id="projects-new_project" name="POST">
1014+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1015+<p>Create and return a brand new Product.</p>
1016+<p>See IProduct for a description of the parameters.</p>
1017+
1018+</wadl:doc>
1019+ <wadl:request>
1020+ <wadl:representation
1021+ mediaType="application/x-www-form-urlencoded">
1022+ <wadl:param style="query" name="ws.op"
1023+ required="true" fixed="new_project">
1024+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
1025+ </wadl:param>
1026+ <wadl:param style="query" required="false"
1027+ name="wiki_url">
1028+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1029+<p>Wiki URL</p>
1030+<dl class="rst-docutils">
1031+<dt>The full URL of this project's wiki, if it has</dt>
1032+<dd>one. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1033+</dl>
1034+
1035+</wadl:doc>
1036+
1037+ </wadl:param>
1038+ <wadl:param style="query" required="false"
1039+ name="download_url">
1040+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1041+<p>Download URL</p>
1042+<dl class="rst-docutils">
1043+<dt>The full URL where downloads for this project</dt>
1044+<dd>are located, if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1045+</dl>
1046+
1047+</wadl:doc>
1048+
1049+ </wadl:param>
1050+ <wadl:param style="query" required="false"
1051+ name="license_reviewed">
1052+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1053+<p>Project reviewed</p>
1054+<p>Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.</p>
1055+
1056+</wadl:doc>
1057+
1058+ </wadl:param>
1059+ <wadl:param style="query" required="true"
1060+ name="display_name">
1061+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1062+<p>Display Name</p>
1063+<dl class="rst-docutils">
1064+<dt>The name of the project as it would appear in a</dt>
1065+<dd>paragraph.</dd>
1066+</dl>
1067+
1068+</wadl:doc>
1069+
1070+ </wadl:param>
1071+ <wadl:param style="query" required="false"
1072+ name="description">
1073+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1074+<p>Description</p>
1075+<dl class="rst-docutils">
1076+<dt>Include information on how to get involved with</dt>
1077+<dd>development. Don't repeat anything from the Summary.</dd>
1078+</dl>
1079+
1080+</wadl:doc>
1081+
1082+ </wadl:param>
1083+ <wadl:param style="query" required="true"
1084+ name="title">
1085+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1086+<p>Title</p>
1087+<p>The project title. Should be just a few words.</p>
1088+
1089+</wadl:doc>
1090+
1091+ </wadl:param>
1092+ <wadl:param style="query" required="true"
1093+ name="summary">
1094+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1095+<p>Summary</p>
1096+<p>The summary should be a single short paragraph.</p>
1097+
1098+</wadl:doc>
1099+
1100+ </wadl:param>
1101+ <wadl:param style="query" required="false"
1102+ name="project_group">
1103+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1104+<p>Part of</p>
1105+<p>Super-project. In Launchpad, we can setup a special &quot;project group&quot; that is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.</p>
1106+
1107+</wadl:doc>
1108+ <wadl:link resource_type="http://api.launchpad.dev/beta/#project_group"/>
1109+ </wadl:param>
1110+ <wadl:param style="query" required="false"
1111+ name="licenses">
1112+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1113+Licenses
1114+</wadl:doc>
1115+
1116+ </wadl:param>
1117+ <wadl:param style="query" required="false"
1118+ name="freshmeat_project">
1119+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1120+<p>Freshmeat Project</p>
1121+<dl class="rst-docutils">
1122+<dt>The Freshmeat project name for</dt>
1123+<dd>this project, if it is in freshmeat.</dd>
1124+</dl>
1125+
1126+</wadl:doc>
1127+
1128+ </wadl:param>
1129+ <wadl:param style="query" required="false"
1130+ name="sourceforge_project">
1131+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1132+<p>Sourceforge Project</p>
1133+<dl class="rst-docutils">
1134+<dt>The SourceForge project name for</dt>
1135+<dd>this project, if it is in sourceforge.</dd>
1136+</dl>
1137+
1138+</wadl:doc>
1139+
1140+ </wadl:param>
1141+ <wadl:param style="query" required="false"
1142+ name="programming_lang">
1143+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1144+<p>Programming Languages</p>
1145+<dl class="rst-docutils">
1146+<dt>A comma delimited list of programming</dt>
1147+<dd>languages used for this project.</dd>
1148+</dl>
1149+
1150+</wadl:doc>
1151+
1152+ </wadl:param>
1153+ <wadl:param style="query" required="false"
1154+ name="screenshots_url">
1155+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1156+<p>Screenshots URL</p>
1157+<dl class="rst-docutils">
1158+<dt>The full URL for screenshots of this project,</dt>
1159+<dd>if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1160+</dl>
1161+
1162+</wadl:doc>
1163+
1164+ </wadl:param>
1165+ <wadl:param style="query" required="false"
1166+ name="license_info">
1167+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1168+<p>Description of additional licenses</p>
1169+<p>Description of licenses that do not appear in the list above.</p>
1170+
1171+</wadl:doc>
1172+
1173+ </wadl:param>
1174+ <wadl:param style="query" required="false"
1175+ name="home_page_url">
1176+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1177+<p>Homepage URL</p>
1178+<dl class="rst-docutils">
1179+<dt>The project home page. Please include</dt>
1180+<dd>the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1181+</dl>
1182+
1183+</wadl:doc>
1184+
1185+ </wadl:param>
1186+ <wadl:param style="query" required="false"
1187+ name="registrant">
1188+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1189+<p>Registrant</p>
1190+<p>This person registered the project in Launchpad.</p>
1191+
1192+</wadl:doc>
1193+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
1194+ </wadl:param>
1195+ <wadl:param style="query" required="true"
1196+ name="name">
1197+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1198+<p>Name</p>
1199+<p>At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs as shown above.</p>
1200+
1201+</wadl:doc>
1202+
1203+ </wadl:param>
1204+ </wadl:representation>
1205+ </wadl:request>
1206+ <wadl:response>
1207+ <wadl:param name="Location" style="header">
1208+ <wadl:link resource_type="http://api.launchpad.dev/beta/#project"/>
1209+ </wadl:param>
1210+
1211+ </wadl:response>
1212+ </wadl:method>
1213+ </wadl:resource_type>
1214+
1215+
1216+
1217+ <wadl:resource_type id="project_groups">
1218+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1219+The collection of projects.
1220+</wadl:doc>
1221+ <wadl:method name="GET" id="project_groups-get">
1222+ <wadl:response>
1223+ <wadl:representation
1224+ href="http://api.launchpad.dev/beta/#project_group-page"/>
1225+ <wadl:representation
1226+ mediaType="application/vnd.sun.wadl+xml"
1227+ id="project_groups-wadl"/>
1228+ </wadl:response>
1229+ </wadl:method>
1230+
1231+ <wadl:method id="project_groups-search" name="GET">
1232+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1233+Search through the Registry database for projects that match the
1234+query terms. text is a piece of text in the title / summary /
1235+description fields of project (and possibly product). soyuz,
1236+bazaar, malone etc are hints as to whether the search should
1237+be limited to projects that are active in those Launchpad
1238+applications.
1239+</wadl:doc>
1240+ <wadl:request>
1241+
1242+ <wadl:param style="query" name="ws.op"
1243+ required="true" fixed="search">
1244+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
1245+ </wadl:param>
1246+ <wadl:param style="query" required="false"
1247+ name="text">
1248+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1249+Search text
1250+</wadl:doc>
1251+
1252+ </wadl:param>
1253+
1254+ </wadl:request>
1255+ <wadl:response>
1256+
1257+ <wadl:representation
1258+ href="http://api.launchpad.dev/beta/#project_group-page"/>
1259+ </wadl:response>
1260+ </wadl:method>
1261+ </wadl:resource_type>
1262+
1263+
1264+
1265+ <wadl:resource_type id="translation_import_queue_entries">
1266+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1267+A set of files to be imported into Rosetta.
1268+</wadl:doc>
1269+ <wadl:method name="GET"
1270+ id="translation_import_queue_entries-get">
1271+ <wadl:response>
1272+ <wadl:representation
1273+ href="http://api.launchpad.dev/beta/#translation_import_queue_entry-page"/>
1274+ <wadl:representation
1275+ mediaType="application/vnd.sun.wadl+xml"
1276+ id="translation_import_queue_entries-wadl"/>
1277+ </wadl:response>
1278+ </wadl:method>
1279+
1280+ <wadl:method id="translation_import_queue_entries-getAllEntries"
1281+ name="GET">
1282+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1283+<p>Return all entries this import queue has.</p>
1284+<table class="rst-docutils field-list" frame="void" rules="none">
1285+<col class="field-name" />
1286+<col class="field-body" />
1287+<tbody valign="top">
1288+<tr class="rst-field"><th class="rst-field-name">arg target:</th><td class="rst-field-body">IPerson, IProduct, IProductSeries, IDistribution,
1289+IDistroSeries or ISourcePackage the import entries are attached to
1290+or None to get all entries available.</td>
1291+</tr>
1292+<tr class="rst-field"><th class="rst-field-name" colspan="2">arg import_status:</th></tr>
1293+<tr><td>&nbsp;</td><td class="rst-field-body">RosettaImportStatus entry.</td>
1294+</tr>
1295+<tr class="rst-field"><th class="rst-field-name" colspan="2">arg file_extensions:</th></tr>
1296+<tr><td>&nbsp;</td><td class="rst-field-body">Sequence of filename suffixes to match, usually
1297+'po' or 'pot'.</td>
1298+</tr>
1299+</tbody>
1300+</table>
1301+<p>If any of target, status or file_extension are given, the returned
1302+entries are filtered based on those values.</p>
1303+
1304+</wadl:doc>
1305+ <wadl:request>
1306+
1307+ <wadl:param style="query" name="ws.op"
1308+ required="true"
1309+ fixed="getAllEntries">
1310+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
1311+ </wadl:param>
1312+ <wadl:param style="query" required="false"
1313+ name="import_status">
1314+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1315+The status of the import.
1316+</wadl:doc>
1317+
1318+ </wadl:param>
1319+
1320+ </wadl:request>
1321+ <wadl:response>
1322+
1323+ <wadl:representation
1324+ href="http://api.launchpad.dev/beta/#translation_import_queue_entry-page"/>
1325+ </wadl:response>
1326+ </wadl:method>
1327+ <wadl:method id="translation_import_queue_entries-getRequestTargets"
1328+ name="GET">
1329+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1330+<p>List Product`s and `DistroSeries with pending imports.</p>
1331+<table class="rst-docutils field-list" frame="void" rules="none">
1332+<col class="field-name" />
1333+<col class="field-body" />
1334+<tbody valign="top">
1335+<tr class="rst-field"><th class="rst-field-name">arg status:</th><td class="rst-field-body">Filter by RosettaImportStatus.</td>
1336+</tr>
1337+</tbody>
1338+</table>
1339+<p>All returned items will implement IHasTranslationImports.</p>
1340+
1341+</wadl:doc>
1342+ <wadl:request>
1343+
1344+ <wadl:param style="query" name="ws.op"
1345+ required="true"
1346+ fixed="getRequestTargets">
1347+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
1348+ </wadl:param>
1349+ <wadl:param style="query" required="false"
1350+ name="status">
1351+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1352+The status of the import.
1353+</wadl:doc>
1354+
1355+ </wadl:param>
1356+
1357+ </wadl:request>
1358+ <wadl:response>
1359+
1360+ <wadl:representation
1361+ href="http://api.launchpad.dev/beta/#object_with_translation_imports-page"/>
1362+ </wadl:response>
1363+ </wadl:method>
1364+ <wadl:method id="translation_import_queue_entries-getFirstEntryToImport"
1365+ name="GET">
1366+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1367+<p>Return the first entry of the queue ready to be imported.</p>
1368+<table class="rst-docutils field-list" frame="void" rules="none">
1369+<col class="field-name" />
1370+<col class="field-body" />
1371+<tbody valign="top">
1372+<tr class="rst-field"><th class="rst-field-name">param target:</th><td class="rst-field-body">IPerson, IProduct, IProductSeries, IDistribution,
1373+IDistroSeries or ISourcePackage the import entries are attached to
1374+or None to get all entries available.</td>
1375+</tr>
1376+</tbody>
1377+</table>
1378+
1379+</wadl:doc>
1380+ <wadl:request>
1381+
1382+ <wadl:param style="query" name="ws.op"
1383+ required="true"
1384+ fixed="getFirstEntryToImport">
1385+ <wadl:doc>The name of the operation being invoked.</wadl:doc>
1386+ </wadl:param>
1387+ <wadl:param style="query" required="false"
1388+ name="target">
1389+
1390+ <wadl:link resource_type="http://api.launchpad.dev/beta/#object_with_translation_imports"/>
1391+ </wadl:param>
1392+
1393+ </wadl:request>
1394+ <wadl:response>
1395+
1396+ <wadl:representation
1397+ href="http://api.launchpad.dev/beta/#translation_import_queue_entry-full"/>
1398+ </wadl:response>
1399+ </wadl:method>
1400+ </wadl:resource_type>
1401+
1402+
1403+ <!--End resource_type definitions for collection resources.-->
1404+
1405+ <!--Begin representation and resource_type definitions for entry
1406+ resources and the collections that contain them. -->
1407+
1408+ <wadl:resource_type id="archive_dependency">
1409+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1410+ArchiveDependency interface.
1411+</wadl:doc>
1412+ <wadl:method name="GET" id="archive_dependency-get">
1413+ <wadl:response>
1414+ <wadl:representation
1415+ href="http://api.launchpad.dev/beta/#archive_dependency-full"/>
1416+ <wadl:representation
1417+ mediaType="application/xhtml+xml"
1418+ id="archive_dependency-xhtml"/>
1419+ <wadl:representation
1420+ mediaType="application/vnd.sun.wadl+xml"
1421+ id="archive_dependency-wadl"/>
1422+ </wadl:response>
1423+ </wadl:method>
1424+
1425+ <wadl:method name="PUT" id="archive_dependency-put">
1426+ <wadl:request>
1427+ <wadl:representation
1428+ href="http://api.launchpad.dev/beta/#archive_dependency-full"/>
1429+ </wadl:request>
1430+ </wadl:method>
1431+
1432+ <wadl:method name="PATCH"
1433+ id="archive_dependency-patch">
1434+ <wadl:request>
1435+ <wadl:representation
1436+ href="http://api.launchpad.dev/beta/#archive_dependency-diff"/>
1437+ </wadl:request>
1438+ </wadl:method>
1439+
1440+
1441+
1442+ </wadl:resource_type>
1443+
1444+
1445+ <wadl:representation mediaType="application/json"
1446+ id="archive_dependency-full">
1447+ <wadl:param style="plain" name="self_link" path="$['self_link']">
1448+ <wadl:doc>The canonical link to this resource.</wadl:doc>
1449+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_dependency"/>
1450+ </wadl:param>
1451+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
1452+ <wadl:doc>
1453+ The link to the WADL description of this resource.
1454+ </wadl:doc>
1455+ <wadl:link/>
1456+ </wadl:param>
1457+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
1458+ <wadl:doc>
1459+ The value of the HTTP ETag for this resource.
1460+ </wadl:doc>
1461+ </wadl:param>
1462+ <wadl:param style="plain" required="true"
1463+ path="$['title']" name="title">
1464+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1465+Archive dependency title.
1466+</wadl:doc>
1467+
1468+ </wadl:param>
1469+ <wadl:param style="plain" required="true"
1470+ path="$['pocket']" name="pocket">
1471+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1472+Pocket
1473+</wadl:doc>
1474+
1475+ <wadl:option value="Release"/>
1476+ <wadl:option value="Security"/>
1477+ <wadl:option value="Updates"/>
1478+ <wadl:option value="Proposed"/>
1479+ <wadl:option value="Backports"/>
1480+ </wadl:param>
1481+ <wadl:param style="plain" required="true"
1482+ path="$['dependency_link']"
1483+ name="dependency_link">
1484+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1485+The archive set as a dependency.
1486+</wadl:doc>
1487+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
1488+ </wadl:param>
1489+ <wadl:param style="plain" required="true"
1490+ path="$['date_created']"
1491+ type="xsd:dateTime" name="date_created">
1492+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1493+Instant when the dependency was created.
1494+</wadl:doc>
1495+
1496+ </wadl:param>
1497+ <wadl:param style="plain" required="true"
1498+ path="$['archive_link']"
1499+ name="archive_link">
1500+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1501+<p>Target archive</p>
1502+<p>The archive affected by this dependecy.</p>
1503+
1504+</wadl:doc>
1505+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
1506+ </wadl:param>
1507+ <wadl:param style="plain" required="true"
1508+ path="$['component_name']"
1509+ name="component_name">
1510+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1511+Component name
1512+</wadl:doc>
1513+
1514+ </wadl:param>
1515+ </wadl:representation>
1516+
1517+ <wadl:representation mediaType="application/json"
1518+ id="archive_dependency-diff">
1519+ </wadl:representation>
1520+
1521+ <!--Collection page for this type of entry-->
1522+ <wadl:resource_type id="archive_dependency-page-resource">
1523+ <wadl:method name="GET"
1524+ id="archive_dependency-page-resource-get">
1525+ <wadl:response>
1526+ <wadl:representation
1527+ href="#archive_dependency-page"/>
1528+ </wadl:response>
1529+ </wadl:method>
1530+ </wadl:resource_type>
1531+
1532+ <wadl:representation mediaType="application/json"
1533+ id="archive_dependency-page">
1534+
1535+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
1536+ <wadl:link/>
1537+ </wadl:param>
1538+
1539+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
1540+
1541+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
1542+
1543+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
1544+ <wadl:link resource_type="#archive_dependency-page-resource"/>
1545+ </wadl:param>
1546+
1547+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
1548+ <wadl:link resource_type="#archive_dependency-page-resource"/>
1549+ </wadl:param>
1550+
1551+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
1552+
1553+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
1554+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_dependency"/>
1555+ </wadl:param>
1556+ </wadl:representation>
1557+
1558+
1559+
1560+ <wadl:resource_type id="archive_permission">
1561+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1562+The interface for ArchivePermission.
1563+</wadl:doc>
1564+ <wadl:method name="GET" id="archive_permission-get">
1565+ <wadl:response>
1566+ <wadl:representation
1567+ href="http://api.launchpad.dev/beta/#archive_permission-full"/>
1568+ <wadl:representation
1569+ mediaType="application/xhtml+xml"
1570+ id="archive_permission-xhtml"/>
1571+ <wadl:representation
1572+ mediaType="application/vnd.sun.wadl+xml"
1573+ id="archive_permission-wadl"/>
1574+ </wadl:response>
1575+ </wadl:method>
1576+
1577+ <wadl:method name="PUT" id="archive_permission-put">
1578+ <wadl:request>
1579+ <wadl:representation
1580+ href="http://api.launchpad.dev/beta/#archive_permission-full"/>
1581+ </wadl:request>
1582+ </wadl:method>
1583+
1584+ <wadl:method name="PATCH"
1585+ id="archive_permission-patch">
1586+ <wadl:request>
1587+ <wadl:representation
1588+ href="http://api.launchpad.dev/beta/#archive_permission-diff"/>
1589+ </wadl:request>
1590+ </wadl:method>
1591+
1592+
1593+
1594+ </wadl:resource_type>
1595+
1596+
1597+ <wadl:representation mediaType="application/json"
1598+ id="archive_permission-full">
1599+ <wadl:param style="plain" name="self_link" path="$['self_link']">
1600+ <wadl:doc>The canonical link to this resource.</wadl:doc>
1601+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_permission"/>
1602+ </wadl:param>
1603+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
1604+ <wadl:doc>
1605+ The link to the WADL description of this resource.
1606+ </wadl:doc>
1607+ <wadl:link/>
1608+ </wadl:param>
1609+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
1610+ <wadl:doc>
1611+ The value of the HTTP ETag for this resource.
1612+ </wadl:doc>
1613+ </wadl:param>
1614+ <wadl:param style="plain" required="true"
1615+ path="$['distro_series_name']"
1616+ name="distro_series_name">
1617+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1618+The name of the distro series associated with the package set.
1619+</wadl:doc>
1620+
1621+ </wadl:param>
1622+ <wadl:param style="plain" required="true"
1623+ path="$['permission']" name="permission">
1624+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1625+The permission type being granted.
1626+</wadl:doc>
1627+
1628+ </wadl:param>
1629+ <wadl:param style="plain" required="true"
1630+ path="$['explicit']" name="explicit">
1631+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1632+<p>Explicit</p>
1633+<p>Set this flag for package sets with high-profile packages requiring specialist skills for proper handling.</p>
1634+
1635+</wadl:doc>
1636+
1637+ </wadl:param>
1638+ <wadl:param style="plain" required="true"
1639+ path="$['source_package_name']"
1640+ name="source_package_name">
1641+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1642+Source Package Name
1643+</wadl:doc>
1644+
1645+ </wadl:param>
1646+ <wadl:param style="plain" required="true"
1647+ path="$['package_set_name']"
1648+ name="package_set_name">
1649+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1650+Package set name
1651+</wadl:doc>
1652+
1653+ </wadl:param>
1654+ <wadl:param style="plain" required="true"
1655+ path="$['person_link']" name="person_link">
1656+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1657+<p>Person</p>
1658+<p>The person or team being granted the permission.</p>
1659+
1660+</wadl:doc>
1661+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
1662+ </wadl:param>
1663+ <wadl:param style="plain" required="true"
1664+ path="$['date_created']"
1665+ type="xsd:dateTime" name="date_created">
1666+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1667+<p>Date Created</p>
1668+<p>The timestamp when the permission was created.</p>
1669+
1670+</wadl:doc>
1671+
1672+ </wadl:param>
1673+ <wadl:param style="plain" required="true"
1674+ path="$['archive_link']"
1675+ name="archive_link">
1676+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1677+<p>Archive</p>
1678+<p>The archive that this permission is for.</p>
1679+
1680+</wadl:doc>
1681+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
1682+ </wadl:param>
1683+ <wadl:param style="plain" required="true"
1684+ path="$['component_name']"
1685+ name="component_name">
1686+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1687+Component Name
1688+</wadl:doc>
1689+
1690+ </wadl:param>
1691+ </wadl:representation>
1692+
1693+ <wadl:representation mediaType="application/json"
1694+ id="archive_permission-diff">
1695+ <wadl:param style="plain" required="false"
1696+ path="$['distro_series_name']"
1697+ name="distro_series_name">
1698+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1699+The name of the distro series associated with the package set.
1700+</wadl:doc>
1701+
1702+ </wadl:param>
1703+ <wadl:param style="plain" required="false"
1704+ path="$['permission']" name="permission">
1705+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1706+The permission type being granted.
1707+</wadl:doc>
1708+
1709+ </wadl:param>
1710+ <wadl:param style="plain" required="false"
1711+ path="$['explicit']" name="explicit">
1712+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1713+<p>Explicit</p>
1714+<p>Set this flag for package sets with high-profile packages requiring specialist skills for proper handling.</p>
1715+
1716+</wadl:doc>
1717+
1718+ </wadl:param>
1719+ <wadl:param style="plain" required="false"
1720+ path="$['source_package_name']"
1721+ name="source_package_name">
1722+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1723+Source Package Name
1724+</wadl:doc>
1725+
1726+ </wadl:param>
1727+ <wadl:param style="plain" required="false"
1728+ path="$['package_set_name']"
1729+ name="package_set_name">
1730+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1731+Package set name
1732+</wadl:doc>
1733+
1734+ </wadl:param>
1735+ <wadl:param style="plain" required="false"
1736+ path="$['person_link']" name="person_link">
1737+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1738+<p>Person</p>
1739+<p>The person or team being granted the permission.</p>
1740+
1741+</wadl:doc>
1742+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
1743+ </wadl:param>
1744+ <wadl:param style="plain" required="false"
1745+ path="$['date_created']"
1746+ type="xsd:dateTime" name="date_created">
1747+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1748+<p>Date Created</p>
1749+<p>The timestamp when the permission was created.</p>
1750+
1751+</wadl:doc>
1752+
1753+ </wadl:param>
1754+ <wadl:param style="plain" required="false"
1755+ path="$['archive_link']"
1756+ name="archive_link">
1757+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1758+<p>Archive</p>
1759+<p>The archive that this permission is for.</p>
1760+
1761+</wadl:doc>
1762+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
1763+ </wadl:param>
1764+ <wadl:param style="plain" required="false"
1765+ path="$['component_name']"
1766+ name="component_name">
1767+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1768+Component Name
1769+</wadl:doc>
1770+
1771+ </wadl:param>
1772+ </wadl:representation>
1773+
1774+ <!--Collection page for this type of entry-->
1775+ <wadl:resource_type id="archive_permission-page-resource">
1776+ <wadl:method name="GET"
1777+ id="archive_permission-page-resource-get">
1778+ <wadl:response>
1779+ <wadl:representation
1780+ href="#archive_permission-page"/>
1781+ </wadl:response>
1782+ </wadl:method>
1783+ </wadl:resource_type>
1784+
1785+ <wadl:representation mediaType="application/json"
1786+ id="archive_permission-page">
1787+
1788+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
1789+ <wadl:link/>
1790+ </wadl:param>
1791+
1792+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
1793+
1794+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
1795+
1796+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
1797+ <wadl:link resource_type="#archive_permission-page-resource"/>
1798+ </wadl:param>
1799+
1800+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
1801+ <wadl:link resource_type="#archive_permission-page-resource"/>
1802+ </wadl:param>
1803+
1804+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
1805+
1806+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
1807+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_permission"/>
1808+ </wadl:param>
1809+ </wadl:representation>
1810+
1811+
1812+
1813+ <wadl:resource_type id="archive_subscriber">
1814+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1815+An interface for archive subscribers.
1816+</wadl:doc>
1817+ <wadl:method name="GET" id="archive_subscriber-get">
1818+ <wadl:response>
1819+ <wadl:representation
1820+ href="http://api.launchpad.dev/beta/#archive_subscriber-full"/>
1821+ <wadl:representation
1822+ mediaType="application/xhtml+xml"
1823+ id="archive_subscriber-xhtml"/>
1824+ <wadl:representation
1825+ mediaType="application/vnd.sun.wadl+xml"
1826+ id="archive_subscriber-wadl"/>
1827+ </wadl:response>
1828+ </wadl:method>
1829+
1830+ <wadl:method name="PUT" id="archive_subscriber-put">
1831+ <wadl:request>
1832+ <wadl:representation
1833+ href="http://api.launchpad.dev/beta/#archive_subscriber-full"/>
1834+ </wadl:request>
1835+ </wadl:method>
1836+
1837+ <wadl:method name="PATCH"
1838+ id="archive_subscriber-patch">
1839+ <wadl:request>
1840+ <wadl:representation
1841+ href="http://api.launchpad.dev/beta/#archive_subscriber-diff"/>
1842+ </wadl:request>
1843+ </wadl:method>
1844+
1845+
1846+
1847+ </wadl:resource_type>
1848+
1849+
1850+ <wadl:representation mediaType="application/json"
1851+ id="archive_subscriber-full">
1852+ <wadl:param style="plain" name="self_link" path="$['self_link']">
1853+ <wadl:doc>The canonical link to this resource.</wadl:doc>
1854+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_subscriber"/>
1855+ </wadl:param>
1856+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
1857+ <wadl:doc>
1858+ The link to the WADL description of this resource.
1859+ </wadl:doc>
1860+ <wadl:link/>
1861+ </wadl:param>
1862+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
1863+ <wadl:doc>
1864+ The value of the HTTP ETag for this resource.
1865+ </wadl:doc>
1866+ </wadl:param>
1867+ <wadl:param style="plain" required="true"
1868+ path="$['status']" name="status">
1869+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1870+<p>Status</p>
1871+<p>The status of this subscription.</p>
1872+
1873+</wadl:doc>
1874+
1875+ <wadl:option value="Active"/>
1876+ <wadl:option value="Expired"/>
1877+ <wadl:option value="Cancelled"/>
1878+ </wadl:param>
1879+ <wadl:param style="plain" required="true"
1880+ path="$['description']" name="description">
1881+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1882+<p>Description</p>
1883+<p>Free text describing this subscription.</p>
1884+
1885+</wadl:doc>
1886+
1887+ </wadl:param>
1888+ <wadl:param style="plain" required="true"
1889+ path="$['registrant_link']"
1890+ name="registrant_link">
1891+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1892+<p>Registrant</p>
1893+<p>The person who registered this subscription.</p>
1894+
1895+</wadl:doc>
1896+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
1897+ </wadl:param>
1898+ <wadl:param style="plain" required="true"
1899+ path="$['subscriber_link']"
1900+ name="subscriber_link">
1901+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1902+<p>Subscriber</p>
1903+<p>The person who is subscribed.</p>
1904+
1905+</wadl:doc>
1906+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
1907+ </wadl:param>
1908+ <wadl:param style="plain" required="true"
1909+ path="$['date_expires']"
1910+ type="xsd:dateTime" name="date_expires">
1911+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1912+<p>Date of Expiration</p>
1913+<p>The timestamp when the subscription will expire.</p>
1914+
1915+</wadl:doc>
1916+
1917+ </wadl:param>
1918+ <wadl:param style="plain" required="true"
1919+ path="$['date_created']"
1920+ type="xsd:dateTime" name="date_created">
1921+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1922+<p>Date Created</p>
1923+<p>The timestamp when the subscription was created.</p>
1924+
1925+</wadl:doc>
1926+
1927+ </wadl:param>
1928+ <wadl:param style="plain" required="true"
1929+ path="$['archive_link']"
1930+ name="archive_link">
1931+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1932+<p>Archive</p>
1933+<p>The archive for this subscription.</p>
1934+
1935+</wadl:doc>
1936+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
1937+ </wadl:param>
1938+ </wadl:representation>
1939+
1940+ <wadl:representation mediaType="application/json"
1941+ id="archive_subscriber-diff">
1942+ <wadl:param style="plain" required="false"
1943+ path="$['status']" name="status">
1944+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1945+<p>Status</p>
1946+<p>The status of this subscription.</p>
1947+
1948+</wadl:doc>
1949+
1950+ <wadl:option value="Active"/>
1951+ <wadl:option value="Expired"/>
1952+ <wadl:option value="Cancelled"/>
1953+ </wadl:param>
1954+ <wadl:param style="plain" required="false"
1955+ path="$['description']" name="description">
1956+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1957+<p>Description</p>
1958+<p>Free text describing this subscription.</p>
1959+
1960+</wadl:doc>
1961+
1962+ </wadl:param>
1963+ <wadl:param style="plain" required="false"
1964+ path="$['date_expires']"
1965+ type="xsd:dateTime" name="date_expires">
1966+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1967+<p>Date of Expiration</p>
1968+<p>The timestamp when the subscription will expire.</p>
1969+
1970+</wadl:doc>
1971+
1972+ </wadl:param>
1973+ </wadl:representation>
1974+
1975+ <!--Collection page for this type of entry-->
1976+ <wadl:resource_type id="archive_subscriber-page-resource">
1977+ <wadl:method name="GET"
1978+ id="archive_subscriber-page-resource-get">
1979+ <wadl:response>
1980+ <wadl:representation
1981+ href="#archive_subscriber-page"/>
1982+ </wadl:response>
1983+ </wadl:method>
1984+ </wadl:resource_type>
1985+
1986+ <wadl:representation mediaType="application/json"
1987+ id="archive_subscriber-page">
1988+
1989+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
1990+ <wadl:link/>
1991+ </wadl:param>
1992+
1993+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
1994+
1995+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
1996+
1997+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
1998+ <wadl:link resource_type="#archive_subscriber-page-resource"/>
1999+ </wadl:param>
2000+
2001+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
2002+ <wadl:link resource_type="#archive_subscriber-page-resource"/>
2003+ </wadl:param>
2004+
2005+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
2006+
2007+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
2008+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_subscriber"/>
2009+ </wadl:param>
2010+ </wadl:representation>
2011+
2012+
2013+
2014+ <wadl:resource_type id="archive">
2015+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2016+Main Archive interface.
2017+</wadl:doc>
2018+ <wadl:method name="GET" id="archive-get">
2019+ <wadl:response>
2020+ <wadl:representation
2021+ href="http://api.launchpad.dev/beta/#archive-full"/>
2022+ <wadl:representation
2023+ mediaType="application/xhtml+xml" id="archive-xhtml"/>
2024+ <wadl:representation
2025+ mediaType="application/vnd.sun.wadl+xml"
2026+ id="archive-wadl"/>
2027+ </wadl:response>
2028+ </wadl:method>
2029+
2030+ <wadl:method name="PUT" id="archive-put">
2031+ <wadl:request>
2032+ <wadl:representation
2033+ href="http://api.launchpad.dev/beta/#archive-full"/>
2034+ </wadl:request>
2035+ </wadl:method>
2036+
2037+ <wadl:method name="PATCH" id="archive-patch">
2038+ <wadl:request>
2039+ <wadl:representation
2040+ href="http://api.launchpad.dev/beta/#archive-diff"/>
2041+ </wadl:request>
2042+ </wadl:method>
2043+
2044+
2045+
2046+ <wadl:method id="archive-isSourceUploadAllowed"
2047+ name="GET">
2048+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2049+<p>True if the person is allowed to upload the given source package.</p>
2050+<dl class="rst-docutils">
2051+<dt>Return True if there exists a permission that combines</dt>
2052+<dd><ul class="rst-first rst-last rst-simple">
2053+<li>this archive</li>
2054+<li>a package set that includes the given source package name</li>
2055+<li>the given person or a team he is a member of</li>
2056+</ul>
2057+</dd>
2058+</dl>
2059+<p>If the source package name is included by <em>any</em> package set with
2060+an explicit permission then only such explicit permissions will
2061+be considered.</p>
2062+<table class="rst-docutils field-list" frame="void" rules="none">
2063+<col class="field-name" />
2064+<col class="field-body" />
2065+<tbody valign="top">
2066+<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2067+<tr><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2068+either a string or a ISourcePackageName.</td>
2069+</tr>
2070+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson for whom you want to find out which
2071+package sets he has access to.</td>
2072+</tr>
2073+<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
2074+<tr><td>&nbsp;</td><td class="rst-field-body">The IDistroSeries for which to check
2075+permissions. If none is supplied then currentseries in
2076+Ubuntu is assumed.</td>
2077+</tr>
2078+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2079+<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the
2080+given name could not be found.</td>
2081+</tr>
2082+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">True if the person is allowed to upload the source package.</td>
2083+</tr>
2084+</tbody>
2085+</table>
2086+
2087+</wadl:doc>
2088+ <wadl:request>
2089+
2090+ <wadl:param style="query" name="ws.op"
2091+ required="true"
2092+ fixed="isSourceUploadAllowed"/>
2093+ <wadl:param style="query" required="true"
2094+ name="person">
2095+
2096+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
2097+ </wadl:param>
2098+ <wadl:param style="query" required="false"
2099+ name="distroseries">
2100+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2101+The distro series
2102+</wadl:doc>
2103+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_series"/>
2104+ </wadl:param>
2105+ <wadl:param style="query" required="true"
2106+ name="sourcepackagename">
2107+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2108+Source package name
2109+</wadl:doc>
2110+
2111+ </wadl:param>
2112+
2113+ </wadl:request>
2114+
2115+ </wadl:method>
2116+ <wadl:method id="archive-getBuildCounters" name="GET">
2117+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2118+<p>Return a dictionary containing the build counters for an archive.</p>
2119+<p>This is necessary currently because the IArchive.failed_builds etc.
2120+counters are not in use.</p>
2121+<p>The returned dictionary contains the follwoing keys and values:</p>
2122+<blockquote>
2123+<ul class="rst-simple">
2124+<li>'total': total number of builds (includes SUPERSEDED);</li>
2125+<li>'pending': number of builds in BUILDING or NEEDSBUILD state;</li>
2126+<li>'failed': number of builds in FAILEDTOBUILD, MANUALDEPWAIT,
2127+CHROOTWAIT and FAILEDTOUPLOAD state;</li>
2128+<li>'succeeded': number of SUCCESSFULLYBUILT builds.</li>
2129+<li>'superseded': number of SUPERSEDED builds.</li>
2130+</ul>
2131+</blockquote>
2132+<table class="rst-docutils field-list" frame="void" rules="none">
2133+<col class="field-name" />
2134+<col class="field-body" />
2135+<tbody valign="top">
2136+<tr class="rst-field"><th class="rst-field-name" colspan="2">param include_needsbuild:</th></tr>
2137+<tr><td>&nbsp;</td><td class="rst-field-body">Indicates whether to include builds with
2138+the status NEEDSBUILD in the pending and total counts. This is
2139+useful in situations where a build that hasn't started isn't
2140+considered a build by the user.</td>
2141+</tr>
2142+<tr class="rst-field"><th class="rst-field-name" colspan="2">type include_needsbuild:</th></tr>
2143+<tr><td>&nbsp;</td><td class="rst-field-body"><tt class="rst-docutils literal"><span class="pre">bool</span></tt></td>
2144+</tr>
2145+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a dictionary with the 4 keys specified above.</td>
2146+</tr>
2147+<tr class="rst-field"><th class="rst-field-name">rtype:</th><td class="rst-field-body"><tt class="rst-docutils literal"><span class="pre">dict</span></tt>.</td>
2148+</tr>
2149+</tbody>
2150+</table>
2151+
2152+</wadl:doc>
2153+ <wadl:request>
2154+
2155+ <wadl:param style="query" name="ws.op"
2156+ required="true"
2157+ fixed="getBuildCounters"/>
2158+ <wadl:param style="query" required="false"
2159+ name="include_needsbuild">
2160+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2161+Include builds with state NEEDSBUILD
2162+</wadl:doc>
2163+
2164+ </wadl:param>
2165+
2166+ </wadl:request>
2167+
2168+ </wadl:method>
2169+ <wadl:method id="archive-getComponentsForQueueAdmin"
2170+ name="GET">
2171+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2172+<p>Return IArchivePermission for the person's queue admin components</p>
2173+<table class="rst-docutils field-list" frame="void" rules="none">
2174+<col class="field-name" />
2175+<col class="field-body" />
2176+<tbody valign="top">
2177+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson</td>
2178+</tr>
2179+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2180+</tr>
2181+</tbody>
2182+</table>
2183+
2184+</wadl:doc>
2185+ <wadl:request>
2186+
2187+ <wadl:param style="query" name="ws.op"
2188+ required="true"
2189+ fixed="getComponentsForQueueAdmin"/>
2190+ <wadl:param style="query" required="true"
2191+ name="person">
2192+
2193+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
2194+ </wadl:param>
2195+
2196+ </wadl:request>
2197+ <wadl:response>
2198+
2199+ <wadl:representation
2200+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2201+ </wadl:response>
2202+ </wadl:method>
2203+ <wadl:method id="archive-getArchiveDependency"
2204+ name="GET">
2205+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2206+<p>Return the IArchiveDependency object for the given dependency.</p>
2207+<table class="rst-docutils field-list" frame="void" rules="none">
2208+<col class="field-name" />
2209+<col class="field-body" />
2210+<tbody valign="top">
2211+<tr class="rst-field"><th class="rst-field-name" colspan="2">param dependency:</th></tr>
2212+<tr><td>&nbsp;</td><td class="rst-field-body">is an IArchive object.</td>
2213+</tr>
2214+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">IArchiveDependency or None if a corresponding object
2215+could not be found.</td>
2216+</tr>
2217+</tbody>
2218+</table>
2219+
2220+</wadl:doc>
2221+ <wadl:request>
2222+
2223+ <wadl:param style="query" name="ws.op"
2224+ required="true"
2225+ fixed="getArchiveDependency"/>
2226+ <wadl:param style="query" required="true"
2227+ name="dependency">
2228+
2229+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
2230+ </wadl:param>
2231+
2232+ </wadl:request>
2233+ <wadl:response>
2234+
2235+ <wadl:representation
2236+ href="http://api.launchpad.dev/beta/#archive_dependency-full"/>
2237+ </wadl:response>
2238+ </wadl:method>
2239+ <wadl:method id="archive-getPublishedSources"
2240+ name="GET">
2241+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2242+<p>All ISourcePackagePublishingHistory target to this archive.</p>
2243+<table class="rst-docutils field-list" frame="void" rules="none">
2244+<col class="field-name" />
2245+<col class="field-body" />
2246+<tbody valign="top">
2247+<tr class="rst-field"><th class="rst-field-name">param name:</th><td class="rst-field-body">source name filter (exact match or SQL LIKE controlled
2248+by 'exact_match' argument).</td>
2249+</tr>
2250+<tr class="rst-field"><th class="rst-field-name">param version:</th><td class="rst-field-body">source version filter (always exact match).</td>
2251+</tr>
2252+<tr class="rst-field"><th class="rst-field-name">param status:</th><td class="rst-field-body">PackagePublishingStatus filter, can be a sequence.</td>
2253+</tr>
2254+<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
2255+<tr><td>&nbsp;</td><td class="rst-field-body">IDistroSeries filter.</td>
2256+</tr>
2257+<tr class="rst-field"><th class="rst-field-name">param pocket:</th><td class="rst-field-body">PackagePublishingPocket filter.</td>
2258+</tr>
2259+<tr class="rst-field"><th class="rst-field-name" colspan="2">param exact_match:</th></tr>
2260+<tr><td>&nbsp;</td><td class="rst-field-body">either or not filter source names by exact
2261+matching.</td>
2262+</tr>
2263+<tr class="rst-field"><th class="rst-field-name" colspan="2">param created_since_date:</th></tr>
2264+<tr><td>&nbsp;</td><td class="rst-field-body">Only return results whose date_created
2265+is greater than or equal to this date.</td>
2266+</tr>
2267+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">SelectResults containing ISourcePackagePublishingHistory.</td>
2268+</tr>
2269+</tbody>
2270+</table>
2271+
2272+</wadl:doc>
2273+ <wadl:request>
2274+
2275+ <wadl:param style="query" name="ws.op"
2276+ required="true"
2277+ fixed="getPublishedSources"/>
2278+ <wadl:param style="query" required="false"
2279+ name="status">
2280+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2281+<p>Package Publishing Status</p>
2282+<p>The status of this publishing record</p>
2283+
2284+</wadl:doc>
2285+
2286+ <wadl:option value="Pending"/>
2287+ <wadl:option value="Published"/>
2288+ <wadl:option value="Superseded"/>
2289+ <wadl:option value="Deleted"/>
2290+ <wadl:option value="Obsolete"/>
2291+ </wadl:param>
2292+ <wadl:param style="query" required="false"
2293+ name="source_name">
2294+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2295+Source package name
2296+</wadl:doc>
2297+
2298+ </wadl:param>
2299+ <wadl:param style="query" required="false"
2300+ name="distro_series">
2301+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2302+Distroseries name
2303+</wadl:doc>
2304+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_series"/>
2305+ </wadl:param>
2306+ <wadl:param style="query" required="false"
2307+ name="exact_match">
2308+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2309+<p>Exact Match</p>
2310+<p>Whether or not to filter source names by exact matching.</p>
2311+
2312+</wadl:doc>
2313+
2314+ </wadl:param>
2315+ <wadl:param style="query" required="false"
2316+ name="pocket">
2317+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2318+<p>Pocket</p>
2319+<p>The pocket into which this entry is published</p>
2320+
2321+</wadl:doc>
2322+
2323+ <wadl:option value="Release"/>
2324+ <wadl:option value="Security"/>
2325+ <wadl:option value="Updates"/>
2326+ <wadl:option value="Proposed"/>
2327+ <wadl:option value="Backports"/>
2328+ </wadl:param>
2329+ <wadl:param style="query" required="false"
2330+ name="version">
2331+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2332+Version
2333+</wadl:doc>
2334+
2335+ </wadl:param>
2336+ <wadl:param style="query" required="false"
2337+ type="xsd:dateTime"
2338+ name="created_since_date">
2339+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2340+<p>Created Since Date</p>
2341+<p>Return entries whose date_created is greater than or equal to this date.</p>
2342+
2343+</wadl:doc>
2344+
2345+ </wadl:param>
2346+
2347+ </wadl:request>
2348+ <wadl:response>
2349+
2350+ <wadl:representation
2351+ href="http://api.launchpad.dev/beta/#source_package_publishing_history-page"/>
2352+ </wadl:response>
2353+ </wadl:method>
2354+ <wadl:method id="archive-getUploadersForPackageset"
2355+ name="GET">
2356+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2357+<p>The ArchivePermission records for uploaders to the package set.</p>
2358+<table class="rst-docutils field-list" frame="void" rules="none">
2359+<col class="field-name" />
2360+<col class="field-body" />
2361+<tbody valign="top">
2362+<tr class="rst-field"><th class="rst-field-name" colspan="2">param packageset:</th></tr>
2363+<tr><td>&nbsp;</td><td class="rst-field-body">An IPackageset.</td>
2364+</tr>
2365+<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_permissions:</th></tr>
2366+<tr><td>&nbsp;</td><td class="rst-field-body">If True, only consider permissions granted
2367+directly for the package set at hand. Otherwise, include any
2368+uploaders for package sets that include this one.</td>
2369+</tr>
2370+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for all the uploaders who are
2371+authorized to upload to the named source package set.</td>
2372+</tr>
2373+</tbody>
2374+</table>
2375+
2376+</wadl:doc>
2377+ <wadl:request>
2378+
2379+ <wadl:param style="query" name="ws.op"
2380+ required="true"
2381+ fixed="getUploadersForPackageset"/>
2382+ <wadl:param style="query" required="true"
2383+ name="packageset">
2384+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2385+Package set
2386+</wadl:doc>
2387+ <wadl:link resource_type="http://api.launchpad.dev/beta/#packageset"/>
2388+ </wadl:param>
2389+ <wadl:param style="query" required="false"
2390+ name="direct_permissions">
2391+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2392+Ignore package set hierarchy
2393+</wadl:doc>
2394+
2395+ </wadl:param>
2396+
2397+ </wadl:request>
2398+ <wadl:response>
2399+
2400+ <wadl:representation
2401+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2402+ </wadl:response>
2403+ </wadl:method>
2404+ <wadl:method id="archive-getPackagesetsForSource"
2405+ name="GET">
2406+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2407+<p>All package set based permissions for the given source.</p>
2408+<p>This method is meant to aid the process of &quot;debugging&quot; package set
2409+based archive permission since It allows the listing of permissions
2410+for the given source package in this archive (irrespective of the
2411+principal).</p>
2412+<table class="rst-docutils field-list" frame="void" rules="none">
2413+<col class="field-name" />
2414+<col class="field-body" />
2415+<tbody valign="top">
2416+<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2417+<tr><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2418+either a string or a ISourcePackageName.</td>
2419+</tr>
2420+<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_permissions:</th></tr>
2421+<tr><td>&nbsp;</td><td class="rst-field-body">If set only package sets that directly
2422+include the given source will be considered.</td>
2423+</tr>
2424+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2425+<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the
2426+given name could not be found.</td>
2427+</tr>
2428+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for the package sets that
2429+include the given source package name and apply to the
2430+archive in question.</td>
2431+</tr>
2432+</tbody>
2433+</table>
2434+
2435+</wadl:doc>
2436+ <wadl:request>
2437+
2438+ <wadl:param style="query" name="ws.op"
2439+ required="true"
2440+ fixed="getPackagesetsForSource"/>
2441+ <wadl:param style="query" required="true"
2442+ name="sourcepackagename">
2443+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2444+Source package name
2445+</wadl:doc>
2446+
2447+ </wadl:param>
2448+ <wadl:param style="query" required="false"
2449+ name="direct_permissions">
2450+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2451+Ignore package set hierarchy
2452+</wadl:doc>
2453+
2454+ </wadl:param>
2455+
2456+ </wadl:request>
2457+ <wadl:response>
2458+
2459+ <wadl:representation
2460+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2461+ </wadl:response>
2462+ </wadl:method>
2463+ <wadl:method id="archive-getBuildRecords" name="GET">
2464+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2465+<p>Return build records in the context it is implemented.</p>
2466+<p>It excludes build records generated by Gina (imported from a external
2467+repository), where IBuild.datebuilt is null and IBuild.buildstate
2468+is BuildStatus.FULLYBUILT.</p>
2469+<p>The result is simply not filtered if the optional filters are omitted
2470+by call sites.</p>
2471+<table class="rst-docutils field-list" frame="void" rules="none">
2472+<col class="field-name" />
2473+<col class="field-body" />
2474+<tbody valign="top">
2475+<tr class="rst-field"><th class="rst-field-name" colspan="2">param build_state:</th></tr>
2476+<tr><td>&nbsp;</td><td class="rst-field-body">optional BuildStatus value for filtering build
2477+records;</td>
2478+</tr>
2479+<tr class="rst-field"><th class="rst-field-name">param name:</th><td class="rst-field-body">optional string for filtering build source package name.
2480+Sub-string matching is allowed via SQL LIKE.</td>
2481+</tr>
2482+<tr class="rst-field"><th class="rst-field-name">param pocket:</th><td class="rst-field-body">optional PackagePublishingPocket value for filtering
2483+build records;</td>
2484+</tr>
2485+<tr class="rst-field"><th class="rst-field-name">param arch_tag:</th><td class="rst-field-body">optional string for filtering build source packages
2486+by their architecture tag;</td>
2487+</tr>
2488+<tr class="rst-field"><th class="rst-field-name">param user:</th><td class="rst-field-body">optional IPerson corresponding to the user performing
2489+the request. It will filter out build records for which the user
2490+have no 'view' permission.</td>
2491+</tr>
2492+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a result set containing IBuild records ordered by descending
2493+IBuild.datebuilt except when builds are filtered by
2494+BuildStatus.NEEDSBUILD, in this case records are ordered by
2495+descending BuildQueue.lastscore (dispatching order).</td>
2496+</tr>
2497+</tbody>
2498+</table>
2499+
2500+</wadl:doc>
2501+ <wadl:request>
2502+
2503+ <wadl:param style="query" name="ws.op"
2504+ required="true"
2505+ fixed="getBuildRecords"/>
2506+ <wadl:param style="query" required="false"
2507+ name="pocket">
2508+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2509+<p>Pocket</p>
2510+<p>The pocket into which this entry is published</p>
2511+
2512+</wadl:doc>
2513+
2514+ <wadl:option value="Release"/>
2515+ <wadl:option value="Security"/>
2516+ <wadl:option value="Updates"/>
2517+ <wadl:option value="Proposed"/>
2518+ <wadl:option value="Backports"/>
2519+ </wadl:param>
2520+ <wadl:param style="query" required="false"
2521+ name="build_state">
2522+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2523+<p>Build status</p>
2524+<p>The status of this build record</p>
2525+
2526+</wadl:doc>
2527+
2528+ <wadl:option value="Needs building"/>
2529+ <wadl:option value="Successfully built"/>
2530+ <wadl:option value="Failed to build"/>
2531+ <wadl:option value="Dependency wait"/>
2532+ <wadl:option value="Chroot problem"/>
2533+ <wadl:option value="Build for superseded Source"/>
2534+ <wadl:option value="Currently building"/>
2535+ <wadl:option value="Failed to upload"/>
2536+ </wadl:param>
2537+ <wadl:param style="query" required="false"
2538+ name="source_name">
2539+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2540+Source package name
2541+</wadl:doc>
2542+
2543+ </wadl:param>
2544+
2545+ </wadl:request>
2546+ <wadl:response>
2547+
2548+ <wadl:representation
2549+ href="http://api.launchpad.dev/beta/#build-page"/>
2550+ </wadl:response>
2551+ </wadl:method>
2552+ <wadl:method id="archive-getPublishedBinaries"
2553+ name="GET">
2554+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2555+<p>All IBinaryPackagePublishingHistory target to this archive.</p>
2556+<table class="rst-docutils field-list" frame="void" rules="none">
2557+<col class="field-name" />
2558+<col class="field-body" />
2559+<tbody valign="top">
2560+<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">name: binary name filter (exact match or SQL LIKE controlled
2561+by 'exact_match' argument).</td>
2562+</tr>
2563+<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">version: binary version filter (always exact match).</td>
2564+</tr>
2565+<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">status: PackagePublishingStatus filter, can be a list.</td>
2566+</tr>
2567+<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">distroarchseries: IDistroArchSeries filter, can be a list.</td>
2568+</tr>
2569+<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">pocket: PackagePublishingPocket filter.</td>
2570+</tr>
2571+<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">exact_match: either or not filter source names by exact
2572+matching.</td>
2573+</tr>
2574+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A collection containing BinaryPackagePublishingHistory.</td>
2575+</tr>
2576+</tbody>
2577+</table>
2578+
2579+</wadl:doc>
2580+ <wadl:request>
2581+
2582+ <wadl:param style="query" name="ws.op"
2583+ required="true"
2584+ fixed="getPublishedBinaries"/>
2585+ <wadl:param style="query" required="false"
2586+ name="status">
2587+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2588+<p>Package Publishing Status</p>
2589+<p>The status of this publishing record</p>
2590+
2591+</wadl:doc>
2592+
2593+ <wadl:option value="Pending"/>
2594+ <wadl:option value="Published"/>
2595+ <wadl:option value="Superseded"/>
2596+ <wadl:option value="Deleted"/>
2597+ <wadl:option value="Obsolete"/>
2598+ </wadl:param>
2599+ <wadl:param style="query" required="false"
2600+ name="binary_name">
2601+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2602+Binary Package Name
2603+</wadl:doc>
2604+
2605+ </wadl:param>
2606+ <wadl:param style="query" required="false"
2607+ name="exact_match">
2608+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2609+Whether or not to filter binary names by exact matching.
2610+</wadl:doc>
2611+
2612+ </wadl:param>
2613+ <wadl:param style="query" required="false"
2614+ name="pocket">
2615+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2616+<p>Pocket</p>
2617+<p>The pocket into which this entry is published</p>
2618+
2619+</wadl:doc>
2620+
2621+ <wadl:option value="Release"/>
2622+ <wadl:option value="Security"/>
2623+ <wadl:option value="Updates"/>
2624+ <wadl:option value="Proposed"/>
2625+ <wadl:option value="Backports"/>
2626+ </wadl:param>
2627+ <wadl:param style="query" required="false"
2628+ name="version">
2629+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2630+Version
2631+</wadl:doc>
2632+
2633+ </wadl:param>
2634+ <wadl:param style="query" required="false"
2635+ name="distro_arch_series">
2636+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2637+Distro Arch Series
2638+</wadl:doc>
2639+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_arch_series"/>
2640+ </wadl:param>
2641+
2642+ </wadl:request>
2643+ <wadl:response>
2644+
2645+ <wadl:representation
2646+ href="http://api.launchpad.dev/beta/#binary_package_publishing_history-page"/>
2647+ </wadl:response>
2648+ </wadl:method>
2649+ <wadl:method id="archive-getUploadersForComponent"
2650+ name="GET">
2651+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2652+<p>Return IArchivePermission records for the component's uploaders.</p>
2653+<table class="rst-docutils field-list" frame="void" rules="none">
2654+<col class="field-name" />
2655+<col class="field-body" />
2656+<tbody valign="top">
2657+<tr class="rst-field"><th class="rst-field-name" colspan="2">param component_name:</th></tr>
2658+<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual name for the
2659+component.</td>
2660+</tr>
2661+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2662+</tr>
2663+</tbody>
2664+</table>
2665+
2666+</wadl:doc>
2667+ <wadl:request>
2668+
2669+ <wadl:param style="query" name="ws.op"
2670+ required="true"
2671+ fixed="getUploadersForComponent"/>
2672+ <wadl:param style="query" required="false"
2673+ name="component_name">
2674+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2675+Component Name
2676+</wadl:doc>
2677+
2678+ </wadl:param>
2679+
2680+ </wadl:request>
2681+ <wadl:response>
2682+
2683+ <wadl:representation
2684+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2685+ </wadl:response>
2686+ </wadl:method>
2687+ <wadl:method id="archive-getUploadersForPackage"
2688+ name="GET">
2689+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2690+<p>Return IArchivePermission records for the package's uploaders.</p>
2691+<table class="rst-docutils field-list" frame="void" rules="none">
2692+<col class="field-name" />
2693+<col class="field-body" />
2694+<tbody valign="top">
2695+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_package_name:</th></tr>
2696+<tr><td>&nbsp;</td><td class="rst-field-body">An ISourcePackageName or textual name
2697+for the source package.</td>
2698+</tr>
2699+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2700+</tr>
2701+</tbody>
2702+</table>
2703+
2704+</wadl:doc>
2705+ <wadl:request>
2706+
2707+ <wadl:param style="query" name="ws.op"
2708+ required="true"
2709+ fixed="getUploadersForPackage"/>
2710+ <wadl:param style="query" required="true"
2711+ name="source_package_name">
2712+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2713+Source Package Name
2714+</wadl:doc>
2715+
2716+ </wadl:param>
2717+
2718+ </wadl:request>
2719+ <wadl:response>
2720+
2721+ <wadl:representation
2722+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2723+ </wadl:response>
2724+ </wadl:method>
2725+ <wadl:method id="archive-getBuildSummariesForSourceIds"
2726+ name="GET">
2727+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2728+<p>Return a dictionary containing a summary of the build statuses.</p>
2729+<p>Only information for sources belonging to the current archive will
2730+be returned. See
2731+IPublishingSet.getBuildStatusSummariesForSourceIdsAndArchive() for
2732+details.</p>
2733+<table class="rst-docutils field-list" frame="void" rules="none">
2734+<col class="field-name" />
2735+<col class="field-body" />
2736+<tbody valign="top">
2737+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_ids:</th></tr>
2738+<tr><td>&nbsp;</td><td class="rst-field-body">A list of source publishing history record ids.</td>
2739+</tr>
2740+<tr class="rst-field"><th class="rst-field-name" colspan="2">type source_ids:</th></tr>
2741+<tr><td>&nbsp;</td><td class="rst-field-body"><tt class="rst-docutils literal"><span class="pre">list</span></tt></td>
2742+</tr>
2743+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A dict consisting of the overall status summaries for the
2744+given ids that belong in the archive.</td>
2745+</tr>
2746+</tbody>
2747+</table>
2748+
2749+</wadl:doc>
2750+ <wadl:request>
2751+
2752+ <wadl:param style="query" name="ws.op"
2753+ required="true"
2754+ fixed="getBuildSummariesForSourceIds"/>
2755+ <wadl:param style="query" required="true"
2756+ name="source_ids">
2757+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2758+A list of source publishing history record ids.
2759+</wadl:doc>
2760+
2761+ </wadl:param>
2762+
2763+ </wadl:request>
2764+
2765+ </wadl:method>
2766+ <wadl:method id="archive-getQueueAdminsForComponent"
2767+ name="GET">
2768+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2769+<p>Return IArchivePermission records for authorised queue admins.</p>
2770+<table class="rst-docutils field-list" frame="void" rules="none">
2771+<col class="field-name" />
2772+<col class="field-body" />
2773+<tbody valign="top">
2774+<tr class="rst-field"><th class="rst-field-name" colspan="2">param component_name:</th></tr>
2775+<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual name for the
2776+component.</td>
2777+</tr>
2778+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2779+</tr>
2780+</tbody>
2781+</table>
2782+
2783+</wadl:doc>
2784+ <wadl:request>
2785+
2786+ <wadl:param style="query" name="ws.op"
2787+ required="true"
2788+ fixed="getQueueAdminsForComponent"/>
2789+ <wadl:param style="query" required="true"
2790+ name="component_name">
2791+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2792+Component Name
2793+</wadl:doc>
2794+
2795+ </wadl:param>
2796+
2797+ </wadl:request>
2798+ <wadl:response>
2799+
2800+ <wadl:representation
2801+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2802+ </wadl:response>
2803+ </wadl:method>
2804+ <wadl:method id="archive-getPermissionsForPerson"
2805+ name="GET">
2806+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2807+<p>Return the IArchivePermission records applicable to the person.</p>
2808+<table class="rst-docutils field-list" frame="void" rules="none">
2809+<col class="field-name" />
2810+<col class="field-body" />
2811+<tbody valign="top">
2812+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson</td>
2813+</tr>
2814+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2815+</tr>
2816+</tbody>
2817+</table>
2818+
2819+</wadl:doc>
2820+ <wadl:request>
2821+
2822+ <wadl:param style="query" name="ws.op"
2823+ required="true"
2824+ fixed="getPermissionsForPerson"/>
2825+ <wadl:param style="query" required="true"
2826+ name="person">
2827+
2828+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
2829+ </wadl:param>
2830+
2831+ </wadl:request>
2832+ <wadl:response>
2833+
2834+ <wadl:representation
2835+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2836+ </wadl:response>
2837+ </wadl:method>
2838+ <wadl:method id="archive-getPackagesetsForSourceUploader"
2839+ name="GET">
2840+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2841+<p>The package set based permissions for a given source and uploader.</p>
2842+<dl class="rst-docutils">
2843+<dt>Return the IArchivePermission records that</dt>
2844+<dd><ul class="rst-first rst-last">
2845+<li><p class="rst-first">apply to this archive</p>
2846+</li>
2847+<li><dl class="rst-first rst-docutils">
2848+<dt>relate to</dt>
2849+<dd><ul class="rst-first rst-last rst-simple">
2850+<li>package sets that include the given source package name</li>
2851+<li>the given person</li>
2852+</ul>
2853+</dd>
2854+</dl>
2855+</li>
2856+</ul>
2857+</dd>
2858+</dl>
2859+<table class="rst-docutils field-list" frame="void" rules="none">
2860+<col class="field-name" />
2861+<col class="field-body" />
2862+<tbody valign="top">
2863+<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2864+<tr><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2865+either a string or a ISourcePackageName.</td>
2866+</tr>
2867+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson for whom you want to find out which
2868+package sets he has access to.</td>
2869+</tr>
2870+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2871+<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the
2872+given name could not be found.</td>
2873+</tr>
2874+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for the package sets that
2875+include the given source package name and to which the given
2876+person may upload.</td>
2877+</tr>
2878+</tbody>
2879+</table>
2880+
2881+</wadl:doc>
2882+ <wadl:request>
2883+
2884+ <wadl:param style="query" name="ws.op"
2885+ required="true"
2886+ fixed="getPackagesetsForSourceUploader"/>
2887+ <wadl:param style="query" required="true"
2888+ name="person">
2889+
2890+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
2891+ </wadl:param>
2892+ <wadl:param style="query" required="true"
2893+ name="sourcepackagename">
2894+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2895+Source package name
2896+</wadl:doc>
2897+
2898+ </wadl:param>
2899+
2900+ </wadl:request>
2901+ <wadl:response>
2902+
2903+ <wadl:representation
2904+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2905+ </wadl:response>
2906+ </wadl:method>
2907+ <wadl:method id="archive-getPackagesetsForUploader"
2908+ name="GET">
2909+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2910+<p>The ArchivePermission records for the person's package sets.</p>
2911+<table class="rst-docutils field-list" frame="void" rules="none">
2912+<col class="field-name" />
2913+<col class="field-body" />
2914+<tbody valign="top">
2915+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson for whom you want to find out which
2916+package sets he has access to.</td>
2917+</tr>
2918+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for all the package sets that
2919+'person' is allowed to upload to.</td>
2920+</tr>
2921+</tbody>
2922+</table>
2923+
2924+</wadl:doc>
2925+ <wadl:request>
2926+
2927+ <wadl:param style="query" name="ws.op"
2928+ required="true"
2929+ fixed="getPackagesetsForUploader"/>
2930+ <wadl:param style="query" required="true"
2931+ name="person">
2932+
2933+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
2934+ </wadl:param>
2935+
2936+ </wadl:request>
2937+ <wadl:response>
2938+
2939+ <wadl:representation
2940+ href="http://api.launchpad.dev/beta/#archive_permission-page"/>
2941+ </wadl:response>
2942+ </wadl:method>
2943+ <wadl:method id="archive-syncSource" name="POST">
2944+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2945+<p>Synchronise (copy) a single named source into this archive.</p>
2946+<p>Copy a specific version of a named source to the destination
2947+archive if necessary.</p>
2948+<table class="rst-docutils field-list" frame="void" rules="none">
2949+<col class="field-name" />
2950+<col class="field-body" />
2951+<tbody valign="top">
2952+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_name:</th></tr>
2953+<tr><td>&nbsp;</td><td class="rst-field-body">a string name of the package to copy.</td>
2954+</tr>
2955+<tr class="rst-field"><th class="rst-field-name">param version:</th><td class="rst-field-body">the version of the package to copy.</td>
2956+</tr>
2957+<tr class="rst-field"><th class="rst-field-name" colspan="2">param from_archive:</th></tr>
2958+<tr><td>&nbsp;</td><td class="rst-field-body">the source archive from which to copy.</td>
2959+</tr>
2960+<tr class="rst-field"><th class="rst-field-name" colspan="2">param to_pocket:</th></tr>
2961+<tr><td>&nbsp;</td><td class="rst-field-body">the target pocket (as a string).</td>
2962+</tr>
2963+<tr class="rst-field"><th class="rst-field-name" colspan="2">param to_series:</th></tr>
2964+<tr><td>&nbsp;</td><td class="rst-field-body">the target distroseries (as a string).</td>
2965+</tr>
2966+<tr class="rst-field"><th class="rst-field-name" colspan="2">param include_binaries:</th></tr>
2967+<tr><td>&nbsp;</td><td class="rst-field-body">optional boolean, controls whether or not
2968+the published binaries for each given source should also be
2969+copied along with the source.</td>
2970+</tr>
2971+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2972+<tr><td>&nbsp;</td><td class="rst-field-body">if the source name is invalid</td>
2973+</tr>
2974+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises PocketNotFound:</th></tr>
2975+<tr><td>&nbsp;</td><td class="rst-field-body">if the pocket name is invalid</td>
2976+</tr>
2977+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises DistroSeriesNotFound:</th></tr>
2978+<tr><td>&nbsp;</td><td class="rst-field-body">if the distro series name is invalid</td>
2979+</tr>
2980+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises CannotCopy:</th></tr>
2981+<tr><td>&nbsp;</td><td class="rst-field-body">if there is a problem copying.</td>
2982+</tr>
2983+</tbody>
2984+</table>
2985+
2986+</wadl:doc>
2987+ <wadl:request>
2988+ <wadl:representation
2989+ mediaType="application/x-www-form-urlencoded">
2990+ <wadl:param style="query" name="ws.op"
2991+ required="true" fixed="syncSource"/>
2992+ <wadl:param style="query" required="false"
2993+ name="to_series">
2994+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2995+Distroseries name
2996+</wadl:doc>
2997+
2998+ </wadl:param>
2999+ <wadl:param style="query" required="true"
3000+ name="source_name">
3001+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3002+Source package name
3003+</wadl:doc>
3004+
3005+ </wadl:param>
3006+ <wadl:param style="query" required="true"
3007+ name="version">
3008+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3009+Version
3010+</wadl:doc>
3011+
3012+ </wadl:param>
3013+ <wadl:param style="query" required="true"
3014+ name="from_archive">
3015+
3016+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
3017+ </wadl:param>
3018+ <wadl:param style="query" required="true"
3019+ name="to_pocket">
3020+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3021+Pocket name
3022+</wadl:doc>
3023+
3024+ </wadl:param>
3025+ <wadl:param style="query" required="false"
3026+ name="include_binaries">
3027+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3028+<p>Include Binaries</p>
3029+<p>Whether or not to copy binaries already built for this source</p>
3030+
3031+</wadl:doc>
3032+
3033+ </wadl:param>
3034+ </wadl:representation>
3035+ </wadl:request>
3036+
3037+ </wadl:method>
3038+ <wadl:method id="archive-deleteQueueAdmin" name="POST">
3039+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3040+<p>Revoke permission for the person to administer distroseries queues.</p>
3041+<p>The supplied person will lose permission to administer the
3042+distroseries queue for packages in the supplied component.</p>
3043+<table class="rst-docutils field-list" frame="void" rules="none">
3044+<col class="field-name" />
3045+<col class="field-body" />
3046+<tbody valign="top">
3047+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson whose permission should be revoked.</td>
3048+</tr>
3049+<tr class="rst-field"><th class="rst-field-name" colspan="2">param component:</th></tr>
3050+<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual component name.</td>
3051+</tr>
3052+</tbody>
3053+</table>
3054+
3055+</wadl:doc>
3056+ <wadl:request>
3057+ <wadl:representation
3058+ mediaType="application/x-www-form-urlencoded">
3059+ <wadl:param style="query" name="ws.op"
3060+ required="true"
3061+ fixed="deleteQueueAdmin"/>
3062+ <wadl:param style="query" required="true"
3063+ name="person">
3064+
3065+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3066+ </wadl:param>
3067+ <wadl:param style="query" required="true"
3068+ name="component_name">
3069+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3070+Component Name
3071+</wadl:doc>
3072+
3073+ </wadl:param>
3074+ </wadl:representation>
3075+ </wadl:request>
3076+
3077+ </wadl:method>
3078+ <wadl:method id="archive-newComponentUploader"
3079+ name="POST">
3080+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3081+<p>Add permission for a person to upload to a component.</p>
3082+<table class="rst-docutils field-list" frame="void" rules="none">
3083+<col class="field-name" />
3084+<col class="field-body" />
3085+<tbody valign="top">
3086+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson whom should be given permission.</td>
3087+</tr>
3088+<tr class="rst-field"><th class="rst-field-name" colspan="2">param component:</th></tr>
3089+<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual component name.</td>
3090+</tr>
3091+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An IArchivePermission which is the newly-created
3092+permission.</td>
3093+</tr>
3094+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises InvalidComponent:</th></tr>
3095+<tr><td>&nbsp;</td><td class="rst-field-body">if this archive is a PPA and the component
3096+is not 'main'.</td>
3097+</tr>
3098+</tbody>
3099+</table>
3100+
3101+</wadl:doc>
3102+ <wadl:request>
3103+ <wadl:representation
3104+ mediaType="application/x-www-form-urlencoded">
3105+ <wadl:param style="query" name="ws.op"
3106+ required="true"
3107+ fixed="newComponentUploader"/>
3108+ <wadl:param style="query" required="true"
3109+ name="person">
3110+
3111+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3112+ </wadl:param>
3113+ <wadl:param style="query" required="true"
3114+ name="component_name">
3115+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3116+Component Name
3117+</wadl:doc>
3118+
3119+ </wadl:param>
3120+ </wadl:representation>
3121+ </wadl:request>
3122+ <wadl:response>
3123+ <wadl:param name="Location" style="header">
3124+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_permission"/>
3125+ </wadl:param>
3126+
3127+ </wadl:response>
3128+ </wadl:method>
3129+ <wadl:method id="archive-syncSources" name="POST">
3130+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3131+<p>Synchronise (copy) named sources into this archive from another.</p>
3132+<p>It will copy the most recent versions of the named sources to
3133+the destination archive if necessary.</p>
3134+<p>This operation will only succeeds when all requested packages
3135+are synchronised between the archives. If any of the requested
3136+copies cannot be performed, the whole operation will fail. There
3137+will be no partial changes of the destination archive.</p>
3138+<table class="rst-docutils field-list" frame="void" rules="none">
3139+<col class="field-name" />
3140+<col class="field-body" />
3141+<tbody valign="top">
3142+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_names:</th></tr>
3143+<tr><td>&nbsp;</td><td class="rst-field-body">a list of string names of packages to copy.</td>
3144+</tr>
3145+<tr class="rst-field"><th class="rst-field-name" colspan="2">param from_archive:</th></tr>
3146+<tr><td>&nbsp;</td><td class="rst-field-body">the source archive from which to copy.</td>
3147+</tr>
3148+<tr class="rst-field"><th class="rst-field-name" colspan="2">param to_pocket:</th></tr>
3149+<tr><td>&nbsp;</td><td class="rst-field-body">the target pocket (as a string).</td>
3150+</tr>
3151+<tr class="rst-field"><th class="rst-field-name" colspan="2">param to_series:</th></tr>
3152+<tr><td>&nbsp;</td><td class="rst-field-body">the target distroseries (as a string).</td>
3153+</tr>
3154+<tr class="rst-field"><th class="rst-field-name" colspan="2">param include_binaries:</th></tr>
3155+<tr><td>&nbsp;</td><td class="rst-field-body">optional boolean, controls whether or not
3156+the published binaries for each given source should also be
3157+copied along with the source.</td>
3158+</tr>
3159+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
3160+<tr><td>&nbsp;</td><td class="rst-field-body">if the source name is invalid</td>
3161+</tr>
3162+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises PocketNotFound:</th></tr>
3163+<tr><td>&nbsp;</td><td class="rst-field-body">if the pocket name is invalid</td>
3164+</tr>
3165+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises DistroSeriesNotFound:</th></tr>
3166+<tr><td>&nbsp;</td><td class="rst-field-body">if the distro series name is invalid</td>
3167+</tr>
3168+<tr class="rst-field"><th class="rst-field-name" colspan="2">raises CannotCopy:</th></tr>
3169+<tr><td>&nbsp;</td><td class="rst-field-body">if there is a problem copying.</td>
3170+</tr>
3171+</tbody>
3172+</table>
3173+
3174+</wadl:doc>
3175+ <wadl:request>
3176+ <wadl:representation
3177+ mediaType="application/x-www-form-urlencoded">
3178+ <wadl:param style="query" name="ws.op"
3179+ required="true" fixed="syncSources"/>
3180+ <wadl:param style="query" required="false"
3181+ name="to_series">
3182+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3183+Distroseries name
3184+</wadl:doc>
3185+
3186+ </wadl:param>
3187+ <wadl:param style="query" required="true"
3188+ name="to_pocket">
3189+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3190+Pocket name
3191+</wadl:doc>
3192+
3193+ </wadl:param>
3194+ <wadl:param style="query" required="true"
3195+ name="source_names">
3196+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3197+Source package names
3198+</wadl:doc>
3199+
3200+ </wadl:param>
3201+ <wadl:param style="query" required="true"
3202+ name="from_archive">
3203+
3204+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
3205+ </wadl:param>
3206+ <wadl:param style="query" required="false"
3207+ name="include_binaries">
3208+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3209+<p>Include Binaries</p>
3210+<p>Whether or not to copy binaries already built for this source</p>
3211+
3212+</wadl:doc>
3213+
3214+ </wadl:param>
3215+ </wadl:representation>
3216+ </wadl:request>
3217+
3218+ </wadl:method>
3219+ <wadl:method id="archive-deletePackageUploader"
3220+ name="POST">
3221+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3222+<p>Revoke permission for the person to upload the package.</p>
3223+<table class="rst-docutils field-list" frame="void" rules="none">
3224+<col class="field-name" />
3225+<col class="field-body" />
3226+<tbody valign="top">
3227+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson whose permission should be revoked.</td>
3228+</tr>
3229+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_package_name:</th></tr>
3230+<tr><td>&nbsp;</td><td class="rst-field-body">An ISourcePackageName or textual package
3231+name.</td>
3232+</tr>
3233+</tbody>
3234+</table>
3235+
3236+</wadl:doc>
3237+ <wadl:request>
3238+ <wadl:representation
3239+ mediaType="application/x-www-form-urlencoded">
3240+ <wadl:param style="query" name="ws.op"
3241+ required="true"
3242+ fixed="deletePackageUploader"/>
3243+ <wadl:param style="query" required="true"
3244+ name="person">
3245+
3246+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3247+ </wadl:param>
3248+ <wadl:param style="query" required="true"
3249+ name="source_package_name">
3250+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3251+Source Package Name
3252+</wadl:doc>
3253+
3254+ </wadl:param>
3255+ </wadl:representation>
3256+ </wadl:request>
3257+
3258+ </wadl:method>
3259+ <wadl:method id="archive-deletePackagesetUploader"
3260+ name="POST">
3261+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3262+<p>Revoke upload permissions for a person.</p>
3263+<table class="rst-docutils field-list" frame="void" rules="none">
3264+<col class="field-name" />
3265+<col class="field-body" />
3266+<tbody valign="top">
3267+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson for whom you want to revoke permission.</td>
3268+</tr>
3269+<tr class="rst-field"><th class="rst-field-name" colspan="2">param packageset:</th></tr>
3270+<tr><td>&nbsp;</td><td class="rst-field-body">An IPackageset.</td>
3271+</tr>
3272+<tr class="rst-field"><th class="rst-field-name">param explicit:</th><td class="rst-field-body">The value of the 'explicit' flag for the permission
3273+to be revoked.</td>
3274+</tr>
3275+</tbody>
3276+</table>
3277+
3278+</wadl:doc>
3279+ <wadl:request>
3280+ <wadl:representation
3281+ mediaType="application/x-www-form-urlencoded">
3282+ <wadl:param style="query" name="ws.op"
3283+ required="true"
3284+ fixed="deletePackagesetUploader"/>
3285+ <wadl:param style="query" required="true"
3286+ name="person">
3287+
3288+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3289+ </wadl:param>
3290+ <wadl:param style="query" required="true"
3291+ name="packageset">
3292+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3293+Package set
3294+</wadl:doc>
3295+ <wadl:link resource_type="http://api.launchpad.dev/beta/#packageset"/>
3296+ </wadl:param>
3297+ <wadl:param style="query" required="false"
3298+ name="explicit">
3299+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3300+Explicit
3301+</wadl:doc>
3302+
3303+ </wadl:param>
3304+ </wadl:representation>
3305+ </wadl:request>
3306+
3307+ </wadl:method>
3308+ <wadl:method id="archive-newPackageUploader"
3309+ name="POST">
3310+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3311+<p>Add permisson for a person to upload a package to this archive.</p>
3312+<table class="rst-docutils field-list" frame="void" rules="none">
3313+<col class="field-name" />
3314+<col class="field-body" />
3315+<tbody valign="top">
3316+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson whom should be given permission.</td>
3317+</tr>
3318+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_package_name:</th></tr>
3319+<tr><td>&nbsp;</td><td class="rst-field-body">An ISourcePackageName or textual package
3320+name.</td>
3321+</tr>
3322+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An IArchivePermission which is the newly-created
3323+permission.</td>
3324+</tr>
3325+</tbody>
3326+</table>
3327+
3328+</wadl:doc>
3329+ <wadl:request>
3330+ <wadl:representation
3331+ mediaType="application/x-www-form-urlencoded">
3332+ <wadl:param style="query" name="ws.op"
3333+ required="true"
3334+ fixed="newPackageUploader"/>
3335+ <wadl:param style="query" required="true"
3336+ name="person">
3337+
3338+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3339+ </wadl:param>
3340+ <wadl:param style="query" required="true"
3341+ name="source_package_name">
3342+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3343+Source Package Name
3344+</wadl:doc>
3345+
3346+ </wadl:param>
3347+ </wadl:representation>
3348+ </wadl:request>
3349+ <wadl:response>
3350+ <wadl:param name="Location" style="header">
3351+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_permission"/>
3352+ </wadl:param>
3353+
3354+ </wadl:response>
3355+ </wadl:method>
3356+ <wadl:method id="archive-deleteComponentUploader"
3357+ name="POST">
3358+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3359+<p>Revoke permission for the person to upload to the component.</p>
3360+<table class="rst-docutils field-list" frame="void" rules="none">
3361+<col class="field-name" />
3362+<col class="field-body" />
3363+<tbody valign="top">
3364+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson whose permission should be revoked.</td>
3365+</tr>
3366+<tr class="rst-field"><th class="rst-field-name" colspan="2">param component:</th></tr>
3367+<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual component name.</td>
3368+</tr>
3369+</tbody>
3370+</table>
3371+
3372+</wadl:doc>
3373+ <wadl:request>
3374+ <wadl:representation
3375+ mediaType="application/x-www-form-urlencoded">
3376+ <wadl:param style="query" name="ws.op"
3377+ required="true"
3378+ fixed="deleteComponentUploader"/>
3379+ <wadl:param style="query" required="true"
3380+ name="person">
3381+
3382+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3383+ </wadl:param>
3384+ <wadl:param style="query" required="true"
3385+ name="component_name">
3386+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3387+Component Name
3388+</wadl:doc>
3389+
3390+ </wadl:param>
3391+ </wadl:representation>
3392+ </wadl:request>
3393+
3394+ </wadl:method>
3395+ <wadl:method id="archive-newPackagesetUploader"
3396+ name="POST">
3397+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3398+<p>Add a package set based permission for a person.</p>
3399+<table class="rst-docutils field-list" frame="void" rules="none">
3400+<col class="field-name" />
3401+<col class="field-body" />
3402+<tbody valign="top">
3403+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson for whom you want to add permission.</td>
3404+</tr>
3405+<tr class="rst-field"><th class="rst-field-name" colspan="2">param packageset:</th></tr>
3406+<tr><td>&nbsp;</td><td class="rst-field-body">An IPackageset.</td>
3407+</tr>
3408+<tr class="rst-field"><th class="rst-field-name">param explicit:</th><td class="rst-field-body">True if the package set in question requires
3409+specialist skills for proper handling.</td>
3410+</tr>
3411+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">The new ArchivePermission, or the existing one if it
3412+already exists.</td>
3413+</tr>
3414+</tbody>
3415+</table>
3416+
3417+</wadl:doc>
3418+ <wadl:request>
3419+ <wadl:representation
3420+ mediaType="application/x-www-form-urlencoded">
3421+ <wadl:param style="query" name="ws.op"
3422+ required="true"
3423+ fixed="newPackagesetUploader"/>
3424+ <wadl:param style="query" required="true"
3425+ name="person">
3426+
3427+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3428+ </wadl:param>
3429+ <wadl:param style="query" required="true"
3430+ name="packageset">
3431+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3432+Package set
3433+</wadl:doc>
3434+ <wadl:link resource_type="http://api.launchpad.dev/beta/#packageset"/>
3435+ </wadl:param>
3436+ <wadl:param style="query" required="false"
3437+ name="explicit">
3438+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3439+Explicit
3440+</wadl:doc>
3441+
3442+ </wadl:param>
3443+ </wadl:representation>
3444+ </wadl:request>
3445+ <wadl:response>
3446+ <wadl:param name="Location" style="header">
3447+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_permission"/>
3448+ </wadl:param>
3449+
3450+ </wadl:response>
3451+ </wadl:method>
3452+ <wadl:method id="archive-newSubscription" name="POST">
3453+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3454+<p>Create a new subscribtion to this archive.</p>
3455+<p>Create an ArchiveSubscriber record which allows an IPerson to
3456+access a private repository.</p>
3457+<table class="rst-docutils field-list" frame="void" rules="none">
3458+<col class="field-name" />
3459+<col class="field-body" />
3460+<tbody valign="top">
3461+<tr class="rst-field"><th class="rst-field-name" colspan="2">param subscriber:</th></tr>
3462+<tr><td>&nbsp;</td><td class="rst-field-body">An IPerson who is allowed to access the
3463+repository for this archive.</td>
3464+</tr>
3465+<tr class="rst-field"><th class="rst-field-name" colspan="2">param registrant:</th></tr>
3466+<tr><td>&nbsp;</td><td class="rst-field-body">An IPerson who created this subscription.</td>
3467+</tr>
3468+<tr class="rst-field"><th class="rst-field-name" colspan="2">param date_expires:</th></tr>
3469+<tr><td>&nbsp;</td><td class="rst-field-body">When the subscription should expire; None if
3470+it should not expire (default).</td>
3471+</tr>
3472+<tr class="rst-field"><th class="rst-field-name" colspan="2">param description:</th></tr>
3473+<tr><td>&nbsp;</td><td class="rst-field-body">An option textual description of the subscription
3474+being created.</td>
3475+</tr>
3476+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">The IArchiveSubscriber that was created.</td>
3477+</tr>
3478+</tbody>
3479+</table>
3480+
3481+</wadl:doc>
3482+ <wadl:request>
3483+ <wadl:representation
3484+ mediaType="application/x-www-form-urlencoded">
3485+ <wadl:param style="query" name="ws.op"
3486+ required="true"
3487+ fixed="newSubscription"/>
3488+ <wadl:param style="query" required="true"
3489+ name="subscriber">
3490+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3491+<p>Subscriber</p>
3492+<p>The person who is subscribed.</p>
3493+
3494+</wadl:doc>
3495+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3496+ </wadl:param>
3497+ <wadl:param style="query" required="false"
3498+ type="xsd:dateTime"
3499+ name="date_expires">
3500+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3501+<p>Date of Expiration</p>
3502+<p>The timestamp when the subscription will expire.</p>
3503+
3504+</wadl:doc>
3505+
3506+ </wadl:param>
3507+ <wadl:param style="query" required="false"
3508+ name="description">
3509+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3510+<p>Description</p>
3511+<p>Free text describing this subscription.</p>
3512+
3513+</wadl:doc>
3514+
3515+ </wadl:param>
3516+ </wadl:representation>
3517+ </wadl:request>
3518+ <wadl:response>
3519+ <wadl:param name="Location" style="header">
3520+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_subscriber"/>
3521+ </wadl:param>
3522+
3523+ </wadl:response>
3524+ </wadl:method>
3525+ <wadl:method id="archive-newQueueAdmin" name="POST">
3526+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3527+<p>Add permission for a person to administer a distroseries queue.</p>
3528+<p>The supplied person will gain permission to administer the
3529+distroseries queue for packages in the supplied component.</p>
3530+<table class="rst-docutils field-list" frame="void" rules="none">
3531+<col class="field-name" />
3532+<col class="field-body" />
3533+<tbody valign="top">
3534+<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson whom should be given permission.</td>
3535+</tr>
3536+<tr class="rst-field"><th class="rst-field-name" colspan="2">param component:</th></tr>
3537+<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual component name.</td>
3538+</tr>
3539+<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An IArchivePermission which is the newly-created
3540+permission.</td>
3541+</tr>
3542+</tbody>
3543+</table>
3544+
3545+</wadl:doc>
3546+ <wadl:request>
3547+ <wadl:representation
3548+ mediaType="application/x-www-form-urlencoded">
3549+ <wadl:param style="query" name="ws.op"
3550+ required="true"
3551+ fixed="newQueueAdmin"/>
3552+ <wadl:param style="query" required="true"
3553+ name="person">
3554+
3555+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3556+ </wadl:param>
3557+ <wadl:param style="query" required="true"
3558+ name="component_name">
3559+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3560+Component Name
3561+</wadl:doc>
3562+
3563+ </wadl:param>
3564+ </wadl:representation>
3565+ </wadl:request>
3566+ <wadl:response>
3567+ <wadl:param name="Location" style="header">
3568+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_permission"/>
3569+ </wadl:param>
3570+
3571+ </wadl:response>
3572+ </wadl:method>
3573+ </wadl:resource_type>
3574+
3575+
3576+ <wadl:representation mediaType="application/json"
3577+ id="archive-full">
3578+ <wadl:param style="plain" name="self_link" path="$['self_link']">
3579+ <wadl:doc>The canonical link to this resource.</wadl:doc>
3580+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
3581+ </wadl:param>
3582+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
3583+ <wadl:doc>
3584+ The link to the WADL description of this resource.
3585+ </wadl:doc>
3586+ <wadl:link/>
3587+ </wadl:param>
3588+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
3589+ <wadl:doc>
3590+ The value of the HTTP ETag for this resource.
3591+ </wadl:doc>
3592+ </wadl:param>
3593+ <wadl:param style="plain" required="true"
3594+ path="$['owner_link']" name="owner_link">
3595+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3596+<p>Owner</p>
3597+<p>The archive owner.</p>
3598+
3599+</wadl:doc>
3600+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3601+ </wadl:param>
3602+ <wadl:param style="plain" required="true"
3603+ path="$['displayname']" name="displayname">
3604+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3605+<p>Displayname</p>
3606+<p>Displayname for this archive.</p>
3607+
3608+</wadl:doc>
3609+
3610+ </wadl:param>
3611+ <wadl:param style="plain" required="true"
3612+ path="$['description']" name="description">
3613+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3614+<p>Archive contents description</p>
3615+<p>A short description of this archive's contents.</p>
3616+
3617+</wadl:doc>
3618+
3619+ </wadl:param>
3620+ <wadl:param style="plain" required="true"
3621+ path="$['dependencies_collection_link']"
3622+ name="dependencies_collection_link">
3623+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3624+Archive dependencies recorded for this archive.
3625+</wadl:doc>
3626+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive_dependency-page-resource"/>
3627+ </wadl:param>
3628+ <wadl:param style="plain" required="true"
3629+ path="$['name']" name="name">
3630+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3631+<p>Name</p>
3632+<p>The name of this archive.</p>
3633+
3634+</wadl:doc>
3635+
3636+ </wadl:param>
3637+ <wadl:param style="plain" required="true"
3638+ path="$['private']" name="private">
3639+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3640+<p>Private</p>
3641+<p>Whether the archive is private to the owner or not.</p>
3642+
3643+</wadl:doc>
3644+
3645+ </wadl:param>
3646+ <wadl:param style="plain" required="true"
3647+ path="$['distribution_link']"
3648+ name="distribution_link">
3649+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3650+The distribution that uses or is used by this archive.
3651+</wadl:doc>
3652+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distribution"/>
3653+ </wadl:param>
3654+ <wadl:param style="plain" required="true"
3655+ path="$['signing_key_fingerprint']"
3656+ name="signing_key_fingerprint">
3657+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3658+<p>Archive signing key fingerprint</p>
3659+<p>A OpenPGP signing key fingerprint (40 chars) for this PPA or None if there is no signing key available.</p>
3660+
3661+</wadl:doc>
3662+
3663+ </wadl:param>
3664+ </wadl:representation>
3665+
3666+ <wadl:representation mediaType="application/json"
3667+ id="archive-diff">
3668+ <wadl:param style="plain" required="false"
3669+ path="$['owner_link']" name="owner_link">
3670+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3671+<p>Owner</p>
3672+<p>The archive owner.</p>
3673+
3674+</wadl:doc>
3675+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
3676+ </wadl:param>
3677+ <wadl:param style="plain" required="false"
3678+ path="$['displayname']" name="displayname">
3679+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3680+<p>Displayname</p>
3681+<p>Displayname for this archive.</p>
3682+
3683+</wadl:doc>
3684+
3685+ </wadl:param>
3686+ <wadl:param style="plain" required="false"
3687+ path="$['description']" name="description">
3688+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3689+<p>Archive contents description</p>
3690+<p>A short description of this archive's contents.</p>
3691+
3692+</wadl:doc>
3693+
3694+ </wadl:param>
3695+ <wadl:param style="plain" required="false"
3696+ path="$['name']" name="name">
3697+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3698+<p>Name</p>
3699+<p>The name of this archive.</p>
3700+
3701+</wadl:doc>
3702+
3703+ </wadl:param>
3704+ <wadl:param style="plain" required="false"
3705+ path="$['private']" name="private">
3706+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3707+<p>Private</p>
3708+<p>Whether the archive is private to the owner or not.</p>
3709+
3710+</wadl:doc>
3711+
3712+ </wadl:param>
3713+ <wadl:param style="plain" required="false"
3714+ path="$['distribution_link']"
3715+ name="distribution_link">
3716+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3717+The distribution that uses or is used by this archive.
3718+</wadl:doc>
3719+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distribution"/>
3720+ </wadl:param>
3721+ <wadl:param style="plain" required="false"
3722+ path="$['signing_key_fingerprint']"
3723+ name="signing_key_fingerprint">
3724+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3725+<p>Archive signing key fingerprint</p>
3726+<p>A OpenPGP signing key fingerprint (40 chars) for this PPA or None if there is no signing key available.</p>
3727+
3728+</wadl:doc>
3729+
3730+ </wadl:param>
3731+ </wadl:representation>
3732+
3733+ <!--Collection page for this type of entry-->
3734+ <wadl:resource_type id="archive-page-resource">
3735+ <wadl:method name="GET" id="archive-page-resource-get">
3736+ <wadl:response>
3737+ <wadl:representation href="#archive-page"/>
3738+ </wadl:response>
3739+ </wadl:method>
3740+ </wadl:resource_type>
3741+
3742+ <wadl:representation mediaType="application/json"
3743+ id="archive-page">
3744+
3745+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
3746+ <wadl:link/>
3747+ </wadl:param>
3748+
3749+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
3750+
3751+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
3752+
3753+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
3754+ <wadl:link resource_type="#archive-page-resource"/>
3755+ </wadl:param>
3756+
3757+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
3758+ <wadl:link resource_type="#archive-page-resource"/>
3759+ </wadl:param>
3760+
3761+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
3762+
3763+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
3764+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
3765+ </wadl:param>
3766+ </wadl:representation>
3767+
3768+
3769+
3770+ <wadl:resource_type id="binary_package_publishing_history">
3771+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3772+A binary package publishing record.
3773+</wadl:doc>
3774+ <wadl:method name="GET"
3775+ id="binary_package_publishing_history-get">
3776+ <wadl:response>
3777+ <wadl:representation
3778+ href="http://api.launchpad.dev/beta/#binary_package_publishing_history-full"/>
3779+ <wadl:representation
3780+ mediaType="application/xhtml+xml"
3781+ id="binary_package_publishing_history-xhtml"/>
3782+ <wadl:representation
3783+ mediaType="application/vnd.sun.wadl+xml"
3784+ id="binary_package_publishing_history-wadl"/>
3785+ </wadl:response>
3786+ </wadl:method>
3787+
3788+ <wadl:method name="PUT"
3789+ id="binary_package_publishing_history-put">
3790+ <wadl:request>
3791+ <wadl:representation
3792+ href="http://api.launchpad.dev/beta/#binary_package_publishing_history-full"/>
3793+ </wadl:request>
3794+ </wadl:method>
3795+
3796+ <wadl:method name="PATCH"
3797+ id="binary_package_publishing_history-patch">
3798+ <wadl:request>
3799+ <wadl:representation
3800+ href="http://api.launchpad.dev/beta/#binary_package_publishing_history-diff"/>
3801+ </wadl:request>
3802+ </wadl:method>
3803+
3804+
3805+
3806+ </wadl:resource_type>
3807+
3808+
3809+ <wadl:representation mediaType="application/json"
3810+ id="binary_package_publishing_history-full">
3811+ <wadl:param style="plain" name="self_link" path="$['self_link']">
3812+ <wadl:doc>The canonical link to this resource.</wadl:doc>
3813+ <wadl:link resource_type="http://api.launchpad.dev/beta/#binary_package_publishing_history"/>
3814+ </wadl:param>
3815+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
3816+ <wadl:doc>
3817+ The link to the WADL description of this resource.
3818+ </wadl:doc>
3819+ <wadl:link/>
3820+ </wadl:param>
3821+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
3822+ <wadl:doc>
3823+ The value of the HTTP ETag for this resource.
3824+ </wadl:doc>
3825+ </wadl:param>
3826+ <wadl:param style="plain" required="true"
3827+ path="$['removal_comment']"
3828+ name="removal_comment">
3829+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3830+<p>Removal Comment</p>
3831+<p>Reason why this publication is going to be removed.</p>
3832+
3833+</wadl:doc>
3834+
3835+ </wadl:param>
3836+ <wadl:param style="plain" required="true"
3837+ path="$['distro_arch_series_link']"
3838+ name="distro_arch_series_link">
3839+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3840+<p>Distro Arch Series</p>
3841+<p>The distroarchseries being published into</p>
3842+
3843+</wadl:doc>
3844+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_arch_series"/>
3845+ </wadl:param>
3846+ <wadl:param style="plain" required="true"
3847+ path="$['date_published']"
3848+ type="xsd:dateTime" name="date_published">
3849+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3850+<p>Date Published</p>
3851+<p>The date on which this record was published</p>
3852+
3853+</wadl:doc>
3854+
3855+ </wadl:param>
3856+ <wadl:param style="plain" required="true"
3857+ path="$['date_removed']"
3858+ type="xsd:dateTime" name="date_removed">
3859+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3860+<p>Date Removed</p>
3861+<p>The date on which this record was removed from the published set</p>
3862+
3863+</wadl:doc>
3864+
3865+ </wadl:param>
3866+ <wadl:param style="plain" required="true"
3867+ path="$['archive_link']"
3868+ name="archive_link">
3869+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3870+<p>Archive</p>
3871+<p>The context archive for this publication.</p>
3872+
3873+</wadl:doc>
3874+ <wadl:link resource_type="http://api.launchpad.dev/beta/#archive"/>
3875+ </wadl:param>
3876+ <wadl:param style="plain" required="true"
3877+ path="$['priority_name']"
3878+ name="priority_name">
3879+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3880+Priority Name
3881+</wadl:doc>
3882+
3883+ </wadl:param>
3884+ <wadl:param style="plain" required="true"
3885+ path="$['date_superseded']"
3886+ type="xsd:dateTime" name="date_superseded">
3887+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3888+<p>Date Superseded</p>
3889+<p>The date on which this record was marked superseded</p>
3890+
3891+</wadl:doc>
3892+
3893+ </wadl:param>
3894+ <wadl:param style="plain" required="true"
3895+ path="$['scheduled_deletion_date']"
3896+ type="xsd:dateTime"
3897+ name="scheduled_deletion_date">
3898+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3899+<p>Scheduled Deletion Date</p>
3900+<p>The date on which this record is scheduled for deletion</p>
3901+
3902+</wadl:doc>
3903+
3904+ </wadl:param>
3905+ <wadl:param style="plain" required="true"
3906+ path="$['date_made_pending']"
3907+ type="xsd:dateTime"
3908+ name="date_made_pending">
3909+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3910+<p>Date Made Pending</p>
3911+<p>The date on which this record was set as pending removal</p>
3912+
3913+</wadl:doc>
3914+
3915+ </wadl:param>
3916+ <wadl:param style="plain" required="true"
3917+ path="$['binary_package_version']"
3918+ name="binary_package_version">
3919+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3920+Binary Package Version
3921+</wadl:doc>
3922+
3923+ </wadl:param>
3924+ <wadl:param style="plain" required="true"
3925+ path="$['component_name']"
3926+ name="component_name">
3927+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3928+Component Name
3929+</wadl:doc>
3930+
3931+ </wadl:param>
3932+ <wadl:param style="plain" required="true"
3933+ path="$['status']" name="status">
3934+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3935+<p>Status</p>
3936+<p>The status of this publishing record</p>
3937+
3938+</wadl:doc>
3939+
3940+ <wadl:option value="Pending"/>
3941+ <wadl:option value="Published"/>
3942+ <wadl:option value="Superseded"/>
3943+ <wadl:option value="Deleted"/>
3944+ <wadl:option value="Obsolete"/>
3945+ </wadl:param>
3946+ <wadl:param style="plain" required="true"
3947+ path="$['display_name']"
3948+ name="display_name">
3949+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3950+<p>Display Name</p>
3951+<p>Text representation of the current record.</p>
3952+
3953+</wadl:doc>
3954+
3955+ </wadl:param>
3956+ <wadl:param style="plain" required="true"
3957+ path="$['pocket']" name="pocket">
3958+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3959+<p>Pocket</p>
3960+<p>The pocket into which this entry is published</p>
3961+
3962+</wadl:doc>
3963+
3964+ <wadl:option value="Release"/>
3965+ <wadl:option value="Security"/>
3966+ <wadl:option value="Updates"/>
3967+ <wadl:option value="Proposed"/>
3968+ <wadl:option value="Backports"/>
3969+ </wadl:param>
3970+ <wadl:param style="plain" required="true"
3971+ path="$['section_name']"
3972+ name="section_name">
3973+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3974+Section Name
3975+</wadl:doc>
3976+
3977+ </wadl:param>
3978+ <wadl:param style="plain" required="true"
3979+ path="$['binary_package_name']"
3980+ name="binary_package_name">
3981+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3982+Binary Package Name
3983+</wadl:doc>
3984+
3985+ </wadl:param>
3986+ <wadl:param style="plain" required="true"
3987+ path="$['date_created']"
3988+ type="xsd:dateTime" name="date_created">
3989+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3990+<p>Date Created</p>
3991+<p>The date on which this record was created</p>
3992+
3993+</wadl:doc>
3994+
3995+ </wadl:param>
3996+ <wadl:param style="plain" required="true"
3997+ path="$['removed_by_link']"
3998+ name="removed_by_link">
3999+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4000+<p>Removed By</p>
4001+<p>The Person responsible for the removal</p>
4002+
4003+</wadl:doc>
4004+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4005+ </wadl:param>
4006+ </wadl:representation>
4007+
4008+ <wadl:representation mediaType="application/json"
4009+ id="binary_package_publishing_history-diff">
4010+ <wadl:param style="plain" required="false"
4011+ path="$['removal_comment']"
4012+ name="removal_comment">
4013+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4014+<p>Removal Comment</p>
4015+<p>Reason why this publication is going to be removed.</p>
4016+
4017+</wadl:doc>
4018+
4019+ </wadl:param>
4020+ <wadl:param style="plain" required="false"
4021+ path="$['distro_arch_series_link']"
4022+ name="distro_arch_series_link">
4023+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4024+<p>Distro Arch Series</p>
4025+<p>The distroarchseries being published into</p>
4026+
4027+</wadl:doc>
4028+ <wadl:link resource_type="http://api.launchpad.dev/beta/#distro_arch_series"/>
4029+ </wadl:param>
4030+ <wadl:param style="plain" required="false"
4031+ path="$['date_published']"
4032+ type="xsd:dateTime" name="date_published">
4033+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4034+<p>Date Published</p>
4035+<p>The date on which this record was published</p>
4036+
4037+</wadl:doc>
4038+
4039+ </wadl:param>
4040+ <wadl:param style="plain" required="false"
4041+ path="$['date_removed']"
4042+ type="xsd:dateTime" name="date_removed">
4043+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4044+<p>Date Removed</p>
4045+<p>The date on which this record was removed from the published set</p>
4046+
4047+</wadl:doc>
4048+
4049+ </wadl:param>
4050+ <wadl:param style="plain" required="false"
4051+ path="$['date_superseded']"
4052+ type="xsd:dateTime" name="date_superseded">
4053+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4054+<p>Date Superseded</p>
4055+<p>The date on which this record was marked superseded</p>
4056+
4057+</wadl:doc>
4058+
4059+ </wadl:param>
4060+ <wadl:param style="plain" required="false"
4061+ path="$['scheduled_deletion_date']"
4062+ type="xsd:dateTime"
4063+ name="scheduled_deletion_date">
4064+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4065+<p>Scheduled Deletion Date</p>
4066+<p>The date on which this record is scheduled for deletion</p>
4067+
4068+</wadl:doc>
4069+
4070+ </wadl:param>
4071+ <wadl:param style="plain" required="false"
4072+ path="$['date_made_pending']"
4073+ type="xsd:dateTime"
4074+ name="date_made_pending">
4075+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4076+<p>Date Made Pending</p>
4077+<p>The date on which this record was set as pending removal</p>
4078+
4079+</wadl:doc>
4080+
4081+ </wadl:param>
4082+ <wadl:param style="plain" required="false"
4083+ path="$['status']" name="status">
4084+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4085+<p>Status</p>
4086+<p>The status of this publishing record</p>
4087+
4088+</wadl:doc>
4089+
4090+ <wadl:option value="Pending"/>
4091+ <wadl:option value="Published"/>
4092+ <wadl:option value="Superseded"/>
4093+ <wadl:option value="Deleted"/>
4094+ <wadl:option value="Obsolete"/>
4095+ </wadl:param>
4096+ <wadl:param style="plain" required="false"
4097+ path="$['display_name']"
4098+ name="display_name">
4099+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4100+<p>Display Name</p>
4101+<p>Text representation of the current record.</p>
4102+
4103+</wadl:doc>
4104+
4105+ </wadl:param>
4106+ <wadl:param style="plain" required="false"
4107+ path="$['date_created']"
4108+ type="xsd:dateTime" name="date_created">
4109+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4110+<p>Date Created</p>
4111+<p>The date on which this record was created</p>
4112+
4113+</wadl:doc>
4114+
4115+ </wadl:param>
4116+ <wadl:param style="plain" required="false"
4117+ path="$['removed_by_link']"
4118+ name="removed_by_link">
4119+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4120+<p>Removed By</p>
4121+<p>The Person responsible for the removal</p>
4122+
4123+</wadl:doc>
4124+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4125+ </wadl:param>
4126+ </wadl:representation>
4127+
4128+ <!--Collection page for this type of entry-->
4129+ <wadl:resource_type id="binary_package_publishing_history-page-resource">
4130+ <wadl:method name="GET"
4131+ id="binary_package_publishing_history-page-resource-get">
4132+ <wadl:response>
4133+ <wadl:representation
4134+ href="#binary_package_publishing_history-page"/>
4135+ </wadl:response>
4136+ </wadl:method>
4137+ </wadl:resource_type>
4138+
4139+ <wadl:representation mediaType="application/json"
4140+ id="binary_package_publishing_history-page">
4141+
4142+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
4143+ <wadl:link/>
4144+ </wadl:param>
4145+
4146+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
4147+
4148+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
4149+
4150+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
4151+ <wadl:link resource_type="#binary_package_publishing_history-page-resource"/>
4152+ </wadl:param>
4153+
4154+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
4155+ <wadl:link resource_type="#binary_package_publishing_history-page-resource"/>
4156+ </wadl:param>
4157+
4158+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
4159+
4160+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
4161+ <wadl:link resource_type="http://api.launchpad.dev/beta/#binary_package_publishing_history"/>
4162+ </wadl:param>
4163+ </wadl:representation>
4164+
4165+
4166+
4167+ <wadl:resource_type id="branch_merge_proposal">
4168+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4169+Branch merge proposals show intent of landing one branch on another.
4170+</wadl:doc>
4171+ <wadl:method name="GET" id="branch_merge_proposal-get">
4172+ <wadl:response>
4173+ <wadl:representation
4174+ href="http://api.launchpad.dev/beta/#branch_merge_proposal-full"/>
4175+ <wadl:representation
4176+ mediaType="application/xhtml+xml"
4177+ id="branch_merge_proposal-xhtml"/>
4178+ <wadl:representation
4179+ mediaType="application/vnd.sun.wadl+xml"
4180+ id="branch_merge_proposal-wadl"/>
4181+ </wadl:response>
4182+ </wadl:method>
4183+
4184+ <wadl:method name="PUT" id="branch_merge_proposal-put">
4185+ <wadl:request>
4186+ <wadl:representation
4187+ href="http://api.launchpad.dev/beta/#branch_merge_proposal-full"/>
4188+ </wadl:request>
4189+ </wadl:method>
4190+
4191+ <wadl:method name="PATCH"
4192+ id="branch_merge_proposal-patch">
4193+ <wadl:request>
4194+ <wadl:representation
4195+ href="http://api.launchpad.dev/beta/#branch_merge_proposal-diff"/>
4196+ </wadl:request>
4197+ </wadl:method>
4198+
4199+
4200+
4201+ <wadl:method id="branch_merge_proposal-getComment"
4202+ name="GET">
4203+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4204+Return the CodeReviewComment with the specified ID.
4205+</wadl:doc>
4206+ <wadl:request>
4207+
4208+ <wadl:param style="query" name="ws.op"
4209+ required="true" fixed="getComment"/>
4210+ <wadl:param style="query" required="true"
4211+ name="id">
4212+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4213+A CodeReviewComment ID.
4214+</wadl:doc>
4215+
4216+ </wadl:param>
4217+
4218+ </wadl:request>
4219+ <wadl:response>
4220+
4221+ <wadl:representation
4222+ href="http://api.launchpad.dev/beta/#code_review_comment-full"/>
4223+ </wadl:response>
4224+ </wadl:method>
4225+ <wadl:method id="branch_merge_proposal-nominateReviewer"
4226+ name="POST">
4227+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4228+<p>Set the specified person as a reviewer.</p>
4229+<p>If they are not already a reviewer, a vote is created. Otherwise,
4230+the details are updated.</p>
4231+
4232+</wadl:doc>
4233+ <wadl:request>
4234+ <wadl:representation
4235+ mediaType="application/x-www-form-urlencoded">
4236+ <wadl:param style="query" name="ws.op"
4237+ required="true"
4238+ fixed="nominateReviewer"/>
4239+ <wadl:param style="query" required="false"
4240+ name="review_type">
4241+
4242+
4243+ </wadl:param>
4244+ <wadl:param style="query" required="true"
4245+ name="reviewer">
4246+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4247+A reviewer.
4248+</wadl:doc>
4249+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4250+ </wadl:param>
4251+ </wadl:representation>
4252+ </wadl:request>
4253+ <wadl:response>
4254+
4255+ <wadl:representation
4256+ href="http://api.launchpad.dev/beta/#code_review_vote_reference-full"/>
4257+ </wadl:response>
4258+ </wadl:method>
4259+ <wadl:method id="branch_merge_proposal-updatePreviewDiff"
4260+ name="POST">
4261+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4262+<p>Update the preview diff for this proposal.</p>
4263+<p>If there is not an existing preview diff, one will be created.</p>
4264+<table class="rst-docutils field-list" frame="void" rules="none">
4265+<col class="field-name" />
4266+<col class="field-body" />
4267+<tbody valign="top">
4268+<tr class="rst-field"><th class="rst-field-name" colspan="2">param diff_content:</th></tr>
4269+<tr><td>&nbsp;</td><td class="rst-field-body">The raw bytes of the diff content to be put in
4270+the librarian.</td>
4271+</tr>
4272+<tr class="rst-field"><th class="rst-field-name" colspan="2">param diff_stat:</th></tr>
4273+<tr><td>&nbsp;</td><td class="rst-field-body">Text describing the files added, remove or modified.</td>
4274+</tr>
4275+<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_revision_id:</th></tr>
4276+<tr><td>&nbsp;</td><td class="rst-field-body">The revision id that was used from the
4277+source branch.</td>
4278+</tr>
4279+<tr class="rst-field"><th class="rst-field-name" colspan="2">param target_revision_id:</th></tr>
4280+<tr><td>&nbsp;</td><td class="rst-field-body">The revision id that was used from the
4281+target branch.</td>
4282+</tr>
4283+<tr class="rst-field"><th class="rst-field-name" colspan="2">param prerequisite_revision_id:</th></tr>
4284+<tr><td>&nbsp;</td><td class="rst-field-body">The revision id that was used from the
4285+prerequisite branch.</td>
4286+</tr>
4287+<tr class="rst-field"><th class="rst-field-name" colspan="2">param conflicts:</th></tr>
4288+<tr><td>&nbsp;</td><td class="rst-field-body">Text describing the conflicts if any.</td>
4289+</tr>
4290+</tbody>
4291+</table>
4292+
4293+</wadl:doc>
4294+ <wadl:request>
4295+ <wadl:representation
4296+ mediaType="multipart/form-data">
4297+ <wadl:param style="query" name="ws.op"
4298+ required="true"
4299+ fixed="updatePreviewDiff"/>
4300+ <wadl:param style="query" required="false"
4301+ name="conflicts">
4302+
4303+
4304+ </wadl:param>
4305+ <wadl:param style="query" required="true"
4306+ name="target_revision_id">
4307+
4308+
4309+ </wadl:param>
4310+ <wadl:param style="query" required="true"
4311+ type="binary" name="diff_content">
4312+
4313+ <wadl:link resource_type="http://api.launchpad.dev/beta/#HostedFile"/>
4314+ </wadl:param>
4315+ <wadl:param style="query" required="true"
4316+ name="source_revision_id">
4317+
4318+
4319+ </wadl:param>
4320+ <wadl:param style="query" required="false"
4321+ name="prerequisite_revision_id">
4322+
4323+
4324+ </wadl:param>
4325+ </wadl:representation>
4326+ </wadl:request>
4327+
4328+ </wadl:method>
4329+ <wadl:method id="branch_merge_proposal-createComment"
4330+ name="POST">
4331+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4332+<p>Create an ICodeReviewComment associated with this merge proposal.</p>
4333+<table class="rst-docutils field-list" frame="void" rules="none">
4334+<col class="field-name" />
4335+<col class="field-body" />
4336+<tbody valign="top">
4337+<tr class="rst-field"><th class="rst-field-name">param owner:</th><td class="rst-field-body">The person who the message is from.</td>
4338+</tr>
4339+<tr class="rst-field"><th class="rst-field-name">param subject:</th><td class="rst-field-body">The subject line to use for the message.</td>
4340+</tr>
4341+<tr class="rst-field"><th class="rst-field-name">param content:</th><td class="rst-field-body">The text to use for the message content. If
4342+unspecified, the text of the merge proposal is used.</td>
4343+</tr>
4344+<tr class="rst-field"><th class="rst-field-name">param parent:</th><td class="rst-field-body">The previous CodeReviewComment in the thread. If
4345+unspecified, the root message is used.</td>
4346+</tr>
4347+</tbody>
4348+</table>
4349+
4350+</wadl:doc>
4351+ <wadl:request>
4352+ <wadl:representation
4353+ mediaType="application/x-www-form-urlencoded">
4354+ <wadl:param style="query" name="ws.op"
4355+ required="true"
4356+ fixed="createComment"/>
4357+ <wadl:param style="query" required="false"
4358+ name="review_type">
4359+
4360+
4361+ </wadl:param>
4362+ <wadl:param style="query" required="false"
4363+ name="vote">
4364+
4365+
4366+ <wadl:option value="Approve"/>
4367+ <wadl:option value="Needs Fixing"/>
4368+ <wadl:option value="Needs Information"/>
4369+ <wadl:option value="Abstain"/>
4370+ <wadl:option value="Disapprove"/>
4371+ <wadl:option value="Resubmit"/>
4372+ </wadl:param>
4373+ <wadl:param style="query" required="false"
4374+ name="content">
4375+
4376+
4377+ </wadl:param>
4378+ <wadl:param style="query" required="false"
4379+ name="parent">
4380+
4381+ <wadl:link resource_type="http://api.launchpad.dev/beta/#code_review_comment"/>
4382+ </wadl:param>
4383+ <wadl:param style="query" required="true"
4384+ name="subject">
4385+
4386+
4387+ </wadl:param>
4388+ </wadl:representation>
4389+ </wadl:request>
4390+ <wadl:response>
4391+ <wadl:param name="Location" style="header">
4392+ <wadl:link resource_type="http://api.launchpad.dev/beta/#code_review_comment"/>
4393+ </wadl:param>
4394+
4395+ </wadl:response>
4396+ </wadl:method>
4397+ <wadl:method id="branch_merge_proposal-setStatus"
4398+ name="POST">
4399+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4400+<p>Set the state of the merge proposal to the specified status.</p>
4401+<table class="rst-docutils field-list" frame="void" rules="none">
4402+<col class="field-name" />
4403+<col class="field-body" />
4404+<tbody valign="top">
4405+<tr class="rst-field"><th class="rst-field-name">param status:</th><td class="rst-field-body">The new status of the merge proposal.</td>
4406+</tr>
4407+<tr class="rst-field"><th class="rst-field-name">param user:</th><td class="rst-field-body">The user making the change.</td>
4408+</tr>
4409+<tr class="rst-field"><th class="rst-field-name" colspan="2">param revision_id:</th></tr>
4410+<tr><td>&nbsp;</td><td class="rst-field-body">The revno to provide to the underlying status
4411+change method.</td>
4412+</tr>
4413+</tbody>
4414+</table>
4415+
4416+</wadl:doc>
4417+ <wadl:request>
4418+ <wadl:representation
4419+ mediaType="application/x-www-form-urlencoded">
4420+ <wadl:param style="query" name="ws.op"
4421+ required="true" fixed="setStatus"/>
4422+ <wadl:param style="query" required="true"
4423+ name="status">
4424+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4425+The new status of the merge proposal.
4426+</wadl:doc>
4427+
4428+ <wadl:option value="Work in progress"/>
4429+ <wadl:option value="Needs review"/>
4430+ <wadl:option value="Approved"/>
4431+ <wadl:option value="Rejected"/>
4432+ <wadl:option value="Merged"/>
4433+ <wadl:option value="Code failed to merge"/>
4434+ <wadl:option value="Queued"/>
4435+ <wadl:option value="Superseded"/>
4436+ </wadl:param>
4437+ <wadl:param style="query" required="false"
4438+ name="revno">
4439+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4440+An optional parameter for specifying the revision of the branch for the status change.
4441+</wadl:doc>
4442+
4443+ </wadl:param>
4444+ </wadl:representation>
4445+ </wadl:request>
4446+
4447+ </wadl:method>
4448+ </wadl:resource_type>
4449+
4450+
4451+ <wadl:representation mediaType="application/json"
4452+ id="branch_merge_proposal-full">
4453+ <wadl:param style="plain" name="self_link" path="$['self_link']">
4454+ <wadl:doc>The canonical link to this resource.</wadl:doc>
4455+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch_merge_proposal"/>
4456+ </wadl:param>
4457+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
4458+ <wadl:doc>
4459+ The link to the WADL description of this resource.
4460+ </wadl:doc>
4461+ <wadl:link/>
4462+ </wadl:param>
4463+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
4464+ <wadl:doc>
4465+ The value of the HTTP ETag for this resource.
4466+ </wadl:doc>
4467+ </wadl:param>
4468+ <wadl:param style="plain" required="true"
4469+ path="$['queuer_link']" name="queuer_link">
4470+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4471+<p>Queuer</p>
4472+<p>The person that queued up the branch.</p>
4473+
4474+</wadl:doc>
4475+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4476+ </wadl:param>
4477+ <wadl:param style="plain" required="true"
4478+ path="$['source_branch_link']"
4479+ name="source_branch_link">
4480+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4481+<p>Source Branch</p>
4482+<p>The branch that has code to land.</p>
4483+
4484+</wadl:doc>
4485+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch"/>
4486+ </wadl:param>
4487+ <wadl:param style="plain" required="true"
4488+ path="$['queue_status']"
4489+ name="queue_status">
4490+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4491+<p>Status</p>
4492+<p>The current state of the proposal.</p>
4493+
4494+</wadl:doc>
4495+
4496+ <wadl:option value="Work in progress"/>
4497+ <wadl:option value="Needs review"/>
4498+ <wadl:option value="Approved"/>
4499+ <wadl:option value="Rejected"/>
4500+ <wadl:option value="Merged"/>
4501+ <wadl:option value="Code failed to merge"/>
4502+ <wadl:option value="Queued"/>
4503+ <wadl:option value="Superseded"/>
4504+ </wadl:param>
4505+ <wadl:param style="plain" required="true"
4506+ path="$['private']" name="private">
4507+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4508+<p>Proposal is confidential</p>
4509+<p>If True, this proposal is visible only to subscribers.</p>
4510+
4511+</wadl:doc>
4512+
4513+ </wadl:param>
4514+ <wadl:param style="plain" required="true"
4515+ path="$['date_reviewed']"
4516+ type="xsd:dateTime" name="date_reviewed">
4517+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4518+Date Reviewed
4519+</wadl:doc>
4520+
4521+ </wadl:param>
4522+ <wadl:param style="plain" required="true"
4523+ path="$['reviewer_link']"
4524+ name="reviewer_link">
4525+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4526+<p>Review person or team</p>
4527+<p>The person that accepted (or rejected) the code for merging.</p>
4528+
4529+</wadl:doc>
4530+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4531+ </wadl:param>
4532+ <wadl:param style="plain" required="true"
4533+ path="$['registrant_link']"
4534+ name="registrant_link">
4535+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4536+<p>Person</p>
4537+<p>The person who registered the landing target.</p>
4538+
4539+</wadl:doc>
4540+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4541+ </wadl:param>
4542+ <wadl:param style="plain" required="true"
4543+ path="$['votes_collection_link']"
4544+ name="votes_collection_link">
4545+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4546+The votes cast or expected for this proposal
4547+</wadl:doc>
4548+ <wadl:link resource_type="http://api.launchpad.dev/beta/#code_review_vote_reference-page-resource"/>
4549+ </wadl:param>
4550+ <wadl:param style="plain" required="true"
4551+ path="$['target_branch_link']"
4552+ name="target_branch_link">
4553+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4554+<p>Target Branch</p>
4555+<p>The branch that the source branch will be merged into.</p>
4556+
4557+</wadl:doc>
4558+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch"/>
4559+ </wadl:param>
4560+ <wadl:param style="plain" required="true"
4561+ path="$['date_review_requested']"
4562+ type="xsd:dateTime"
4563+ name="date_review_requested">
4564+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4565+Date Review Requested
4566+</wadl:doc>
4567+
4568+ </wadl:param>
4569+ <wadl:param style="plain" required="true"
4570+ path="$['preview_diff_link']"
4571+ name="preview_diff_link">
4572+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4573+The current diff of the source branch against the target branch.
4574+</wadl:doc>
4575+ <wadl:link resource_type="http://api.launchpad.dev/beta/#preview_diff"/>
4576+ </wadl:param>
4577+ <wadl:param style="plain" required="true"
4578+ path="$['commit_message']"
4579+ name="commit_message">
4580+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4581+<p>Commit Message</p>
4582+<p>The commit message that should be used when merging the source branch.</p>
4583+
4584+</wadl:doc>
4585+
4586+ </wadl:param>
4587+ <wadl:param style="plain" required="true"
4588+ path="$['supersedes_link']"
4589+ name="supersedes_link">
4590+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4591+<p>Supersedes</p>
4592+<p>The branch merge proposal that this one supersedes.</p>
4593+
4594+</wadl:doc>
4595+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch_merge_proposal"/>
4596+ </wadl:param>
4597+ <wadl:param style="plain" required="true"
4598+ path="$['queue_position']"
4599+ name="queue_position">
4600+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4601+<p>Queue Position</p>
4602+<p>The position in the queue.</p>
4603+
4604+</wadl:doc>
4605+
4606+ </wadl:param>
4607+ <wadl:param style="plain" required="true"
4608+ path="$['prerequisite_branch_link']"
4609+ name="prerequisite_branch_link">
4610+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4611+<p>Dependent Branch</p>
4612+<p>The branch that the source branch branched from. If this is the same as the target branch, then leave this field blank.</p>
4613+
4614+</wadl:doc>
4615+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch"/>
4616+ </wadl:param>
4617+ <wadl:param style="plain" required="true"
4618+ path="$['date_merged']"
4619+ type="xsd:dateTime" name="date_merged">
4620+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4621+<p>Date Merged</p>
4622+<p>The date that the source branch was merged into the target branch</p>
4623+
4624+</wadl:doc>
4625+
4626+ </wadl:param>
4627+ <wadl:param style="plain" required="true"
4628+ path="$['reviewed_revno']"
4629+ name="reviewed_revno">
4630+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4631+The revision id that has been approved by the reviewer.
4632+</wadl:doc>
4633+
4634+ </wadl:param>
4635+ <wadl:param style="plain" required="true"
4636+ path="$['all_comments_collection_link']"
4637+ name="all_comments_collection_link">
4638+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4639+All messages discussing this merge proposal
4640+</wadl:doc>
4641+ <wadl:link resource_type="http://api.launchpad.dev/beta/#code_review_comment-page-resource"/>
4642+ </wadl:param>
4643+ <wadl:param style="plain" required="true"
4644+ path="$['address']" name="address">
4645+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4646+<p>The email address for this proposal.</p>
4647+<p>Any emails sent to this address will resultin comments being added.</p>
4648+
4649+</wadl:doc>
4650+
4651+ </wadl:param>
4652+ <wadl:param style="plain" required="true"
4653+ path="$['queued_revno']"
4654+ name="queued_revno">
4655+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4656+<p>Queued Revision ID</p>
4657+<p>The revision id that has been queued for landing.</p>
4658+
4659+</wadl:doc>
4660+
4661+ </wadl:param>
4662+ <wadl:param style="plain" required="true"
4663+ path="$['date_queued']"
4664+ type="xsd:dateTime" name="date_queued">
4665+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4666+Date Queued
4667+</wadl:doc>
4668+
4669+ </wadl:param>
4670+ <wadl:param style="plain" required="true"
4671+ path="$['merged_revno']"
4672+ name="merged_revno">
4673+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4674+<p>Merged Revision Number</p>
4675+<p>The revision number on the target branch which contains the merge from the source branch.</p>
4676+
4677+</wadl:doc>
4678+
4679+ </wadl:param>
4680+ <wadl:param style="plain" required="true"
4681+ path="$['superseded_by_link']"
4682+ name="superseded_by_link">
4683+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4684+<p>Superseded By</p>
4685+<p>The branch merge proposal that supersedes this one.</p>
4686+
4687+</wadl:doc>
4688+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch_merge_proposal"/>
4689+ </wadl:param>
4690+ <wadl:param style="plain" required="true"
4691+ path="$['date_created']"
4692+ type="xsd:dateTime" name="date_created">
4693+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4694+Date Created
4695+</wadl:doc>
4696+
4697+ </wadl:param>
4698+ <wadl:param style="plain" required="true"
4699+ path="$['merge_reporter_link']"
4700+ name="merge_reporter_link">
4701+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4702+<p>Merge Reporter</p>
4703+<p>The user that marked the branch as merged.</p>
4704+
4705+</wadl:doc>
4706+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4707+ </wadl:param>
4708+ </wadl:representation>
4709+
4710+ <wadl:representation mediaType="application/json"
4711+ id="branch_merge_proposal-diff">
4712+ <wadl:param style="plain" required="false"
4713+ path="$['commit_message']"
4714+ name="commit_message">
4715+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4716+<p>Commit Message</p>
4717+<p>The commit message that should be used when merging the source branch.</p>
4718+
4719+</wadl:doc>
4720+
4721+ </wadl:param>
4722+ <wadl:param style="plain" required="false"
4723+ path="$['reviewed_revno']"
4724+ name="reviewed_revno">
4725+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4726+The revision id that has been approved by the reviewer.
4727+</wadl:doc>
4728+
4729+ </wadl:param>
4730+ </wadl:representation>
4731+
4732+ <!--Collection page for this type of entry-->
4733+ <wadl:resource_type id="branch_merge_proposal-page-resource">
4734+ <wadl:method name="GET"
4735+ id="branch_merge_proposal-page-resource-get">
4736+ <wadl:response>
4737+ <wadl:representation
4738+ href="#branch_merge_proposal-page"/>
4739+ </wadl:response>
4740+ </wadl:method>
4741+ </wadl:resource_type>
4742+
4743+ <wadl:representation mediaType="application/json"
4744+ id="branch_merge_proposal-page">
4745+
4746+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
4747+ <wadl:link/>
4748+ </wadl:param>
4749+
4750+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
4751+
4752+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
4753+
4754+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
4755+ <wadl:link resource_type="#branch_merge_proposal-page-resource"/>
4756+ </wadl:param>
4757+
4758+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
4759+ <wadl:link resource_type="#branch_merge_proposal-page-resource"/>
4760+ </wadl:param>
4761+
4762+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
4763+
4764+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
4765+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch_merge_proposal"/>
4766+ </wadl:param>
4767+ </wadl:representation>
4768+
4769+
4770+
4771+ <wadl:resource_type id="branch_subscription">
4772+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4773+The relationship between a person and a branch.
4774+</wadl:doc>
4775+ <wadl:method name="GET" id="branch_subscription-get">
4776+ <wadl:response>
4777+ <wadl:representation
4778+ href="http://api.launchpad.dev/beta/#branch_subscription-full"/>
4779+ <wadl:representation
4780+ mediaType="application/xhtml+xml"
4781+ id="branch_subscription-xhtml"/>
4782+ <wadl:representation
4783+ mediaType="application/vnd.sun.wadl+xml"
4784+ id="branch_subscription-wadl"/>
4785+ </wadl:response>
4786+ </wadl:method>
4787+
4788+ <wadl:method name="PUT" id="branch_subscription-put">
4789+ <wadl:request>
4790+ <wadl:representation
4791+ href="http://api.launchpad.dev/beta/#branch_subscription-full"/>
4792+ </wadl:request>
4793+ </wadl:method>
4794+
4795+ <wadl:method name="PATCH"
4796+ id="branch_subscription-patch">
4797+ <wadl:request>
4798+ <wadl:representation
4799+ href="http://api.launchpad.dev/beta/#branch_subscription-diff"/>
4800+ </wadl:request>
4801+ </wadl:method>
4802+
4803+
4804+
4805+ </wadl:resource_type>
4806+
4807+
4808+ <wadl:representation mediaType="application/json"
4809+ id="branch_subscription-full">
4810+ <wadl:param style="plain" name="self_link" path="$['self_link']">
4811+ <wadl:doc>The canonical link to this resource.</wadl:doc>
4812+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch_subscription"/>
4813+ </wadl:param>
4814+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
4815+ <wadl:doc>
4816+ The link to the WADL description of this resource.
4817+ </wadl:doc>
4818+ <wadl:link/>
4819+ </wadl:param>
4820+ <wadl:param style="plain" name="http_etag" path="$['http_etag']">
4821+ <wadl:doc>
4822+ The value of the HTTP ETag for this resource.
4823+ </wadl:doc>
4824+ </wadl:param>
4825+ <wadl:param style="plain" required="true"
4826+ path="$['notification_level']"
4827+ name="notification_level">
4828+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4829+<p>Notification Level</p>
4830+<p>Attribute notifications are sent when branch details are changed such as lifecycle status and name. Revision notifications are generated when new branch revisions are found due to the branch being updated through either pushes to the hosted branches or the mirrored branches being updated.</p>
4831+
4832+</wadl:doc>
4833+
4834+ <wadl:option value="No email"/>
4835+ <wadl:option value="Branch attribute notifications only"/>
4836+ <wadl:option value="Branch revision notifications only"/>
4837+ <wadl:option value="Branch attribute and revision notifications"/>
4838+ </wadl:param>
4839+ <wadl:param style="plain" required="true"
4840+ path="$['max_diff_lines']"
4841+ name="max_diff_lines">
4842+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4843+<p>Generated Diff Size Limit</p>
4844+<p>Diffs greater than the specified number of lines will not be sent to the subscriber. The subscriber will still receive an email with the new revision details even if the diff is larger than the specified number of lines.</p>
4845+
4846+</wadl:doc>
4847+
4848+ <wadl:option value="Don't send diffs"/>
4849+ <wadl:option value="500 lines"/>
4850+ <wadl:option value="1000 lines"/>
4851+ <wadl:option value="5000 lines"/>
4852+ <wadl:option value="Send entire diff"/>
4853+ </wadl:param>
4854+ <wadl:param style="plain" required="true"
4855+ path="$['review_level']"
4856+ name="review_level">
4857+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4858+<p>Code review Level</p>
4859+<p>Control the kind of review activity that triggers notifications.</p>
4860+
4861+</wadl:doc>
4862+
4863+ <wadl:option value="No email"/>
4864+ <wadl:option value="Status changes only"/>
4865+ <wadl:option value="Email about all changes"/>
4866+ </wadl:param>
4867+ <wadl:param style="plain" required="true"
4868+ path="$['person_link']" name="person_link">
4869+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4870+<p>Person</p>
4871+<p>Enter the launchpad id, or email address of the person you wish to subscribe to this branch. If you are unsure, use the &quot;Choose...&quot; option to find the person in Launchpad. You can only subscribe someone who is a registered user of the system.</p>
4872+
4873+</wadl:doc>
4874+ <wadl:link resource_type="http://api.launchpad.dev/beta/#person"/>
4875+ </wadl:param>
4876+ <wadl:param style="plain" required="true"
4877+ path="$['branch_link']" name="branch_link">
4878+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4879+Branch ID
4880+</wadl:doc>
4881+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch"/>
4882+ </wadl:param>
4883+ </wadl:representation>
4884+
4885+ <wadl:representation mediaType="application/json"
4886+ id="branch_subscription-diff">
4887+ <wadl:param style="plain" required="false"
4888+ path="$['notification_level']"
4889+ name="notification_level">
4890+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4891+<p>Notification Level</p>
4892+<p>Attribute notifications are sent when branch details are changed such as lifecycle status and name. Revision notifications are generated when new branch revisions are found due to the branch being updated through either pushes to the hosted branches or the mirrored branches being updated.</p>
4893+
4894+</wadl:doc>
4895+
4896+ <wadl:option value="No email"/>
4897+ <wadl:option value="Branch attribute notifications only"/>
4898+ <wadl:option value="Branch revision notifications only"/>
4899+ <wadl:option value="Branch attribute and revision notifications"/>
4900+ </wadl:param>
4901+ <wadl:param style="plain" required="false"
4902+ path="$['max_diff_lines']"
4903+ name="max_diff_lines">
4904+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4905+<p>Generated Diff Size Limit</p>
4906+<p>Diffs greater than the specified number of lines will not be sent to the subscriber. The subscriber will still receive an email with the new revision details even if the diff is larger than the specified number of lines.</p>
4907+
4908+</wadl:doc>
4909+
4910+ <wadl:option value="Don't send diffs"/>
4911+ <wadl:option value="500 lines"/>
4912+ <wadl:option value="1000 lines"/>
4913+ <wadl:option value="5000 lines"/>
4914+ <wadl:option value="Send entire diff"/>
4915+ </wadl:param>
4916+ <wadl:param style="plain" required="false"
4917+ path="$['review_level']"
4918+ name="review_level">
4919+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4920+<p>Code review Level</p>
4921+<p>Control the kind of review activity that triggers notifications.</p>
4922+
4923+</wadl:doc>
4924+
4925+ <wadl:option value="No email"/>
4926+ <wadl:option value="Status changes only"/>
4927+ <wadl:option value="Email about all changes"/>
4928+ </wadl:param>
4929+ </wadl:representation>
4930+
4931+ <!--Collection page for this type of entry-->
4932+ <wadl:resource_type id="branch_subscription-page-resource">
4933+ <wadl:method name="GET"
4934+ id="branch_subscription-page-resource-get">
4935+ <wadl:response>
4936+ <wadl:representation
4937+ href="#branch_subscription-page"/>
4938+ </wadl:response>
4939+ </wadl:method>
4940+ </wadl:resource_type>
4941+
4942+ <wadl:representation mediaType="application/json"
4943+ id="branch_subscription-page">
4944+
4945+ <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
4946+ <wadl:link/>
4947+ </wadl:param>
4948+
4949+ <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
4950+
4951+ <wadl:param style="plain" name="start" path="$['start']" required="true"/>
4952+
4953+ <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
4954+ <wadl:link resource_type="#branch_subscription-page-resource"/>
4955+ </wadl:param>
4956+
4957+ <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
4958+ <wadl:link resource_type="#branch_subscription-page-resource"/>
4959+ </wadl:param>
4960+
4961+ <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
4962+
4963+ <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
4964+ <wadl:link resource_type="http://api.launchpad.dev/beta/#branch_subscription"/>
4965+ </wadl:param>
4966+ </wadl:representation>
4967+
4968+
4969+
4970+ <wadl:resource_type id="branch">
4971+ <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
4972+A Bazaar branch.
4973+</wadl:doc>
4974+ <wadl:method name="GET" id="branch-get">
4975+ <wadl:response>
4976+ <wadl:representation
4977+ href="http://api.launchpad.dev/beta/#branch-full"/>
4978+ <wadl:representation
4979+ mediaType="application/xhtml+xml" id="branch-xhtml"/>
4980+ <wadl:representation
4981+ mediaType="application/vnd.sun.wadl+xml"
4982+ id="branch-wadl"/>
4983+ </wadl:response>
4984+ </wadl:method>
4985+
4986+ <wadl:method name="PUT" id="branch-put">
4987+ <wadl:request>
4988+ <wadl:representation
4989+ href="http://api.launchpad.dev/beta/#branch-full"/>
4990+ </wadl:request>
4991+ </wadl:method>
4992+
4993+ <wadl:method name="PATCH" id="branch-patch">
4994+ <wadl:request>
4995+ <wadl:representation
4996+ href="http://api.launchpad.dev/beta/#branch-diff"/>
4997+ </wadl:request>
4998+ </wadl:method>
4999+
5000+ <wadl:method name="DELETE" id="branch-delete"/>
The diff has been truncated for viewing.

Subscribers

People subscribed via source and target branches

to status/vote changes: