blob: fdc317783393b962769ac4ea8004f5ef24e32ed0 [file] [log] [blame]
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -07001#
2# Copyright (C) 2008 The Android Open Source Project
3#
4# Licensed under the Apache License, Version 2.0 (the "License");
5# you may not use this file except in compliance with the License.
6# You may obtain a copy of the License at
7#
8# http://www.apache.org/licenses/LICENSE-2.0
9#
10# Unless required by applicable law or agreed to in writing, software
11# distributed under the License is distributed on an "AS IS" BASIS,
12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13# See the License for the specific language governing permissions and
14# limitations under the License.
15
Sarah Owenscecd1d82012-11-01 22:59:27 -070016from __future__ import print_function
Colin Cross23acdd32012-04-21 00:33:54 -070017import itertools
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070018import os
Conley Owensdb728cd2011-09-26 16:34:01 -070019import re
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070020import sys
David Pursehouse59bbb582013-05-17 10:49:33 +090021import xml.dom.minidom
22
23from pyversion import is_python3
24if is_python3():
Chirayu Desai217ea7d2013-03-01 19:14:38 +053025 import urllib.parse
David Pursehouse59bbb582013-05-17 10:49:33 +090026else:
Chirayu Desai217ea7d2013-03-01 19:14:38 +053027 import imp
28 import urlparse
29 urllib = imp.new_module('urllib')
Chirayu Desaidb2ad9d2013-06-11 13:42:25 +053030 urllib.parse = urlparse
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070031
David Pursehousee15c65a2012-08-22 10:46:11 +090032from git_config import GitConfig
David Pursehousee00aa6b2012-09-11 14:33:51 +090033from git_refs import R_HEADS, HEAD
34from project import RemoteSpec, Project, MetaProject
Julien Camperguedd654222014-01-09 16:21:37 +010035from error import ManifestParseError, ManifestInvalidRevisionError
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070036
37MANIFEST_FILE_NAME = 'manifest.xml'
Shawn O. Pearce5cc66792008-10-23 16:19:27 -070038LOCAL_MANIFEST_NAME = 'local_manifest.xml'
David Pursehouse2d5a0df2012-11-13 02:50:36 +090039LOCAL_MANIFESTS_DIR_NAME = 'local_manifests'
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070040
Chirayu Desai217ea7d2013-03-01 19:14:38 +053041urllib.parse.uses_relative.extend(['ssh', 'git'])
42urllib.parse.uses_netloc.extend(['ssh', 'git'])
Conley Owensdb728cd2011-09-26 16:34:01 -070043
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070044class _Default(object):
45 """Project defaults within the manifest."""
46
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -070047 revisionExpr = None
Conley Owensb6a16e62013-09-25 15:06:09 -070048 destBranchExpr = None
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070049 remote = None
Shawn O. Pearce6392c872011-09-22 17:44:31 -070050 sync_j = 1
Anatol Pomazau79770d22012-04-20 14:41:59 -070051 sync_c = False
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +080052 sync_s = False
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -070053
Julien Campergue74879922013-10-09 14:38:46 +020054 def __eq__(self, other):
55 return self.__dict__ == other.__dict__
56
57 def __ne__(self, other):
58 return self.__dict__ != other.__dict__
59
Shawn O. Pearced1f70d92009-05-19 14:58:02 -070060class _XmlRemote(object):
61 def __init__(self,
62 name,
Yestin Sunb292b982012-07-02 07:32:50 -070063 alias=None,
Shawn O. Pearced1f70d92009-05-19 14:58:02 -070064 fetch=None,
Conley Owensdb728cd2011-09-26 16:34:01 -070065 manifestUrl=None,
Anthony King36ea2fb2014-05-06 11:54:01 +010066 review=None,
67 revision=None):
Shawn O. Pearced1f70d92009-05-19 14:58:02 -070068 self.name = name
69 self.fetchUrl = fetch
Conley Owensdb728cd2011-09-26 16:34:01 -070070 self.manifestUrl = manifestUrl
Yestin Sunb292b982012-07-02 07:32:50 -070071 self.remoteAlias = alias
Shawn O. Pearced1f70d92009-05-19 14:58:02 -070072 self.reviewUrl = review
Anthony King36ea2fb2014-05-06 11:54:01 +010073 self.revision = revision
Conley Owensceea3682011-10-20 10:45:47 -070074 self.resolvedFetchUrl = self._resolveFetchUrl()
Shawn O. Pearced1f70d92009-05-19 14:58:02 -070075
David Pursehouse717ece92012-11-13 08:49:16 +090076 def __eq__(self, other):
77 return self.__dict__ == other.__dict__
78
79 def __ne__(self, other):
80 return self.__dict__ != other.__dict__
81
Conley Owensceea3682011-10-20 10:45:47 -070082 def _resolveFetchUrl(self):
83 url = self.fetchUrl.rstrip('/')
Conley Owensdb728cd2011-09-26 16:34:01 -070084 manifestUrl = self.manifestUrl.rstrip('/')
Conley Owens2d0f5082014-01-31 15:03:51 -080085 # urljoin will gets confused over quite a few things. The ones we care
86 # about here are:
87 # * no scheme in the base url, like <hostname:port>
88 # * persistent-https://
89 # We handle this by replacing these with obscure protocols
90 # and then replacing them with the original when we are done.
91 # gopher -> <none>
92 # wais -> persistent-https
Conley Owensdb728cd2011-09-26 16:34:01 -070093 if manifestUrl.find(':') != manifestUrl.find('/') - 1:
David Pursehousec1b86a22012-11-14 11:36:51 +090094 manifestUrl = 'gopher://' + manifestUrl
Conley Owens2d0f5082014-01-31 15:03:51 -080095 manifestUrl = re.sub(r'^persistent-https://', 'wais://', manifestUrl)
Chirayu Desai217ea7d2013-03-01 19:14:38 +053096 url = urllib.parse.urljoin(manifestUrl, url)
Shawn Pearcea9f11b32013-01-02 15:40:48 -080097 url = re.sub(r'^gopher://', '', url)
Conley Owens2d0f5082014-01-31 15:03:51 -080098 url = re.sub(r'^wais://', 'persistent-https://', url)
Shawn Pearcea9f11b32013-01-02 15:40:48 -080099 return url
Conley Owensceea3682011-10-20 10:45:47 -0700100
101 def ToRemoteSpec(self, projectName):
Conley Owens9d8f9142011-10-20 14:36:35 -0700102 url = self.resolvedFetchUrl.rstrip('/') + '/' + projectName
Yestin Sunb292b982012-07-02 07:32:50 -0700103 remoteName = self.name
Conley Owens1e7ab2a2013-10-08 17:26:57 -0700104 if self.remoteAlias:
David Pursehouse37128b62013-10-15 10:48:40 +0900105 remoteName = self.remoteAlias
Yestin Sunb292b982012-07-02 07:32:50 -0700106 return RemoteSpec(remoteName, url, self.reviewUrl)
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700107
Shawn O. Pearcec8a300f2009-05-18 13:19:57 -0700108class XmlManifest(object):
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700109 """manages the repo configuration file"""
110
111 def __init__(self, repodir):
112 self.repodir = os.path.abspath(repodir)
113 self.topdir = os.path.dirname(self.repodir)
114 self.manifestFile = os.path.join(self.repodir, MANIFEST_FILE_NAME)
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700115 self.globalConfig = GitConfig.ForUser()
David Pursehouse4eb285c2013-02-14 16:28:44 +0900116 self.localManifestWarning = False
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700117
118 self.repoProject = MetaProject(self, 'repo',
119 gitdir = os.path.join(repodir, 'repo/.git'),
120 worktree = os.path.join(repodir, 'repo'))
121
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700122 self.manifestProject = MetaProject(self, 'manifests',
Shawn O. Pearcef5c25a62008-11-04 08:11:53 -0800123 gitdir = os.path.join(repodir, 'manifests.git'),
124 worktree = os.path.join(repodir, 'manifests'))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700125
126 self._Unload()
127
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700128 def Override(self, name):
129 """Use a different manifest, just for the current instantiation.
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700130 """
131 path = os.path.join(self.manifestProject.worktree, name)
132 if not os.path.isfile(path):
133 raise ManifestParseError('manifest %s not found' % name)
134
135 old = self.manifestFile
136 try:
137 self.manifestFile = path
138 self._Unload()
139 self._Load()
140 finally:
141 self.manifestFile = old
142
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700143 def Link(self, name):
144 """Update the repo metadata to use a different manifest.
145 """
146 self.Override(name)
147
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700148 try:
Sebastian Frias223bf962012-11-21 19:09:25 +0100149 if os.path.lexists(self.manifestFile):
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700150 os.remove(self.manifestFile)
151 os.symlink('manifests/%s' % name, self.manifestFile)
Sebastian Frias223bf962012-11-21 19:09:25 +0100152 except OSError as e:
153 raise ManifestParseError('cannot link manifest %s: %s' % (name, str(e)))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700154
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800155 def _RemoteToXml(self, r, doc, root):
156 e = doc.createElement('remote')
157 root.appendChild(e)
158 e.setAttribute('name', r.name)
159 e.setAttribute('fetch', r.fetchUrl)
Conley Owens1e7ab2a2013-10-08 17:26:57 -0700160 if r.remoteAlias is not None:
161 e.setAttribute('alias', r.remoteAlias)
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800162 if r.reviewUrl is not None:
163 e.setAttribute('review', r.reviewUrl)
Anthony King36ea2fb2014-05-06 11:54:01 +0100164 if r.revision is not None:
165 e.setAttribute('revision', r.revision)
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800166
Brian Harring14a66742012-09-28 20:21:57 -0700167 def Save(self, fd, peg_rev=False, peg_rev_upstream=True):
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800168 """Write the current manifest out to the given file descriptor.
169 """
Colin Cross5acde752012-03-28 20:15:45 -0700170 mp = self.manifestProject
171
172 groups = mp.config.GetString('manifest.groups')
Matt Gumbel0c635bb2012-12-21 10:14:53 -0800173 if groups:
174 groups = [x for x in re.split(r'[,\s]+', groups) if x]
Colin Cross5acde752012-03-28 20:15:45 -0700175
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800176 doc = xml.dom.minidom.Document()
177 root = doc.createElement('manifest')
178 doc.appendChild(root)
179
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700180 # Save out the notice. There's a little bit of work here to give it the
181 # right whitespace, which assumes that the notice is automatically indented
182 # by 4 by minidom.
183 if self.notice:
184 notice_element = root.appendChild(doc.createElement('notice'))
185 notice_lines = self.notice.splitlines()
186 indented_notice = ('\n'.join(" "*4 + line for line in notice_lines))[4:]
187 notice_element.appendChild(doc.createTextNode(indented_notice))
188
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800189 d = self.default
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800190
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530191 for r in sorted(self.remotes):
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800192 self._RemoteToXml(self.remotes[r], doc, root)
193 if self.remotes:
194 root.appendChild(doc.createTextNode(''))
195
196 have_default = False
197 e = doc.createElement('default')
198 if d.remote:
199 have_default = True
200 e.setAttribute('remote', d.remote.name)
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -0700201 if d.revisionExpr:
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800202 have_default = True
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -0700203 e.setAttribute('revision', d.revisionExpr)
Shawn O. Pearce6392c872011-09-22 17:44:31 -0700204 if d.sync_j > 1:
205 have_default = True
206 e.setAttribute('sync-j', '%d' % d.sync_j)
Anatol Pomazau79770d22012-04-20 14:41:59 -0700207 if d.sync_c:
208 have_default = True
209 e.setAttribute('sync-c', 'true')
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800210 if d.sync_s:
211 have_default = True
212 e.setAttribute('sync-s', 'true')
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800213 if have_default:
214 root.appendChild(e)
215 root.appendChild(doc.createTextNode(''))
216
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700217 if self._manifest_server:
218 e = doc.createElement('manifest-server')
219 e.setAttribute('url', self._manifest_server)
220 root.appendChild(e)
221 root.appendChild(doc.createTextNode(''))
222
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800223 def output_projects(parent, parent_node, projects):
David James8d201162013-10-11 17:03:19 -0700224 for project_name in projects:
225 for project in self._projects[project_name]:
226 output_project(parent, parent_node, project)
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800227
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800228 def output_project(parent, parent_node, p):
Colin Cross5acde752012-03-28 20:15:45 -0700229 if not p.MatchesGroups(groups):
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800230 return
231
232 name = p.name
233 relpath = p.relpath
234 if parent:
235 name = self._UnjoinName(parent.name, name)
236 relpath = self._UnjoinRelpath(parent.relpath, relpath)
Colin Cross5acde752012-03-28 20:15:45 -0700237
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800238 e = doc.createElement('project')
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800239 parent_node.appendChild(e)
240 e.setAttribute('name', name)
241 if relpath != name:
242 e.setAttribute('path', relpath)
Conley Owensa17d7af2013-10-16 14:38:09 -0700243 remoteName = None
244 if d.remote:
Conley Owensce201a52013-10-16 14:42:42 -0700245 remoteName = d.remote.remoteAlias or d.remote.name
Conley Owens1e7ab2a2013-10-08 17:26:57 -0700246 if not d.remote or p.remote.name != remoteName:
Anthony King36ea2fb2014-05-06 11:54:01 +0100247 remoteName = p.remote.name
248 e.setAttribute('remote', remoteName)
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800249 if peg_rev:
250 if self.IsMirror:
Brian Harring14a66742012-09-28 20:21:57 -0700251 value = p.bare_git.rev_parse(p.revisionExpr + '^0')
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800252 else:
Brian Harring14a66742012-09-28 20:21:57 -0700253 value = p.work_git.rev_parse(HEAD + '^0')
254 e.setAttribute('revision', value)
255 if peg_rev_upstream and value != p.revisionExpr:
256 # Only save the origin if the origin is not a sha1, and the default
257 # isn't our value, and the if the default doesn't already have that
258 # covered.
259 e.setAttribute('upstream', p.revisionExpr)
Anthony King36ea2fb2014-05-06 11:54:01 +0100260 else:
261 revision = self.remotes[remoteName].revision or d.revisionExpr
262 if not revision or revision != p.revisionExpr:
263 e.setAttribute('revision', p.revisionExpr)
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800264
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800265 for c in p.copyfiles:
266 ce = doc.createElement('copyfile')
267 ce.setAttribute('src', c.src)
268 ce.setAttribute('dest', c.dest)
269 e.appendChild(ce)
270
Jeff Hamiltone0df2322014-04-21 17:10:59 -0500271 for l in p.linkfiles:
272 le = doc.createElement('linkfile')
273 le.setAttribute('src', l.src)
274 le.setAttribute('dest', l.dest)
275 e.appendChild(le)
276
Conley Owensbb1b5f52012-08-13 13:11:18 -0700277 default_groups = ['all', 'name:%s' % p.name, 'path:%s' % p.relpath]
Dmitry Fink17f85ea2012-08-06 14:52:29 -0700278 egroups = [g for g in p.groups if g not in default_groups]
Conley Owens971de8e2012-04-16 10:36:08 -0700279 if egroups:
280 e.setAttribute('groups', ','.join(egroups))
Colin Cross5acde752012-03-28 20:15:45 -0700281
James W. Mills24c13082012-04-12 15:04:13 -0500282 for a in p.annotations:
283 if a.keep == "true":
284 ae = doc.createElement('annotation')
285 ae.setAttribute('name', a.name)
286 ae.setAttribute('value', a.value)
287 e.appendChild(ae)
288
Anatol Pomazau79770d22012-04-20 14:41:59 -0700289 if p.sync_c:
290 e.setAttribute('sync-c', 'true')
291
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800292 if p.sync_s:
293 e.setAttribute('sync-s', 'true')
294
295 if p.subprojects:
David James8d201162013-10-11 17:03:19 -0700296 subprojects = set(subp.name for subp in p.subprojects)
297 output_projects(p, e, list(sorted(subprojects)))
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800298
David James8d201162013-10-11 17:03:19 -0700299 projects = set(p.name for p in self._paths.values() if not p.parent)
300 output_projects(None, root, list(sorted(projects)))
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800301
Doug Anderson37282b42011-03-04 11:54:18 -0800302 if self._repo_hooks_project:
303 root.appendChild(doc.createTextNode(''))
304 e = doc.createElement('repo-hooks')
305 e.setAttribute('in-project', self._repo_hooks_project.name)
306 e.setAttribute('enabled-list',
307 ' '.join(self._repo_hooks_project.enabled_repo_hooks))
308 root.appendChild(e)
309
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800310 doc.writexml(fd, '', ' ', '\n', 'UTF-8')
311
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700312 @property
David James8d201162013-10-11 17:03:19 -0700313 def paths(self):
314 self._Load()
315 return self._paths
316
317 @property
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700318 def projects(self):
319 self._Load()
Anthony Kingd58bfe52014-05-05 23:30:49 +0100320 return list(self._paths.values())
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700321
322 @property
323 def remotes(self):
324 self._Load()
325 return self._remotes
326
327 @property
328 def default(self):
329 self._Load()
330 return self._default
331
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800332 @property
Doug Anderson37282b42011-03-04 11:54:18 -0800333 def repo_hooks_project(self):
334 self._Load()
335 return self._repo_hooks_project
336
337 @property
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700338 def notice(self):
339 self._Load()
340 return self._notice
341
342 @property
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700343 def manifest_server(self):
344 self._Load()
Shawn O. Pearce34fb20f2011-11-30 13:41:02 -0800345 return self._manifest_server
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700346
347 @property
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800348 def IsMirror(self):
349 return self.manifestProject.config.GetBoolean('repo.mirror')
350
Julien Campergue335f5ef2013-10-16 11:02:35 +0200351 @property
352 def IsArchive(self):
353 return self.manifestProject.config.GetBoolean('repo.archive')
354
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700355 def _Unload(self):
356 self._loaded = False
357 self._projects = {}
David James8d201162013-10-11 17:03:19 -0700358 self._paths = {}
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700359 self._remotes = {}
360 self._default = None
Doug Anderson37282b42011-03-04 11:54:18 -0800361 self._repo_hooks_project = None
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700362 self._notice = None
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700363 self.branch = None
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700364 self._manifest_server = None
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700365
366 def _Load(self):
367 if not self._loaded:
Shawn O. Pearce2450a292008-11-04 08:22:07 -0800368 m = self.manifestProject
369 b = m.GetBranch(m.CurrentBranch).merge
Shawn O. Pearce21c5c342009-06-25 16:47:30 -0700370 if b is not None and b.startswith(R_HEADS):
Shawn O. Pearce2450a292008-11-04 08:22:07 -0800371 b = b[len(R_HEADS):]
372 self.branch = b
373
Colin Cross23acdd32012-04-21 00:33:54 -0700374 nodes = []
Brian Harring475a47d2012-06-07 20:05:35 -0700375 nodes.append(self._ParseManifestXml(self.manifestFile,
376 self.manifestProject.worktree))
Shawn O. Pearce5cc66792008-10-23 16:19:27 -0700377
378 local = os.path.join(self.repodir, LOCAL_MANIFEST_NAME)
379 if os.path.exists(local):
David Pursehouse4eb285c2013-02-14 16:28:44 +0900380 if not self.localManifestWarning:
381 self.localManifestWarning = True
382 print('warning: %s is deprecated; put local manifests in `%s` instead'
383 % (LOCAL_MANIFEST_NAME, os.path.join(self.repodir, LOCAL_MANIFESTS_DIR_NAME)),
384 file=sys.stderr)
Brian Harring475a47d2012-06-07 20:05:35 -0700385 nodes.append(self._ParseManifestXml(local, self.repodir))
Colin Cross23acdd32012-04-21 00:33:54 -0700386
David Pursehouse2d5a0df2012-11-13 02:50:36 +0900387 local_dir = os.path.abspath(os.path.join(self.repodir, LOCAL_MANIFESTS_DIR_NAME))
388 try:
David Pursehouse52f1e5d2012-11-14 04:53:24 +0900389 for local_file in sorted(os.listdir(local_dir)):
David Pursehouse2d5a0df2012-11-13 02:50:36 +0900390 if local_file.endswith('.xml'):
David Pursehouse5f434ed2012-11-22 13:48:10 +0900391 local = os.path.join(local_dir, local_file)
392 nodes.append(self._ParseManifestXml(local, self.repodir))
David Pursehouse2d5a0df2012-11-13 02:50:36 +0900393 except OSError:
394 pass
395
Joe Onorato26e24752013-01-11 12:35:53 -0800396 try:
397 self._ParseManifest(nodes)
398 except ManifestParseError as e:
399 # There was a problem parsing, unload ourselves in case they catch
400 # this error and try again later, we will show the correct error
401 self._Unload()
402 raise e
Shawn O. Pearce5cc66792008-10-23 16:19:27 -0700403
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800404 if self.IsMirror:
405 self._AddMetaProjectMirror(self.repoProject)
406 self._AddMetaProjectMirror(self.manifestProject)
407
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700408 self._loaded = True
409
Brian Harring475a47d2012-06-07 20:05:35 -0700410 def _ParseManifestXml(self, path, include_root):
David Pursehousef7fc8a92012-11-13 04:00:28 +0900411 try:
412 root = xml.dom.minidom.parse(path)
David Pursehouse2d5a0df2012-11-13 02:50:36 +0900413 except (OSError, xml.parsers.expat.ExpatError) as e:
David Pursehousef7fc8a92012-11-13 04:00:28 +0900414 raise ManifestParseError("error parsing manifest %s: %s" % (path, e))
415
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700416 if not root or not root.childNodes:
Brian Harring26448742011-04-28 05:04:41 -0700417 raise ManifestParseError("no root node in %s" % (path,))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700418
Jooncheol Park34acdd22012-08-27 02:25:59 +0900419 for manifest in root.childNodes:
420 if manifest.nodeName == 'manifest':
421 break
422 else:
Brian Harring26448742011-04-28 05:04:41 -0700423 raise ManifestParseError("no <manifest> in %s" % (path,))
424
Colin Cross23acdd32012-04-21 00:33:54 -0700425 nodes = []
David Pursehouse4f7bdea2012-10-22 12:50:15 +0900426 for node in manifest.childNodes: # pylint:disable=W0631
David Pursehouse5c6eeac2012-10-11 16:44:48 +0900427 # We only get here if manifest is initialised
David Pursehousec1b86a22012-11-14 11:36:51 +0900428 if node.nodeName == 'include':
429 name = self._reqatt(node, 'name')
430 fp = os.path.join(include_root, name)
431 if not os.path.isfile(fp):
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530432 raise ManifestParseError("include %s doesn't exist or isn't a file"
433 % (name,))
David Pursehousec1b86a22012-11-14 11:36:51 +0900434 try:
435 nodes.extend(self._ParseManifestXml(fp, include_root))
436 # should isolate this to the exact exception, but that's
437 # tricky. actual parsing implementation may vary.
438 except (KeyboardInterrupt, RuntimeError, SystemExit):
439 raise
440 except Exception as e:
441 raise ManifestParseError(
442 "failed parsing included manifest %s: %s", (name, e))
443 else:
444 nodes.append(node)
Colin Cross23acdd32012-04-21 00:33:54 -0700445 return nodes
Brian Harring26448742011-04-28 05:04:41 -0700446
Colin Cross23acdd32012-04-21 00:33:54 -0700447 def _ParseManifest(self, node_list):
448 for node in itertools.chain(*node_list):
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700449 if node.nodeName == 'remote':
450 remote = self._ParseRemote(node)
David Pursehouse717ece92012-11-13 08:49:16 +0900451 if remote:
452 if remote.name in self._remotes:
453 if remote != self._remotes[remote.name]:
454 raise ManifestParseError(
455 'remote %s already exists with different attributes' %
456 (remote.name))
457 else:
458 self._remotes[remote.name] = remote
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700459
Colin Cross23acdd32012-04-21 00:33:54 -0700460 for node in itertools.chain(*node_list):
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700461 if node.nodeName == 'default':
Julien Campergue74879922013-10-09 14:38:46 +0200462 new_default = self._ParseDefault(node)
463 if self._default is None:
464 self._default = new_default
465 elif new_default != self._default:
David Pursehouse37128b62013-10-15 10:48:40 +0900466 raise ManifestParseError('duplicate default in %s' %
467 (self.manifestFile))
Julien Campergue74879922013-10-09 14:38:46 +0200468
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700469 if self._default is None:
470 self._default = _Default()
471
Colin Cross23acdd32012-04-21 00:33:54 -0700472 for node in itertools.chain(*node_list):
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700473 if node.nodeName == 'notice':
474 if self._notice is not None:
Doug Anderson37282b42011-03-04 11:54:18 -0800475 raise ManifestParseError(
476 'duplicate notice in %s' %
477 (self.manifestFile))
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700478 self._notice = self._ParseNotice(node)
479
Colin Cross23acdd32012-04-21 00:33:54 -0700480 for node in itertools.chain(*node_list):
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700481 if node.nodeName == 'manifest-server':
482 url = self._reqatt(node, 'url')
483 if self._manifest_server is not None:
David Pursehousec1b86a22012-11-14 11:36:51 +0900484 raise ManifestParseError(
485 'duplicate manifest-server in %s' %
486 (self.manifestFile))
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700487 self._manifest_server = url
488
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800489 def recursively_add_projects(project):
David James8d201162013-10-11 17:03:19 -0700490 projects = self._projects.setdefault(project.name, [])
491 if project.relpath is None:
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800492 raise ManifestParseError(
David James8d201162013-10-11 17:03:19 -0700493 'missing path for %s in %s' %
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800494 (project.name, self.manifestFile))
David James8d201162013-10-11 17:03:19 -0700495 if project.relpath in self._paths:
496 raise ManifestParseError(
497 'duplicate path %s in %s' %
498 (project.relpath, self.manifestFile))
499 self._paths[project.relpath] = project
500 projects.append(project)
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800501 for subproject in project.subprojects:
502 recursively_add_projects(subproject)
503
Colin Cross23acdd32012-04-21 00:33:54 -0700504 for node in itertools.chain(*node_list):
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700505 if node.nodeName == 'project':
506 project = self._ParseProject(node)
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800507 recursively_add_projects(project)
Doug Anderson37282b42011-03-04 11:54:18 -0800508 if node.nodeName == 'repo-hooks':
509 # Get the name of the project and the (space-separated) list of enabled.
510 repo_hooks_project = self._reqatt(node, 'in-project')
511 enabled_repo_hooks = self._reqatt(node, 'enabled-list').split()
512
513 # Only one project can be the hooks project
514 if self._repo_hooks_project is not None:
515 raise ManifestParseError(
516 'duplicate repo-hooks in %s' %
517 (self.manifestFile))
518
519 # Store a reference to the Project.
520 try:
David James8d201162013-10-11 17:03:19 -0700521 repo_hooks_projects = self._projects[repo_hooks_project]
Doug Anderson37282b42011-03-04 11:54:18 -0800522 except KeyError:
523 raise ManifestParseError(
524 'project %s not found for repo-hooks' %
525 (repo_hooks_project))
526
David James8d201162013-10-11 17:03:19 -0700527 if len(repo_hooks_projects) != 1:
528 raise ManifestParseError(
529 'internal error parsing repo-hooks in %s' %
530 (self.manifestFile))
531 self._repo_hooks_project = repo_hooks_projects[0]
532
Doug Anderson37282b42011-03-04 11:54:18 -0800533 # Store the enabled hooks in the Project object.
534 self._repo_hooks_project.enabled_repo_hooks = enabled_repo_hooks
Colin Cross23acdd32012-04-21 00:33:54 -0700535 if node.nodeName == 'remove-project':
536 name = self._reqatt(node, 'name')
David Jamesb8433df2014-01-30 10:11:17 -0800537
538 if name not in self._projects:
David Pursehousef9107482012-11-16 19:12:32 +0900539 raise ManifestParseError('remove-project element specifies non-existent '
540 'project: %s' % name)
Colin Cross23acdd32012-04-21 00:33:54 -0700541
David Jamesb8433df2014-01-30 10:11:17 -0800542 for p in self._projects[name]:
543 del self._paths[p.relpath]
544 del self._projects[name]
545
Colin Cross23acdd32012-04-21 00:33:54 -0700546 # If the manifest removes the hooks project, treat it as if it deleted
547 # the repo-hooks element too.
548 if self._repo_hooks_project and (self._repo_hooks_project.name == name):
549 self._repo_hooks_project = None
550
Doug Anderson37282b42011-03-04 11:54:18 -0800551
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800552 def _AddMetaProjectMirror(self, m):
553 name = None
554 m_url = m.GetRemote(m.remote.name).url
555 if m_url.endswith('/.git'):
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530556 raise ManifestParseError('refusing to mirror %s' % m_url)
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800557
558 if self._default and self._default.remote:
Conley Owensceea3682011-10-20 10:45:47 -0700559 url = self._default.remote.resolvedFetchUrl
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800560 if not url.endswith('/'):
561 url += '/'
562 if m_url.startswith(url):
563 remote = self._default.remote
564 name = m_url[len(url):]
565
566 if name is None:
567 s = m_url.rindex('/') + 1
Conley Owensdb728cd2011-09-26 16:34:01 -0700568 manifestUrl = self.manifestProject.config.GetString('remote.origin.url')
Shawn O. Pearcef35b2d92012-08-02 11:46:22 -0700569 remote = _XmlRemote('origin', fetch=m_url[:s], manifestUrl=manifestUrl)
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800570 name = m_url[s:]
571
572 if name.endswith('.git'):
573 name = name[:-4]
574
575 if name not in self._projects:
576 m.PreSync()
577 gitdir = os.path.join(self.topdir, '%s.git' % name)
578 project = Project(manifest = self,
579 name = name,
Shawn O. Pearced1f70d92009-05-19 14:58:02 -0700580 remote = remote.ToRemoteSpec(name),
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800581 gitdir = gitdir,
David James8d201162013-10-11 17:03:19 -0700582 objdir = gitdir,
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800583 worktree = None,
Kwanhong Leeccd218c2014-02-17 13:07:32 +0900584 relpath = name or None,
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -0700585 revisionExpr = m.revisionExpr,
586 revisionId = None)
David James8d201162013-10-11 17:03:19 -0700587 self._projects[project.name] = [project]
Kwanhong Leeccd218c2014-02-17 13:07:32 +0900588 self._paths[project.relpath] = project
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800589
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700590 def _ParseRemote(self, node):
591 """
592 reads a <remote> element from the manifest file
593 """
594 name = self._reqatt(node, 'name')
Yestin Sunb292b982012-07-02 07:32:50 -0700595 alias = node.getAttribute('alias')
596 if alias == '':
597 alias = None
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700598 fetch = self._reqatt(node, 'fetch')
599 review = node.getAttribute('review')
Shawn O. Pearceae6e0942008-11-06 10:25:35 -0800600 if review == '':
601 review = None
Anthony King36ea2fb2014-05-06 11:54:01 +0100602 revision = node.getAttribute('revision')
603 if revision == '':
604 revision = None
Conley Owensdb728cd2011-09-26 16:34:01 -0700605 manifestUrl = self.manifestProject.config.GetString('remote.origin.url')
Anthony King36ea2fb2014-05-06 11:54:01 +0100606 return _XmlRemote(name, alias, fetch, manifestUrl, review, revision)
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700607
608 def _ParseDefault(self, node):
609 """
610 reads a <default> element from the manifest file
611 """
612 d = _Default()
613 d.remote = self._get_remote(node)
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -0700614 d.revisionExpr = node.getAttribute('revision')
615 if d.revisionExpr == '':
616 d.revisionExpr = None
Anatol Pomazau79770d22012-04-20 14:41:59 -0700617
Bryan Jacobsf609f912013-05-06 13:36:24 -0400618 d.destBranchExpr = node.getAttribute('dest-branch') or None
619
Shawn O. Pearce6392c872011-09-22 17:44:31 -0700620 sync_j = node.getAttribute('sync-j')
621 if sync_j == '' or sync_j is None:
622 d.sync_j = 1
623 else:
624 d.sync_j = int(sync_j)
Anatol Pomazau79770d22012-04-20 14:41:59 -0700625
626 sync_c = node.getAttribute('sync-c')
627 if not sync_c:
628 d.sync_c = False
629 else:
630 d.sync_c = sync_c.lower() in ("yes", "true", "1")
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800631
632 sync_s = node.getAttribute('sync-s')
633 if not sync_s:
634 d.sync_s = False
635 else:
636 d.sync_s = sync_s.lower() in ("yes", "true", "1")
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700637 return d
638
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700639 def _ParseNotice(self, node):
640 """
641 reads a <notice> element from the manifest file
642
643 The <notice> element is distinct from other tags in the XML in that the
644 data is conveyed between the start and end tag (it's not an empty-element
645 tag).
646
647 The white space (carriage returns, indentation) for the notice element is
648 relevant and is parsed in a way that is based on how python docstrings work.
649 In fact, the code is remarkably similar to here:
650 http://www.python.org/dev/peps/pep-0257/
651 """
652 # Get the data out of the node...
653 notice = node.childNodes[0].data
654
655 # Figure out minimum indentation, skipping the first line (the same line
656 # as the <notice> tag)...
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530657 minIndent = sys.maxsize
Doug Anderson2b8db3c2010-11-01 15:08:06 -0700658 lines = notice.splitlines()
659 for line in lines[1:]:
660 lstrippedLine = line.lstrip()
661 if lstrippedLine:
662 indent = len(line) - len(lstrippedLine)
663 minIndent = min(indent, minIndent)
664
665 # Strip leading / trailing blank lines and also indentation.
666 cleanLines = [lines[0].strip()]
667 for line in lines[1:]:
668 cleanLines.append(line[minIndent:].rstrip())
669
670 # Clear completely blank lines from front and back...
671 while cleanLines and not cleanLines[0]:
672 del cleanLines[0]
673 while cleanLines and not cleanLines[-1]:
674 del cleanLines[-1]
675
676 return '\n'.join(cleanLines)
677
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800678 def _JoinName(self, parent_name, name):
679 return os.path.join(parent_name, name)
680
681 def _UnjoinName(self, parent_name, name):
682 return os.path.relpath(name, parent_name)
683
684 def _ParseProject(self, node, parent = None):
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700685 """
686 reads a <project> element from the manifest file
Nico Sallembiena1bfd2c2010-04-06 10:40:01 -0700687 """
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700688 name = self._reqatt(node, 'name')
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800689 if parent:
690 name = self._JoinName(parent.name, name)
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700691
692 remote = self._get_remote(node)
693 if remote is None:
694 remote = self._default.remote
695 if remote is None:
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530696 raise ManifestParseError("no remote for project %s within %s" %
697 (name, self.manifestFile))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700698
Anthony King36ea2fb2014-05-06 11:54:01 +0100699 revisionExpr = node.getAttribute('revision') or remote.revision
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -0700700 if not revisionExpr:
701 revisionExpr = self._default.revisionExpr
702 if not revisionExpr:
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530703 raise ManifestParseError("no revision for project %s within %s" %
704 (name, self.manifestFile))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700705
706 path = node.getAttribute('path')
707 if not path:
708 path = name
709 if path.startswith('/'):
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530710 raise ManifestParseError("project %s path cannot be absolute in %s" %
711 (name, self.manifestFile))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700712
Mike Pontillod3153822012-02-28 11:53:24 -0800713 rebase = node.getAttribute('rebase')
714 if not rebase:
715 rebase = True
716 else:
717 rebase = rebase.lower() in ("yes", "true", "1")
718
Anatol Pomazau79770d22012-04-20 14:41:59 -0700719 sync_c = node.getAttribute('sync-c')
720 if not sync_c:
721 sync_c = False
722 else:
723 sync_c = sync_c.lower() in ("yes", "true", "1")
724
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800725 sync_s = node.getAttribute('sync-s')
726 if not sync_s:
727 sync_s = self._default.sync_s
728 else:
729 sync_s = sync_s.lower() in ("yes", "true", "1")
730
David Pursehouseede7f122012-11-27 22:25:30 +0900731 clone_depth = node.getAttribute('clone-depth')
732 if clone_depth:
733 try:
734 clone_depth = int(clone_depth)
735 if clone_depth <= 0:
736 raise ValueError()
737 except ValueError:
738 raise ManifestParseError('invalid clone-depth %s in %s' %
739 (clone_depth, self.manifestFile))
740
Bryan Jacobsf609f912013-05-06 13:36:24 -0400741 dest_branch = node.getAttribute('dest-branch') or self._default.destBranchExpr
742
Brian Harring14a66742012-09-28 20:21:57 -0700743 upstream = node.getAttribute('upstream')
744
Conley Owens971de8e2012-04-16 10:36:08 -0700745 groups = ''
746 if node.hasAttribute('groups'):
747 groups = node.getAttribute('groups')
David Pursehouse1d947b32012-10-25 12:23:11 +0900748 groups = [x for x in re.split(r'[,\s]+', groups) if x]
Brian Harring7da13142012-06-15 02:24:20 -0700749
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800750 if parent is None:
David James8d201162013-10-11 17:03:19 -0700751 relpath, worktree, gitdir, objdir = self.GetProjectPaths(name, path)
Shawn O. Pearcecd81dd62012-10-26 12:18:00 -0700752 else:
David James8d201162013-10-11 17:03:19 -0700753 relpath, worktree, gitdir, objdir = \
754 self.GetSubprojectPaths(parent, name, path)
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800755
756 default_groups = ['all', 'name:%s' % name, 'path:%s' % relpath]
757 groups.extend(set(default_groups).difference(groups))
Shawn O. Pearcecd81dd62012-10-26 12:18:00 -0700758
Scott Fandb83b1b2013-02-28 09:34:14 +0800759 if self.IsMirror and node.hasAttribute('force-path'):
760 if node.getAttribute('force-path').lower() in ("yes", "true", "1"):
761 gitdir = os.path.join(self.topdir, '%s.git' % path)
762
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700763 project = Project(manifest = self,
764 name = name,
Shawn O. Pearced1f70d92009-05-19 14:58:02 -0700765 remote = remote.ToRemoteSpec(name),
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700766 gitdir = gitdir,
David James8d201162013-10-11 17:03:19 -0700767 objdir = objdir,
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700768 worktree = worktree,
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800769 relpath = relpath,
Shawn O. Pearce3c8dea12009-05-29 18:38:17 -0700770 revisionExpr = revisionExpr,
Mike Pontillod3153822012-02-28 11:53:24 -0800771 revisionId = None,
Colin Cross5acde752012-03-28 20:15:45 -0700772 rebase = rebase,
Anatol Pomazau79770d22012-04-20 14:41:59 -0700773 groups = groups,
Brian Harring14a66742012-09-28 20:21:57 -0700774 sync_c = sync_c,
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800775 sync_s = sync_s,
David Pursehouseede7f122012-11-27 22:25:30 +0900776 clone_depth = clone_depth,
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800777 upstream = upstream,
Bryan Jacobsf609f912013-05-06 13:36:24 -0400778 parent = parent,
779 dest_branch = dest_branch)
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700780
781 for n in node.childNodes:
Shawn O. Pearce242b5262009-05-19 13:00:29 -0700782 if n.nodeName == 'copyfile':
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700783 self._ParseCopyFile(project, n)
Jeff Hamiltone0df2322014-04-21 17:10:59 -0500784 if n.nodeName == 'linkfile':
785 self._ParseLinkFile(project, n)
James W. Mills24c13082012-04-12 15:04:13 -0500786 if n.nodeName == 'annotation':
787 self._ParseAnnotation(project, n)
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800788 if n.nodeName == 'project':
789 project.subprojects.append(self._ParseProject(n, parent = project))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700790
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700791 return project
792
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800793 def GetProjectPaths(self, name, path):
794 relpath = path
795 if self.IsMirror:
796 worktree = None
797 gitdir = os.path.join(self.topdir, '%s.git' % name)
David James8d201162013-10-11 17:03:19 -0700798 objdir = gitdir
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800799 else:
800 worktree = os.path.join(self.topdir, path).replace('\\', '/')
801 gitdir = os.path.join(self.repodir, 'projects', '%s.git' % path)
David James8d201162013-10-11 17:03:19 -0700802 objdir = os.path.join(self.repodir, 'project-objects', '%s.git' % name)
803 return relpath, worktree, gitdir, objdir
804
805 def GetProjectsWithName(self, name):
806 return self._projects.get(name, [])
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800807
808 def GetSubprojectName(self, parent, submodule_path):
809 return os.path.join(parent.name, submodule_path)
810
811 def _JoinRelpath(self, parent_relpath, relpath):
812 return os.path.join(parent_relpath, relpath)
813
814 def _UnjoinRelpath(self, parent_relpath, relpath):
815 return os.path.relpath(relpath, parent_relpath)
816
David James8d201162013-10-11 17:03:19 -0700817 def GetSubprojectPaths(self, parent, name, path):
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800818 relpath = self._JoinRelpath(parent.relpath, path)
819 gitdir = os.path.join(parent.gitdir, 'subprojects', '%s.git' % path)
David James8d201162013-10-11 17:03:19 -0700820 objdir = os.path.join(parent.gitdir, 'subproject-objects', '%s.git' % name)
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800821 if self.IsMirror:
822 worktree = None
823 else:
824 worktree = os.path.join(parent.worktree, path).replace('\\', '/')
David James8d201162013-10-11 17:03:19 -0700825 return relpath, worktree, gitdir, objdir
Che-Liang Chioub2bd91c2012-01-11 11:28:42 +0800826
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700827 def _ParseCopyFile(self, project, node):
828 src = self._reqatt(node, 'src')
829 dest = self._reqatt(node, 'dest')
Shawn O. Pearcee284ad12008-11-04 07:37:10 -0800830 if not self.IsMirror:
831 # src is project relative;
832 # dest is relative to the top of the tree
Shawn O. Pearcec7a4eef2009-03-05 10:32:38 -0800833 project.AddCopyFile(src, dest, os.path.join(self.topdir, dest))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700834
Jeff Hamiltone0df2322014-04-21 17:10:59 -0500835 def _ParseLinkFile(self, project, node):
836 src = self._reqatt(node, 'src')
837 dest = self._reqatt(node, 'dest')
838 if not self.IsMirror:
839 # src is project relative;
840 # dest is relative to the top of the tree
841 project.AddLinkFile(src, dest, os.path.join(self.topdir, dest))
842
James W. Mills24c13082012-04-12 15:04:13 -0500843 def _ParseAnnotation(self, project, node):
844 name = self._reqatt(node, 'name')
845 value = self._reqatt(node, 'value')
846 try:
847 keep = self._reqatt(node, 'keep').lower()
848 except ManifestParseError:
849 keep = "true"
850 if keep != "true" and keep != "false":
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530851 raise ManifestParseError('optional "keep" attribute must be '
852 '"true" or "false"')
James W. Mills24c13082012-04-12 15:04:13 -0500853 project.AddAnnotation(name, value, keep)
854
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700855 def _get_remote(self, node):
856 name = node.getAttribute('remote')
857 if not name:
858 return None
859
860 v = self._remotes.get(name)
861 if not v:
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530862 raise ManifestParseError("remote %s not defined in %s" %
863 (name, self.manifestFile))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700864 return v
865
866 def _reqatt(self, node, attname):
867 """
868 reads a required attribute from the node.
869 """
870 v = node.getAttribute(attname)
871 if not v:
Chirayu Desai217ea7d2013-03-01 19:14:38 +0530872 raise ManifestParseError("no %s in <%s> within %s" %
873 (attname, node.nodeName, self.manifestFile))
The Android Open Source Projectcf31fe92008-10-21 07:00:00 -0700874 return v
Julien Camperguedd654222014-01-09 16:21:37 +0100875
876 def projectsDiff(self, manifest):
877 """return the projects differences between two manifests.
878
879 The diff will be from self to given manifest.
880
881 """
882 fromProjects = self.paths
883 toProjects = manifest.paths
884
Anthony King7446c592014-05-06 09:19:39 +0100885 fromKeys = sorted(fromProjects.keys())
886 toKeys = sorted(toProjects.keys())
Julien Camperguedd654222014-01-09 16:21:37 +0100887
888 diff = {'added': [], 'removed': [], 'changed': [], 'unreachable': []}
889
890 for proj in fromKeys:
891 if not proj in toKeys:
892 diff['removed'].append(fromProjects[proj])
893 else:
894 fromProj = fromProjects[proj]
895 toProj = toProjects[proj]
896 try:
897 fromRevId = fromProj.GetCommitRevisionId()
898 toRevId = toProj.GetCommitRevisionId()
899 except ManifestInvalidRevisionError:
900 diff['unreachable'].append((fromProj, toProj))
901 else:
902 if fromRevId != toRevId:
903 diff['changed'].append((fromProj, toProj))
904 toKeys.remove(proj)
905
906 for proj in toKeys:
907 diff['added'].append(toProjects[proj])
908
909 return diff