Merge lp:~jml/launchpadlib/fake-launchpad into lp:launchpadlib

Proposed by Jonathan Lange on 2011-09-13
Status: Merged
Approved by: Jeroen T. Vermeulen on 2011-09-15
Approved revision: 98
Merged at revision: 118
Proposed branch: lp:~jml/launchpadlib/fake-launchpad
Merge into: lp:launchpadlib
Diff against target: 40484 lines (+40406/-5)
8 files modified
.bzrignore (+1/-0)
setup.py (+1/-0)
src/launchpadlib/testing/launchpad-wadl.xml (+39070/-0)
src/launchpadlib/testing/launchpad.py (+537/-0)
src/launchpadlib/testing/resources.py (+55/-0)
src/launchpadlib/testing/testing-wadl.xml (+346/-0)
src/launchpadlib/testing/tests/test_launchpad.py (+393/-0)
src/launchpadlib/tests/test_launchpad.py (+3/-5)
To merge this branch: bzr merge lp:~jml/launchpadlib/fake-launchpad
Reviewer Review Type Date Requested Status
Jeroen T. Vermeulen (community) Approve on 2011-09-15
Graham Binns (community) code 2011-09-13 Approve on 2011-09-14
Review via email: mp+75211@code.launchpad.net

Commit message

[r=gmb,jtv][no-qa] Fake Launchpad web service for unit tests.

Description of the change

This is based on https://code.launchpad.net/~jkakar/launchpadlib/fake-launchpad/+merge/26391. I've tried to take all of the merge proposal comments I could in order to get this darn thing landed.

Oh. There's a massive change to the WADL file. Use jkakar's "sane diff" instructions from the linked MP.

I'm going to include the extracted suggestions from the linked MP and number them here with my own special numbering system, and follow them with my responses.

A. Include a datetime for the stored WADL and then use If-Modified-Since when fetching the new WADL

<jml> Not doing this. Can be done in a later branch if necessary.

B. Put this into lazr.restfulclient

<jml> Not doing this. If you really care about it, perhaps you could do it.

C. Use a smaller, custom WADL for testing, perhaps even one per feature.

<jml> I've made a smaller WADL called testing-wadl.xml and have used that for testing. It's probably not minimal, but it's way smaller.

D. FakeResource should have FakeEntry and FakeRoot subclasses.

<jml> Done this. They are pretty trivial, but I hope this makes things clearer.

E. The return value of methods should be wrapped in either FakeEntry or FakeCollection, depending on what is being returned.

<jml> Sadly, there's no obvious way to do this. So I haven't.

F. Ditch the index lookups. Add them later when you can do them right.

<jml> Done.

G. Add a README demonstrating how to use this.

<jml> Done, sort of. Have expanded the module docstring, which I hope is enough.

H. Change FakeResource not to do XML parsing, maybe use lxml.

<jml> Not doing this. Follow up patches welcome.

I. Change the interface so that sample data population is more Pythonic and / or closer to how to do it in actual APIs.

<jml> Not doing this either. If there's a clear solution offered, I might be tempted, but am more likely to ask that someone else do it.

This branch has been proposed for well over a year. It's time to put this to bed.

To post a comment you must log in.
Graham Binns (gmb) wrote :

I'm going to have to punt on this, since I don't have time to complete the review before my EOD. I'll be happy to allocate time for it later in the week or during my next OCR day, though.

Jonathan Lange (jml) wrote :

On Tue, Sep 13, 2011 at 5:38 PM, Graham Binns <email address hidden> wrote:
> I'm going to have to punt on this, since I don't have time to complete the review before my EOD. I'll be happy to allocate time for it later in the week or during my next OCR day, though.

Thanks, that would be much appreciated. I'd rather not wait until your
next OCR day though, as that would leave me with too much WIP.

jml

Jeroen T. Vermeulen (jtv) wrote :
Download full text (11.8 KiB)

I see the bikeshedding has already been done. Good—you won't be needing much from me then. Thanks for putting your weight behind this project!

My notes are essentially about superficialities. See below. What they mostly boil down to is that you seem to be missing an abstraction layer to translate parsed WADL into meaningful information. In practice it looks like a matter of extracting lots of little helpers to separate the parsing nitty-gritty from the real meaning of the Fake* code.

