launchpadlib

Merge ~jugmac00/launchpadlib:apply-inclusive-naming into launchpadlib:main

  1. Git
  2. lp:~jugmac00/launchpadlib
  3. apply-inclusive-naming
  4. Merge into main
Proposed by Jürgen Gmach
Status: Merged
Merged at revision: d90fe8932586a6bed14ca9cc873fbb4ecf990b91
Proposed branch: ~jugmac00/launchpadlib:apply-inclusive-naming
Merge into: launchpadlib:main
Diff against target: 58732 lines (+21700/-22738)
5 files modified
.pre-commit-config.yaml (+4/-0)
.woke.yaml (+228/-0)
NEWS.rst (+1/-0)
src/launchpadlib/testing/launchpad-wadl.xml (+21465/-22736)
src/launchpadlib/tests/test_launchpad.py (+2/-2)
Reviewer Review Type Date Requested Status
Colin Watson (community) Approve
Review via email: mp+411789@code.launchpad.net

Commit message

Apply inclusive naming via the `woke` `pre-commit` hook

To post a comment you must log in.
Revision history for this message
Guruprasad (lgp171188) :
Revision history for this message
Colin Watson (cjwatson) :
Revision history for this message
Colin Watson (cjwatson) :
Revision history for this message
Jürgen Gmach (jugmac00) wrote :

Thanks for the review! I replied to all comments, but it looks like the only thing to do is to replace the devel with the 1.0 version. Which I will do in a min.

Revision history for this message
Jürgen Gmach (jugmac00) wrote :

Please note - the diff is too long and needs to be reviewed on the command line (or similar).

Revision history for this message
Colin Watson (cjwatson) wrote :

