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