=== added file 'src/launchpadlib/testing/launchpad.py'

—8<—

+class FakeResource(object):
+ """
+ Fake resource validates and represents sample data set on L{FakeLaunchpad}
+ instances.

Found this a bit hard to read. Maybe leave out the “Fake resource” at the beginning? The “set” could be a verb or a noun, so maybe just say “Valides and represents sample data on a L{FakeLaunchpad}”? Has the added benefit of fitting on a single line.

+ @param application: A C{waddlib.application.Application} instance.
+ @param resource_type: A C{wadllib.application.ResourceType} instance for
+ this resource.
+ @param values: Optionally, a dict representing attribute key/value pairs
+ for this resource.

You're using a bunch of documentation conventions I'm not familiar with. Do constructor parameters normally go into the class docstring then?

+ def __setattr__(self, name, value):
+ """Set sample data.
+
+ @param name: The name of the attribute.
+ @param values: A dict representing an object matching a resource
+ defined in Launchpad's WADL definition.

Which is it—“value” or “values”? The code suggests that it can be a dict or… an atomic value I suppose:

+ if isinstance(value, dict):
+ self._children[name] = self._create_child_resource(name, value)
+ else:
+ values = {}
+ if self._values is not None:
+ values.update(self._values)
+ values[name] = value
+ self._check_resource_type(self._resource_type, values)
+ self.__dict__["_values"] = values

A comment might be helpful. Does it make sense to run a full modified copy of self._values through _check_resource_type? It checks each item individually anyway, right?

+ def __getattr__(self, name):
+ """Get sample data.
+
+ @param name: The name of the attribute.
+ """
+ result = self._children.get(name)

What kind of items can I expect to find in _children?

+ if not result:

 What exactly are you testing for? Can result be, say, an integer that might be zero, or a string that might be empty?

+ if isinstance(self._values, dict):
+ result = self._values.get(name)
+ if callable(result):
+ return self._wrap_method(name, result)

What does it mean for self._values not to be a dict? One case we've seen is that it might be None… are there other possibilities? If no, then please harmonize the test and maybe wrap it in a meaningfully-named method.

+ def _create_child_resource(self, name, values):
+ """
+ Ensure that C{values} is a valid obje...

Jonathan Lange (jml) wrote :
Download full text (14.9 KiB)

On Wed, Sep 14, 2011 at 12:51 PM, Jeroen T. Vermeulen <email address hidden> wrote:
> I see the bikeshedding has already been done.  Good—you won't be needing much from me then.  Thanks for putting your weight behind this project!
>

No worries. A lot of your input here has been very useful.

FWIW, all I've done for this has been to take Jamu's branch and reply
to other people's review comments (now yours).

> My notes are essentially about superficialities.  See below.  What they mostly boil down to is that you seem to be missing an abstraction layer to translate parsed WADL into meaningful information.  In practice it looks like a matter of extracting lots of little helpers to separate the parsing nitty-gritty from the real meaning of the Fake* code.

Yeah. Looking at this code, I think it would be worthwhile to extract
something that's very much focused on WADL interpretation. (e.g. a
ResourceType class). However, as I declared in the beginning, that's
out of scope. I just want to merge Jamu's useful code to prove that
useful code can be merged! When I have confidence that this is even
possible, I'll merrily refactor away.

> === added file 'src/launchpadlib/testing/launchpad.py'
>
> —8<—
>
> +class FakeResource(object):
> +    """
> +    Fake resource validates and represents sample data set on L{FakeLaunchpad}
> +    instances.
>
> Found this a bit hard to read.  Maybe leave out the “Fake resource” at the beginning?  The “set” could be a verb or a noun, so maybe just say “Valides and represents sample data on a L{FakeLaunchpad}”?  Has the added benefit of fitting on a single line.
>

Changed.

>
> +    @param application: A C{waddlib.application.Application} instance.
> +    @param resource_type: A C{wadllib.application.ResourceType} instance for
> +        this resource.
> +    @param values: Optionally, a dict representing attribute key/value pairs
> +        for this resource.
>
> You're using a bunch of documentation conventions I'm not familiar with.  Do constructor parameters normally go into the class docstring then?
>

They normally do. This was how I found them. Have moved into constructor.