I've only really sampled the WADL updates, but they broadly look fine to me and are clearly just bringing things up to date with Launchpad itself. The rest is OK too.

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index c528329..fe333f3 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -19,3 +19,7 @@ repos:
19 rev: 21.9b019 rev: 21.9b0
20 hooks:20 hooks:
21 - id: black21 - id: black
22- repo: https://github.com/get-woke/woke
23 rev: v0.17.0
24 hooks:
25 - id: woke-from-source
diff --git a/.woke.yaml b/.woke.yaml
22new file mode 10064426new file mode 100644
index 0000000..424838e
--- /dev/null
+++ b/.woke.yaml
@@ -0,0 +1,228 @@
1
2# Based on Canonical's Guidelines
3# https://docs.google.com/document/d/1mJUa1VJHOMWa723dmKmNjSKGW-nlBv9xktzGZZwacVo/edit#heading=h.5efudb237qdb
4rules:
5 - name: whitelist
6 terms:
7 - whitelist
8 - white-list
9 - whitelisted
10 - white-listed
11 alternatives:
12 - allowlist
13 - inclusion list
14 severity: warning
15 note: "The underlying assumption of the whitelist/blacklist metaphor is that white = good and black = bad. Because colors in and of themselves have no predetermined meaning, any meaning we assign to them is cultural: for example, the color red in many Southeast Asian countries is lucky, and is often associated with events like marriages, whereas the color white carries the same connotations in many European countries. In the case of whitelist/blacklist, the terms originate in the publishing industry – one dominated by the USA and England, two countries which participated in slavery and which grapple with their racist legacies to this day."
16
17 - name: blacklist
18 terms:
19 - blacklist
20 - black-list
21 - blacklisted
22 - black-listed
23 alternatives:
24 - denylist
25 - blocklist
26 - exclusion list
27 severity: warning
28 note: "The underlying assumption of the whitelist/blacklist metaphor is that white = good and black = bad. Because colors in and of themselves have no predetermined meaning, any meaning we assign to them is cultural: for example, the color red in many Southeast Asian countries is lucky, and is often associated with events like marriages, whereas the color white carries the same connotations in many European countries. In the case of whitelist/blacklist, the terms originate in the publishing industry – one dominated by the USA and England, two countries which participated in slavery and which grapple with their racist legacies to this day."
29
30 - name: master-slave
31 terms:
32 - master-slave
33 - master/slave
34 alternatives:
35 - leader/follower
36 - main/replica
37 - primary/replica
38 - primary/standby
39 - primary/secondary
40
41 - name: slave
42 terms:
43 - slave
44 alternatives:
45 - follower
46 - replica
47 - standby
48
49 - name: grandfathered
50 terms:
51 - grandfathered
52 alternatives:
53 - legacy status
54 - legacied
55 - exempted
56 - carried
57 - brought forward
58 - rolled over
59
60 - name: man-hours
61 terms:
62 - man hours
63 - man-hours
64 alternatives:
65 - person hours
66 - engineer hours
67
68 - name: sanity
69 terms:
70 - sanity
71 alternatives:
72 - confidence
73 - quick check
74 - coherence check
75
76 - name: dummy
77 terms:
78 - dummy
79 alternatives:
80 - placeholder
81 - sample
82
83 - name: guys
84 terms:
85 - guys
86 alternatives:
87 - folks
88 - people
89 - you all
90 - y'all
91 - yinz
92
93 - name: whitebox
94 terms:
95 - white-box
96 - whitebox
97 - white box
98 alternatives:
99 - open-box
100
101 - name: blackbox
102 terms:
103 - black-box
104 - blackbox
105 - black box
106 alternatives:
107 - closed-box
108
109 - name: blackhat
110 terms:
111 - blackhat
112 - black-hat
113 - black hat
114 alternatives:
115 - attacker
116 - malicious actor
117
118 - name: whitehat
119 terms:
120 - whitehat
121 - white-hat
122 - white hat
123 alternatives:
124 - researcher
125 - security specialist
126
127 - name: illegal characters
128 terms:
129 - illegal characters
130 alternatives:
131 - invalid characters
132 - unsupported characters
133 - special characters
134
135 - name: native feature
136 terms:
137 - native feature
138 alternatives:
139 - core feature
140 - built-in feature
141
142 - name: native feature
143 terms:
144 - native feature
145 alternatives:
146 - core feature
147 - built-in feature
148
149 - name: chairman/foreman
150 terms:
151 - chairman
152 - foreman
153 alternatives:
154 - chair
155 - foreperson
156
157 - name: man in the middle
158 terms:
159 - man in the middle
160 - man-in-the-middle
161 alternatives:
162 - machine-in-the-middle
163 - person-in-the-middle
164 - system-in-the-middle
165 - intermediary attack
166
167 - name: middleman
168 terms:
169 - middleman
170 alternatives:
171 - middleperson
172 - intermediary
173
174 - name: manned
175 terms:
176 - manned
177 alternatives:
178 - crewed
179 - staffed
180 - monitored
181 - human operated
182
183 - name: mom test / girlfriend test
184 terms:
185 - mom test
186 - girlfriend test
187 alternatives:
188 - user test
189 - user friendly
190
191 - name: crazy
192 terms:
193 - crazy
194 alternatives:
195 - baffling
196 - unexplained
197 - errant
198
199 - name: cripples
200 terms:
201 - cripples
202 alternatives:
203 - slows down
204 - hinders
205 - obstructs
206
207 - name: crippling
208 terms:
209 - crippling
210 alternatives:
211 - attenuating
212 - incapacitating
213
214 - name: stonith/stomith
215 terms:
216 - stonith
217 - stomith
218 alternatives:
219 - fence failed nodes
220 - machines
221
222 - name: demilitarized zone
223 terms:
224 - demilitarized zone
225 - dmz
226 alternatives:
227 - perimeter network
228 - passthrough network
0\ No newline at end of file229\ No newline at end of file
diff --git a/NEWS.rst b/NEWS.rst
index d89f010..b7c734b 100644
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -9,6 +9,7 @@ NEWS for launchpadlib
9- Apply ``black`` code formatter.9- Apply ``black`` code formatter.
10- Publish documentation on Read the Docs.10- Publish documentation on Read the Docs.
11- Remove remnants of ``simplejson`` in favour of ``json``.11- Remove remnants of ``simplejson`` in favour of ``json``.
12- Apply inclusive naming via the ``woke`` ``pre-commit`` hook.
1213
131.10.15.1 (2021-10-27)141.10.15.1 (2021-10-27)
14======================15======================
diff --git a/src/launchpadlib/testing/launchpad-wadl.xml b/src/launchpadlib/testing/launchpad-wadl.xml
index 0d87ea8..f138c26 100644
--- a/src/launchpadlib/testing/launchpad-wadl.xml
+++ b/src/launchpadlib/testing/launchpad-wadl.xml
@@ -2,20 +2,14 @@
2<!DOCTYPE application [2<!DOCTYPE application [
3 <!ENTITY nbsp "\&#160;">3 <!ENTITY nbsp "\&#160;">
4]>4]>
5<wadl:application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"5<wadl:application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://research.sun.com/wadl/2006/10" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wadl="http://research.sun.com/wadl/2006/10" xsi:schemaLocation="http://research.sun.com/wadl/2006/10/wadl.xsd">
6 xmlns="http://research.sun.com/wadl/2006/10"6
7 xmlns:xsd="http://www.w3.org/2001/XMLSchema"7 <wadl:doc xmlns="http://www.w3.org/1999/xhtml" title="About this service">The Launchpad web service allows automated
8 xmlns:wadl="http://research.sun.com/wadl/2006/10"
9 xsi:schemaLocation="http://research.sun.com/wadl/2006/10/wadl.xsd">
10
11 <wadl:doc xmlns="http://www.w3.org/1999/xhtml"
12 title="About this service">The Launchpad web service allows automated
13 clients to access most of the functionality available on the8 clients to access most of the functionality available on the
14 Launchpad web site. For help getting started, see9 Launchpad web site. For help getting started, see
15 <a href="https://help.launchpad.net/API/">the help wiki.</a></wadl:doc>10 <a href="https://help.launchpad.net/API/">the help wiki.</a></wadl:doc>
1611
17 <wadl:doc xmlns="http://www.w3.org/1999/xhtml"12 <wadl:doc xmlns="http://www.w3.org/1999/xhtml" title="About version 1.0">This version of the web service removes unnecessary
18 title="About version 1.0">This version of the web service removes unnecessary
19 named operations. It was introduced in March 2010, and its13 named operations. It was introduced in March 2010, and its
20 end-of-life date is April 2015, the same as the server version14 end-of-life date is April 2015, the same as the server version
21 of the Ubuntu release "Lucid Lynx".</wadl:doc>15 of the Ubuntu release "Lucid Lynx".</wadl:doc>
@@ -23,7 +17,7 @@
23 <!--There is one "service root" resource, located (as you'd expect)17 <!--There is one "service root" resource, located (as you'd expect)
24 at the service root. This very document is the WADL18 at the service root. This very document is the WADL
25 representation of the "service root" resource.-->19 representation of the "service root" resource.-->
26 <wadl:resources base="https://api.launchpad.net/1.0/">20 <wadl:resources base="https://api.launchpad.test/1.0/">
27 <wadl:resource path="" type="#service-root"/>21 <wadl:resource path="" type="#service-root"/>
28 </wadl:resources>22 </wadl:resources>
2923
@@ -42,141 +36,153 @@
42 number of links to collection-type resources.-->36 number of links to collection-type resources.-->
43 <wadl:representation mediaType="application/json" id="service-root-json">37 <wadl:representation mediaType="application/json" id="service-root-json">
44 38
45 <wadl:param style="plain"39 <wadl:param style="plain" name="archives_collection_link" path="$['archives_collection_link']">
46 path="$['branches_collection_link']"40 <wadl:link resource_type="https://api.launchpad.test/1.0/#archives"/>
47 name="branches_collection_link">41 </wadl:param>
48 <wadl:link resource_type="https://api.launchpad.net/1.0/#branches"/>42
43
44 <wadl:param style="plain" name="branches_collection_link" path="$['branches_collection_link']">
45 <wadl:link resource_type="https://api.launchpad.test/1.0/#branches"/>
46 </wadl:param>
47
48
49 <wadl:param style="plain" name="bug_trackers_collection_link" path="$['bug_trackers_collection_link']">
50 <wadl:link resource_type="https://api.launchpad.test/1.0/#bug_trackers"/>
51 </wadl:param>
52
53
54 <wadl:param style="plain" name="bugs_collection_link" path="$['bugs_collection_link']">
55 <wadl:link resource_type="https://api.launchpad.test/1.0/#bugs"/>
56 </wadl:param>
57
58
59 <wadl:param style="plain" name="builders_collection_link" path="$['builders_collection_link']">
60 <wadl:link resource_type="https://api.launchpad.test/1.0/#builders"/>
61 </wadl:param>
62
63
64 <wadl:param style="plain" name="charm_bases_collection_link" path="$['charm_bases_collection_link']">
65 <wadl:link resource_type="https://api.launchpad.test/1.0/#charm_bases"/>
49 </wadl:param>66 </wadl:param>
50 67
51 68
52 <wadl:param style="plain"69 <wadl:param style="plain" name="charm_recipes_collection_link" path="$['charm_recipes_collection_link']">
53 path="$['bug_trackers_collection_link']"70 <wadl:link resource_type="https://api.launchpad.test/1.0/#charm_recipes"/>
54 name="bug_trackers_collection_link">
55 <wadl:link resource_type="https://api.launchpad.net/1.0/#bug_trackers"/>
56 </wadl:param>71 </wadl:param>
57 72
58 73
59 <wadl:param style="plain"74 <wadl:param style="plain" name="countries_collection_link" path="$['countries_collection_link']">
60 path="$['bugs_collection_link']"75 <wadl:link resource_type="https://api.launchpad.test/1.0/#countries"/>
61 name="bugs_collection_link">
62 <wadl:link resource_type="https://api.launchpad.net/1.0/#bugs"/>
63 </wadl:param>76 </wadl:param>
64 77
65 78
66 <wadl:param style="plain"79 <wadl:param style="plain" name="cves_collection_link" path="$['cves_collection_link']">
67 path="$['builders_collection_link']"80 <wadl:link resource_type="https://api.launchpad.test/1.0/#cves"/>
68 name="builders_collection_link">
69 <wadl:link resource_type="https://api.launchpad.net/1.0/#builders"/>
70 </wadl:param>81 </wadl:param>
71 82
72 83
73 <wadl:param style="plain"84 <wadl:param style="plain" name="distributions_collection_link" path="$['distributions_collection_link']">
74 path="$['countries_collection_link']"85 <wadl:link resource_type="https://api.launchpad.test/1.0/#distributions"/>
75 name="countries_collection_link">
76 <wadl:link resource_type="https://api.launchpad.net/1.0/#countries"/>
77 </wadl:param>86 </wadl:param>
78 87
79 88
80 <wadl:param style="plain"89 <wadl:param style="plain" name="git_repositories_collection_link" path="$['git_repositories_collection_link']">
81 path="$['cves_collection_link']"90 <wadl:link resource_type="https://api.launchpad.test/1.0/#git_repositories"/>
82 name="cves_collection_link">
83 <wadl:link resource_type="https://api.launchpad.net/1.0/#cves"/>
84 </wadl:param>91 </wadl:param>
85 92
86 93
87 <wadl:param style="plain"94 <wadl:param style="plain" name="languages_collection_link" path="$['languages_collection_link']">
88 path="$['distributions_collection_link']"95 <wadl:link resource_type="https://api.launchpad.test/1.0/#languages"/>
89 name="distributions_collection_link">
90 <wadl:link resource_type="https://api.launchpad.net/1.0/#distributions"/>
91 </wadl:param>96 </wadl:param>
92 97
93 98
94 <wadl:param style="plain"99 <wadl:param style="plain" name="livefses_collection_link" path="$['livefses_collection_link']">
95 path="$['languages_collection_link']"100 <wadl:link resource_type="https://api.launchpad.test/1.0/#livefses"/>
96 name="languages_collection_link">
97 <wadl:link resource_type="https://api.launchpad.net/1.0/#languages"/>
98 </wadl:param>101 </wadl:param>
99 102
100 103
101 <wadl:param style="plain" path="$['me_link']"104 <wadl:param style="plain" name="me_link" path="$['me_link']">
102 name="me_link">105 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
103 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>
104 </wadl:param>106 </wadl:param>
105 107
106 108
107 <wadl:param style="plain"109 <wadl:param style="plain" name="packagesets_collection_link" path="$['packagesets_collection_link']">
108 path="$['packagesets_collection_link']"110 <wadl:link resource_type="https://api.launchpad.test/1.0/#packagesets"/>
109 name="packagesets_collection_link">
110 <wadl:link resource_type="https://api.launchpad.net/1.0/#packagesets"/>
111 </wadl:param>111 </wadl:param>
112 112
113 113
114 <wadl:param style="plain"114 <wadl:param style="plain" name="people_collection_link" path="$['people_collection_link']">
115 path="$['people_collection_link']"115 <wadl:link resource_type="https://api.launchpad.test/1.0/#people"/>
116 name="people_collection_link">
117 <wadl:link resource_type="https://api.launchpad.net/1.0/#people"/>
118 </wadl:param>116 </wadl:param>
119 117
120 118
121 <wadl:param style="plain" path="$['pillars_link']"119 <wadl:param style="plain" name="pillars_link" path="$['pillars_link']">
122 name="pillars_link">120 <wadl:link resource_type="https://api.launchpad.test/1.0/#pillars"/>
123 <wadl:link resource_type="https://api.launchpad.net/1.0/#pillars"/>
124 </wadl:param>121 </wadl:param>
125 122
126 123
127 <wadl:param style="plain"124 <wadl:param style="plain" name="polls_collection_link" path="$['polls_collection_link']">
128 path="$['processor_families_collection_link']"125 <wadl:link resource_type="https://api.launchpad.test/1.0/#polls"/>
129 name="processor_families_collection_link">
130 <wadl:link resource_type="https://api.launchpad.net/1.0/#processor_families"/>
131 </wadl:param>126 </wadl:param>
132 127
133 128
134 <wadl:param style="plain"129 <wadl:param style="plain" name="processors_collection_link" path="$['processors_collection_link']">
135 path="$['processors_collection_link']"130 <wadl:link resource_type="https://api.launchpad.test/1.0/#processors"/>
136 name="processors_collection_link">
137 <wadl:link resource_type="https://api.launchpad.net/1.0/#processors"/>
138 </wadl:param>131 </wadl:param>
139 132
140 133
141 <wadl:param style="plain"134 <wadl:param style="plain" name="project_groups_collection_link" path="$['project_groups_collection_link']">
142 path="$['project_groups_collection_link']"135 <wadl:link resource_type="https://api.launchpad.test/1.0/#project_groups"/>
143 name="project_groups_collection_link">
144 <wadl:link resource_type="https://api.launchpad.net/1.0/#project_groups"/>
145 </wadl:param>136 </wadl:param>
146 137
147 138
148 <wadl:param style="plain"139 <wadl:param style="plain" name="projects_collection_link" path="$['projects_collection_link']">
149 path="$['projects_collection_link']"140 <wadl:link resource_type="https://api.launchpad.test/1.0/#projects"/>
150 name="projects_collection_link">
151 <wadl:link resource_type="https://api.launchpad.net/1.0/#projects"/>
152 </wadl:param>141 </wadl:param>
153 142
154 143
155 <wadl:param style="plain"144 <wadl:param style="plain" name="questions_collection_link" path="$['questions_collection_link']">
156 path="$['questions_collection_link']"145 <wadl:link resource_type="https://api.launchpad.test/1.0/#questions"/>
157 name="questions_collection_link">
158 <wadl:link resource_type="https://api.launchpad.net/1.0/#questions"/>
159 </wadl:param>146 </wadl:param>
160 147
161 148
162 <wadl:param style="plain"149 <wadl:param style="plain" name="services_link" path="$['services_link']">
163 path="$['temporary_blobs_collection_link']"150 <wadl:link resource_type="https://api.launchpad.test/1.0/#service_factory"/>
164 name="temporary_blobs_collection_link">
165 <wadl:link resource_type="https://api.launchpad.net/1.0/#temporary_blobs"/>
166 </wadl:param>151 </wadl:param>
167 152
168 153
169 <wadl:param style="plain"154 <wadl:param style="plain" name="snap_bases_collection_link" path="$['snap_bases_collection_link']">
170 path="$['translation_groups_collection_link']"155 <wadl:link resource_type="https://api.launchpad.test/1.0/#snap_bases"/>
171 name="translation_groups_collection_link">
172 <wadl:link resource_type="https://api.launchpad.net/1.0/#translation_groups"/>
173 </wadl:param>156 </wadl:param>
174 157
175 158
176 <wadl:param style="plain"159 <wadl:param style="plain" name="snappy_serieses_collection_link" path="$['snappy_serieses_collection_link']">
177 path="$['translation_import_queue_entries_collection_link']"160 <wadl:link resource_type="https://api.launchpad.test/1.0/#snappy_serieses"/>
178 name="translation_import_queue_entries_collection_link">161 </wadl:param>
179 <wadl:link resource_type="https://api.launchpad.net/1.0/#translation_import_queue_entries"/>162
163
164 <wadl:param style="plain" name="snaps_collection_link" path="$['snaps_collection_link']">
165 <wadl:link resource_type="https://api.launchpad.test/1.0/#snaps"/>
166 </wadl:param>
167
168
169 <wadl:param style="plain" name="specifications_collection_link" path="$['specifications_collection_link']">
170 <wadl:link resource_type="https://api.launchpad.test/1.0/#specifications"/>
171 </wadl:param>
172
173
174 <wadl:param style="plain" name="temporary_blobs_collection_link" path="$['temporary_blobs_collection_link']">
175 <wadl:link resource_type="https://api.launchpad.test/1.0/#temporary_blobs"/>
176 </wadl:param>
177
178
179 <wadl:param style="plain" name="translation_groups_collection_link" path="$['translation_groups_collection_link']">
180 <wadl:link resource_type="https://api.launchpad.test/1.0/#translation_groups"/>
181 </wadl:param>
182
183
184 <wadl:param style="plain" name="translation_import_queue_entries_collection_link" path="$['translation_import_queue_entries_collection_link']">
185 <wadl:link resource_type="https://api.launchpad.test/1.0/#translation_import_queue_entries"/>
180 </wadl:param>186 </wadl:param>
181 187
182 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">188 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
@@ -191,17 +197,29 @@
191197
192 <!--Begin resource_type definitions for collection resources.-->198 <!--Begin resource_type definitions for collection resources.-->
193 199
200 <wadl:resource_type id="archives">
201 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
202Interface for ArchiveSet
203</wadl:doc>
204 <wadl:method name="GET" id="archives-get">
205 <wadl:response>
206 <wadl:representation href="https://api.launchpad.test/1.0/#archive-page"/>
207 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="archives-wadl"/>
208 </wadl:response>
209 </wadl:method>
210
211 </wadl:resource_type>
212
213
214
194 <wadl:resource_type id="branches">215 <wadl:resource_type id="branches">
195 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">216 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
196Interface representing the set of branches.217Interface representing the set of branches.
197</wadl:doc>218</wadl:doc>
198 <wadl:method name="GET" id="branches-get">219 <wadl:method name="GET" id="branches-get">
199 <wadl:response>220 <wadl:response>
200 <wadl:representation221 <wadl:representation href="https://api.launchpad.test/1.0/#branch-page"/>
201 href="https://api.launchpad.net/1.0/#branch-page"/>222 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="branches-wadl"/>
202 <wadl:representation
203 mediaType="application/vnd.sun.wadl+xml"
204 id="branches-wadl"/>
205 </wadl:response>223 </wadl:response>
206 </wadl:method>224 </wadl:method>
207225
@@ -228,12 +246,10 @@ associated branch, the URL will map to None.</td>
228</wadl:doc>246</wadl:doc>
229 <wadl:request>247 <wadl:request>
230 248
231 <wadl:param style="query" name="ws.op"249 <wadl:param style="query" name="ws.op" required="true" fixed="getByUrls">
232 required="true" fixed="getByUrls">
233 <wadl:doc>The name of the operation being invoked.</wadl:doc>250 <wadl:doc>The name of the operation being invoked.</wadl:doc>
234 </wadl:param>251 </wadl:param>
235 <wadl:param style="query" required="true"252 <wadl:param style="query" name="urls" required="true">
236 name="urls">
237 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">253 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
238<p>A list of URLs of branches</p>254<p>A list of URLs of branches</p>
239<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>255<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>
@@ -253,13 +269,10 @@ associated branch, the URL will map to None.</td>
253</wadl:doc>269</wadl:doc>
254 <wadl:request>270 <wadl:request>
255 271
256 <wadl:param style="query" name="ws.op"272 <wadl:param style="query" name="ws.op" required="true" fixed="getByUniqueName">
257 required="true"
258 fixed="getByUniqueName">
259 <wadl:doc>The name of the operation being invoked.</wadl:doc>273 <wadl:doc>The name of the operation being invoked.</wadl:doc>
260 </wadl:param>274 </wadl:param>
261 <wadl:param style="query" required="true"275 <wadl:param style="query" name="unique_name" required="true">
262 name="unique_name">
263 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">276 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
264Branch unique name277Branch unique name
265</wadl:doc>278</wadl:doc>
@@ -269,8 +282,7 @@ Branch unique name
269 </wadl:request>282 </wadl:request>
270 <wadl:response>283 <wadl:response>
271 284
272 <wadl:representation285 <wadl:representation href="https://api.launchpad.test/1.0/#branch-full"/>
273 href="https://api.launchpad.net/1.0/#branch-full"/>
274 </wadl:response>286 </wadl:response>
275 </wadl:method>287 </wadl:method>
276 <wadl:method id="branches-getByUrl" name="GET">288 <wadl:method id="branches-getByUrl" name="GET">
@@ -286,12 +298,10 @@ Launchpad app, use the IBranchLookup version instead.</p>
286</wadl:doc>298</wadl:doc>
287 <wadl:request>299 <wadl:request>
288 300
289 <wadl:param style="query" name="ws.op"301 <wadl:param style="query" name="ws.op" required="true" fixed="getByUrl">
290 required="true" fixed="getByUrl">
291 <wadl:doc>The name of the operation being invoked.</wadl:doc>302 <wadl:doc>The name of the operation being invoked.</wadl:doc>
292 </wadl:param>303 </wadl:param>
293 <wadl:param style="query" required="true"304 <wadl:param style="query" name="url" required="true">
294 name="url">
295 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">305 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
296Branch URL306Branch URL
297</wadl:doc>307</wadl:doc>
@@ -301,8 +311,7 @@ Branch URL
301 </wadl:request>311 </wadl:request>
302 <wadl:response>312 <wadl:response>
303 313
304 <wadl:representation314 <wadl:representation href="https://api.launchpad.test/1.0/#branch-full"/>
305 href="https://api.launchpad.net/1.0/#branch-full"/>
306 </wadl:response>315 </wadl:response>
307 </wadl:method>316 </wadl:method>
308 </wadl:resource_type>317 </wadl:resource_type>
@@ -318,30 +327,25 @@ example, bugzilla.mozilla.org is distinct from bugzilla.gnome.org.</p>
318</wadl:doc>327</wadl:doc>
319 <wadl:method name="GET" id="bug_trackers-get">328 <wadl:method name="GET" id="bug_trackers-get">
320 <wadl:response>329 <wadl:response>
321 <wadl:representation330 <wadl:representation href="https://api.launchpad.test/1.0/#bug_tracker-page"/>
322 href="https://api.launchpad.net/1.0/#bug_tracker-page"/>331 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="bug_trackers-wadl"/>
323 <wadl:representation
324 mediaType="application/vnd.sun.wadl+xml"
325 id="bug_trackers-wadl"/>
326 </wadl:response>332 </wadl:response>
327 </wadl:method>333 </wadl:method>
328334
329 <wadl:method id="bug_trackers-queryByBaseURL"335 <wadl:method id="bug_trackers-getByName" name="GET">
330 name="GET">
331 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">336 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
332Return one or None BugTracker's by baseurl337<p>Get a BugTracker by its name.</p>
338<p>If no tracker with the given name exists, return default.</p>
339
333</wadl:doc>340</wadl:doc>
334 <wadl:request>341 <wadl:request>
335 342
336 <wadl:param style="query" name="ws.op"343 <wadl:param style="query" name="ws.op" required="true" fixed="getByName">
337 required="true"
338 fixed="queryByBaseURL">
339 <wadl:doc>The name of the operation being invoked.</wadl:doc>344 <wadl:doc>The name of the operation being invoked.</wadl:doc>
340 </wadl:param>345 </wadl:param>
341 <wadl:param style="query" required="true"346 <wadl:param style="query" name="name" required="true">
342 name="base_url">
343 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">347 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
344The base URL of the bug tracker348The bug tracker name
345</wadl:doc>349</wadl:doc>
346 350
347 </wadl:param>351 </wadl:param>
@@ -349,26 +353,21 @@ The base URL of the bug tracker
349 </wadl:request>353 </wadl:request>
350 <wadl:response>354 <wadl:response>
351 355
352 <wadl:representation356 <wadl:representation href="https://api.launchpad.test/1.0/#bug_tracker-full"/>
353 href="https://api.launchpad.net/1.0/#bug_tracker-full"/>
354 </wadl:response>357 </wadl:response>
355 </wadl:method>358 </wadl:method>
356 <wadl:method id="bug_trackers-getByName" name="GET">359 <wadl:method id="bug_trackers-queryByBaseURL" name="GET">
357 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">360 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
358<p>Get a BugTracker by its name.</p>361Return one or None BugTracker's by baseurl
359<p>If no tracker with the given name exists, return default.</p>
360
361</wadl:doc>362</wadl:doc>
362 <wadl:request>363 <wadl:request>
363 364
364 <wadl:param style="query" name="ws.op"365 <wadl:param style="query" name="ws.op" required="true" fixed="queryByBaseURL">
365 required="true" fixed="getByName">
366 <wadl:doc>The name of the operation being invoked.</wadl:doc>366 <wadl:doc>The name of the operation being invoked.</wadl:doc>
367 </wadl:param>367 </wadl:param>
368 <wadl:param style="query" required="true"368 <wadl:param style="query" name="base_url" required="true">
369 name="name">
370 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">369 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
371The bug tracker name370The base URL of the bug tracker
372</wadl:doc>371</wadl:doc>
373 372
374 </wadl:param>373 </wadl:param>
@@ -376,45 +375,29 @@ The bug tracker name
376 </wadl:request>375 </wadl:request>
377 <wadl:response>376 <wadl:response>
378 377
379 <wadl:representation378 <wadl:representation href="https://api.launchpad.test/1.0/#bug_tracker-full"/>
380 href="https://api.launchpad.net/1.0/#bug_tracker-full"/>
381 </wadl:response>379 </wadl:response>
382 </wadl:method>380 </wadl:method>
383 <wadl:method id="bug_trackers-ensureBugTracker"381 <wadl:method id="bug_trackers-ensureBugTracker" name="POST">
384 name="POST">
385 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">382 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
386<p>Make sure that there is a bugtracker for the given base url.</p>383<p>Make sure that there is a bugtracker for the given base url.</p>
387<p>If not, create one using the given attributes.</p>384<p>If not, create one using the given attributes.</p>
388385
389</wadl:doc>386</wadl:doc>
390 <wadl:request>387 <wadl:request>
391 <wadl:representation388 <wadl:representation mediaType="application/x-www-form-urlencoded">
392 mediaType="application/x-www-form-urlencoded">389 <wadl:param style="query" name="ws.op" required="true" fixed="ensureBugTracker">
393 <wadl:param style="query" name="ws.op"
394 required="true"
395 fixed="ensureBugTracker">
396 <wadl:doc>The name of the operation being invoked.</wadl:doc>390 <wadl:doc>The name of the operation being invoked.</wadl:doc>
397 </wadl:param>391 </wadl:param>
398 <wadl:param style="query" required="false"392 <wadl:param style="query" name="base_url" required="true">
399 name="name">
400 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
401<p>Name</p>
402<p>A URL-friendly name for the bug tracker, such as &quot;mozilla-bugs&quot;.</p>
403
404</wadl:doc>
405
406 </wadl:param>
407 <wadl:param style="query" required="false"
408 name="title">
409 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">393 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
410<p>Title</p>394<p>Location</p>
411<p>A descriptive label for this tracker to show in listings.</p>395<p>The top-level URL for the bug tracker, or an upstream email address. This must be accurate so that Launchpad can link to external bug reports.</p>
412396
413</wadl:doc>397</wadl:doc>
414 398
415 </wadl:param>399 </wadl:param>
416 <wadl:param style="query" required="false"400 <wadl:param style="query" name="bug_tracker_type" required="false">
417 name="bug_tracker_type">
418 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">401 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
419Bug Tracker Type402Bug Tracker Type
420</wadl:doc>403</wadl:doc>
@@ -430,18 +413,18 @@ Bug Tracker Type
430 <wadl:option value="Savane"/>413 <wadl:option value="Savane"/>
431 <wadl:option value="PHP Project Bugtracker"/>414 <wadl:option value="PHP Project Bugtracker"/>
432 <wadl:option value="Google Code"/>415 <wadl:option value="Google Code"/>
416 <wadl:option value="GitHub Issues"/>
417 <wadl:option value="GitLab Issues"/>
433 </wadl:param>418 </wadl:param>
434 <wadl:param style="query" required="true"419 <wadl:param style="query" name="title" required="false">
435 name="base_url">
436 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">420 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
437<p>Location</p>421<p>Title</p>
438<p>The top-level URL for the bug tracker, or an upstream email address. This must be accurate so that Launchpad can link to external bug reports.</p>422<p>A descriptive label for this tracker to show in listings.</p>
439423
440</wadl:doc>424</wadl:doc>
441 425
442 </wadl:param>426 </wadl:param>
443 <wadl:param style="query" required="false"427 <wadl:param style="query" name="summary" required="false">
444 name="summary">
445 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">428 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
446<p>Summary</p>429<p>Summary</p>
447<p>A brief introduction or overview of this bug tracker instance.</p>430<p>A brief introduction or overview of this bug tracker instance.</p>
@@ -449,8 +432,7 @@ Bug Tracker Type
449</wadl:doc>432</wadl:doc>
450 433
451 </wadl:param>434 </wadl:param>
452 <wadl:param style="query" required="false"435 <wadl:param style="query" name="contact_details" required="false">
453 name="contact_details">
454 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">436 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
455<p>Contact details</p>437<p>Contact details</p>
456<p>The contact details for the external bug tracker (so that, for example, its administrators can be contacted about a security breach).</p>438<p>The contact details for the external bug tracker (so that, for example, its administrators can be contacted about a security breach).</p>
@@ -458,11 +440,19 @@ Bug Tracker Type
458</wadl:doc>440</wadl:doc>
459 441
460 </wadl:param>442 </wadl:param>
443 <wadl:param style="query" name="name" required="false">
444 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
445<p>Name</p>
446<p>A URL-friendly name for the bug tracker, such as &quot;mozilla-bugs&quot;.</p>
447
448</wadl:doc>
449
450 </wadl:param>
461 </wadl:representation>451 </wadl:representation>
462 </wadl:request>452 </wadl:request>
463 <wadl:response>453 <wadl:response>
464 <wadl:param name="Location" style="header">454 <wadl:param name="Location" style="header">
465 <wadl:link resource_type="https://api.launchpad.net/1.0/#bug_tracker"/>455 <wadl:link resource_type="https://api.launchpad.test/1.0/#bug_tracker"/>
466 </wadl:param>456 </wadl:param>
467 457
468 </wadl:response>458 </wadl:response>
@@ -482,11 +472,8 @@ methods that affect a single Builder should be on IBuilder.</p>
482</wadl:doc>472</wadl:doc>
483 <wadl:method name="GET" id="builders-get">473 <wadl:method name="GET" id="builders-get">
484 <wadl:response>474 <wadl:response>
485 <wadl:representation475 <wadl:representation href="https://api.launchpad.test/1.0/#builder-page"/>
486 href="https://api.launchpad.net/1.0/#builder-page"/>476 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="builders-wadl"/>
487 <wadl:representation
488 mediaType="application/vnd.sun.wadl+xml"
489 id="builders-wadl"/>
490 </wadl:response>477 </wadl:response>
491 </wadl:method>478 </wadl:method>
492479
@@ -496,12 +483,10 @@ Retrieve a builder by name
496</wadl:doc>483</wadl:doc>
497 <wadl:request>484 <wadl:request>
498 485
499 <wadl:param style="query" name="ws.op"486 <wadl:param style="query" name="ws.op" required="true" fixed="getByName">
500 required="true" fixed="getByName">
501 <wadl:doc>The name of the operation being invoked.</wadl:doc>487 <wadl:doc>The name of the operation being invoked.</wadl:doc>
502 </wadl:param>488 </wadl:param>
503 <wadl:param style="query" required="true"489 <wadl:param style="query" name="name" required="true">
504 name="name">
505 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">490 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
506Builder name491Builder name
507</wadl:doc>492</wadl:doc>
@@ -511,10 +496,39 @@ Builder name
511 </wadl:request>496 </wadl:request>
512 <wadl:response>497 <wadl:response>
513 498
514 <wadl:representation499 <wadl:representation href="https://api.launchpad.test/1.0/#builder-full"/>
515 href="https://api.launchpad.net/1.0/#builder-full"/>500 </wadl:response>
501 </wadl:method>
502 </wadl:resource_type>
503
504
505
506 <wadl:resource_type id="charm_bases">
507 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
508Interface representing the set of bases for charms.
509</wadl:doc>
510 <wadl:method name="GET" id="charm_bases-get">
511 <wadl:response>
512 <wadl:representation href="https://api.launchpad.test/1.0/#charm_base-page"/>
513 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="charm_bases-wadl"/>
514 </wadl:response>
515 </wadl:method>
516
517 </wadl:resource_type>
518
519
520
521 <wadl:resource_type id="charm_recipes">
522 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
523A utility to create and access charm recipes.
524</wadl:doc>
525 <wadl:method name="GET" id="charm_recipes-get">
526 <wadl:response>
527 <wadl:representation href="https://api.launchpad.test/1.0/#charm_recipe-page"/>
528 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="charm_recipes-wadl"/>
516 </wadl:response>529 </wadl:response>
517 </wadl:method>530 </wadl:method>
531
518 </wadl:resource_type>532 </wadl:resource_type>
519533
520 534
@@ -525,28 +539,23 @@ A container for countries.
525</wadl:doc>539</wadl:doc>
526 <wadl:method name="GET" id="countries-get">540 <wadl:method name="GET" id="countries-get">
527 <wadl:response>541 <wadl:response>
528 <wadl:representation542 <wadl:representation href="https://api.launchpad.test/1.0/#country-page"/>
529 href="https://api.launchpad.net/1.0/#country-page"/>543 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="countries-wadl"/>
530 <wadl:representation
531 mediaType="application/vnd.sun.wadl+xml"
532 id="countries-wadl"/>
533 </wadl:response>544 </wadl:response>
534 </wadl:method>545 </wadl:method>
535546
536 <wadl:method id="countries-getByCode" name="GET">547 <wadl:method id="countries-getByName" name="GET">
537 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">548 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
538Return a country by its code.549Return a country by its name.
539</wadl:doc>550</wadl:doc>
540 <wadl:request>551 <wadl:request>
541 552
542 <wadl:param style="query" name="ws.op"553 <wadl:param style="query" name="ws.op" required="true" fixed="getByName">
543 required="true" fixed="getByCode">
544 <wadl:doc>The name of the operation being invoked.</wadl:doc>554 <wadl:doc>The name of the operation being invoked.</wadl:doc>
545 </wadl:param>555 </wadl:param>
546 <wadl:param style="query" required="true"556 <wadl:param style="query" name="name" required="true">
547 name="code">
548 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">557 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
549Code558Name
550</wadl:doc>559</wadl:doc>
551 560
552 </wadl:param>561 </wadl:param>
@@ -554,24 +563,21 @@ Code
554 </wadl:request>563 </wadl:request>
555 <wadl:response>564 <wadl:response>
556 565
557 <wadl:representation566 <wadl:representation href="https://api.launchpad.test/1.0/#country-full"/>
558 href="https://api.launchpad.net/1.0/#country-full"/>
559 </wadl:response>567 </wadl:response>
560 </wadl:method>568 </wadl:method>
561 <wadl:method id="countries-getByName" name="GET">569 <wadl:method id="countries-getByCode" name="GET">
562 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">570 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
563Return a country by its name.571Return a country by its code.
564</wadl:doc>572</wadl:doc>
565 <wadl:request>573 <wadl:request>
566 574
567 <wadl:param style="query" name="ws.op"575 <wadl:param style="query" name="ws.op" required="true" fixed="getByCode">
568 required="true" fixed="getByName">
569 <wadl:doc>The name of the operation being invoked.</wadl:doc>576 <wadl:doc>The name of the operation being invoked.</wadl:doc>
570 </wadl:param>577 </wadl:param>
571 <wadl:param style="query" required="true"578 <wadl:param style="query" name="code" required="true">
572 name="name">
573 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">579 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
574Name580Code
575</wadl:doc>581</wadl:doc>
576 582
577 </wadl:param>583 </wadl:param>
@@ -579,8 +585,7 @@ Name
579 </wadl:request>585 </wadl:request>
580 <wadl:response>586 <wadl:response>
581 587
582 <wadl:representation588 <wadl:representation href="https://api.launchpad.test/1.0/#country-full"/>
583 href="https://api.launchpad.net/1.0/#country-full"/>
584 </wadl:response>589 </wadl:response>
585 </wadl:method>590 </wadl:method>
586 </wadl:resource_type>591 </wadl:resource_type>
@@ -593,10 +598,8 @@ The set of ICve objects.
593</wadl:doc>598</wadl:doc>
594 <wadl:method name="GET" id="cves-get">599 <wadl:method name="GET" id="cves-get">
595 <wadl:response>600 <wadl:response>
596 <wadl:representation601 <wadl:representation href="https://api.launchpad.test/1.0/#cve-page"/>
597 href="https://api.launchpad.net/1.0/#cve-page"/>602 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="cves-wadl"/>
598 <wadl:representation
599 mediaType="application/vnd.sun.wadl+xml" id="cves-wadl"/>
600 </wadl:response>603 </wadl:response>
601 </wadl:method>604 </wadl:method>
602605
@@ -610,11 +613,23 @@ Interface for DistrosSet
610</wadl:doc>613</wadl:doc>
611 <wadl:method name="GET" id="distributions-get">614 <wadl:method name="GET" id="distributions-get">
612 <wadl:response>615 <wadl:response>
613 <wadl:representation616 <wadl:representation href="https://api.launchpad.test/1.0/#distribution-page"/>
614 href="https://api.launchpad.net/1.0/#distribution-page"/>617 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="distributions-wadl"/>
615 <wadl:representation618 </wadl:response>
616 mediaType="application/vnd.sun.wadl+xml"619 </wadl:method>
617 id="distributions-wadl"/>620
621 </wadl:resource_type>
622
623
624
625 <wadl:resource_type id="git_repositories">
626 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
627Interface representing the set of Git repositories.
628</wadl:doc>
629 <wadl:method name="GET" id="git_repositories-get">
630 <wadl:response>
631 <wadl:representation href="https://api.launchpad.test/1.0/#git_repository-page"/>
632 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="git_repositories-wadl"/>
618 </wadl:response>633 </wadl:response>
619 </wadl:method>634 </wadl:method>
620635
@@ -632,11 +647,8 @@ the getAllLanguages method.</p>
632</wadl:doc>647</wadl:doc>
633 <wadl:method name="GET" id="languages-get">648 <wadl:method name="GET" id="languages-get">
634 <wadl:response>649 <wadl:response>
635 <wadl:representation650 <wadl:representation href="https://api.launchpad.test/1.0/#language-page"/>
636 href="https://api.launchpad.net/1.0/#language-page"/>651 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="languages-wadl"/>
637 <wadl:representation
638 mediaType="application/vnd.sun.wadl+xml"
639 id="languages-wadl"/>
640 </wadl:response>652 </wadl:response>
641 </wadl:method>653 </wadl:method>
642654
@@ -646,19 +658,31 @@ Return a result set of all ILanguages from Launchpad.
646</wadl:doc>658</wadl:doc>
647 <wadl:request>659 <wadl:request>
648 660
649 <wadl:param style="query" name="ws.op"661 <wadl:param style="query" name="ws.op" required="true" fixed="getAllLanguages">
650 required="true"
651 fixed="getAllLanguages">
652 <wadl:doc>The name of the operation being invoked.</wadl:doc>662 <wadl:doc>The name of the operation being invoked.</wadl:doc>
653 </wadl:param>663 </wadl:param>
654 664
655 </wadl:request>665 </wadl:request>
656 <wadl:response>666 <wadl:response>
657 667
658 <wadl:representation668 <wadl:representation href="https://api.launchpad.test/1.0/#language-page"/>
659 href="https://api.launchpad.net/1.0/#language-page"/>669 </wadl:response>
670 </wadl:method>
671 </wadl:resource_type>
672
673
674
675 <wadl:resource_type id="livefses">
676 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
677A utility to create and access live filesystems.
678</wadl:doc>
679 <wadl:method name="GET" id="livefses-get">
680 <wadl:response>
681 <wadl:representation href="https://api.launchpad.test/1.0/#livefs-page"/>
682 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="livefses-wadl"/>
660 </wadl:response>683 </wadl:response>
661 </wadl:method>684 </wadl:method>
685
662 </wadl:resource_type>686 </wadl:resource_type>
663687
664 688
@@ -669,371 +693,321 @@ Application root for malone.
669</wadl:doc>693</wadl:doc>
670 <wadl:method name="GET" id="bugs-get">694 <wadl:method name="GET" id="bugs-get">
671 <wadl:response>695 <wadl:response>
672 <wadl:representation696 <wadl:representation href="https://api.launchpad.test/1.0/#bug-page"/>
673 href="https://api.launchpad.net/1.0/#bug-page"/>697 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="bugs-wadl"/>
674 <wadl:representation
675 mediaType="application/vnd.sun.wadl+xml" id="bugs-wadl"/>
676 </wadl:response>698 </wadl:response>
677 </wadl:method>699 </wadl:method>
678700
679 <wadl:method id="bugs-createBug" name="POST">701 <wadl:method id="bugs-searchTasks" name="GET">
680 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">702 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
681<p>Create a bug (with an appropriate bugtask) and return it.</p>703<p>Search the IBugTasks reported on this entity.</p>
682<table class="rst-docutils field-list" frame="void" rules="none">704<table class="rst-docutils field-list" frame="void" rules="none">
683<col class="field-name" />705<col class="field-name" />
684<col class="field-body" />706<col class="field-body" />
685<tbody valign="top">707<tbody valign="top">
686<tr class="rst-field"><th class="rst-field-name">param target:</th><td class="rst-field-body">The Product, Distribution or DistributionSourcePackage708<tr class="rst-field"><th class="rst-field-name">search_params:</th><td class="rst-field-body">a BugTaskSearchParams object</td>
687affected by this bug.</td>
688</tr>709</tr>
689</tbody>710</tbody>
690</table>711</table>
691<p>Things to note when using this factory:</p>712<p>Return an iterable of matching results.</p>
692<blockquote>713<p>Note: milestone is currently ignored for all IBugTargets
693<ul class="rst-simple">714except IProduct.</p>
694<li>the owner will be subscribed to the bug</li>
695<li>distribution, product and package contacts (whichever ones are
696applicable based on the bug report target) will be subscribed to
697all <em>public bugs only</em></li>
698<li>for public upstreams bugs where there is no upstream bug contact,
699the product owner will be subscribed instead</li>
700</ul>
701</blockquote>
702715
703</wadl:doc>716</wadl:doc>
704 <wadl:request>717 <wadl:request>
705 <wadl:representation718
706 mediaType="application/x-www-form-urlencoded">719 <wadl:param style="query" name="ws.op" required="true" fixed="searchTasks">
707 <wadl:param style="query" name="ws.op"
708 required="true" fixed="createBug">
709 <wadl:doc>The name of the operation being invoked.</wadl:doc>720 <wadl:doc>The name of the operation being invoked.</wadl:doc>
710 </wadl:param>721 </wadl:param>
711 <wadl:param style="query" required="false"722 <wadl:param style="query" name="bug_reporter" required="false">
712 name="security_related">723
724 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
725 </wadl:param>
726 <wadl:param style="query" name="has_cve" required="false">
713 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">727 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
714This bug is a security vulnerability.728Show only bugs associated with a CVE
715</wadl:doc>729</wadl:doc>
716 730
717 </wadl:param>731 </wadl:param>
718 <wadl:param style="query" required="true"732 <wadl:param style="query" name="omit_targeted" required="false">
719 name="target">
720 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">733 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
721The project, distribution or source package that has this bug.734Omit bugs targeted to a series
722</wadl:doc>735</wadl:doc>
723 <wadl:link resource_type="https://api.launchpad.net/1.0/#bug_target"/>736
737 </wadl:param>
738 <wadl:param style="query" name="bug_subscriber" required="false">
739
740 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
724 </wadl:param>741 </wadl:param>
725 <wadl:param style="query" required="false"742 <wadl:param style="query" name="status_upstream" required="false">
726 name="tags">
727 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">743 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
728<p>Tags</p>744<p>Status upstream</p>
729<p>Space-separated keywords for classifying this bug report.</p>745<p>Indicates the status of any remote watches associated with the bug. Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.</p>
730746
731</wadl:doc>747</wadl:doc>
732 748
733 </wadl:param>749 </wadl:param>
734 <wadl:param style="query" required="true"750 <wadl:param style="query" name="tags" required="false">
735 name="title">
736 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">751 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
737<p>Summary</p>752<p>Tags</p>
738<p>A one-line summary of the problem.</p>753<p>String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'</p>
739754
740</wadl:doc>755</wadl:doc>
741 756
742 </wadl:param>757 </wadl:param>
743 <wadl:param style="query" required="false"758 <wadl:param style="query" name="omit_duplicates" required="false">
744 name="private">
745 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">759 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
746<p>This bug report should be private</p>760Omit bugs marked as duplicate,
747<p>Private bug reports are visible only to their subscribers.</p>
748
749</wadl:doc>761</wadl:doc>
750 762
751 </wadl:param>763 </wadl:param>
752 <wadl:param style="query" required="true"764 <wadl:param style="query" name="nominated_for" required="false">
753 name="description">765
766 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
767 </wadl:param>
768 <wadl:param style="query" name="modified_since" required="false" type="xsd:dateTime">
754 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">769 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
755<p>Description</p>770Search for bugs that have been modified since the given date.
756<dl class="rst-docutils">
757<dt>A detailed description of the problem,</dt>
758<dd>including the steps required to reproduce it.</dd>
759</dl>
760
761</wadl:doc>771</wadl:doc>
762 772
763 </wadl:param>773 </wadl:param>
764 </wadl:representation>774 <wadl:param style="query" name="structural_subscriber" required="false">
765 </wadl:request>775
766 <wadl:response>776 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
767 <wadl:param name="Location" style="header">777 </wadl:param>
768 <wadl:link resource_type="https://api.launchpad.net/1.0/#bug"/>778 <wadl:param style="query" name="owner" required="false">
769 </wadl:param>779
770 780 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
771 </wadl:response>781 </wadl:param>
772 </wadl:method>782 <wadl:param style="query" name="created_since" required="false" type="xsd:dateTime">
773 </wadl:resource_type>783 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
774784Search for bugs that have been created since the given date.
775
776
777 <wadl:resource_type id="packagesets">
778 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
779An interface for multiple package sets.
780</wadl:doc>
781 <wadl:method name="GET" id="packagesets-get">
782 <wadl:response>
783 <wadl:representation
784 href="https://api.launchpad.net/1.0/#packageset-page"/>
785 <wadl:representation
786 mediaType="application/vnd.sun.wadl+xml"
787 id="packagesets-wadl"/>
788 </wadl:response>
789 </wadl:method>
790
791 <wadl:method id="packagesets-setsIncludingSource"
792 name="GET">
793 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
794<p>Get the package sets that include this source package.</p>
795<p>Return all package sets that directly or indirectly include the
796given source package name.</p>
797<table class="rst-docutils field-list" frame="void" rules="none">
798<col class="field-name" />
799<col class="field-body" />
800<tbody valign="top">
801<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
802<tr><td>&nbsp;</td><td class="rst-field-body">the included source package name; can be
803either a string or a ISourcePackageName.</td>
804</tr>
805<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
806<tr><td>&nbsp;</td><td class="rst-field-body">the IDistroSeries in which to look for sets.
807If omitted, matching package sets from all series will be
808returned.</td>
809</tr>
810<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_inclusion:</th></tr>
811<tr><td>&nbsp;</td><td class="rst-field-body">if this flag is set to True, then only
812package sets that directly include this source package name will
813be considered.</td>
814</tr>
815<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
816<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the given
817name cannot be found.</td>
818</tr>
819<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A (potentially empty) sequence of IPackageset instances.</td>
820</tr>
821</tbody>
822</table>
823
824</wadl:doc>785</wadl:doc>
825 <wadl:request>786
826
827 <wadl:param style="query" name="ws.op"
828 required="true"
829 fixed="setsIncludingSource">
830 <wadl:doc>The name of the operation being invoked.</wadl:doc>
831 </wadl:param>787 </wadl:param>
832 <wadl:param style="query" required="true"788 <wadl:param style="query" name="has_patch" required="false">
833 name="sourcepackagename">
834 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">789 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
835Source package name790Show only bugs with patches available.
836</wadl:doc>791</wadl:doc>
837 792
838 </wadl:param>793 </wadl:param>
839 <wadl:param style="query" required="false"794 <wadl:param style="query" name="bug_commenter" required="false">
840 name="distroseries">795
796 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
797 </wadl:param>
798 <wadl:param style="query" name="assignee" required="false">
799
800 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
801 </wadl:param>
802 <wadl:param style="query" name="status" required="false">
841 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">803 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
842<p>Distribution series</p>804<p>Status</p>
843<p>The distroseries to which this package set is related.</p>805<p>Show only bugs with the given status value or list of values.</p>
844806
845</wadl:doc>807</wadl:doc>
846 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>808
847 </wadl:param>809 </wadl:param>
848 <wadl:param style="query" required="false"810 <wadl:param style="query" name="affected_user" required="false">
849 name="direct_inclusion">
850 811
812 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
813 </wadl:param>
814 <wadl:param style="query" name="search_text" required="false">
815 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
816Bug ID or search text.
817</wadl:doc>
851 818
852 </wadl:param>819 </wadl:param>
853 820 <wadl:param style="query" name="order_by" required="false">
854 </wadl:request>821 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
855 <wadl:response>822List of fields by which the results are ordered.
856 823</wadl:doc>
857 <wadl:representation824
858 href="https://api.launchpad.net/1.0/#packageset-page"/>825 </wadl:param>
859 </wadl:response>826 <wadl:param style="query" name="bug_supervisor" required="false">
860 </wadl:method>827
861 <wadl:method id="packagesets-getByName" name="GET">828 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
862 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">829 </wadl:param>
863<p>Return the single package set with the given name (if any).</p>830 <wadl:param style="query" name="tags_combinator" required="false">
864<table class="rst-docutils field-list" frame="void" rules="none">831 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
865<col class="field-name" />832<p>Tags combination</p>
866<col class="field-body" />833<p>Search for any or all of the tags specified.</p>
867<tbody valign="top">
868<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>
869</tr>
870<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
871<tr><td>&nbsp;</td><td class="rst-field-body">the distroseries to which the new packageset
872is related. Defaults to the current Ubuntu series.</td>
873</tr>
874<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An IPackageset instance.</td>
875</tr>
876<tr class="rst-field"><th class="rst-field-name" colspan="2">raise NoSuchPackageSet:</th></tr>
877<tr><td>&nbsp;</td><td class="rst-field-body">if no package set is found.</td>
878</tr>
879</tbody>
880</table>
881834
882</wadl:doc>835</wadl:doc>
883 <wadl:request>836
884 837 <wadl:option value="Any"/>
885 <wadl:param style="query" name="ws.op"838 <wadl:option value="All"/>
886 required="true" fixed="getByName">
887 <wadl:doc>The name of the operation being invoked.</wadl:doc>
888 </wadl:param>839 </wadl:param>
889 <wadl:param style="query" required="false"840 <wadl:param style="query" name="component" required="false">
890 name="distroseries">
891 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">841 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
892<p>Distroseries</p>842<p>Component</p>
893<p>The distribution series to which the packageset is related.</p>843<p>Distribution package archive grouping. E.g. main, universe, multiverse</p>
894844
895</wadl:doc>845</wadl:doc>
896 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>846
897 </wadl:param>847 </wadl:param>
898 <wadl:param style="query" required="true"848 <wadl:param style="query" name="importance" required="false">
899 name="name">
900 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">849 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
901Package set name850<p>Importance</p>
851<p>Show only bugs with the given importance or list of importances.</p>
852
902</wadl:doc>853</wadl:doc>
903 854
904 </wadl:param>855 </wadl:param>
905 856 <wadl:param style="query" name="information_type" required="false">
906 </wadl:request>857 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
907 <wadl:response>858<p>Information Type</p>
908 859<p>Show only bugs with the given information type or list of information types.</p>
909 <wadl:representation
910 href="https://api.launchpad.net/1.0/#packageset-full"/>
911 </wadl:response>
912 </wadl:method>
913 <wadl:method id="packagesets-getBySeries" name="GET">
914 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
915<p>Return the package sets associated with the given distroseries.</p>
916<table class="rst-docutils field-list" frame="void" rules="none">
917<col class="field-name" />
918<col class="field-body" />
919<tbody valign="top">
920<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
921<tr><td>&nbsp;</td><td class="rst-field-body">A DistroSeries.</td>
922</tr>
923<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An iterable collection of IPackageset instances.</td>
924</tr>
925</tbody>
926</table>
927860
928</wadl:doc>861</wadl:doc>
929 <wadl:request>862
930
931 <wadl:param style="query" name="ws.op"
932 required="true" fixed="getBySeries">
933 <wadl:doc>The name of the operation being invoked.</wadl:doc>
934 </wadl:param>863 </wadl:param>
935 <wadl:param style="query" required="true"864 <wadl:param style="query" name="created_before" required="false" type="xsd:dateTime">
936 name="distroseries">
937 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">865 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
938<p>Distribution series</p>866Search for bugs that were created before the given date.
939<p>The distroseries to which this package set is related.</p>867</wadl:doc>
868
869 </wadl:param>
870 <wadl:param style="query" name="milestone" required="false">
871 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
872<p>Milestone</p>
873<p>Show only bug tasks targeted to this milestone.</p>
940874
941</wadl:doc>875</wadl:doc>
942 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>876
877 </wadl:param>
878 <wadl:param style="query" name="linked_branches" required="false">
879 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
880Search for bugs that are linked to branches or for bugs that are not linked to branches.
881</wadl:doc>
882
883 <wadl:option value="Show all bugs"/>
884 <wadl:option value="Show only Bugs with linked Branches"/>
885 <wadl:option value="Show only Bugs without linked Branches"/>
886 </wadl:param>
887 <wadl:param style="query" name="has_no_package" required="false">
888 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
889Exclude bugs with packages specified
890</wadl:doc>
891
943 </wadl:param>892 </wadl:param>
944 893
945 </wadl:request>894 </wadl:request>
946 <wadl:response>895 <wadl:response>
947 896
948 <wadl:representation897 <wadl:representation href="https://api.launchpad.test/1.0/#bug_task-page"/>
949 href="https://api.launchpad.net/1.0/#packageset-page"/>
950 </wadl:response>898 </wadl:response>
951 </wadl:method>899 </wadl:method>
952 <wadl:method id="packagesets-new" name="POST">900 <wadl:method id="bugs-createBug" name="POST">
953 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">901 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
954<p>Create a new package set.</p>902<p>Create a bug (with an appropriate bugtask) and return it.</p>
955<table class="rst-docutils field-list" frame="void" rules="none">903<table class="rst-docutils field-list" frame="void" rules="none">
956<col class="field-name" />904<col class="field-name" />
957<col class="field-body" />905<col class="field-body" />
958<tbody valign="top">906<tbody valign="top">
959<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>907<tr class="rst-field"><th class="rst-field-name">param target:</th><td class="rst-field-body">The Project, Distribution or DistributionSourcePackage
908affected by this bug.</td>
960</tr>909</tr>
961<tr class="rst-field"><th class="rst-field-name" colspan="2">param description:</th></tr>910<tr class="rst-field"><th class="rst-field-name">param title:</th><td class="rst-field-body">The title shown in bug listings.</td>
962<tr><td>&nbsp;</td><td class="rst-field-body">the description for the package set to be created.</td>
963</tr>911</tr>
964<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>912<tr class="rst-field"><th class="rst-field-name" colspan="2">param description:</th></tr>
913<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">The description of the issue.</td>
965</tr>914</tr>
966<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>915<tr class="rst-field"><th class="rst-field-name" colspan="2">param information_type:</th></tr>
967<tr><td>&nbsp;</td><td class="rst-field-body">the distroseries to which the new packageset916<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">Set the bug's information type to one
968is related. Defaults to the current Ubuntu series.</td>917different from the project's default. The type must conform
918to the project's bug sharing policy. (optional)</td>
969</tr>919</tr>
970<tr class="rst-field"><th class="rst-field-name" colspan="2">param related_set:</th></tr>920<tr class="rst-field"><th class="rst-field-name">param tags:</th><td class="rst-field-body">A list of bug tags. (optional)</td>
971<tr><td>&nbsp;</td><td class="rst-field-body">the newly created package set is to be related to
972related_set (by being placed in the same package group).</td>
973</tr>921</tr>
974<tr class="rst-field"><th class="rst-field-name" colspan="2">raises DuplicatePackagesetName:</th></tr>922<tr class="rst-field"><th class="rst-field-name" colspan="2">param security_related:</th></tr>
975<tr><td>&nbsp;</td><td class="rst-field-body">if a package set with the same name923<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">Is this bug's information type
976exists in distroseries already.</td>924Private Security? (deprecated)</td>
977</tr>925</tr>
978<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a newly created IPackageset.</td>926<tr class="rst-field"><th class="rst-field-name">param tags:</th><td class="rst-field-body">Is this bug's information type Private
927user data. (deprecated)</td>
979</tr>928</tr>
980</tbody>929</tbody>
981</table>930</table>
931<p>Things to note when using this factory:</p>
932<blockquote>
933<ul class="rst-simple">
934<li>The reporter will be subscribed to the bug.</li>
935<li>Only people that the project shares with will see the bug
936when the bug's information type is Proprietary, Private, or
937Private Security.</li>
938</ul>
939</blockquote>
982940
983</wadl:doc>941</wadl:doc>
984 <wadl:request>942 <wadl:request>
985 <wadl:representation943 <wadl:representation mediaType="application/x-www-form-urlencoded">
986 mediaType="application/x-www-form-urlencoded">944 <wadl:param style="query" name="ws.op" required="true" fixed="createBug">
987 <wadl:param style="query" name="ws.op"
988 required="true" fixed="new">
989 <wadl:doc>The name of the operation being invoked.</wadl:doc>945 <wadl:doc>The name of the operation being invoked.</wadl:doc>
990 </wadl:param>946 </wadl:param>
991 <wadl:param style="query" required="true"947 <wadl:param style="query" name="title" required="true">
992 name="owner">
993 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">948 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
994<p>Person</p>949<p>Summary</p>
995<p>The person who owns this package set.</p>950<p>A one-line summary of the problem.</p>
996951
997</wadl:doc>952</wadl:doc>
998 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>953
999 </wadl:param>954 </wadl:param>
1000 <wadl:param style="query" required="false"955 <wadl:param style="query" name="description" required="true">
1001 name="distroseries">
1002 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">956 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1003<p>Distroseries</p>957<p>Description</p>
1004<p>The distribution series to which the packageset is related.</p>958<p>A detailed description of the problem,
959including the steps required to reproduce it.</p>
1005960
1006</wadl:doc>961</wadl:doc>
1007 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>962
1008 </wadl:param>963 </wadl:param>
1009 <wadl:param style="query" required="true"964 <wadl:param style="query" name="tags" required="false">
1010 name="description">
1011 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">965 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1012Package set description966<p>Tags</p>
967<p>Space-separated keywords for classifying this bug report.</p>
968
1013</wadl:doc>969</wadl:doc>
1014 970
1015 </wadl:param>971 </wadl:param>
1016 <wadl:param style="query" required="true"972 <wadl:param style="query" name="information_type" required="false">
1017 name="name">
1018 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">973 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1019Valid package set name974<p>Information Type</p>
975<p>The type of information contained in this bug report.</p>
976
1020</wadl:doc>977</wadl:doc>
1021 978
979 <wadl:option value="Public"/>
980 <wadl:option value="Public Security"/>
981 <wadl:option value="Private Security"/>
982 <wadl:option value="Private"/>
983 <wadl:option value="Proprietary"/>
984 <wadl:option value="Embargoed"/>
1022 </wadl:param>985 </wadl:param>
1023 <wadl:param style="query" required="false"986 <wadl:param style="query" name="security_related" required="false">
1024 name="related_set">
1025 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">987 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1026<p>Related package set</p>988This bug is a security vulnerability.
1027<p>The new package set will share the package set group with this one.</p>989</wadl:doc>
990
991 </wadl:param>
992 <wadl:param style="query" name="private" required="false">
993 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
994<p>This bug report should be private</p>
995<p>Private bug reports are visible only to their subscribers.</p>
1028996
1029</wadl:doc>997</wadl:doc>
1030 <wadl:link resource_type="https://api.launchpad.net/1.0/#packageset"/>998
999 </wadl:param>
1000 <wadl:param style="query" name="target" required="true">
1001 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1002The project, distribution or source package that has this bug.
1003</wadl:doc>
1004 <wadl:link resource_type="https://api.launchpad.test/1.0/#bug_target"/>
1031 </wadl:param>1005 </wadl:param>
1032 </wadl:representation>1006 </wadl:representation>
1033 </wadl:request>1007 </wadl:request>
1034 <wadl:response>1008 <wadl:response>
1035 <wadl:param name="Location" style="header">1009 <wadl:param name="Location" style="header">
1036 <wadl:link resource_type="https://api.launchpad.net/1.0/#packageset"/>1010 <wadl:link resource_type="https://api.launchpad.test/1.0/#bug"/>
1037 </wadl:param>1011 </wadl:param>
1038 1012
1039 </wadl:response>1013 </wadl:response>
@@ -1042,66 +1016,55 @@ Valid package set name
10421016
1043 1017
1044 1018
1045 <wadl:resource_type id="people">1019 <wadl:resource_type id="packagesets">
1046 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1020 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1047The set of Persons.1021An interface for multiple package sets.
1048</wadl:doc>1022</wadl:doc>
1049 <wadl:method name="GET" id="people-get">1023 <wadl:method name="GET" id="packagesets-get">
1050 <wadl:response>1024 <wadl:response>
1051 <wadl:representation1025 <wadl:representation href="https://api.launchpad.test/1.0/#packageset-page"/>
1052 href="https://api.launchpad.net/1.0/#person-page"/>1026 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="packagesets-wadl"/>
1053 <wadl:representation
1054 mediaType="application/vnd.sun.wadl+xml"
1055 id="people-wadl"/>
1056 </wadl:response>1027 </wadl:response>
1057 </wadl:method>1028 </wadl:method>
10581029
1059 <wadl:method id="people-findPerson" name="GET">1030 <wadl:method id="packagesets-getByName" name="GET">
1060 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1031 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1061<p>Return all non-merged Persons with at least one email address whose1032<p>Return the single package set with the given name (if any).</p>
1062name, displayname or email address match &lt;text&gt;.</p>1033<table class="rst-docutils field-list" frame="void" rules="none">
1063<p>If text is an empty string, all persons with at least one email1034<col class="field-name" />
1064address will be returned.</p>1035<col class="field-body" />
1065<p>The results will be ordered using the default ordering specified in1036<tbody valign="top">
1066Person._defaultOrder.</p>1037<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
1067<p>If exclude_inactive_accounts is True, any accounts whose1038<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the distroseries to which the new packageset
1068account_status is any of INACTIVE_ACCOUNT_STATUSES will not be in the1039is related.</td>
1069returned set.</p>1040</tr>
1070<p>If must_have_email is True, only people with one or more email1041<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>
1071addresses are returned.</p>1042</tr>
1072<p>While we don't have Full Text Indexes in the emailaddress table, we'll1043<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An IPackageset instance.</td>
1073be trying to match the text only against the beginning of an email1044</tr>
1074address.</p>1045<tr class="rst-field"><th class="rst-field-name" colspan="2">raise NoSuchPackageSet:</th></tr>
1075<p>If created_before or created_after are not None, they are used to1046<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if no package set is found.</td>
1076restrict the search to the dates provided.</p>1047</tr>
1048</tbody>
1049</table>
10771050
1078</wadl:doc>1051</wadl:doc>
1079 <wadl:request>1052 <wadl:request>
1080 1053
1081 <wadl:param style="query" name="ws.op"1054 <wadl:param style="query" name="ws.op" required="true" fixed="getByName">
1082 required="true" fixed="findPerson">
1083 <wadl:doc>The name of the operation being invoked.</wadl:doc>1055 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1084 </wadl:param>1056 </wadl:param>
1085 <wadl:param style="query" required="true"1057 <wadl:param style="query" name="distroseries" required="true">
1086 name="text">
1087 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1088Search text
1089</wadl:doc>
1090
1091 </wadl:param>
1092 <wadl:param style="query" required="false"
1093 type="xsd:dateTime"
1094 name="created_before">
1095 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1058 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1096Created before1059<p>Distribution series</p>
1060<p>The distroseries to which this package set is related.</p>
1061
1097</wadl:doc>1062</wadl:doc>
1098 1063 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
1099 </wadl:param>1064 </wadl:param>
1100 <wadl:param style="query" required="false"1065 <wadl:param style="query" name="name" required="true">
1101 type="xsd:dateTime"
1102 name="created_after">
1103 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1066 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1104Created after1067Valid package set name
1105</wadl:doc>1068</wadl:doc>
1106 1069
1107 </wadl:param>1070 </wadl:param>
@@ -1109,86 +1072,323 @@ Created after
1109 </wadl:request>1072 </wadl:request>
1110 <wadl:response>1073 <wadl:response>
1111 1074
1112 <wadl:representation1075 <wadl:representation href="https://api.launchpad.test/1.0/#packageset-full"/>
1113 href="https://api.launchpad.net/1.0/#person-page"/>
1114 </wadl:response>1076 </wadl:response>
1115 </wadl:method>1077 </wadl:method>
1116 <wadl:method id="people-getByEmail" name="GET">1078 <wadl:method id="packagesets-getBySeries" name="GET">
1117 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1079 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1118<p>Return the person with the given email address.</p>1080<p>Return the package sets associated with the given distroseries.</p>
1119<p>Return None if there is no person with the given email address.</p>1081<table class="rst-docutils field-list" frame="void" rules="none">
1082<col class="field-name" />
1083<col class="field-body" />
1084<tbody valign="top">
1085<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
1086<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">A DistroSeries.</td>
1087</tr>
1088<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">An iterable collection of IPackageset instances.</td>
1089</tr>
1090</tbody>
1091</table>
11201092
1121</wadl:doc>1093</wadl:doc>
1122 <wadl:request>1094 <wadl:request>
1123 1095
1124 <wadl:param style="query" name="ws.op"1096 <wadl:param style="query" name="ws.op" required="true" fixed="getBySeries">
1125 required="true" fixed="getByEmail">
1126 <wadl:doc>The name of the operation being invoked.</wadl:doc>1097 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1127 </wadl:param>1098 </wadl:param>
1128 <wadl:param style="query" required="true"1099 <wadl:param style="query" name="distroseries" required="true">
1129 name="email">1100 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1130 1101<p>Distribution series</p>
1131 1102<p>The distroseries to which this package set is related.</p>
1103
1104</wadl:doc>
1105 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
1132 </wadl:param>1106 </wadl:param>
1133 1107
1134 </wadl:request>1108 </wadl:request>
1135 <wadl:response>1109 <wadl:response>
1136 1110
1137 <wadl:representation1111 <wadl:representation href="https://api.launchpad.test/1.0/#packageset-page"/>
1138 href="https://api.launchpad.net/1.0/#person-full"/>
1139 </wadl:response>1112 </wadl:response>
1140 </wadl:method>1113 </wadl:method>
1141 <wadl:method id="people-find" name="GET">1114 <wadl:method id="packagesets-setsIncludingSource" name="GET">
1142 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1115 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1143<p>Return all non-merged Persons and Teams whose name, displayname or1116<p>Get the package sets that include this source package.</p>
1144email address match &lt;text&gt;.</p>1117<p>Return all package sets that directly or indirectly include the
1145<p>The results will be ordered using the default ordering specified in1118given source package name.</p>
1146Person._defaultOrder.</p>1119<table class="rst-docutils field-list" frame="void" rules="none">
1147<p>While we don't have Full Text Indexes in the emailaddress table, we'll1120<col class="field-name" />
1148be trying to match the text only against the beginning of an email1121<col class="field-body" />
1149address.</p>1122<tbody valign="top">
1123<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
1124<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the included source package name; can be
1125either a string or a ISourcePackageName.</td>
1126</tr>
1127<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
1128<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the IDistroSeries in which to look for sets.
1129If omitted, matching package sets from all series will be
1130returned.</td>
1131</tr>
1132<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_inclusion:</th></tr>
1133<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if this flag is set to True, then only
1134package sets that directly include this source package name will
1135be considered.</td>
1136</tr>
1137<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
1138<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if a source package with the given
1139name cannot be found.</td>
1140</tr>
1141<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A (potentially empty) sequence of IPackageset instances.</td>
1142</tr>
1143</tbody>
1144</table>
11501145
1151</wadl:doc>1146</wadl:doc>
1152 <wadl:request>1147 <wadl:request>
1153 1148
1154 <wadl:param style="query" name="ws.op"1149 <wadl:param style="query" name="ws.op" required="true" fixed="setsIncludingSource">
1155 required="true" fixed="find">
1156 <wadl:doc>The name of the operation being invoked.</wadl:doc>1150 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1157 </wadl:param>1151 </wadl:param>
1158 <wadl:param style="query" required="true"1152 <wadl:param style="query" name="sourcepackagename" required="true">
1159 name="text">
1160 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1153 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1161Search text1154Source package name
1155</wadl:doc>
1156
1157 </wadl:param>
1158 <wadl:param style="query" name="distroseries" required="false">
1159 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1160<p>Distribution series</p>
1161<p>The distroseries to which this package set is related.</p>
1162
1162</wadl:doc>1163</wadl:doc>
1164 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
1165 </wadl:param>
1166 <wadl:param style="query" name="direct_inclusion" required="false">
1167
1163 1168
1164 </wadl:param>1169 </wadl:param>
1165 1170
1166 </wadl:request>1171 </wadl:request>
1167 <wadl:response>1172 <wadl:response>
1168 1173
1169 <wadl:representation1174 <wadl:representation href="https://api.launchpad.test/1.0/#packageset-page"/>
1170 href="https://api.launchpad.net/1.0/#person-page"/>
1171 </wadl:response>1175 </wadl:response>
1172 </wadl:method>1176 </wadl:method>
1173 <wadl:method id="people-findTeam" name="GET">1177 <wadl:method id="packagesets-new" name="POST">
1174 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1178 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1175<p>Return all Teams whose name, displayname or email address1179<p>Create a new package set.</p>
1176match &lt;text&gt;.</p>1180<table class="rst-docutils field-list" frame="void" rules="none">
1177<p>The results will be ordered using the default ordering specified in1181<col class="field-name" />
1178Person._defaultOrder.</p>1182<col class="field-body" />
1179<p>While we don't have Full Text Indexes in the emailaddress table, we'll1183<tbody valign="top">
1180be trying to match the text only against the beginning of an email1184<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>
1181address.</p>1185</tr>
1186<tr class="rst-field"><th class="rst-field-name" colspan="2">param description:</th></tr>
1187<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the description for the package set to be created.</td>
1188</tr>
1189<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>
1190</tr>
1191<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
1192<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the distroseries to which the new packageset
1193is related.</td>
1194</tr>
1195<tr class="rst-field"><th class="rst-field-name" colspan="2">param related_set:</th></tr>
1196<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the newly created package set is to be related to
1197related_set (by being placed in the same package group).</td>
1198</tr>
1199<tr class="rst-field"><th class="rst-field-name" colspan="2">raises DuplicatePackagesetName:</th></tr>
1200<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if a package set with the same name
1201exists in distroseries already.</td>
1202</tr>
1203<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a newly created IPackageset.</td>
1204</tr>
1205</tbody>
1206</table>
1207
1208</wadl:doc>
1209 <wadl:request>
1210 <wadl:representation mediaType="application/x-www-form-urlencoded">
1211 <wadl:param style="query" name="ws.op" required="true" fixed="new">
1212 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1213 </wadl:param>
1214 <wadl:param style="query" name="description" required="true">
1215 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1216Package set description
1217</wadl:doc>
1218
1219 </wadl:param>
1220 <wadl:param style="query" name="owner" required="true">
1221 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1222<p>Person</p>
1223<p>The person who owns this package set.</p>
1224
1225</wadl:doc>
1226 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
1227 </wadl:param>
1228 <wadl:param style="query" name="related_set" required="false">
1229 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1230<p>Related package set</p>
1231<p>The new package set will share the package set group with this one.</p>
1232
1233</wadl:doc>
1234 <wadl:link resource_type="https://api.launchpad.test/1.0/#packageset"/>
1235 </wadl:param>
1236 <wadl:param style="query" name="distroseries" required="true">
1237 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1238<p>Distroseries</p>
1239<p>The distribution series to which the packageset is related.</p>
1240
1241</wadl:doc>
1242 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
1243 </wadl:param>
1244 <wadl:param style="query" name="name" required="true">
1245 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1246Valid package set name
1247</wadl:doc>
1248
1249 </wadl:param>
1250 </wadl:representation>
1251 </wadl:request>
1252 <wadl:response>
1253 <wadl:param name="Location" style="header">
1254 <wadl:link resource_type="https://api.launchpad.test/1.0/#packageset"/>
1255 </wadl:param>
1256
1257 </wadl:response>
1258 </wadl:method>
1259 </wadl:resource_type>
1260
1261
1262
1263 <wadl:resource_type id="people">
1264 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1265Combined schema for operations on a group of Persons.
1266</wadl:doc>
1267 <wadl:method name="GET" id="people-get">
1268 <wadl:response>
1269 <wadl:representation href="https://api.launchpad.test/1.0/#person-page"/>
1270 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="people-wadl"/>
1271 </wadl:response>
1272 </wadl:method>
1273
1274 <wadl:method id="people-getByEmail" name="GET">
1275 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1276<p>Return the person with the given email address.</p>
1277<p>Return None if there is no person with the given email address.</p>
1278
1279</wadl:doc>
1280 <wadl:request>
1281
1282 <wadl:param style="query" name="ws.op" required="true" fixed="getByEmail">
1283 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1284 </wadl:param>
1285 <wadl:param style="query" name="email" required="true">
1286
1287
1288 </wadl:param>
1289
1290 </wadl:request>
1291 <wadl:response>
1292
1293 <wadl:representation href="https://api.launchpad.test/1.0/#person-full"/>
1294 </wadl:response>
1295 </wadl:method>
1296 <wadl:method id="people-findTeam" name="GET">
1297 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1298<p>Return all Teams whose name, displayname or email address
1299match &lt;text&gt;.</p>
1300<p>The results will be ordered using the default ordering specified in
1301Person._defaultOrder.</p>
1302<p>While we don't have Full Text Indexes in the emailaddress table, we'll
1303be trying to match the text only against the beginning of an email
1304address.</p>
1305
1306</wadl:doc>
1307 <wadl:request>
1308
1309 <wadl:param style="query" name="ws.op" required="true" fixed="findTeam">
1310 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1311 </wadl:param>
1312 <wadl:param style="query" name="text" required="true">
1313 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1314Search text
1315</wadl:doc>
1316
1317 </wadl:param>
1318
1319 </wadl:request>
1320 <wadl:response>
1321
1322 <wadl:representation href="https://api.launchpad.test/1.0/#person-page"/>
1323 </wadl:response>
1324 </wadl:method>
1325 <wadl:method id="people-findPerson" name="GET">
1326 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1327<p>Return all non-merged Persons with at least one email address whose
1328name, displayname or email address match &lt;text&gt;.</p>
1329<p>If text is an empty string, all persons with at least one email
1330address will be returned.</p>
1331<p>The results will be ordered using the default ordering specified in
1332Person._defaultOrder.</p>
1333<p>If exclude_inactive_accounts is True, any accounts whose
1334account_status is any of INACTIVE_ACCOUNT_STATUSES will not be in the
1335returned set.</p>
1336<p>If must_have_email is True, only people with one or more email
1337addresses are returned.</p>
1338<p>While we don't have Full Text Indexes in the emailaddress table, we'll
1339be trying to match the text only against the beginning of an email
1340address.</p>
1341<p>If created_before or created_after are not None, they are used to
1342restrict the search to the dates provided.</p>
1343
1344</wadl:doc>
1345 <wadl:request>
1346
1347 <wadl:param style="query" name="ws.op" required="true" fixed="findPerson">
1348 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1349 </wadl:param>
1350 <wadl:param style="query" name="created_before" required="false" type="xsd:dateTime">
1351 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1352Created before
1353</wadl:doc>
1354
1355 </wadl:param>
1356 <wadl:param style="query" name="text" required="true">
1357 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1358Search text
1359</wadl:doc>
1360
1361 </wadl:param>
1362 <wadl:param style="query" name="created_after" required="false" type="xsd:dateTime">
1363 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1364Created after
1365</wadl:doc>
1366
1367 </wadl:param>
1368
1369 </wadl:request>
1370 <wadl:response>
1371
1372 <wadl:representation href="https://api.launchpad.test/1.0/#person-page"/>
1373 </wadl:response>
1374 </wadl:method>
1375 <wadl:method id="people-find" name="GET">
1376 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1377<p>Return all non-merged Persons and Teams whose name, displayname or
1378email address match &lt;text&gt;.</p>
1379<p>The results will be ordered using the default ordering specified in
1380Person._defaultOrder.</p>
1381<p>While we don't have Full Text Indexes in the emailaddress table, we'll
1382be trying to match the text only against the beginning of an email
1383address.</p>
11821384
1183</wadl:doc>1385</wadl:doc>
1184 <wadl:request>1386 <wadl:request>
1185 1387
1186 <wadl:param style="query" name="ws.op"1388 <wadl:param style="query" name="ws.op" required="true" fixed="find">
1187 required="true" fixed="findTeam">
1188 <wadl:doc>The name of the operation being invoked.</wadl:doc>1389 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1189 </wadl:param>1390 </wadl:param>
1190 <wadl:param style="query" required="true"1391 <wadl:param style="query" name="text" required="true">
1191 name="text">
1192 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1392 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1193Search text1393Search text
1194</wadl:doc>1394</wadl:doc>
@@ -1198,8 +1398,7 @@ Search text
1198 </wadl:request>1398 </wadl:request>
1199 <wadl:response>1399 <wadl:response>
1200 1400
1201 <wadl:representation1401 <wadl:representation href="https://api.launchpad.test/1.0/#person-page"/>
1202 href="https://api.launchpad.net/1.0/#person-page"/>
1203 </wadl:response>1402 </wadl:response>
1204 </wadl:method>1403 </wadl:method>
1205 <wadl:method id="people-newTeam" name="POST">1404 <wadl:method id="people-newTeam" name="POST">
@@ -1207,14 +1406,19 @@ Search text
1207Create and return a new Team with given arguments.1406Create and return a new Team with given arguments.
1208</wadl:doc>1407</wadl:doc>
1209 <wadl:request>1408 <wadl:request>
1210 <wadl:representation1409 <wadl:representation mediaType="application/x-www-form-urlencoded">
1211 mediaType="application/x-www-form-urlencoded">1410 <wadl:param style="query" name="ws.op" required="true" fixed="newTeam">
1212 <wadl:param style="query" name="ws.op"
1213 required="true" fixed="newTeam">
1214 <wadl:doc>The name of the operation being invoked.</wadl:doc>1411 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1215 </wadl:param>1412 </wadl:param>
1216 <wadl:param style="query" required="true"1413 <wadl:param style="query" name="name" required="true">
1217 name="display_name">1414 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1415<p>Name</p>
1416<p>A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.</p>
1417
1418</wadl:doc>
1419
1420 </wadl:param>
1421 <wadl:param style="query" name="display_name" required="true">
1218 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1422 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1219<p>Display Name</p>1423<p>Display Name</p>
1220<p>Your name as you would like it displayed throughout Launchpad. Most people use their full name here.</p>1424<p>Your name as you would like it displayed throughout Launchpad. Most people use their full name here.</p>
@@ -1222,17 +1426,15 @@ Create and return a new Team with given arguments.
1222</wadl:doc>1426</wadl:doc>
1223 1427
1224 </wadl:param>1428 </wadl:param>
1225 <wadl:param style="query" required="true"1429 <wadl:param style="query" name="team_description" required="false">
1226 name="name">
1227 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1430 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1228<p>Name</p>1431<p>Team Description</p>
1229<p>A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.</p>1432<p>Obsolete. Use description.</p>
12301433
1231</wadl:doc>1434</wadl:doc>
1232 1435
1233 </wadl:param>1436 </wadl:param>
1234 <wadl:param style="query" required="false"1437 <wadl:param style="query" name="default_membership_period" required="false">
1235 name="default_membership_period">
1236 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1438 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1237<p>Subscription period</p>1439<p>Subscription period</p>
1238<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>1440<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>
@@ -1240,28 +1442,29 @@ Create and return a new Team with given arguments.
1240</wadl:doc>1442</wadl:doc>
1241 1443
1242 </wadl:param>1444 </wadl:param>
1243 <wadl:param style="query" required="false"1445 <wadl:param style="query" name="default_renewal_period" required="false">
1244 name="team_description">
1245 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1446 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1246<p>Team Description</p>1447<p>Self renewal period</p>
1247<p>Details about the team's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages.</p>1448<p>Number of days members can renew their own membership. The number can be from 1 to 3650 (10 years).</p>
12481449
1249</wadl:doc>1450</wadl:doc>
1250 1451
1251 </wadl:param>1452 </wadl:param>
1252 <wadl:param style="query" required="false"1453 <wadl:param style="query" name="subscription_policy" required="false">
1253 name="default_renewal_period">
1254 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1454 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1255<p>Renewal period</p>1455<p>Membership policy</p>
1256<p>Number of days a subscription lasts after being renewed. The number can be from 1 to 3650 (10 years). You can customize the lengths of individual renewals, but this is what's used for auto-renewed and user-renewed memberships.</p>1456<p>Obsolete: use membership_policy</p>
12571457
1258</wadl:doc>1458</wadl:doc>
1259 1459
1460 <wadl:option value="Open Team"/>
1461 <wadl:option value="Delegated Team"/>
1462 <wadl:option value="Moderated Team"/>
1463 <wadl:option value="Restricted Team"/>
1260 </wadl:param>1464 </wadl:param>
1261 <wadl:param style="query" required="false"1465 <wadl:param style="query" name="membership_policy" required="false">
1262 name="subscription_policy">
1263 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1466 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1264Subscription policy1467Membership policy
1265</wadl:doc>1468</wadl:doc>
1266 1469
1267 <wadl:option value="Open Team"/>1470 <wadl:option value="Open Team"/>
@@ -1273,7 +1476,7 @@ Subscription policy
1273 </wadl:request>1476 </wadl:request>
1274 <wadl:response>1477 <wadl:response>
1275 <wadl:param name="Location" style="header">1478 <wadl:param name="Location" style="header">
1276 <wadl:link resource_type="https://api.launchpad.net/1.0/#team"/>1479 <wadl:link resource_type="https://api.launchpad.test/1.0/#team"/>
1277 </wadl:param>1480 </wadl:param>
1278 1481
1279 </wadl:response>1482 </wadl:response>
@@ -1282,17 +1485,14 @@ Subscription policy
12821485
1283 1486
1284 1487
1285 <wadl:resource_type id="processor_families">1488 <wadl:resource_type id="polls">
1286 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1489 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1287Operations related to ProcessorFamily instances.1490The set of Poll objects.
1288</wadl:doc>1491</wadl:doc>
1289 <wadl:method name="GET" id="processor_families-get">1492 <wadl:method name="GET" id="polls-get">
1290 <wadl:response>1493 <wadl:response>
1291 <wadl:representation1494 <wadl:representation href="https://api.launchpad.test/1.0/#poll-page"/>
1292 href="https://api.launchpad.net/1.0/#processor_family-page"/>1495 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="polls-wadl"/>
1293 <wadl:representation
1294 mediaType="application/vnd.sun.wadl+xml"
1295 id="processor_families-wadl"/>
1296 </wadl:response>1496 </wadl:response>
1297 </wadl:method>1497 </wadl:method>
12981498
@@ -1306,11 +1506,8 @@ Operations related to Processor instances.
1306</wadl:doc>1506</wadl:doc>
1307 <wadl:method name="GET" id="processors-get">1507 <wadl:method name="GET" id="processors-get">
1308 <wadl:response>1508 <wadl:response>
1309 <wadl:representation1509 <wadl:representation href="https://api.launchpad.test/1.0/#processor-page"/>
1310 href="https://api.launchpad.net/1.0/#processor-page"/>1510 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="processors-wadl"/>
1311 <wadl:representation
1312 mediaType="application/vnd.sun.wadl+xml"
1313 id="processors-wadl"/>
1314 </wadl:response>1511 </wadl:response>
1315 </wadl:method>1512 </wadl:method>
13161513
@@ -1322,141 +1519,83 @@ Operations related to Processor instances.
1322 1519
1323 <wadl:method name="GET" id="projects-get">1520 <wadl:method name="GET" id="projects-get">
1324 <wadl:response>1521 <wadl:response>
1325 <wadl:representation1522 <wadl:representation href="https://api.launchpad.test/1.0/#project-page"/>
1326 href="https://api.launchpad.net/1.0/#project-page"/>1523 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="projects-wadl"/>
1327 <wadl:representation
1328 mediaType="application/vnd.sun.wadl+xml"
1329 id="projects-wadl"/>
1330 </wadl:response>1524 </wadl:response>
1331 </wadl:method>1525 </wadl:method>
13321526
1333 <wadl:method id="projects-search" name="GET">
1334 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1335<p>Search through the Registry database for products that match the
1336query terms. text is a piece of text in the title / summary /
1337description fields of product.</p>
1338<p>This call eager loads data appropriate for web API; caution may be
1339needed for other callers.</p>
1340
1341</wadl:doc>
1342 <wadl:request>
1343
1344 <wadl:param style="query" name="ws.op"
1345 required="true" fixed="search">
1346 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1347 </wadl:param>
1348 <wadl:param style="query" required="false"
1349 name="text">
1350 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1351Search text
1352</wadl:doc>
1353
1354 </wadl:param>
1355
1356 </wadl:request>
1357 <wadl:response>
1358
1359 <wadl:representation
1360 href="https://api.launchpad.net/1.0/#project-page"/>
1361 </wadl:response>
1362 </wadl:method>
1363 <wadl:method id="projects-licensing_search" name="GET">1527 <wadl:method id="projects-licensing_search" name="GET">
1364 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1528 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1365Return an iterator over products that need to be reviewed.1529Return an iterator over products that need to be reviewed.
1366</wadl:doc>1530</wadl:doc>
1367 <wadl:request>1531 <wadl:request>
1368 1532
1369 <wadl:param style="query" name="ws.op"1533 <wadl:param style="query" name="ws.op" required="true" fixed="licensing_search">
1370 required="true"
1371 fixed="licensing_search">
1372 <wadl:doc>The name of the operation being invoked.</wadl:doc>1534 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1373 </wadl:param>1535 </wadl:param>
1374 <wadl:param style="query" required="false"1536 <wadl:param style="query" name="active" required="false">
1375 type="xsd:date"
1376 name="subscription_modified_after">
1377 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1537 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1378Subscription modified after1538Is the project active
1379</wadl:doc>1539</wadl:doc>
1380 1540
1381 </wadl:param>1541 </wadl:param>
1382 <wadl:param style="query" required="false"1542 <wadl:param style="query" name="subscription_expires_before" required="false" type="xsd:date">
1383 name="license_info_is_empty">
1384 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1543 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1385License info is empty1544Subscription expired before
1386</wadl:doc>1545</wadl:doc>
1387 1546
1388 </wadl:param>1547 </wadl:param>
1389 <wadl:param style="query" required="false"1548 <wadl:param style="query" name="has_subscription" required="false">
1390 name="search_text">
1391 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1549 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1392Search text1550Has a commercial subscription
1393</wadl:doc>1551</wadl:doc>
1394 1552
1395 </wadl:param>1553 </wadl:param>
1396 <wadl:param style="query" required="false"1554 <wadl:param style="query" name="project_reviewed" required="false">
1397 name="project_reviewed">
1398 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1555 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1399Is the project license reviewed1556Is the project licence reviewed
1400</wadl:doc>1557</wadl:doc>
1401 1558
1402 </wadl:param>1559 </wadl:param>
1403 <wadl:param style="query" required="false"1560 <wadl:param style="query" name="created_after" required="false" type="xsd:date">
1404 type="xsd:date"
1405 name="subscription_expires_after">
1406 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1561 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1407Subscription expires after1562Created after date
1408</wadl:doc>1563</wadl:doc>
1409 1564
1410 </wadl:param>1565 </wadl:param>
1411 <wadl:param style="query" required="false"1566 <wadl:param style="query" name="subscription_modified_after" required="false" type="xsd:date">
1412 name="active">
1413 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1567 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1414Is the project active1568Subscription modified after
1415</wadl:doc>1569</wadl:doc>
1416 1570
1417 </wadl:param>1571 </wadl:param>
1418 <wadl:param style="query" required="false"1572 <wadl:param style="query" name="created_before" required="false" type="xsd:date">
1419 type="xsd:date"
1420 name="subscription_modified_before">
1421 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1573 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1422Subscription modified before1574Created before date
1423</wadl:doc>1575</wadl:doc>
1424 1576
1425 </wadl:param>1577 </wadl:param>
1426 <wadl:param style="query" required="false"1578 <wadl:param style="query" name="subscription_modified_before" required="false" type="xsd:date">
1427 type="xsd:date" name="created_after">
1428 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1579 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1429Created after date1580Subscription modified before
1430</wadl:doc>1581</wadl:doc>
1431 1582
1432 </wadl:param>1583 </wadl:param>
1433 <wadl:param style="query" required="false"1584 <wadl:param style="query" name="licenses" required="false">
1434 name="licenses">
1435 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1585 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1436Licenses1586Licenses
1437</wadl:doc>1587</wadl:doc>
1438 1588
1439 </wadl:param>1589 </wadl:param>
1440 <wadl:param style="query" required="false"1590 <wadl:param style="query" name="search_text" required="false">
1441 type="xsd:date"
1442 name="subscription_expires_before">
1443 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1444Subscription expired before
1445</wadl:doc>
1446
1447 </wadl:param>
1448 <wadl:param style="query" required="false"
1449 type="xsd:date"
1450 name="created_before">
1451 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1591 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1452Created before date1592Search text
1453</wadl:doc>1593</wadl:doc>
1454 1594
1455 </wadl:param>1595 </wadl:param>
1456 <wadl:param style="query" required="false"1596 <wadl:param style="query" name="subscription_expires_after" required="false" type="xsd:date">
1457 name="has_zero_licenses">
1458 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1597 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1459Has zero licenses1598Subscription expires after
1460</wadl:doc>1599</wadl:doc>
1461 1600
1462 </wadl:param>1601 </wadl:param>
@@ -1464,13 +1603,13 @@ Has zero licenses
1464 </wadl:request>1603 </wadl:request>
1465 <wadl:response>1604 <wadl:response>
1466 1605
1467 <wadl:representation1606 <wadl:representation href="https://api.launchpad.test/1.0/#project-page"/>
1468 href="https://api.launchpad.net/1.0/#project-page"/>
1469 </wadl:response>1607 </wadl:response>
1470 </wadl:method>1608 </wadl:method>
1471 <wadl:method id="projects-latest" name="GET">1609 <wadl:method id="projects-latest" name="GET">
1472 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1610 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1473<p>Return the latest projects registered in Launchpad.</p>1611<p>Return the latest projects registered in Launchpad.</p>
1612<p>The supplied user determines which objects are visible.</p>
1474<p>If the quantity is not specified or is a value that is not 'None'1613<p>If the quantity is not specified or is a value that is not 'None'
1475then the set of projects returned is limited to that value (the1614then the set of projects returned is limited to that value (the
1476default quantity is 5). If quantity is 'None' then all projects are1615default quantity is 5). If quantity is 'None' then all projects are
@@ -1480,78 +1619,72 @@ quantity, so all projects are returned, latest first.</p>
1480</wadl:doc>1619</wadl:doc>
1481 <wadl:request>1620 <wadl:request>
1482 1621
1483 <wadl:param style="query" name="ws.op"1622 <wadl:param style="query" name="ws.op" required="true" fixed="latest">
1484 required="true" fixed="latest">
1485 <wadl:doc>The name of the operation being invoked.</wadl:doc>1623 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1486 </wadl:param>1624 </wadl:param>
1487 1625
1488 </wadl:request>1626 </wadl:request>
1489 <wadl:response>1627 <wadl:response>
1490 1628
1491 <wadl:representation1629 <wadl:representation href="https://api.launchpad.test/1.0/#project-page"/>
1492 href="https://api.launchpad.net/1.0/#project-page"/>
1493 </wadl:response>1630 </wadl:response>
1494 </wadl:method>1631 </wadl:method>
1495 <wadl:method id="projects-new_project" name="POST">1632 <wadl:method id="projects-search" name="GET">
1496 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1633 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1497<p>Create and return a brand new Product.</p>1634<p>Search through the Registry database for products that match the
1498<p>See IProduct for a description of the parameters.</p>1635query terms. text is a piece of text in the title / summary /
1636description fields of product.</p>
1637<p>This call eager loads data appropriate for web API; caution may be
1638needed for other callers.</p>
14991639
1500</wadl:doc>1640</wadl:doc>
1501 <wadl:request>1641 <wadl:request>
1502 <wadl:representation1642
1503 mediaType="application/x-www-form-urlencoded">1643 <wadl:param style="query" name="ws.op" required="true" fixed="search">
1504 <wadl:param style="query" name="ws.op"
1505 required="true" fixed="new_project">
1506 <wadl:doc>The name of the operation being invoked.</wadl:doc>1644 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1507 </wadl:param>1645 </wadl:param>
1508 <wadl:param style="query" required="false"1646 <wadl:param style="query" name="text" required="false">
1509 name="wiki_url">
1510 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1647 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1511<p>Wiki URL</p>1648Search text
1512<dl class="rst-docutils">
1513<dt>The full URL of this project's wiki, if it has</dt>
1514<dd>one. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1515</dl>
1516
1517</wadl:doc>1649</wadl:doc>
1518 1650
1519 </wadl:param>1651 </wadl:param>
1520 <wadl:param style="query" required="false"1652
1521 name="download_url">1653 </wadl:request>
1522 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1654 <wadl:response>
1523<p>Download URL</p>1655
1524<dl class="rst-docutils">1656 <wadl:representation href="https://api.launchpad.test/1.0/#project-page"/>
1525<dt>The full URL where downloads for this project</dt>1657 </wadl:response>
1526<dd>are located, if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>1658 </wadl:method>
1527</dl>1659 <wadl:method id="projects-new_project" name="POST">
15281660 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1529</wadl:doc>1661<p>Create and return a brand new Product.</p>
1530 1662<p>See IProduct for a description of the parameters.</p>
1663
1664</wadl:doc>
1665 <wadl:request>
1666 <wadl:representation mediaType="application/x-www-form-urlencoded">
1667 <wadl:param style="query" name="ws.op" required="true" fixed="new_project">
1668 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1531 </wadl:param>1669 </wadl:param>
1532 <wadl:param style="query" required="true"1670 <wadl:param style="query" name="name" required="true">
1533 name="display_name">
1534 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1671 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1535<p>Display Name</p>1672<p>Name</p>
1536<dl class="rst-docutils">1673<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>
1537<dt>The name of the project as it would appear in a</dt>
1538<dd>paragraph.</dd>
1539</dl>
15401674
1541</wadl:doc>1675</wadl:doc>
1542 1676
1543 </wadl:param>1677 </wadl:param>
1544 <wadl:param style="query" required="false"1678 <wadl:param style="query" name="display_name" required="true">
1545 name="description">
1546 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1679 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1547<p>Description</p>1680<p>Display Name</p>
1548<p>Details about the project's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.</p>1681<p>The name of the project as it would appear in a
1682paragraph.</p>
15491683
1550</wadl:doc>1684</wadl:doc>
1551 1685
1552 </wadl:param>1686 </wadl:param>
1553 <wadl:param style="query" required="true"1687 <wadl:param style="query" name="title" required="true">
1554 name="title">
1555 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1688 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1556<p>Title</p>1689<p>Title</p>
1557<p>The project title. Should be just a few words.</p>1690<p>The project title. Should be just a few words.</p>
@@ -1559,132 +1692,144 @@ quantity, so all projects are returned, latest first.</p>
1559</wadl:doc>1692</wadl:doc>
1560 1693
1561 </wadl:param>1694 </wadl:param>
1562 <wadl:param style="query" required="false"1695 <wadl:param style="query" name="summary" required="true">
1563 name="project_reviewed">
1564 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1696 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1565<p>Project reviewed</p>1697<p>Summary</p>
1566<p>Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.</p>1698<p>A short paragraph to introduce the project's work.</p>
15671699
1568</wadl:doc>1700</wadl:doc>
1569 1701
1570 </wadl:param>1702 </wadl:param>
1571 <wadl:param style="query" required="true"1703 <wadl:param style="query" name="description" required="false">
1572 name="summary">
1573 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1704 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1574<p>Summary</p>1705<p>Description</p>
1575<p>A short paragraph to introduce the project's work.</p>1706<p>Details about the project's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.</p>
15761707
1577</wadl:doc>1708</wadl:doc>
1578 1709
1579 </wadl:param>1710 </wadl:param>
1580 <wadl:param style="query" required="false"1711 <wadl:param style="query" name="project_group" required="false">
1581 name="project_group">
1582 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1712 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1583<p>Part of</p>1713<p>Part of</p>
1584<p>Project group. This is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.</p>1714<p>Project group. This is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.</p>
15851715
1586</wadl:doc>1716</wadl:doc>
1587 <wadl:link resource_type="https://api.launchpad.net/1.0/#project_group"/>1717 <wadl:link resource_type="https://api.launchpad.test/1.0/#project_group"/>
1588 </wadl:param>1718 </wadl:param>
1589 <wadl:param style="query" required="false"1719 <wadl:param style="query" name="home_page_url" required="false">
1590 name="licenses">
1591 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1720 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1592Licenses1721<p>Homepage URL</p>
1722<p>The project home page. Please include
1723the <a class="rst-reference external" href="http://" target="_top">http://</a></p>
1724
1725</wadl:doc>
1726
1727 </wadl:param>
1728 <wadl:param style="query" name="screenshots_url" required="false">
1729 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1730<p>Screenshots URL</p>
1731<p>The full URL for screenshots of this project,
1732if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></p>
1733
1734</wadl:doc>
1735
1736 </wadl:param>
1737 <wadl:param style="query" name="download_url" required="false">
1738 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1739<p>Download URL</p>
1740<p>The full URL where downloads for this project
1741are located, if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></p>
1742
1593</wadl:doc>1743</wadl:doc>
1594 1744
1595 </wadl:param>1745 </wadl:param>
1596 <wadl:param style="query" required="false"1746 <wadl:param style="query" name="freshmeat_project" required="false">
1597 name="freshmeat_project">
1598 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1747 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1599<p>Freshmeat Project</p>1748<p>Freshmeat Project</p>
1600<dl class="rst-docutils">1749<p>The Freshmeat project name for
1601<dt>The Freshmeat project name for</dt>1750this project, if it is in freshmeat. [DEPRECATED]</p>
1602<dd>this project, if it is in freshmeat.</dd>1751
1603</dl>1752</wadl:doc>
1753
1754 </wadl:param>
1755 <wadl:param style="query" name="wiki_url" required="false">
1756 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1757<p>Wiki URL</p>
1758<p>The full URL of this project's wiki, if it has
1759one. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></p>
16041760
1605</wadl:doc>1761</wadl:doc>
1606 1762
1607 </wadl:param>1763 </wadl:param>
1608 <wadl:param style="query" required="false"1764 <wadl:param style="query" name="sourceforge_project" required="false">
1609 name="sourceforge_project">
1610 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1765 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1611<p>Sourceforge Project</p>1766<p>Sourceforge Project</p>
1612<dl class="rst-docutils">1767<p>The SourceForge project name for
1613<dt>The SourceForge project name for</dt>1768this project, if it is in sourceforge.</p>
1614<dd>this project, if it is in sourceforge.</dd>
1615</dl>
16161769
1617</wadl:doc>1770</wadl:doc>
1618 1771
1619 </wadl:param>1772 </wadl:param>
1620 <wadl:param style="query" required="false"1773 <wadl:param style="query" name="programming_lang" required="false">
1621 name="programming_lang">
1622 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1774 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1623<p>Programming Languages</p>1775<p>Programming Languages</p>
1624<dl class="rst-docutils">1776<p>A comma delimited list of programming
1625<dt>A comma delimited list of programming</dt>1777languages used for this project.</p>
1626<dd>languages used for this project.</dd>
1627</dl>
16281778
1629</wadl:doc>1779</wadl:doc>
1630 1780
1631 </wadl:param>1781 </wadl:param>
1632 <wadl:param style="query" required="false"1782 <wadl:param style="query" name="project_reviewed" required="false">
1633 name="screenshots_url">
1634 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1783 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1635<p>Screenshots URL</p>1784<p>Project reviewed</p>
1636<dl class="rst-docutils">1785<p>Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.</p>
1637<dt>The full URL for screenshots of this project,</dt>
1638<dd>if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1639</dl>
16401786
1641</wadl:doc>1787</wadl:doc>
1642 1788
1643 </wadl:param>1789 </wadl:param>
1644 <wadl:param style="query" required="false"1790 <wadl:param style="query" name="licenses" required="false">
1645 name="license_info">
1646 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1791 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1647<p>Description of additional licenses</p>1792Licences
1648<p>Description of licenses that do not appear in the list above.</p>
1649
1650</wadl:doc>1793</wadl:doc>
1651 1794
1652 </wadl:param>1795 </wadl:param>
1653 <wadl:param style="query" required="false"1796 <wadl:param style="query" name="license_info" required="false">
1654 name="home_page_url">
1655 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1797 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1656<p>Homepage URL</p>1798<p>Description of additional licences</p>
1657<dl class="rst-docutils">1799<p>Description of licences that do not appear in the list above.</p>
1658<dt>The project home page. Please include</dt>
1659<dd>the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
1660</dl>
16611800
1662</wadl:doc>1801</wadl:doc>
1663 1802
1664 </wadl:param>1803 </wadl:param>
1665 <wadl:param style="query" required="false"1804 <wadl:param style="query" name="registrant" required="false">
1666 name="registrant">
1667 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1805 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1668<p>Registrant</p>1806<p>Registrant</p>
1669<p>This person registered the project in Launchpad.</p>1807<p>This person registered the project in Launchpad.</p>
16701808
1671</wadl:doc>1809</wadl:doc>
1672 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>1810 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
1673 </wadl:param>1811 </wadl:param>
1674 <wadl:param style="query" required="true"1812 <wadl:param style="query" name="bug_supervisor" required="false">
1675 name="name">
1676 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1813 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1677<p>Name</p>1814<p>Bug Supervisor</p>
1678<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>1815<p>The Launchpad id of the person or team (preferred) responsible for bug management.</p>
16791816
1680</wadl:doc>1817</wadl:doc>
1681 1818 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
1819 </wadl:param>
1820 <wadl:param style="query" name="driver" required="false">
1821 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1822<p>Driver</p>
1823<p>This person or team will be able to set feature goals for and approve bug targeting or backporting for ANY major series in this project. You might want to leave this blank and just appoint a team for each specific series, rather than having one project team that does it all.</p>
1824
1825</wadl:doc>
1826 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
1682 </wadl:param>1827 </wadl:param>
1683 </wadl:representation>1828 </wadl:representation>
1684 </wadl:request>1829 </wadl:request>
1685 <wadl:response>1830 <wadl:response>
1686 <wadl:param name="Location" style="header">1831 <wadl:param name="Location" style="header">
1687 <wadl:link resource_type="https://api.launchpad.net/1.0/#project"/>1832 <wadl:link resource_type="https://api.launchpad.test/1.0/#project"/>
1688 </wadl:param>1833 </wadl:param>
1689 1834
1690 </wadl:response>1835 </wadl:response>
@@ -1699,11 +1844,8 @@ The collection of projects.
1699</wadl:doc>1844</wadl:doc>
1700 <wadl:method name="GET" id="project_groups-get">1845 <wadl:method name="GET" id="project_groups-get">
1701 <wadl:response>1846 <wadl:response>
1702 <wadl:representation1847 <wadl:representation href="https://api.launchpad.test/1.0/#project_group-page"/>
1703 href="https://api.launchpad.net/1.0/#project_group-page"/>1848 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="project_groups-wadl"/>
1704 <wadl:representation
1705 mediaType="application/vnd.sun.wadl+xml"
1706 id="project_groups-wadl"/>
1707 </wadl:response>1849 </wadl:response>
1708 </wadl:method>1850 </wadl:method>
17091851
@@ -1718,12 +1860,10 @@ applications.
1718</wadl:doc>1860</wadl:doc>
1719 <wadl:request>1861 <wadl:request>
1720 1862
1721 <wadl:param style="query" name="ws.op"1863 <wadl:param style="query" name="ws.op" required="true" fixed="search">
1722 required="true" fixed="search">
1723 <wadl:doc>The name of the operation being invoked.</wadl:doc>1864 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1724 </wadl:param>1865 </wadl:param>
1725 <wadl:param style="query" required="false"1866 <wadl:param style="query" name="text" required="false">
1726 name="text">
1727 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1867 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1728Search text1868Search text
1729</wadl:doc>1869</wadl:doc>
@@ -1733,8 +1873,7 @@ Search text
1733 </wadl:request>1873 </wadl:request>
1734 <wadl:response>1874 <wadl:response>
1735 1875
1736 <wadl:representation1876 <wadl:representation href="https://api.launchpad.test/1.0/#project_group-page"/>
1737 href="https://api.launchpad.net/1.0/#project_group-page"/>
1738 </wadl:response>1877 </wadl:response>
1739 </wadl:method>1878 </wadl:method>
1740 </wadl:resource_type>1879 </wadl:resource_type>
@@ -1747,11 +1886,68 @@ A utility that contain all the questions published in Launchpad.
1747</wadl:doc>1886</wadl:doc>
1748 <wadl:method name="GET" id="questions-get">1887 <wadl:method name="GET" id="questions-get">
1749 <wadl:response>1888 <wadl:response>
1750 <wadl:representation1889 <wadl:representation href="https://api.launchpad.test/1.0/#question-page"/>
1751 href="https://api.launchpad.net/1.0/#question-page"/>1890 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="questions-wadl"/>
1752 <wadl:representation1891 </wadl:response>
1753 mediaType="application/vnd.sun.wadl+xml"1892 </wadl:method>
1754 id="questions-wadl"/>1893
1894 </wadl:resource_type>
1895
1896
1897
1898 <wadl:resource_type id="snap_bases">
1899 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1900Interface representing the set of bases for snaps.
1901</wadl:doc>
1902 <wadl:method name="GET" id="snap_bases-get">
1903 <wadl:response>
1904 <wadl:representation href="https://api.launchpad.test/1.0/#snap_base-page"/>
1905 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="snap_bases-wadl"/>
1906 </wadl:response>
1907 </wadl:method>
1908
1909 </wadl:resource_type>
1910
1911
1912
1913 <wadl:resource_type id="snaps">
1914 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1915A utility to create and access snap packages.
1916</wadl:doc>
1917 <wadl:method name="GET" id="snaps-get">
1918 <wadl:response>
1919 <wadl:representation href="https://api.launchpad.test/1.0/#snap-page"/>
1920 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="snaps-wadl"/>
1921 </wadl:response>
1922 </wadl:method>
1923
1924 </wadl:resource_type>
1925
1926
1927
1928 <wadl:resource_type id="snappy_serieses">
1929 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1930Interface representing the set of snappy series.
1931</wadl:doc>
1932 <wadl:method name="GET" id="snappy_serieses-get">
1933 <wadl:response>
1934 <wadl:representation href="https://api.launchpad.test/1.0/#snappy_series-page"/>
1935 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="snappy_serieses-wadl"/>
1936 </wadl:response>
1937 </wadl:method>
1938
1939 </wadl:resource_type>
1940
1941
1942
1943 <wadl:resource_type id="specifications">
1944 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1945A container for specifications.
1946</wadl:doc>
1947 <wadl:method name="GET" id="specifications-get">
1948 <wadl:response>
1949 <wadl:representation href="https://api.launchpad.test/1.0/#specification-page"/>
1950 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="specifications-wadl"/>
1755 </wadl:response>1951 </wadl:response>
1756 </wadl:method>1952 </wadl:method>
17571953
@@ -1765,11 +1961,8 @@ A tool to create temporary blobs.
1765</wadl:doc>1961</wadl:doc>
1766 <wadl:method name="GET" id="temporary_blobs-get">1962 <wadl:method name="GET" id="temporary_blobs-get">
1767 <wadl:response>1963 <wadl:response>
1768 <wadl:representation1964 <wadl:representation href="https://api.launchpad.test/1.0/#temporary_blob-page"/>
1769 href="https://api.launchpad.net/1.0/#temporary_blob-page"/>1965 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="temporary_blobs-wadl"/>
1770 <wadl:representation
1771 mediaType="application/vnd.sun.wadl+xml"
1772 id="temporary_blobs-wadl"/>
1773 </wadl:response>1966 </wadl:response>
1774 </wadl:method>1967 </wadl:method>
17751968
@@ -1779,12 +1972,10 @@ Retrieve a TemporaryBlobStorage by uuid.
1779</wadl:doc>1972</wadl:doc>
1780 <wadl:request>1973 <wadl:request>
1781 1974
1782 <wadl:param style="query" name="ws.op"1975 <wadl:param style="query" name="ws.op" required="true" fixed="fetch">
1783 required="true" fixed="fetch">
1784 <wadl:doc>The name of the operation being invoked.</wadl:doc>1976 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1785 </wadl:param>1977 </wadl:param>
1786 <wadl:param style="query" required="true"1978 <wadl:param style="query" name="token" required="true">
1787 name="token">
1788 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">1979 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1789UUID1980UUID
1790</wadl:doc>1981</wadl:doc>
@@ -1804,11 +1995,8 @@ A container for translation groups.
1804</wadl:doc>1995</wadl:doc>
1805 <wadl:method name="GET" id="translation_groups-get">1996 <wadl:method name="GET" id="translation_groups-get">
1806 <wadl:response>1997 <wadl:response>
1807 <wadl:representation1998 <wadl:representation href="https://api.launchpad.test/1.0/#translation_group-page"/>
1808 href="https://api.launchpad.net/1.0/#translation_group-page"/>1999 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="translation_groups-wadl"/>
1809 <wadl:representation
1810 mediaType="application/vnd.sun.wadl+xml"
1811 id="translation_groups-wadl"/>
1812 </wadl:response>2000 </wadl:response>
1813 </wadl:method>2001 </wadl:method>
18142002
@@ -1820,19 +2008,45 @@ A container for translation groups.
1820 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2008 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1821A set of files to be imported into Rosetta.2009A set of files to be imported into Rosetta.
1822</wadl:doc>2010</wadl:doc>
1823 <wadl:method name="GET"2011 <wadl:method name="GET" id="translation_import_queue_entries-get">
1824 id="translation_import_queue_entries-get">
1825 <wadl:response>2012 <wadl:response>
1826 <wadl:representation2013 <wadl:representation href="https://api.launchpad.test/1.0/#translation_import_queue_entry-page"/>
1827 href="https://api.launchpad.net/1.0/#translation_import_queue_entry-page"/>2014 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="translation_import_queue_entries-wadl"/>
1828 <wadl:representation
1829 mediaType="application/vnd.sun.wadl+xml"
1830 id="translation_import_queue_entries-wadl"/>
1831 </wadl:response>2015 </wadl:response>
1832 </wadl:method>2016 </wadl:method>
18332017
1834 <wadl:method id="translation_import_queue_entries-getAllEntries"2018 <wadl:method id="translation_import_queue_entries-getFirstEntryToImport" name="GET">
1835 name="GET">2019 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2020<p>Return the first entry of the queue ready to be imported.</p>
2021<table class="rst-docutils field-list" frame="void" rules="none">
2022<col class="field-name" />
2023<col class="field-body" />
2024<tbody valign="top">
2025<tr class="rst-field"><th class="rst-field-name">param target:</th><td class="rst-field-body">IPerson, IProduct, IProductSeries, IDistribution,
2026IDistroSeries or ISourcePackage the import entries are attached to
2027or None to get all entries available.</td>
2028</tr>
2029</tbody>
2030</table>
2031
2032</wadl:doc>
2033 <wadl:request>
2034
2035 <wadl:param style="query" name="ws.op" required="true" fixed="getFirstEntryToImport">
2036 <wadl:doc>The name of the operation being invoked.</wadl:doc>
2037 </wadl:param>
2038 <wadl:param style="query" name="target" required="false">
2039
2040 <wadl:link resource_type="https://api.launchpad.test/1.0/#object_with_translation_imports"/>
2041 </wadl:param>
2042
2043 </wadl:request>
2044 <wadl:response>
2045
2046 <wadl:representation href="https://api.launchpad.test/1.0/#translation_import_queue_entry-full"/>
2047 </wadl:response>
2048 </wadl:method>
2049 <wadl:method id="translation_import_queue_entries-getAllEntries" name="GET">
1836 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2050 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1837<p>Return all entries this import queue has.</p>2051<p>Return all entries this import queue has.</p>
1838<table class="rst-docutils field-list" frame="void" rules="none">2052<table class="rst-docutils field-list" frame="void" rules="none">
@@ -1844,10 +2058,10 @@ IDistroSeries or ISourcePackage the import entries are attached to
1844or None to get all entries available.</td>2058or None to get all entries available.</td>
1845</tr>2059</tr>
1846<tr class="rst-field"><th class="rst-field-name" colspan="2">arg import_status:</th></tr>2060<tr class="rst-field"><th class="rst-field-name" colspan="2">arg import_status:</th></tr>
1847<tr><td>&nbsp;</td><td class="rst-field-body">RosettaImportStatus entry.</td>2061<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">RosettaImportStatus entry.</td>
1848</tr>2062</tr>
1849<tr class="rst-field"><th class="rst-field-name" colspan="2">arg file_extensions:</th></tr>2063<tr class="rst-field"><th class="rst-field-name" colspan="2">arg file_extensions:</th></tr>
1850<tr><td>&nbsp;</td><td class="rst-field-body">Sequence of filename suffixes to match, usually2064<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">Sequence of filename suffixes to match, usually
1851'po' or 'pot'.</td>2065'po' or 'pot'.</td>
1852</tr>2066</tr>
1853</tbody>2067</tbody>
@@ -1858,13 +2072,10 @@ entries are filtered based on those values.</p>
1858</wadl:doc>2072</wadl:doc>
1859 <wadl:request>2073 <wadl:request>
1860 2074
1861 <wadl:param style="query" name="ws.op"2075 <wadl:param style="query" name="ws.op" required="true" fixed="getAllEntries">
1862 required="true"
1863 fixed="getAllEntries">
1864 <wadl:doc>The name of the operation being invoked.</wadl:doc>2076 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1865 </wadl:param>2077 </wadl:param>
1866 <wadl:param style="query" required="false"2078 <wadl:param style="query" name="import_status" required="false">
1867 name="import_status">
1868 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2079 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1869The status of the import.2080The status of the import.
1870</wadl:doc>2081</wadl:doc>
@@ -1881,12 +2092,10 @@ The status of the import.
1881 </wadl:request>2092 </wadl:request>
1882 <wadl:response>2093 <wadl:response>
1883 2094
1884 <wadl:representation2095 <wadl:representation href="https://api.launchpad.test/1.0/#translation_import_queue_entry-page"/>
1885 href="https://api.launchpad.net/1.0/#translation_import_queue_entry-page"/>
1886 </wadl:response>2096 </wadl:response>
1887 </wadl:method>2097 </wadl:method>
1888 <wadl:method id="translation_import_queue_entries-getRequestTargets"2098 <wadl:method id="translation_import_queue_entries-getRequestTargets" name="GET">
1889 name="GET">
1890 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2099 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1891<p>List Product`s and `DistroSeries with pending imports.</p>2100<p>List Product`s and `DistroSeries with pending imports.</p>
1892<table class="rst-docutils field-list" frame="void" rules="none">2101<table class="rst-docutils field-list" frame="void" rules="none">
@@ -1902,13 +2111,10 @@ The status of the import.
1902</wadl:doc>2111</wadl:doc>
1903 <wadl:request>2112 <wadl:request>
1904 2113
1905 <wadl:param style="query" name="ws.op"2114 <wadl:param style="query" name="ws.op" required="true" fixed="getRequestTargets">
1906 required="true"
1907 fixed="getRequestTargets">
1908 <wadl:doc>The name of the operation being invoked.</wadl:doc>2115 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1909 </wadl:param>2116 </wadl:param>
1910 <wadl:param style="query" required="false"2117 <wadl:param style="query" name="status" required="false">
1911 name="status">
1912 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2118 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1913The status of the import.2119The status of the import.
1914</wadl:doc>2120</wadl:doc>
@@ -1925,44 +2131,7 @@ The status of the import.
1925 </wadl:request>2131 </wadl:request>
1926 <wadl:response>2132 <wadl:response>
1927 2133
1928 <wadl:representation2134 <wadl:representation href="https://api.launchpad.test/1.0/#object_with_translation_imports-page"/>
1929 href="https://api.launchpad.net/1.0/#object_with_translation_imports-page"/>
1930 </wadl:response>
1931 </wadl:method>
1932 <wadl:method id="translation_import_queue_entries-getFirstEntryToImport"
1933 name="GET">
1934 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1935<p>Return the first entry of the queue ready to be imported.</p>
1936<table class="rst-docutils field-list" frame="void" rules="none">
1937<col class="field-name" />
1938<col class="field-body" />
1939<tbody valign="top">
1940<tr class="rst-field"><th class="rst-field-name">param target:</th><td class="rst-field-body">IPerson, IProduct, IProductSeries, IDistribution,
1941IDistroSeries or ISourcePackage the import entries are attached to
1942or None to get all entries available.</td>
1943</tr>
1944</tbody>
1945</table>
1946
1947</wadl:doc>
1948 <wadl:request>
1949
1950 <wadl:param style="query" name="ws.op"
1951 required="true"
1952 fixed="getFirstEntryToImport">
1953 <wadl:doc>The name of the operation being invoked.</wadl:doc>
1954 </wadl:param>
1955 <wadl:param style="query" required="false"
1956 name="target">
1957
1958 <wadl:link resource_type="https://api.launchpad.net/1.0/#object_with_translation_imports"/>
1959 </wadl:param>
1960
1961 </wadl:request>
1962 <wadl:response>
1963
1964 <wadl:representation
1965 href="https://api.launchpad.net/1.0/#translation_import_queue_entry-full"/>
1966 </wadl:response>2135 </wadl:response>
1967 </wadl:method>2136 </wadl:method>
1968 </wadl:resource_type>2137 </wadl:resource_type>
@@ -1973,35 +2142,27 @@ or None to get all entries available.</td>
1973 <!--Begin representation and resource_type definitions for entry2142 <!--Begin representation and resource_type definitions for entry
1974 resources and the collections that contain them. -->2143 resources and the collections that contain them. -->
1975 2144
1976 <wadl:resource_type id="archive_dependency">2145 <wadl:resource_type id="access_token">
1977 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2146 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
1978ArchiveDependency interface.2147A personal access token for the webservice API.
1979</wadl:doc>2148</wadl:doc>
1980 <wadl:method name="GET" id="archive_dependency-get">2149 <wadl:method name="GET" id="access_token-get">
1981 <wadl:response>2150 <wadl:response>
1982 <wadl:representation2151 <wadl:representation href="https://api.launchpad.test/1.0/#access_token-full"/>
1983 href="https://api.launchpad.net/1.0/#archive_dependency-full"/>2152 <wadl:representation mediaType="application/xhtml+xml" id="access_token-xhtml"/>
1984 <wadl:representation2153 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="access_token-wadl"/>
1985 mediaType="application/xhtml+xml"
1986 id="archive_dependency-xhtml"/>
1987 <wadl:representation
1988 mediaType="application/vnd.sun.wadl+xml"
1989 id="archive_dependency-wadl"/>
1990 </wadl:response>2154 </wadl:response>
1991 </wadl:method>2155 </wadl:method>
19922156
1993 <wadl:method name="PUT" id="archive_dependency-put">2157 <wadl:method name="PUT" id="access_token-put">
1994 <wadl:request>2158 <wadl:request>
1995 <wadl:representation2159 <wadl:representation href="https://api.launchpad.test/1.0/#access_token-full"/>
1996 href="https://api.launchpad.net/1.0/#archive_dependency-full"/>
1997 </wadl:request>2160 </wadl:request>
1998 </wadl:method>2161 </wadl:method>
19992162
2000 <wadl:method name="PATCH"2163 <wadl:method name="PATCH" id="access_token-patch">
2001 id="archive_dependency-patch">
2002 <wadl:request>2164 <wadl:request>
2003 <wadl:representation2165 <wadl:representation href="https://api.launchpad.test/1.0/#access_token-diff"/>
2004 href="https://api.launchpad.net/1.0/#archive_dependency-diff"/>
2005 </wadl:request>2166 </wadl:request>
2006 </wadl:method>2167 </wadl:method>
20072168
@@ -2010,13 +2171,17 @@ ArchiveDependency interface.
2010 </wadl:resource_type>2171 </wadl:resource_type>
20112172
20122173
2013 <wadl:representation mediaType="application/json"2174 <wadl:representation mediaType="application/json" id="access_token-full">
2014 id="archive_dependency-full">
2015 <wadl:param style="plain" name="self_link" path="$['self_link']">2175 <wadl:param style="plain" name="self_link" path="$['self_link']">
2016 <wadl:doc>The canonical link to this resource.</wadl:doc>2176 <wadl:doc>The canonical link to this resource.</wadl:doc>
2017 <wadl:link resource_type="https://api.launchpad.net/1.0/#archive_dependency"/>2177 <wadl:link resource_type="https://api.launchpad.test/1.0/#access_token"/>
2178 </wadl:param>
2179 <wadl:param style="plain" name="web_link" path="$['web_link']">
2180 <wadl:doc>
2181 The canonical human-addressable web link to this resource.
2182 </wadl:doc>
2183 <wadl:link/>
2018 </wadl:param>2184 </wadl:param>
2019
2020 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">2185 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
2021 <wadl:doc>2186 <wadl:doc>
2022 The link to the WADL description of this resource.2187 The link to the WADL description of this resource.
@@ -2028,78 +2193,93 @@ ArchiveDependency interface.
2028 The value of the HTTP ETag for this resource.2193 The value of the HTTP ETag for this resource.
2029 </wadl:doc>2194 </wadl:doc>
2030 </wadl:param>2195 </wadl:param>
2031 <wadl:param style="plain" required="true"2196 <wadl:param style="plain" required="true" name="date_created" path="$['date_created']" type="xsd:dateTime">
2032 path="$['archive_link']"
2033 name="archive_link">
2034 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2197 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2035<p>Target archive</p>2198<p>Creation date</p>
2036<p>The archive affected by this dependecy.</p>2199<p>When the token was created.</p>
20372200
2038</wadl:doc>2201</wadl:doc>
2039 <wadl:link resource_type="https://api.launchpad.net/1.0/#archive"/>2202
2040 </wadl:param>2203 </wadl:param>
2041 <wadl:param style="plain" required="true"2204 <wadl:param style="plain" required="true" name="date_expires" path="$['date_expires']" type="xsd:dateTime">
2042 path="$['component_name']"
2043 name="component_name">
2044 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2205 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2045Component name2206<p>Expiry date</p>
2207<p>When the token should expire or was revoked.</p>
2208
2046</wadl:doc>2209</wadl:doc>
2047 2210
2048 </wadl:param>2211 </wadl:param>
2049 <wadl:param style="plain" required="true"2212 <wadl:param style="plain" required="true" name="date_last_used" path="$['date_last_used']" type="xsd:dateTime">
2050 path="$['date_created']"
2051 type="xsd:dateTime" name="date_created">
2052 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2213 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2053Instant when the dependency was created.2214<p>Date last used</p>
2215<p>When the token was last used.</p>
2216
2054</wadl:doc>2217</wadl:doc>
2055 2218
2056 </wadl:param>2219 </wadl:param>
2057 <wadl:param style="plain" required="true"2220 <wadl:param style="plain" required="true" name="description" path="$['description']">
2058 path="$['dependency_link']"
2059 name="dependency_link">
2060 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2221 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2061The archive set as a dependency.2222<p>Description</p>
2223<p>A short description of the token.</p>
2224
2062</wadl:doc>2225</wadl:doc>
2063 <wadl:link resource_type="https://api.launchpad.net/1.0/#archive"/>2226
2064 </wadl:param>2227 </wadl:param>
2065 <wadl:param style="plain" required="true"2228 <wadl:param style="plain" required="true" name="owner_link" path="$['owner_link']">
2066 path="$['pocket']" name="pocket">
2067 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2229 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2068Pocket2230<p>Owner</p>
2231<p>The person who created the token.</p>
2232
2069</wadl:doc>2233</wadl:doc>
2070 2234 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2071 <wadl:option value="Release"/>
2072 <wadl:option value="Security"/>
2073 <wadl:option value="Updates"/>
2074 <wadl:option value="Proposed"/>
2075 <wadl:option value="Backports"/>
2076 </wadl:param>2235 </wadl:param>
2077 <wadl:param style="plain" required="true"2236 <wadl:param style="plain" required="true" name="revoked_by_link" path="$['revoked_by_link']">
2078 path="$['title']" name="title">
2079 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2237 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2080Archive dependency title.2238<p>Revoked by</p>
2239<p>The person who revoked the token, if any.</p>
2240
2241</wadl:doc>
2242 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2243 </wadl:param>
2244 <wadl:param style="plain" required="true" name="scopes" path="$['scopes']">
2245 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2246<p>Scopes</p>
2247<p>A list of scopes granted by the token.</p>
2248
2081</wadl:doc>2249</wadl:doc>
2082 2250
2083 </wadl:param>2251 </wadl:param>
2252 <wadl:param style="plain" required="true" name="target_link" path="$['target_link']">
2253 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2254<p>Target</p>
2255<p>The target for which the token was issued.</p>
2256
2257</wadl:doc>
2258 <wadl:link resource_type="https://api.launchpad.test/1.0/#access_token_target"/>
2259 </wadl:param>
2084 </wadl:representation>2260 </wadl:representation>
20852261
2086 <wadl:representation mediaType="application/json"2262 <wadl:representation mediaType="application/json" id="access_token-diff">
2087 id="archive_dependency-diff">2263 <wadl:param style="plain" required="false" name="description" path="$['description']">
2264 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2265<p>Description</p>
2266<p>A short description of the token.</p>
2267
2268</wadl:doc>
2269
2270 </wadl:param>
2088 </wadl:representation>2271 </wadl:representation>
20892272
2090 <!--Collection page for this type of entry-->2273 <!--Collection page for this type of entry-->
2091 <wadl:resource_type id="archive_dependency-page-resource">2274 <wadl:resource_type id="access_token-page-resource">
2092 <wadl:method name="GET"2275 <wadl:method name="GET" id="access_token-page-resource-get">
2093 id="archive_dependency-page-resource-get">
2094 <wadl:response>2276 <wadl:response>
2095 <wadl:representation2277 <wadl:representation href="#access_token-page"/>
2096 href="#archive_dependency-page"/>
2097 </wadl:response>2278 </wadl:response>
2098 </wadl:method>2279 </wadl:method>
2099 </wadl:resource_type>2280 </wadl:resource_type>
21002281
2101 <wadl:representation mediaType="application/json"2282 <wadl:representation mediaType="application/json" id="access_token-page">
2102 id="archive_dependency-page">
21032283
2104 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">2284 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
2105 <wadl:link/>2285 <wadl:link/>
@@ -2107,164 +2287,344 @@ Archive dependency title.
21072287
2108 2288
21092289
2110 <wadl:param style="plain" name="total_size"2290 <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
2111 path="$['total_size']" required="true"/>
21122291
2113 2292
21142293
2115 <wadl:param style="plain" name="start" path="$['start']" required="true"/>2294 <wadl:param style="plain" name="start" path="$['start']" required="true"/>
21162295
2117 <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">2296 <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
2118 <wadl:link resource_type="#archive_dependency-page-resource"/>2297 <wadl:link resource_type="#access_token-page-resource"/>
2119 </wadl:param>2298 </wadl:param>
21202299
2121 <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">2300 <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
2122 <wadl:link resource_type="#archive_dependency-page-resource"/>2301 <wadl:link resource_type="#access_token-page-resource"/>
2123 </wadl:param>2302 </wadl:param>
21242303
2125 <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>2304 <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
21262305
2127 <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">2306 <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
2128 <wadl:link resource_type="https://api.launchpad.net/1.0/#archive_dependency"/>2307 <wadl:link resource_type="https://api.launchpad.test/1.0/#access_token"/>
2129 </wadl:param>2308 </wadl:param>
2130 </wadl:representation>2309 </wadl:representation>
21312310
2132 2311
2133 2312
2134 <wadl:resource_type id="archive">2313 <wadl:resource_type id="access_token_target">
2135 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2314 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2136Main Archive interface.2315An object that can be a target for access tokens.
2137</wadl:doc>2316</wadl:doc>
2138 <wadl:method name="GET" id="archive-get">2317 <wadl:method name="GET" id="access_token_target-get">
2139 <wadl:response>2318 <wadl:response>
2140 <wadl:representation2319 <wadl:representation href="https://api.launchpad.test/1.0/#access_token_target-full"/>
2141 href="https://api.launchpad.net/1.0/#archive-full"/>2320 <wadl:representation mediaType="application/xhtml+xml" id="access_token_target-xhtml"/>
2142 <wadl:representation2321 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="access_token_target-wadl"/>
2143 mediaType="application/xhtml+xml" id="archive-xhtml"/>
2144 <wadl:representation
2145 mediaType="application/vnd.sun.wadl+xml"
2146 id="archive-wadl"/>
2147 </wadl:response>2322 </wadl:response>
2148 </wadl:method>2323 </wadl:method>
21492324
2150 <wadl:method name="PUT" id="archive-put">2325 <wadl:method name="PUT" id="access_token_target-put">
2151 <wadl:request>2326 <wadl:request>
2152 <wadl:representation2327 <wadl:representation href="https://api.launchpad.test/1.0/#access_token_target-full"/>
2153 href="https://api.launchpad.net/1.0/#archive-full"/>
2154 </wadl:request>2328 </wadl:request>
2155 </wadl:method>2329 </wadl:method>
21562330
2157 <wadl:method name="PATCH" id="archive-patch">2331 <wadl:method name="PATCH" id="access_token_target-patch">
2158 <wadl:request>2332 <wadl:request>
2159 <wadl:representation2333 <wadl:representation href="https://api.launchpad.test/1.0/#access_token_target-diff"/>
2160 href="https://api.launchpad.net/1.0/#archive-diff"/>
2161 </wadl:request>2334 </wadl:request>
2162 </wadl:method>2335 </wadl:method>
21632336
2164 2337
21652338
2166 <wadl:method id="archive-isSourceUploadAllowed"2339 </wadl:resource_type>
2167 name="GET">
2168 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2169<p>True if the person is allowed to upload the given source package.</p>
2170<dl class="rst-docutils">
2171<dt>Return True if there exists a permission that combines</dt>
2172<dd><ul class="rst-first rst-last rst-simple">
2173<li>this archive</li>
2174<li>a package set that includes the given source package name</li>
2175<li>the given person or a team he is a member of</li>
2176</ul>
2177</dd>
2178</dl>
2179<p>If the source package name is included by <em>any</em> package set with
2180an explicit permission then only such explicit permissions will
2181be considered.</p>
2182<table class="rst-docutils field-list" frame="void" rules="none">
2183<col class="field-name" />
2184<col class="field-body" />
2185<tbody valign="top">
2186<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2187<tr><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2188either a string or a ISourcePackageName.</td>
2189</tr>
2190<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
2191package sets he has access to.</td>
2192</tr>
2193<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
2194<tr><td>&nbsp;</td><td class="rst-field-body">The IDistroSeries for which to check
2195permissions. If none is supplied then currentseries in
2196Ubuntu is assumed.</td>
2197</tr>
2198<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2199<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the
2200given name could not be found.</td>
2201</tr>
2202<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>
2203</tr>
2204</tbody>
2205</table>
22062340
2207</wadl:doc>2341
2342 <wadl:representation mediaType="application/json" id="access_token_target-full">
2343 <wadl:param style="plain" name="self_link" path="$['self_link']">
2344 <wadl:doc>The canonical link to this resource.</wadl:doc>
2345 <wadl:link resource_type="https://api.launchpad.test/1.0/#access_token_target"/>
2346 </wadl:param>
2347 <wadl:param style="plain" name="web_link" path="$['web_link']">
2348 <wadl:doc>
2349 The canonical human-addressable web link to this resource.
2350 </wadl:doc>
2351 <wadl:link/>
2352 </wadl:param>
2353 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
2354 <wadl:doc>
2355 The link to the WADL description of this resource.
2356 </wadl:doc>
2357 <wadl:link/>
2358 </wadl:param>
2359 <wadl:param style="plain" name="http_etag" path="$['http_etag']">
2360 <wadl:doc>
2361 The value of the HTTP ETag for this resource.
2362 </wadl:doc>
2363 </wadl:param>
2364 </wadl:representation>
2365
2366 <wadl:representation mediaType="application/json" id="access_token_target-diff">
2367 </wadl:representation>
2368
2369 <!--Collection page for this type of entry-->
2370 <wadl:resource_type id="access_token_target-page-resource">
2371 <wadl:method name="GET" id="access_token_target-page-resource-get">
2372 <wadl:response>
2373 <wadl:representation href="#access_token_target-page"/>
2374 </wadl:response>
2375 </wadl:method>
2376 </wadl:resource_type>
2377
2378 <wadl:representation mediaType="application/json" id="access_token_target-page">
2379
2380 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
2381 <wadl:link/>
2382 </wadl:param>
2383
2384
2385
2386 <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
2387
2388
2389
2390 <wadl:param style="plain" name="start" path="$['start']" required="true"/>
2391
2392 <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
2393 <wadl:link resource_type="#access_token_target-page-resource"/>
2394 </wadl:param>
2395
2396 <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
2397 <wadl:link resource_type="#access_token_target-page-resource"/>
2398 </wadl:param>
2399
2400 <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
2401
2402 <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
2403 <wadl:link resource_type="https://api.launchpad.test/1.0/#access_token_target"/>
2404 </wadl:param>
2405 </wadl:representation>
2406
2407
2408
2409 <wadl:resource_type id="archive_dependency">
2410 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2411ArchiveDependency interface.
2412</wadl:doc>
2413 <wadl:method name="GET" id="archive_dependency-get">
2414 <wadl:response>
2415 <wadl:representation href="https://api.launchpad.test/1.0/#archive_dependency-full"/>
2416 <wadl:representation mediaType="application/xhtml+xml" id="archive_dependency-xhtml"/>
2417 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="archive_dependency-wadl"/>
2418 </wadl:response>
2419 </wadl:method>
2420
2421 <wadl:method name="PUT" id="archive_dependency-put">
2208 <wadl:request>2422 <wadl:request>
2209 2423 <wadl:representation href="https://api.launchpad.test/1.0/#archive_dependency-full"/>
2210 <wadl:param style="query" name="ws.op"2424 </wadl:request>
2211 required="true"2425 </wadl:method>
2212 fixed="isSourceUploadAllowed"/>2426
2213 <wadl:param style="query" required="true"2427 <wadl:method name="PATCH" id="archive_dependency-patch">
2214 name="person">2428 <wadl:request>
2215 2429 <wadl:representation href="https://api.launchpad.test/1.0/#archive_dependency-diff"/>
2216 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>2430 </wadl:request>
2217 </wadl:param>2431 </wadl:method>
2218 <wadl:param style="query" required="false"2432
2219 name="distroseries">2433
2220 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2434
2221The distro series2435 </wadl:resource_type>
2436
2437
2438 <wadl:representation mediaType="application/json" id="archive_dependency-full">
2439 <wadl:param style="plain" name="self_link" path="$['self_link']">
2440 <wadl:doc>The canonical link to this resource.</wadl:doc>
2441 <wadl:link resource_type="https://api.launchpad.test/1.0/#archive_dependency"/>
2442 </wadl:param>
2443
2444 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
2445 <wadl:doc>
2446 The link to the WADL description of this resource.
2447 </wadl:doc>
2448 <wadl:link/>
2449 </wadl:param>
2450 <wadl:param style="plain" name="http_etag" path="$['http_etag']">
2451 <wadl:doc>
2452 The value of the HTTP ETag for this resource.
2453 </wadl:doc>
2454 </wadl:param>
2455 <wadl:param style="plain" required="true" name="archive_link" path="$['archive_link']">
2456 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2457<p>Target archive</p>
2458<p>The archive that has this dependency.</p>
2459
2222</wadl:doc>2460</wadl:doc>
2223 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>2461 <wadl:link resource_type="https://api.launchpad.test/1.0/#archive"/>
2224 </wadl:param>2462 </wadl:param>
2225 <wadl:param style="query" required="true"2463 <wadl:param style="plain" required="true" name="component_name" path="$['component_name']">
2226 name="sourcepackagename">2464 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2227 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2465Component name
2228Source package name2466</wadl:doc>
2467
2468 </wadl:param>
2469 <wadl:param style="plain" required="true" name="date_created" path="$['date_created']" type="xsd:dateTime">
2470 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2471Instant when the dependency was created.
2472</wadl:doc>
2473
2474 </wadl:param>
2475 <wadl:param style="plain" required="true" name="dependency_link" path="$['dependency_link']">
2476 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2477The archive set as a dependency.
2478</wadl:doc>
2479 <wadl:link resource_type="https://api.launchpad.test/1.0/#archive"/>
2480 </wadl:param>
2481 <wadl:param style="plain" required="true" name="pocket" path="$['pocket']">
2482 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2483Pocket
2484</wadl:doc>
2485
2486 <wadl:option value="Release"/>
2487 <wadl:option value="Security"/>
2488 <wadl:option value="Updates"/>
2489 <wadl:option value="Proposed"/>
2490 <wadl:option value="Backports"/>
2491 </wadl:param>
2492 <wadl:param style="plain" required="true" name="snap_base_link" path="$['snap_base_link']">
2493 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2494<p>Target snap base</p>
2495<p>The snap base that has this dependency.</p>
2496
2497</wadl:doc>
2498 <wadl:link resource_type="https://api.launchpad.test/1.0/#snap_base"/>
2499 </wadl:param>
2500 <wadl:param style="plain" required="true" name="title" path="$['title']">
2501 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2502Archive dependency title.
2229</wadl:doc>2503</wadl:doc>
2230
2231 </wadl:param>
2232
2233 </wadl:request>
2234 2504
2505 </wadl:param>
2506 </wadl:representation>
2507
2508 <wadl:representation mediaType="application/json" id="archive_dependency-diff">
2509 </wadl:representation>
2510
2511 <!--Collection page for this type of entry-->
2512 <wadl:resource_type id="archive_dependency-page-resource">
2513 <wadl:method name="GET" id="archive_dependency-page-resource-get">
2514 <wadl:response>
2515 <wadl:representation href="#archive_dependency-page"/>
2516 </wadl:response>
2235 </wadl:method>2517 </wadl:method>
2236 <wadl:method id="archive-getBuildCounters" name="GET">2518 </wadl:resource_type>
2519
2520 <wadl:representation mediaType="application/json" id="archive_dependency-page">
2521
2522 <wadl:param style="plain" name="resource_type_link" path="$['resource_type_link']">
2523 <wadl:link/>
2524 </wadl:param>
2525
2526
2527
2528 <wadl:param style="plain" name="total_size" path="$['total_size']" required="true"/>
2529
2530
2531
2532 <wadl:param style="plain" name="start" path="$['start']" required="true"/>
2533
2534 <wadl:param style="plain" name="next_collection_link" path="$['next_collection_link']">
2535 <wadl:link resource_type="#archive_dependency-page-resource"/>
2536 </wadl:param>
2537
2538 <wadl:param style="plain" name="prev_collection_link" path="$['prev_collection_link']">
2539 <wadl:link resource_type="#archive_dependency-page-resource"/>
2540 </wadl:param>
2541
2542 <wadl:param style="plain" name="entries" path="$['entries']" required="true"/>
2543
2544 <wadl:param style="plain" name="entry_links" path="$['entries'][*]['self_link']">
2545 <wadl:link resource_type="https://api.launchpad.test/1.0/#archive_dependency"/>
2546 </wadl:param>
2547 </wadl:representation>
2548
2549
2550
2551 <wadl:resource_type id="archive">
2552 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2553Main Archive interface.
2554</wadl:doc>
2555 <wadl:method name="GET" id="archive-get">
2556 <wadl:response>
2557 <wadl:representation href="https://api.launchpad.test/1.0/#archive-full"/>
2558 <wadl:representation mediaType="application/xhtml+xml" id="archive-xhtml"/>
2559 <wadl:representation mediaType="application/vnd.sun.wadl+xml" id="archive-wadl"/>
2560 </wadl:response>
2561 </wadl:method>
2562
2563 <wadl:method name="PUT" id="archive-put">
2564 <wadl:request>
2565 <wadl:representation href="https://api.launchpad.test/1.0/#archive-full"/>
2566 </wadl:request>
2567 </wadl:method>
2568
2569 <wadl:method name="PATCH" id="archive-patch">
2570 <wadl:request>
2571 <wadl:representation href="https://api.launchpad.test/1.0/#archive-diff"/>
2572 </wadl:request>
2573 </wadl:method>
2574
2575
2576
2577 <wadl:method id="archive-getPublishedBinaries" name="GET">
2237 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2578 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2238<p>Return a dictionary containing the build counters for an archive.</p>2579<p>All IBinaryPackagePublishingHistory target to this archive.</p>
2239<p>This is necessary currently because the IArchive.failed_builds etc.
2240counters are not in use.</p>
2241<p>The returned dictionary contains the follwoing keys and values:</p>
2242<blockquote>
2243<ul class="rst-simple">
2244<li>'total': total number of builds (includes SUPERSEDED);</li>
2245<li>'pending': number of builds in BUILDING or NEEDSBUILD state;</li>
2246<li>'failed': number of builds in FAILEDTOBUILD, MANUALDEPWAIT,
2247CHROOTWAIT and FAILEDTOUPLOAD state;</li>
2248<li>'succeeded': number of SUCCESSFULLYBUILT builds.</li>
2249<li>'superseded': number of SUPERSEDED builds.</li>
2250</ul>
2251</blockquote>
2252<table class="rst-docutils field-list" frame="void" rules="none">2580<table class="rst-docutils field-list" frame="void" rules="none">
2253<col class="field-name" />2581<col class="field-name" />
2254<col class="field-body" />2582<col class="field-body" />
2255<tbody valign="top">2583<tbody valign="top">
2256<tr class="rst-field"><th class="rst-field-name" colspan="2">param include_needsbuild:</th></tr>2584<tr class="rst-field"><th class="rst-field-name">param name:</th><td class="rst-field-body">binary name filter (exact match or SQL LIKE controlled
2257<tr><td>&nbsp;</td><td class="rst-field-body">Indicates whether to include builds with2585by 'exact_match' argument).</td>
2258the status NEEDSBUILD in the pending and total counts. This is
2259useful in situations where a build that hasn't started isn't
2260considered a build by the user.</td>
2261</tr>2586</tr>
2262<tr class="rst-field"><th class="rst-field-name" colspan="2">type include_needsbuild:</th></tr>2587<tr class="rst-field"><th class="rst-field-name">param version:</th><td class="rst-field-body">binary version filter (always exact match).</td>
2263<tr><td>&nbsp;</td><td class="rst-field-body"><tt class="rst-docutils literal"><span class="pre">bool</span></tt></td>
2264</tr>2588</tr>
2265<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>2589<tr class="rst-field"><th class="rst-field-name">param status:</th><td class="rst-field-body">PackagePublishingStatus filter, can be a list.</td>
2590</tr>
2591<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroarchseries:</th></tr>
2592<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">IDistroArchSeries filter, can be a list.</td>
2266</tr>2593</tr>
2267<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>2594<tr class="rst-field"><th class="rst-field-name">param pocket:</th><td class="rst-field-body">PackagePublishingPocket filter.</td>
2595</tr>
2596<tr class="rst-field"><th class="rst-field-name" colspan="2">param exact_match:</th></tr>
2597<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">either or not filter source names by exact
2598matching.</td>
2599</tr>
2600<tr class="rst-field"><th class="rst-field-name" colspan="2">param created_since_date:</th></tr>
2601<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">Only return publications created on or
2602after this date.</td>
2603</tr>
2604<tr class="rst-field"><th class="rst-field-name">param ordered:</th><td class="rst-field-body">Normally publications are ordered by binary package
2605name and then ID order (creation order). If this parameter is
2606False then the results will be unordered. This will make the
2607operation much quicker to return results if you don't care about
2608ordering.</td>
2609</tr>
2610<tr class="rst-field"><th class="rst-field-name" colspan="2">param order_by_date:</th></tr>
2611<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">Order publications by descending creation date
2612and then by descending ID. This is suitable for applications
2613that need to catch up with publications since their last run.</td>
2614</tr>
2615<tr class="rst-field"><th class="rst-field-name" colspan="2">param include_removed:</th></tr>
2616<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">If True, include publications that have been
2617removed from disk as well as those that have not.</td>
2618</tr>
2619<tr class="rst-field"><th class="rst-field-name" colspan="2">param only_unpublished:</th></tr>
2620<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">If True, only include publications that
2621have never been published to disk.</td>
2622</tr>
2623<tr class="rst-field"><th class="rst-field-name" colspan="2">param component_name:</th></tr>
2624<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">component filter. Only return binaries that are
2625in this component.</td>
2626</tr>
2627<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A collection containing BinaryPackagePublishingHistory.</td>
2268</tr>2628</tr>
2269</tbody>2629</tbody>
2270</table>2630</table>
@@ -2272,91 +2632,162 @@ considered a build by the user.</td>
2272</wadl:doc>2632</wadl:doc>
2273 <wadl:request>2633 <wadl:request>
2274 2634
2275 <wadl:param style="query" name="ws.op"2635 <wadl:param style="query" name="ws.op" required="true" fixed="getPublishedBinaries"/>
2276 required="true"2636 <wadl:param style="query" name="version" required="false">
2277 fixed="getBuildCounters"/>
2278 <wadl:param style="query" required="false"
2279 name="include_needsbuild">
2280 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2637 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2281Include builds with state NEEDSBUILD2638Version
2282</wadl:doc>2639</wadl:doc>
2283 2640
2284 </wadl:param>2641 </wadl:param>
2285 2642 <wadl:param style="query" name="binary_name" required="false">
2286 </wadl:request>2643 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2287 2644Binary Package Name
2288 </wadl:method>2645</wadl:doc>
2289 <wadl:method id="archive-getComponentsForQueueAdmin"2646
2290 name="GET">2647 </wadl:param>
2291 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2648 <wadl:param style="query" name="status" required="false">
2292<p>Return IArchivePermission for the person's queue admin2649 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2293components.</p>2650<p>Package Publishing Status</p>
2294<table class="rst-docutils field-list" frame="void" rules="none">2651<p>The status of this publishing record</p>
2295<col class="field-name" />
2296<col class="field-body" />
2297<tbody valign="top">
2298<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson.</td>
2299</tr>
2300<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2301</tr>
2302</tbody>
2303</table>
23042652
2305</wadl:doc>2653</wadl:doc>
2306 <wadl:request>
2307
2308 <wadl:param style="query" name="ws.op"
2309 required="true"
2310 fixed="getComponentsForQueueAdmin"/>
2311 <wadl:param style="query" required="true"
2312 name="person">
2313 2654
2314 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>2655 <wadl:option value="Pending"/>
2656 <wadl:option value="Published"/>
2657 <wadl:option value="Superseded"/>
2658 <wadl:option value="Deleted"/>
2659 <wadl:option value="Obsolete"/>
2315 </wadl:param>2660 </wadl:param>
2316 2661 <wadl:param style="query" name="component_name" required="false">
2317 </wadl:request>2662 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2318 <wadl:response>2663Component name
2319
2320 <wadl:representation
2321 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
2322 </wadl:response>
2323 </wadl:method>
2324 <wadl:method id="archive-checkUpload" name="GET">
2325 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2326Wrapper around checkUpload for the web service API.
2327</wadl:doc>2664</wadl:doc>
2328 <wadl:request>
2329
2330 <wadl:param style="query" name="ws.op"
2331 required="true" fixed="checkUpload"/>
2332 <wadl:param style="query" required="true"
2333 name="person">
2334 2665
2335 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>
2336 </wadl:param>2666 </wadl:param>
2337 <wadl:param style="query" required="true"2667 <wadl:param style="query" name="distro_arch_series" required="false">
2338 name="distroseries">
2339 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2668 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2340The distro series2669Distro Arch Series
2341</wadl:doc>2670</wadl:doc>
2342 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>2671 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_arch_series"/>
2343 </wadl:param>2672 </wadl:param>
2344 <wadl:param style="query" required="true"2673 <wadl:param style="query" name="ordered" required="false">
2345 name="component">
2346 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2674 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2347Component2675<p>Ordered</p>
2676<p>Return ordered results by default, but specifying False will return results more quickly.</p>
2677
2348</wadl:doc>2678</wadl:doc>
2349 2679
2350 </wadl:param>2680 </wadl:param>
2351 <wadl:param style="query" required="false"2681 <wadl:param style="query" name="pocket" required="false">
2352 name="strict_component">
2353 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2682 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2354Strict component2683<p>Pocket</p>
2684<p>The pocket into which this entry is published</p>
2685
2686</wadl:doc>
2687
2688 <wadl:option value="Release"/>
2689 <wadl:option value="Security"/>
2690 <wadl:option value="Updates"/>
2691 <wadl:option value="Proposed"/>
2692 <wadl:option value="Backports"/>
2693 </wadl:param>
2694 <wadl:param style="query" name="created_since_date" required="false" type="xsd:dateTime">
2695 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2696<p>Created Since Date</p>
2697<p>Return entries whose date_created is greater than or equal to this date.</p>
2698
2699</wadl:doc>
2700
2701 </wadl:param>
2702 <wadl:param style="query" name="exact_match" required="false">
2703 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2704Whether or not to filter binary names by exact matching.
2705</wadl:doc>
2706
2707 </wadl:param>
2708 <wadl:param style="query" name="order_by_date" required="false">
2709 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2710<p>Order by creation date</p>
2711<p>Return newest results first. This is recommended for applications that need to catch up with publications since their last run.</p>
2712
2713</wadl:doc>
2714
2715 </wadl:param>
2716
2717 </wadl:request>
2718 <wadl:response>
2719
2720 <wadl:representation href="https://api.launchpad.test/1.0/#binary_package_publishing_history-page"/>
2721 </wadl:response>
2722 </wadl:method>
2723 <wadl:method id="archive-getBuildRecords" name="GET">
2724 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2725<p>Return build records in the context it is implemented.</p>
2726<p>It excludes build records generated by Gina (imported from a external
2727repository), where IBuild.datebuilt is null and IBuild.buildstate
2728is BuildStatus.FULLYBUILT.</p>
2729<p>The result is simply not filtered if the optional filters are omitted
2730by call sites.</p>
2731<table class="rst-docutils field-list" frame="void" rules="none">
2732<col class="field-name" />
2733<col class="field-body" />
2734<tbody valign="top">
2735<tr class="rst-field"><th class="rst-field-name" colspan="2">param build_state:</th></tr>
2736<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">optional BuildStatus value for filtering build
2737records;</td>
2738</tr>
2739<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.
2740Sub-string matching is allowed via SQL LIKE.</td>
2741</tr>
2742<tr class="rst-field"><th class="rst-field-name">param pocket:</th><td class="rst-field-body">optional PackagePublishingPocket value for filtering
2743build records;</td>
2744</tr>
2745<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
2746by their architecture tag;</td>
2747</tr>
2748<tr class="rst-field"><th class="rst-field-name">param user:</th><td class="rst-field-body">optional IPerson corresponding to the user performing
2749the request. It will filter out build records for which the user
2750have no 'view' permission.</td>
2751</tr>
2752<tr class="rst-field"><th class="rst-field-name" colspan="2">param binary_only:</th></tr>
2753<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">optional boolean indicating whether only
2754BinaryPackageBuild objects should be returned, or more general
2755PackageBuild objects (which may include, for example,
2756SourcePackageRecipeBuild objects.</td>
2757</tr>
2758<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a result set containing IPackageBuild records ordered by
2759descending IPackageBuild.date_finished except when builds are
2760filtered by BuildStatus.NEEDSBUILD, in this case records
2761are ordered by descending BuildQueue.lastscore
2762(dispatching order).</td>
2763</tr>
2764</tbody>
2765</table>
2766
2767</wadl:doc>
2768 <wadl:request>
2769
2770 <wadl:param style="query" name="ws.op" required="true" fixed="getBuildRecords"/>
2771 <wadl:param style="query" name="build_state" required="false">
2772 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2773<p>Build status</p>
2774<p>The status of this build record</p>
2775
2355</wadl:doc>2776</wadl:doc>
2356 2777
2778 <wadl:option value="Needs building"/>
2779 <wadl:option value="Successfully built"/>
2780 <wadl:option value="Failed to build"/>
2781 <wadl:option value="Dependency wait"/>
2782 <wadl:option value="Chroot problem"/>
2783 <wadl:option value="Build for superseded Source"/>
2784 <wadl:option value="Currently building"/>
2785 <wadl:option value="Failed to upload"/>
2786 <wadl:option value="Uploading build"/>
2787 <wadl:option value="Cancelling build"/>
2788 <wadl:option value="Cancelled build"/>
2357 </wadl:param>2789 </wadl:param>
2358 <wadl:param style="query" required="true"2790 <wadl:param style="query" name="pocket" required="false">
2359 name="pocket">
2360 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2791 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2361<p>Pocket</p>2792<p>Pocket</p>
2362<p>The pocket into which this entry is published</p>2793<p>The pocket into which this entry is published</p>
@@ -2369,8 +2800,7 @@ Strict component
2369 <wadl:option value="Proposed"/>2800 <wadl:option value="Proposed"/>
2370 <wadl:option value="Backports"/>2801 <wadl:option value="Backports"/>
2371 </wadl:param>2802 </wadl:param>
2372 <wadl:param style="query" required="true"2803 <wadl:param style="query" name="source_name" required="false">
2373 name="sourcepackagename">
2374 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2804 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2375Source package name2805Source package name
2376</wadl:doc>2806</wadl:doc>
@@ -2378,21 +2808,22 @@ Source package name
2378 </wadl:param>2808 </wadl:param>
2379 2809
2380 </wadl:request>2810 </wadl:request>
2381 2811 <wadl:response>
2812
2813 <wadl:representation href="https://api.launchpad.test/1.0/#build-page"/>
2814 </wadl:response>
2382 </wadl:method>2815 </wadl:method>
2383 <wadl:method id="archive-getArchiveDependency"2816 <wadl:method id="archive-getComponentsForQueueAdmin" name="GET">
2384 name="GET">
2385 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2817 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2386<p>Return the IArchiveDependency object for the given dependency.</p>2818<p>Return IArchivePermission for the person's queue admin
2819components.</p>
2387<table class="rst-docutils field-list" frame="void" rules="none">2820<table class="rst-docutils field-list" frame="void" rules="none">
2388<col class="field-name" />2821<col class="field-name" />
2389<col class="field-body" />2822<col class="field-body" />
2390<tbody valign="top">2823<tbody valign="top">
2391<tr class="rst-field"><th class="rst-field-name" colspan="2">param dependency:</th></tr>2824<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson.</td>
2392<tr><td>&nbsp;</td><td class="rst-field-body">is an IArchive object.</td>
2393</tr>2825</tr>
2394<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">IArchiveDependency or None if a corresponding object2826<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2395could not be found.</td>
2396</tr>2827</tr>
2397</tbody>2828</tbody>
2398</table>2829</table>
@@ -2400,55 +2831,28 @@ could not be found.</td>
2400</wadl:doc>2831</wadl:doc>
2401 <wadl:request>2832 <wadl:request>
2402 2833
2403 <wadl:param style="query" name="ws.op"2834 <wadl:param style="query" name="ws.op" required="true" fixed="getComponentsForQueueAdmin"/>
2404 required="true"2835 <wadl:param style="query" name="person" required="true">
2405 fixed="getArchiveDependency"/>
2406 <wadl:param style="query" required="true"
2407 name="dependency">
2408 2836
2409 <wadl:link resource_type="https://api.launchpad.net/1.0/#archive"/>2837 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2410 </wadl:param>2838 </wadl:param>
2411 2839
2412 </wadl:request>2840 </wadl:request>
2413 <wadl:response>2841 <wadl:response>
2414 2842
2415 <wadl:representation2843 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2416 href="https://api.launchpad.net/1.0/#archive_dependency-full"/>
2417 </wadl:response>2844 </wadl:response>
2418 </wadl:method>2845 </wadl:method>
2419 <wadl:method id="archive-getPublishedSources"2846 <wadl:method id="archive-getPermissionsForPerson" name="GET">
2420 name="GET">
2421 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2847 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2422<p>All ISourcePackagePublishingHistory target to this archive.</p>2848<p>Return the IArchivePermission records applicable to the person.</p>
2423<table class="rst-docutils field-list" frame="void" rules="none">2849<table class="rst-docutils field-list" frame="void" rules="none">
2424<col class="field-name" />2850<col class="field-name" />
2425<col class="field-body" />2851<col class="field-body" />
2426<tbody valign="top">2852<tbody valign="top">
2427<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 controlled2853<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson</td>
2428by 'exact_match' argument).
2429Name can be a single string or a list of strings.</td>
2430</tr>
2431<tr class="rst-field"><th class="rst-field-name">param version:</th><td class="rst-field-body">source version filter (always exact match).</td>
2432</tr>
2433<tr class="rst-field"><th class="rst-field-name">param status:</th><td class="rst-field-body">PackagePublishingStatus filter, can be a sequence.</td>
2434</tr>
2435<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
2436<tr><td>&nbsp;</td><td class="rst-field-body">IDistroSeries filter.</td>
2437</tr>
2438<tr class="rst-field"><th class="rst-field-name">param pocket:</th><td class="rst-field-body">PackagePublishingPocket filter. This may be an
2439iterable of more than one pocket or a single pocket.</td>
2440</tr>
2441<tr class="rst-field"><th class="rst-field-name" colspan="2">param exact_match:</th></tr>
2442<tr><td>&nbsp;</td><td class="rst-field-body">either or not filter source names by exact
2443matching.</td>
2444</tr>
2445<tr class="rst-field"><th class="rst-field-name" colspan="2">param created_since_date:</th></tr>
2446<tr><td>&nbsp;</td><td class="rst-field-body">Only return results whose date_created
2447is greater than or equal to this date.</td>
2448</tr>2854</tr>
2449<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">SelectResults containing ISourcePackagePublishingHistory,2855<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
2450ordered by name. If there are multiple results for the same
2451name then they are sub-ordered newest first.</td>
2452</tr>2856</tr>
2453</tbody>2857</tbody>
2454</table>2858</table>
@@ -2456,48 +2860,63 @@ name then they are sub-ordered newest first.</td>
2456</wadl:doc>2860</wadl:doc>
2457 <wadl:request>2861 <wadl:request>
2458 2862
2459 <wadl:param style="query" name="ws.op"2863 <wadl:param style="query" name="ws.op" required="true" fixed="getPermissionsForPerson"/>
2460 required="true"2864 <wadl:param style="query" name="person" required="true">
2461 fixed="getPublishedSources"/>2865
2462 <wadl:param style="query" required="false"2866 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2463 name="status">2867 </wadl:param>
2868
2869 </wadl:request>
2870 <wadl:response>
2871
2872 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2873 </wadl:response>
2874 </wadl:method>
2875 <wadl:method id="archive-getPublishedSources" name="GET">
2876 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2877All ISourcePackagePublishingHistory target to this archive.
2878</wadl:doc>
2879 <wadl:request>
2880
2881 <wadl:param style="query" name="ws.op" required="true" fixed="getPublishedSources"/>
2882 <wadl:param style="query" name="version" required="false">
2464 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2883 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2465<p>Package Publishing Status</p>2884Version
2466<p>The status of this publishing record</p>
2467
2468</wadl:doc>2885</wadl:doc>
2469 2886
2470 <wadl:option value="Pending"/>
2471 <wadl:option value="Published"/>
2472 <wadl:option value="Superseded"/>
2473 <wadl:option value="Deleted"/>
2474 <wadl:option value="Obsolete"/>
2475 </wadl:param>2887 </wadl:param>
2476 <wadl:param style="query" required="false"2888 <wadl:param style="query" name="source_name" required="false">
2477 name="source_name">
2478 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2889 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2479Source package name2890Source package name
2480</wadl:doc>2891</wadl:doc>
2481 2892
2482 </wadl:param>2893 </wadl:param>
2483 <wadl:param style="query" required="false"2894 <wadl:param style="query" name="distro_series" required="false">
2484 name="distro_series">
2485 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2895 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2486Distroseries name2896Distroseries name
2487</wadl:doc>2897</wadl:doc>
2488 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_series"/>2898 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
2489 </wadl:param>2899 </wadl:param>
2490 <wadl:param style="query" required="false"2900 <wadl:param style="query" name="status" required="false">
2491 name="exact_match">
2492 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2901 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2493<p>Exact Match</p>2902<p>Package Publishing Status</p>
2494<p>Whether or not to filter source names by exact matching.</p>2903<p>The status of this publishing record</p>
24952904
2496</wadl:doc>2905</wadl:doc>
2497 2906
2907 <wadl:option value="Pending"/>
2908 <wadl:option value="Published"/>
2909 <wadl:option value="Superseded"/>
2910 <wadl:option value="Deleted"/>
2911 <wadl:option value="Obsolete"/>
2912 </wadl:param>
2913 <wadl:param style="query" name="component_name" required="false">
2914 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2915Component name
2916</wadl:doc>
2917
2498 </wadl:param>2918 </wadl:param>
2499 <wadl:param style="query" required="false"2919 <wadl:param style="query" name="pocket" required="false">
2500 name="pocket">
2501 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2920 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2502<p>Pocket</p>2921<p>Pocket</p>
2503<p>The pocket into which this entry is published</p>2922<p>The pocket into which this entry is published</p>
@@ -2510,16 +2929,7 @@ Distroseries name
2510 <wadl:option value="Proposed"/>2929 <wadl:option value="Proposed"/>
2511 <wadl:option value="Backports"/>2930 <wadl:option value="Backports"/>
2512 </wadl:param>2931 </wadl:param>
2513 <wadl:param style="query" required="false"2932 <wadl:param style="query" name="created_since_date" required="false" type="xsd:dateTime">
2514 name="version">
2515 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2516Version
2517</wadl:doc>
2518
2519 </wadl:param>
2520 <wadl:param style="query" required="false"
2521 type="xsd:dateTime"
2522 name="created_since_date">
2523 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2933 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2524<p>Created Since Date</p>2934<p>Created Since Date</p>
2525<p>Return entries whose date_created is greater than or equal to this date.</p>2935<p>Return entries whose date_created is greater than or equal to this date.</p>
@@ -2527,53 +2937,19 @@ Version
2527</wadl:doc>2937</wadl:doc>
2528 2938
2529 </wadl:param>2939 </wadl:param>
2530 2940 <wadl:param style="query" name="exact_match" required="false">
2531 </wadl:request>
2532 <wadl:response>
2533
2534 <wadl:representation
2535 href="https://api.launchpad.net/1.0/#source_package_publishing_history-page"/>
2536 </wadl:response>
2537 </wadl:method>
2538 <wadl:method id="archive-getUploadersForPackageset"
2539 name="GET">
2540 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2541<p>The ArchivePermission records for uploaders to the package set.</p>
2542<table class="rst-docutils field-list" frame="void" rules="none">
2543<col class="field-name" />
2544<col class="field-body" />
2545<tbody valign="top">
2546<tr class="rst-field"><th class="rst-field-name" colspan="2">param packageset:</th></tr>
2547<tr><td>&nbsp;</td><td class="rst-field-body">An IPackageset.</td>
2548</tr>
2549<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_permissions:</th></tr>
2550<tr><td>&nbsp;</td><td class="rst-field-body">If True, only consider permissions granted
2551directly for the package set at hand. Otherwise, include any
2552uploaders for package sets that include this one.</td>
2553</tr>
2554<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for all the uploaders who are
2555authorized to upload to the named source package set.</td>
2556</tr>
2557</tbody>
2558</table>
2559
2560</wadl:doc>
2561 <wadl:request>
2562
2563 <wadl:param style="query" name="ws.op"
2564 required="true"
2565 fixed="getUploadersForPackageset"/>
2566 <wadl:param style="query" required="true"
2567 name="packageset">
2568 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2941 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2569Package set2942<p>Exact Match</p>
2943<p>Whether or not to filter source names by exact matching.</p>
2944
2570</wadl:doc>2945</wadl:doc>
2571 <wadl:link resource_type="https://api.launchpad.net/1.0/#packageset"/>2946
2572 </wadl:param>2947 </wadl:param>
2573 <wadl:param style="query" required="false"2948 <wadl:param style="query" name="order_by_date" required="false">
2574 name="direct_permissions">
2575 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2949 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2576Ignore package set hierarchy2950<p>Order by creation date</p>
2951<p>Return newest results first. This is recommended for applications that need to catch up with publications since their last run. If not specified, results are ordered by source package name (lexicographically), then by descending version and then descending ID.</p>
2952
2577</wadl:doc>2953</wadl:doc>
2578 2954
2579 </wadl:param>2955 </wadl:param>
@@ -2581,37 +2957,46 @@ Ignore package set hierarchy
2581 </wadl:request>2957 </wadl:request>
2582 <wadl:response>2958 <wadl:response>
2583 2959
2584 <wadl:representation2960 <wadl:representation href="https://api.launchpad.test/1.0/#source_package_publishing_history-page"/>
2585 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
2586 </wadl:response>2961 </wadl:response>
2587 </wadl:method>2962 </wadl:method>
2588 <wadl:method id="archive-getPackagesetsForSource"2963 <wadl:method id="archive-getPackagesetsForSourceUploader" name="GET">
2589 name="GET">
2590 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">2964 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2591<p>All package set based permissions for the given source.</p>2965<p>The package set based permissions for a given source and uploader.</p>
2592<p>This method is meant to aid the process of &quot;debugging&quot; package set2966<dl class="rst-docutils">
2593based archive permission since It allows the listing of permissions2967<dt>Return the IArchivePermission records that</dt>
2594for the given source package in this archive (irrespective of the2968<dd><ul class="rst-first rst-last rst-simple">
2595principal).</p>2969<li>apply to this archive</li>
2970<li><dl class="rst-first rst-docutils">
2971<dt>relate to</dt>
2972<dd><ul class="rst-first rst-last">
2973<li>package sets that include the given source package name</li>
2974<li>the given person</li>
2975</ul>
2976</dd>
2977</dl>
2978</li>
2979</ul>
2980</dd>
2981</dl>
2596<table class="rst-docutils field-list" frame="void" rules="none">2982<table class="rst-docutils field-list" frame="void" rules="none">
2597<col class="field-name" />2983<col class="field-name" />
2598<col class="field-body" />2984<col class="field-body" />
2599<tbody valign="top">2985<tbody valign="top">
2600<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>2986<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2601<tr><td>&nbsp;</td><td class="rst-field-body">the source package name; can be2987<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2602either a string or a ISourcePackageName.</td>2988either a string or a ISourcePackageName.</td>
2603</tr>2989</tr>
2604<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_permissions:</th></tr>2990<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
2605<tr><td>&nbsp;</td><td class="rst-field-body">If set only package sets that directly2991package sets they have access to.</td>
2606include the given source will be considered.</td>
2607</tr>2992</tr>
2608<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>2993<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2609<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the2994<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if a source package with the
2610given name could not be found.</td>2995given name could not be found.</td>
2611</tr>2996</tr>
2612<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for the package sets that2997<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for the package sets that
2613include the given source package name and apply to the2998include the given source package name and to which the given
2614archive in question.</td>2999person may upload.</td>
2615</tr>3000</tr>
2616</tbody>3001</tbody>
2617</table>3002</table>
@@ -2619,71 +3004,36 @@ archive in question.</td>
2619</wadl:doc>3004</wadl:doc>
2620 <wadl:request>3005 <wadl:request>
2621 3006
2622 <wadl:param style="query" name="ws.op"3007 <wadl:param style="query" name="ws.op" required="true" fixed="getPackagesetsForSourceUploader"/>
2623 required="true"3008 <wadl:param style="query" name="sourcepackagename" required="true">
2624 fixed="getPackagesetsForSource"/>
2625 <wadl:param style="query" required="true"
2626 name="sourcepackagename">
2627 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3009 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2628Source package name3010Source package name
2629</wadl:doc>3011</wadl:doc>
2630 3012
2631 </wadl:param>3013 </wadl:param>
2632 <wadl:param style="query" required="false"3014 <wadl:param style="query" name="person" required="true">
2633 name="direct_permissions">
2634 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2635Ignore package set hierarchy
2636</wadl:doc>
2637 3015
3016 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2638 </wadl:param>3017 </wadl:param>
2639 3018
2640 </wadl:request>3019 </wadl:request>
2641 <wadl:response>3020 <wadl:response>
2642 3021
2643 <wadl:representation3022 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2644 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
2645 </wadl:response>3023 </wadl:response>
2646 </wadl:method>3024 </wadl:method>
2647 <wadl:method id="archive-getBuildRecords" name="GET">3025 <wadl:method id="archive-getArchiveDependency" name="GET">
2648 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3026 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2649<p>Return build records in the context it is implemented.</p>3027<p>Return the IArchiveDependency object for the given dependency.</p>
2650<p>It excludes build records generated by Gina (imported from a external
2651repository), where IBuild.datebuilt is null and IBuild.buildstate
2652is BuildStatus.FULLYBUILT.</p>
2653<p>The result is simply not filtered if the optional filters are omitted
2654by call sites.</p>
2655<table class="rst-docutils field-list" frame="void" rules="none">3028<table class="rst-docutils field-list" frame="void" rules="none">
2656<col class="field-name" />3029<col class="field-name" />
2657<col class="field-body" />3030<col class="field-body" />
2658<tbody valign="top">3031<tbody valign="top">
2659<tr class="rst-field"><th class="rst-field-name" colspan="2">param build_state:</th></tr>3032<tr class="rst-field"><th class="rst-field-name" colspan="2">param dependency:</th></tr>
2660<tr><td>&nbsp;</td><td class="rst-field-body">optional BuildStatus value for filtering build3033<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">is an IArchive object.</td>
2661records;</td>
2662</tr>
2663<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.
2664Sub-string matching is allowed via SQL LIKE.</td>
2665</tr>
2666<tr class="rst-field"><th class="rst-field-name">param pocket:</th><td class="rst-field-body">optional PackagePublishingPocket value for filtering
2667build records;</td>
2668</tr>
2669<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
2670by their architecture tag;</td>
2671</tr>
2672<tr class="rst-field"><th class="rst-field-name">param user:</th><td class="rst-field-body">optional IPerson corresponding to the user performing
2673the request. It will filter out build records for which the user
2674have no 'view' permission.</td>
2675</tr>
2676<tr class="rst-field"><th class="rst-field-name" colspan="2">param binary_only:</th></tr>
2677<tr><td>&nbsp;</td><td class="rst-field-body">optional boolean indicating whether only
2678BinaryPackageBuild objects should be returned, or more general
2679PackageBuild objects (which may include, for example,
2680SourcePackageRecipeBuild objects.</td>
2681</tr>3034</tr>
2682<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">a result set containing IPackageBuild records ordered by3035<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">IArchiveDependency or None if a corresponding object
2683descending IPackageBuild.date_finished except when builds are3036could not be found.</td>
2684filtered by BuildStatus.NEEDSBUILD, in this case records
2685are ordered by descending BuildQueue.lastscore
2686(dispatching order).</td>
2687</tr>3037</tr>
2688</tbody>3038</tbody>
2689</table>3039</table>
@@ -2691,79 +3041,54 @@ are ordered by descending BuildQueue.lastscore
2691</wadl:doc>3041</wadl:doc>
2692 <wadl:request>3042 <wadl:request>
2693 3043
2694 <wadl:param style="query" name="ws.op"3044 <wadl:param style="query" name="ws.op" required="true" fixed="getArchiveDependency"/>
2695 required="true"3045 <wadl:param style="query" name="dependency" required="true">
2696 fixed="getBuildRecords"/>
2697 <wadl:param style="query" required="false"
2698 name="pocket">
2699 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2700<p>Pocket</p>
2701<p>The pocket into which this entry is published</p>
2702
2703</wadl:doc>
2704
2705 <wadl:option value="Release"/>
2706 <wadl:option value="Security"/>
2707 <wadl:option value="Updates"/>
2708 <wadl:option value="Proposed"/>
2709 <wadl:option value="Backports"/>
2710 </wadl:param>
2711 <wadl:param style="query" required="false"
2712 name="build_state">
2713 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2714<p>Build status</p>
2715<p>The status of this build record</p>
2716
2717</wadl:doc>
2718
2719 <wadl:option value="Needs building"/>
2720 <wadl:option value="Successfully built"/>
2721 <wadl:option value="Failed to build"/>
2722 <wadl:option value="Dependency wait"/>
2723 <wadl:option value="Chroot problem"/>
2724 <wadl:option value="Build for superseded Source"/>
2725 <wadl:option value="Currently building"/>
2726 <wadl:option value="Failed to upload"/>
2727 <wadl:option value="Uploading build"/>
2728 </wadl:param>
2729 <wadl:param style="query" required="false"
2730 name="source_name">
2731 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2732Source package name
2733</wadl:doc>
2734 3046
3047 <wadl:link resource_type="https://api.launchpad.test/1.0/#archive"/>
2735 </wadl:param>3048 </wadl:param>
2736 3049
2737 </wadl:request>3050 </wadl:request>
2738 <wadl:response>3051 <wadl:response>
2739 3052
2740 <wadl:representation3053 <wadl:representation href="https://api.launchpad.test/1.0/#archive_dependency-full"/>
2741 href="https://api.launchpad.net/1.0/#build-page"/>
2742 </wadl:response>3054 </wadl:response>
2743 </wadl:method>3055 </wadl:method>
2744 <wadl:method id="archive-getPublishedBinaries"3056 <wadl:method id="archive-isSourceUploadAllowed" name="GET">
2745 name="GET">
2746 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3057 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2747<p>All IBinaryPackagePublishingHistory target to this archive.</p>3058<p>True if the person is allowed to upload the given source package.</p>
3059<dl class="rst-docutils">
3060<dt>Return True if there exists a permission that combines</dt>
3061<dd><ul class="rst-first rst-last rst-simple">
3062<li>this archive</li>
3063<li>a package set that includes the given source package name</li>
3064<li>the given person or a team they are a member of</li>
3065</ul>
3066</dd>
3067</dl>
3068<p>If the source package name is included by <em>any</em> package set with
3069an explicit permission then only such explicit permissions will
3070be considered.</p>
2748<table class="rst-docutils field-list" frame="void" rules="none">3071<table class="rst-docutils field-list" frame="void" rules="none">
2749<col class="field-name" />3072<col class="field-name" />
2750<col class="field-body" />3073<col class="field-body" />
2751<tbody valign="top">3074<tbody valign="top">
2752<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 controlled3075<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2753by 'exact_match' argument).</td>3076<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2754</tr>3077either a string or a ISourcePackageName.</td>
2755<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">version: binary version filter (always exact match).</td>
2756</tr>
2757<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">status: PackagePublishingStatus filter, can be a list.</td>
2758</tr>3078</tr>
2759<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">distroarchseries: IDistroArchSeries filter, can be a list.</td>3079<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
3080package sets they have access to.</td>
2760</tr>3081</tr>
2761<tr class="rst-field"><th class="rst-field-name">param:</th><td class="rst-field-body">pocket: PackagePublishingPocket filter.</td>3082<tr class="rst-field"><th class="rst-field-name" colspan="2">param distroseries:</th></tr>
3083<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">The IDistroSeries for which to check
3084permissions. If none is supplied then currentseries in
3085the archive's distribution is assumed.</td>
2762</tr>3086</tr>
2763<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 exact3087<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
2764matching.</td>3088<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if a source package with the
3089given name could not be found.</td>
2765</tr>3090</tr>
2766<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A collection containing BinaryPackagePublishingHistory.</td>3091<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>
2767</tr>3092</tr>
2768</tbody>3093</tbody>
2769</table>3094</table>
@@ -2771,86 +3096,86 @@ matching.</td>
2771</wadl:doc>3096</wadl:doc>
2772 <wadl:request>3097 <wadl:request>
2773 3098
2774 <wadl:param style="query" name="ws.op"3099 <wadl:param style="query" name="ws.op" required="true" fixed="isSourceUploadAllowed"/>
2775 required="true"3100 <wadl:param style="query" name="distroseries" required="false">
2776 fixed="getPublishedBinaries"/>
2777 <wadl:param style="query" required="false"
2778 name="status">
2779 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3101 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2780<p>Package Publishing Status</p>3102The distro series
2781<p>The status of this publishing record</p>
2782
2783</wadl:doc>3103</wadl:doc>
2784 3104 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
2785 <wadl:option value="Pending"/>
2786 <wadl:option value="Published"/>
2787 <wadl:option value="Superseded"/>
2788 <wadl:option value="Deleted"/>
2789 <wadl:option value="Obsolete"/>
2790 </wadl:param>3105 </wadl:param>
2791 <wadl:param style="query" required="false"3106 <wadl:param style="query" name="person" required="true">
2792 name="binary_name">
2793 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2794Binary Package Name
2795</wadl:doc>
2796 3107
3108 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2797 </wadl:param>3109 </wadl:param>
2798 <wadl:param style="query" required="false"3110 <wadl:param style="query" name="sourcepackagename" required="true">
2799 name="exact_match">
2800 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3111 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2801Whether or not to filter binary names by exact matching.3112Source package name
2802</wadl:doc>3113</wadl:doc>
2803 3114
2804 </wadl:param>3115 </wadl:param>
2805 <wadl:param style="query" required="false"3116
2806 name="pocket">3117 </wadl:request>
2807 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3118
2808<p>Pocket</p>3119 </wadl:method>
2809<p>The pocket into which this entry is published</p>3120 <wadl:method id="archive-getUploadersForComponent" name="GET">
3121 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3122<p>Return IArchivePermission records for the component's uploaders.</p>
3123<table class="rst-docutils field-list" frame="void" rules="none">
3124<col class="field-name" />
3125<col class="field-body" />
3126<tbody valign="top">
3127<tr class="rst-field"><th class="rst-field-name" colspan="2">param component_name:</th></tr>
3128<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual name for the
3129component.</td>
3130</tr>
3131<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
3132</tr>
3133</tbody>
3134</table>
28103135
2811</wadl:doc>3136</wadl:doc>
2812 3137 <wadl:request>
2813 <wadl:option value="Release"/>3138
2814 <wadl:option value="Security"/>3139 <wadl:param style="query" name="ws.op" required="true" fixed="getUploadersForComponent"/>
2815 <wadl:option value="Updates"/>3140 <wadl:param style="query" name="component_name" required="false">
2816 <wadl:option value="Proposed"/>
2817 <wadl:option value="Backports"/>
2818 </wadl:param>
2819 <wadl:param style="query" required="false"
2820 name="version">
2821 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3141 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2822Version3142Component Name
2823</wadl:doc>3143</wadl:doc>
2824 3144
2825 </wadl:param>3145 </wadl:param>
2826 <wadl:param style="query" required="false"
2827 name="distro_arch_series">
2828 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2829Distro Arch Series
2830</wadl:doc>
2831 <wadl:link resource_type="https://api.launchpad.net/1.0/#distro_arch_series"/>
2832 </wadl:param>
2833 3146
2834 </wadl:request>3147 </wadl:request>
2835 <wadl:response>3148 <wadl:response>
2836 3149
2837 <wadl:representation3150 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2838 href="https://api.launchpad.net/1.0/#binary_package_publishing_history-page"/>
2839 </wadl:response>3151 </wadl:response>
2840 </wadl:method>3152 </wadl:method>
2841 <wadl:method id="archive-getUploadersForComponent"3153 <wadl:method id="archive-getPackagesetsForSource" name="GET">
2842 name="GET">
2843 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3154 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2844<p>Return IArchivePermission records for the component's uploaders.</p>3155<p>All package set based permissions for the given source.</p>
3156<p>This method is meant to aid the process of &quot;debugging&quot; package set
3157based archive permission since It allows the listing of permissions
3158for the given source package in this archive (irrespective of the
3159principal).</p>
2845<table class="rst-docutils field-list" frame="void" rules="none">3160<table class="rst-docutils field-list" frame="void" rules="none">
2846<col class="field-name" />3161<col class="field-name" />
2847<col class="field-body" />3162<col class="field-body" />
2848<tbody valign="top">3163<tbody valign="top">
2849<tr class="rst-field"><th class="rst-field-name" colspan="2">param component_name:</th></tr>3164<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
2850<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual name for the3165<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
2851component.</td>3166either a string or a ISourcePackageName.</td>
2852</tr>3167</tr>
2853<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>3168<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_permissions:</th></tr>
3169<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">If set only package sets that directly
3170include the given source will be considered.</td>
3171</tr>
3172<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
3173<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">if a source package with the
3174given name could not be found.</td>
3175</tr>
3176<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for the package sets that
3177include the given source package name and apply to the
3178archive in question.</td>
2854</tr>3179</tr>
2855</tbody>3180</tbody>
2856</table>3181</table>
@@ -2858,13 +3183,16 @@ component.</td>
2858</wadl:doc>3183</wadl:doc>
2859 <wadl:request>3184 <wadl:request>
2860 3185
2861 <wadl:param style="query" name="ws.op"3186 <wadl:param style="query" name="ws.op" required="true" fixed="getPackagesetsForSource"/>
2862 required="true"3187 <wadl:param style="query" name="sourcepackagename" required="true">
2863 fixed="getUploadersForComponent"/>
2864 <wadl:param style="query" required="false"
2865 name="component_name">
2866 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3188 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2867Component Name3189Source package name
3190</wadl:doc>
3191
3192 </wadl:param>
3193 <wadl:param style="query" name="direct_permissions" required="false">
3194 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3195Ignore package set hierarchy
2868</wadl:doc>3196</wadl:doc>
2869 3197
2870 </wadl:param>3198 </wadl:param>
@@ -2872,23 +3200,26 @@ Component Name
2872 </wadl:request>3200 </wadl:request>
2873 <wadl:response>3201 <wadl:response>
2874 3202
2875 <wadl:representation3203 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2876 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
2877 </wadl:response>3204 </wadl:response>
2878 </wadl:method>3205 </wadl:method>
2879 <wadl:method id="archive-getUploadersForPackage"3206 <wadl:method id="archive-getUploadersForPackageset" name="GET">
2880 name="GET">
2881 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3207 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2882<p>Return IArchivePermission records for the package's uploaders.</p>3208<p>The ArchivePermission records for uploaders to the package set.</p>
2883<table class="rst-docutils field-list" frame="void" rules="none">3209<table class="rst-docutils field-list" frame="void" rules="none">
2884<col class="field-name" />3210<col class="field-name" />
2885<col class="field-body" />3211<col class="field-body" />
2886<tbody valign="top">3212<tbody valign="top">
2887<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_package_name:</th></tr>3213<tr class="rst-field"><th class="rst-field-name" colspan="2">param packageset:</th></tr>
2888<tr><td>&nbsp;</td><td class="rst-field-body">An ISourcePackageName or textual name3214<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">An IPackageset.</td>
2889for the source package.</td>
2890</tr>3215</tr>
2891<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>3216<tr class="rst-field"><th class="rst-field-name" colspan="2">param direct_permissions:</th></tr>
3217<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">If True, only consider permissions granted
3218directly for the package set at hand. Otherwise, include any
3219uploaders for package sets that include this one.</td>
3220</tr>
3221<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for all the uploaders who are
3222authorized to upload to the named source package set.</td>
2892</tr>3223</tr>
2893</tbody>3224</tbody>
2894</table>3225</table>
@@ -2896,13 +3227,16 @@ for the source package.</td>
2896</wadl:doc>3227</wadl:doc>
2897 <wadl:request>3228 <wadl:request>
2898 3229
2899 <wadl:param style="query" name="ws.op"3230 <wadl:param style="query" name="ws.op" required="true" fixed="getUploadersForPackageset"/>
2900 required="true"3231 <wadl:param style="query" name="packageset" required="true">
2901 fixed="getUploadersForPackage"/>
2902 <wadl:param style="query" required="true"
2903 name="source_package_name">
2904 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3232 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2905Source Package Name3233Package set
3234</wadl:doc>
3235 <wadl:link resource_type="https://api.launchpad.test/1.0/#packageset"/>
3236 </wadl:param>
3237 <wadl:param style="query" name="direct_permissions" required="false">
3238 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3239Ignore package set hierarchy
2906</wadl:doc>3240</wadl:doc>
2907 3241
2908 </wadl:param>3242 </wadl:param>
@@ -2910,12 +3244,10 @@ Source Package Name
2910 </wadl:request>3244 </wadl:request>
2911 <wadl:response>3245 <wadl:response>
2912 3246
2913 <wadl:representation3247 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2914 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
2915 </wadl:response>3248 </wadl:response>
2916 </wadl:method>3249 </wadl:method>
2917 <wadl:method id="archive-getBuildSummariesForSourceIds"3250 <wadl:method id="archive-getBuildSummariesForSourceIds" name="GET">
2918 name="GET">
2919 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3251 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2920<p>Return a dictionary containing a summary of the build statuses.</p>3252<p>Return a dictionary containing a summary of the build statuses.</p>
2921<p>Only information for sources belonging to the current archive will3253<p>Only information for sources belonging to the current archive will
@@ -2927,10 +3259,10 @@ details.</p>
2927<col class="field-body" />3259<col class="field-body" />
2928<tbody valign="top">3260<tbody valign="top">
2929<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_ids:</th></tr>3261<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_ids:</th></tr>
2930<tr><td>&nbsp;</td><td class="rst-field-body">A list of source publishing history record ids.</td>3262<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">A list of source publishing history record ids.</td>
2931</tr>3263</tr>
2932<tr class="rst-field"><th class="rst-field-name" colspan="2">type source_ids:</th></tr>3264<tr class="rst-field"><th class="rst-field-name" colspan="2">type source_ids:</th></tr>
2933<tr><td>&nbsp;</td><td class="rst-field-body"><tt class="rst-docutils literal"><span class="pre">list</span></tt></td>3265<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body"><tt class="rst-docutils literal">list</tt></td>
2934</tr>3266</tr>
2935<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 the3267<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
2936given ids that belong in the archive.</td>3268given ids that belong in the archive.</td>
@@ -2941,11 +3273,8 @@ given ids that belong in the archive.</td>
2941</wadl:doc>3273</wadl:doc>
2942 <wadl:request>3274 <wadl:request>
2943 3275
2944 <wadl:param style="query" name="ws.op"3276 <wadl:param style="query" name="ws.op" required="true" fixed="getBuildSummariesForSourceIds"/>
2945 required="true"3277 <wadl:param style="query" name="source_ids" required="true">
2946 fixed="getBuildSummariesForSourceIds"/>
2947 <wadl:param style="query" required="true"
2948 name="source_ids">
2949 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3278 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2950A list of source publishing history record ids.3279A list of source publishing history record ids.
2951</wadl:doc>3280</wadl:doc>
@@ -2955,19 +3284,18 @@ A list of source publishing history record ids.
2955 </wadl:request>3284 </wadl:request>
2956 3285
2957 </wadl:method>3286 </wadl:method>
2958 <wadl:method id="archive-getQueueAdminsForComponent"3287 <wadl:method id="archive-getPackagesetsForUploader" name="GET">
2959 name="GET">
2960 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3288 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2961<p>Return IArchivePermission records for authorised queue admins.</p>3289<p>The ArchivePermission records for the person's package sets.</p>
2962<table class="rst-docutils field-list" frame="void" rules="none">3290<table class="rst-docutils field-list" frame="void" rules="none">
2963<col class="field-name" />3291<col class="field-name" />
2964<col class="field-body" />3292<col class="field-body" />
2965<tbody valign="top">3293<tbody valign="top">
2966<tr class="rst-field"><th class="rst-field-name" colspan="2">param component_name:</th></tr>3294<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
2967<tr><td>&nbsp;</td><td class="rst-field-body">An IComponent or textual name for the3295package sets they have access to.</td>
2968component.</td>
2969</tr>3296</tr>
2970<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>3297<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for all the package sets that
3298'person' is allowed to upload to.</td>
2971</tr>3299</tr>
2972</tbody>3300</tbody>
2973</table>3301</table>
@@ -2975,33 +3303,28 @@ component.</td>
2975</wadl:doc>3303</wadl:doc>
2976 <wadl:request>3304 <wadl:request>
2977 3305
2978 <wadl:param style="query" name="ws.op"3306 <wadl:param style="query" name="ws.op" required="true" fixed="getPackagesetsForUploader"/>
2979 required="true"3307 <wadl:param style="query" name="person" required="true">
2980 fixed="getQueueAdminsForComponent"/>
2981 <wadl:param style="query" required="true"
2982 name="component_name">
2983 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2984Component Name
2985</wadl:doc>
2986 3308
3309 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
2987 </wadl:param>3310 </wadl:param>
2988 3311
2989 </wadl:request>3312 </wadl:request>
2990 <wadl:response>3313 <wadl:response>
2991 3314
2992 <wadl:representation3315 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
2993 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
2994 </wadl:response>3316 </wadl:response>
2995 </wadl:method>3317 </wadl:method>
2996 <wadl:method id="archive-getPermissionsForPerson"3318 <wadl:method id="archive-getUploadersForPackage" name="GET">
2997 name="GET">
2998 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3319 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
2999<p>Return the IArchivePermission records applicable to the person.</p>3320<p>Return IArchivePermission records for the package's uploaders.</p>
3000<table class="rst-docutils field-list" frame="void" rules="none">3321<table class="rst-docutils field-list" frame="void" rules="none">
3001<col class="field-name" />3322<col class="field-name" />
3002<col class="field-body" />3323<col class="field-body" />
3003<tbody valign="top">3324<tbody valign="top">
3004<tr class="rst-field"><th class="rst-field-name">param person:</th><td class="rst-field-body">An IPerson</td>3325<tr class="rst-field"><th class="rst-field-name" colspan="2">param source_package_name:</th></tr>
3326<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">An ISourcePackageName or textual name
3327for the source package.</td>
3005</tr>3328</tr>
3006<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>3329<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">A list of IArchivePermission records.</td>
3007</tr>3330</tr>
@@ -3011,104 +3334,104 @@ Component Name
3011</wadl:doc>3334</wadl:doc>
3012 <wadl:request>3335 <wadl:request>
3013 3336
3014 <wadl:param style="query" name="ws.op"3337 <wadl:param style="query" name="ws.op" required="true" fixed="getUploadersForPackage"/>
3015 required="true"3338 <wadl:param style="query" name="source_package_name" required="true">
3016 fixed="getPermissionsForPerson"/>3339 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3017 <wadl:param style="query" required="true"3340Source Package Name
3018 name="person">3341</wadl:doc>
3019 3342
3020 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>
3021 </wadl:param>3343 </wadl:param>
3022 3344
3023 </wadl:request>3345 </wadl:request>
3024 <wadl:response>3346 <wadl:response>
3025 3347
3026 <wadl:representation3348 <wadl:representation href="https://api.launchpad.test/1.0/#archive_permission-page"/>
3027 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
3028 </wadl:response>3349 </wadl:response>
3029 </wadl:method>3350 </wadl:method>
3030 <wadl:method id="archive-getPackagesetsForSourceUploader"3351 <wadl:method id="archive-checkUpload" name="GET">
3031 name="GET">
3032 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3352 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3033<p>The package set based permissions for a given source and uploader.</p>3353Wrapper around checkUpload for the web service API.
3034<dl class="rst-docutils">
3035<dt>Return the IArchivePermission records that</dt>
3036<dd><ul class="rst-first rst-last">
3037<li><p class="rst-first">apply to this archive</p>
3038</li>
3039<li><dl class="rst-first rst-docutils">
3040<dt>relate to</dt>
3041<dd><ul class="rst-first rst-last rst-simple">
3042<li>package sets that include the given source package name</li>
3043<li>the given person</li>
3044</ul>
3045</dd>
3046</dl>
3047</li>
3048</ul>
3049</dd>
3050</dl>
3051<table class="rst-docutils field-list" frame="void" rules="none">
3052<col class="field-name" />
3053<col class="field-body" />
3054<tbody valign="top">
3055<tr class="rst-field"><th class="rst-field-name" colspan="2">param sourcepackagename:</th></tr>
3056<tr><td>&nbsp;</td><td class="rst-field-body">the source package name; can be
3057either a string or a ISourcePackageName.</td>
3058</tr>
3059<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
3060package sets he has access to.</td>
3061</tr>
3062<tr class="rst-field"><th class="rst-field-name" colspan="2">raises NoSuchSourcePackageName:</th></tr>
3063<tr><td>&nbsp;</td><td class="rst-field-body">if a source package with the
3064given name could not be found.</td>
3065</tr>
3066<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for the package sets that
3067include the given source package name and to which the given
3068person may upload.</td>
3069</tr>
3070</tbody>
3071</table>
3072
3073</wadl:doc>3354</wadl:doc>
3074 <wadl:request>3355 <wadl:request>
3075 3356
3076 <wadl:param style="query" name="ws.op"3357 <wadl:param style="query" name="ws.op" required="true" fixed="checkUpload"/>
3077 required="true"3358 <wadl:param style="query" name="distroseries" required="true">
3078 fixed="getPackagesetsForSourceUploader"/>3359 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3079 <wadl:param style="query" required="true"3360The distro series
3080 name="person">3361</wadl:doc>
3362 <wadl:link resource_type="https://api.launchpad.test/1.0/#distro_series"/>
3363 </wadl:param>
3364 <wadl:param style="query" name="component" required="true">
3365 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3366Component
3367</wadl:doc>
3081 3368
3082 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>
3083 </wadl:param>3369 </wadl:param>
3084 <wadl:param style="query" required="true"3370 <wadl:param style="query" name="strict_component" required="false">
3085 name="sourcepackagename">
3086 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3371 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3087Source package name3372Strict component
3088</wadl:doc>3373</wadl:doc>
3089 3374
3090 </wadl:param>3375 </wadl:param>
3091 3376 <wadl:param style="query" name="pocket" required="true">
3092 </wadl:request>3377 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3093 <wadl:response>3378<p>Pocket</p>
3094 3379<p>The pocket into which this entry is published</p>
3095 <wadl:representation3380
3096 href="https://api.launchpad.net/1.0/#archive_permission-page"/>3381</wadl:doc>
3097 </wadl:response>3382
3383 <wadl:option value="Release"/>
3384 <wadl:option value="Security"/>
3385 <wadl:option value="Updates"/>
3386 <wadl:option value="Proposed"/>
3387 <wadl:option value="Backports"/>
3388 </wadl:param>
3389 <wadl:param style="query" name="sourcepackagename" required="true">
3390 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3391Source package name
3392</wadl:doc>
3393
3394 </wadl:param>
3395 <wadl:param style="query" name="person" required="true">
3396
3397 <wadl:link resource_type="https://api.launchpad.test/1.0/#person"/>
3398 </wadl:param>
3399
3400 </wadl:request>
3401
3098 </wadl:method>3402 </wadl:method>
3099 <wadl:method id="archive-getPackagesetsForUploader"3403 <wadl:method id="archive-getBuildCounters" name="GET">
3100 name="GET">
3101 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">3404 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3102<p>The ArchivePermission records for the person's package sets.</p>3405<p>Return a dictionary containing the build counters for an archive.</p>
3406<p>This is necessary currently because the IArchive.failed_builds etc.
3407counters are not in use.</p>
3408<p>The returned dictionary contains the follwoing keys and values:</p>
3409<blockquote>
3410<ul class="rst-simple">
3411<li>'total': total number of builds (includes SUPERSEDED);</li>
3412<li>'pending': number of builds in BUILDING or NEEDSBUILD state;</li>
3413<li>'failed': number of builds in FAILEDTOBUILD, MANUALDEPWAIT,
3414CHROOTWAIT and FAILEDTOUPLOAD state;</li>
3415<li>'succeeded': number of SUCCESSFULLYBUILT builds.</li>
3416<li>'superseded': number of SUPERSEDED builds.</li>
3417</ul>
3418</blockquote>
3103<table class="rst-docutils field-list" frame="void" rules="none">3419<table class="rst-docutils field-list" frame="void" rules="none">
3104<col class="field-name" />3420<col class="field-name" />
3105<col class="field-body" />3421<col class="field-body" />
3106<tbody valign="top">3422<tbody valign="top">
3107<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 which3423<tr class="rst-field"><th class="rst-field-name" colspan="2">param include_needsbuild:</th></tr>
3108package sets he has access to.</td>3424<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body">Indicates whether to include builds with
3425the status NEEDSBUILD in the pending and total counts. This is
3426useful in situations where a build that hasn't started isn't
3427considered a build by the user.</td>
3109</tr>3428</tr>
3110<tr class="rst-field"><th class="rst-field-name">return:</th><td class="rst-field-body">ArchivePermission records for all the package sets that3429<tr class="rst-field"><th class="rst-field-name" colspan="2">type include_needsbuild:</th></tr>
3111'person' is allowed to upload to.</td>3430<tr class="rst-field"><td>&nbsp;</td><td class="rst-field-body"><tt class="rst-docutils literal">bool</tt></td>
3431</tr>
3432<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>
3433</tr>
3434<tr class="rst-field"><th class="rst-field-name">rtype:</th><td class="rst-field-body"><tt class="rst-docutils literal">dict</tt>.</td>
3112</tr>3435</tr>
3113</tbody>3436</tbody>
3114</table>3437</table>
@@ -3116,118 +3439,49 @@ package sets he has access to.</td>
3116</wadl:doc>3439</wadl:doc>
3117 <wadl:request>3440 <wadl:request>
3118 3441
3119 <wadl:param style="query" name="ws.op"3442 <wadl:param style="query" name="ws.op" required="true" fixed="getBuildCounters"/>
3120 required="true"3443 <wadl:param style="query" name="include_needsbuild" required="false">
3121 fixed="getPackagesetsForUploader"/>3444 <wadl:doc xmlns="http://www.w3.org/1999/xhtml">
3122 <wadl:param style="query" required="true"3445Include builds with state NEEDSBUILD
3123 name="person">3446</wadl:doc>
3124 3447
3125 <wadl:link resource_type="https://api.launchpad.net/1.0/#person"/>
3126 </wadl:param>3448 </wadl:param>
3127 3449
3128 </wadl:request>3450 </wadl:request>
3129 <wadl:response>3451
3130
3131 <wadl:representation
3132 href="https://api.launchpad.net/1.0/#archive_permission-page"/>
3133 </wadl:response>
3134 </wadl:method>3452 </wadl:method>
3135 <wadl:method id="archive-syncSource" name="POST">3453 <wadl:method id="archive-getQueueAdminsForComponent" name="GET">
The diff has been truncated for viewing.

Subscribers

People subscribed via source and target branches