>
> +    def __setattr__(self, name, value):
> +        """Set sample data.
> +
> +        @param name: The name of the attribute.
> +        @param values: A dict representing an object matching a resource
> +            defined in Launchpad's WADL definition.
>
> Which is it—“value” or “values”?  The code suggests that it can be a dict or… an atomic value I suppose:
>

Have deleted the param documentation: setattr doesn't need it.
Explained how value works.

>
> +        if isinstance(value, dict):
> +            self._children[name] = self._create_child_resource(name, value)
> +        else:
> +            values = {}
> +            if self._values is not None:
> +                values.update(self._values)
> +            values[name] = value
> +            self._check_resource_type(self._resource_type, values)
> +            self.__dict__["_values"] = values
>
> A comment might be helpful.  Does it make sense to run a full modified copy of self._values through _check_resource_type?  It checks each item individually anyway, right?

It's act...

lp:~jml/launchpadlib/fake-launchpad updated on 2011-09-14
83. By Jonathan Lange on 2011-09-14

Documentation tweaks.

84. By Jonathan Lange on 2011-09-14

Be more explicit.

85. By Jonathan Lange on 2011-09-14

Use a consistent check.

86. By Jonathan Lange on 2011-09-14

Make values always set. Use marker() pattern for safe_hasattr.

87. By Jonathan Lange on 2011-09-14

Correct documentation.

88. By Jonathan Lange on 2011-09-14

Rewrite so that get-as-in checks are clearer and stricter.

89. By Jonathan Lange on 2011-09-14

Reverse if/else check, making code simpler.

90. By Jonathan Lange on 2011-09-14

Change _check_method to _get_method so it can be re-used in more places.

91. By Jonathan Lange on 2011-09-14

Factor out the element finding.

92. By Jonathan Lange on 2011-09-14

Remove more duplicated code.

93. By Jonathan Lange on 2011-09-14

Simplify code and correct docstring.

94. By Jonathan Lange on 2011-09-14

More docstring changes.

95. By Jonathan Lange on 2011-09-14

Extract attribute lookup

96. By Jonathan Lange on 2011-09-14

Don't use getchildren. Use iter & list.

Graham Binns (gmb) wrote :

Hi Jono,

Disappointingly (or not, depending on your point of view) I've found nothing whatever to complain about in your tests. These need changing though:

> === added file 'src/launchpadlib/testing/launchpad.py'
> --- src/launchpadlib/testing/launchpad.py 1970-01-01 00:00:00 +0000
> +++ src/launchpadlib/testing/launchpad.py 2011-09-14 15:20:28 +0000
> @@ -0,0 +1,531 @@
> +# Copyright 2008 Canonical Ltd.
> +

This needs 2011 appending to it.

> === added file 'src/launchpadlib/testing/tests/__init__.py'
> === added file 'src/launchpadlib/testing/tests/test_launchpad.py'
> --- src/launchpadlib/testing/tests/test_launchpad.py 1970-01-01 00:00:00 +0000
> +++ src/launchpadlib/testing/tests/test_launchpad.py 2011-09-13 15:56:51 +0000
> @@ -0,0 +1,393 @@
> +# Copyright 2008 Canonical Ltd.
> +

As does this.

r=me on the tests. I'll let Jeroen be the one to respond to your changes w.r.t his comments.

review: Approve (code)
lp:~jml/launchpadlib/fake-launchpad updated on 2011-09-14
97. By Jonathan Lange on 2011-09-14

Copyright, flakes.

Jeroen T. Vermeulen (jtv) wrote :

Thanks for being patient with my nitpicking. I do agree that this should go in quickly, with localized fixes only.

One thing however (hence the alarmist Needs Fixing vote): don't strip off the “-full” suffix using rstrip! That would strip off, say, “-flufl” as well (not nice to Barry) and turn “wonderful-lulu” into a mere “wonder.”

review: Needs Fixing
Jonathan Lange (jml) wrote :

Changed.

lp:~jml/launchpadlib/fake-launchpad updated on 2011-09-15
98. By Jonathan Lange on 2011-09-15

Whatever.

Jeroen T. Vermeulen (jtv) wrote :

Thanks for fixing that. I'll land the branch.

review: Approve

Preview Diff

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

Subscribers

People subscribed via source and target branches