##// END OF EJS Templates
discovery: move missing tracking inside the partialdiscovery object...
Boris Feld -
r41206:96201120 default
parent child Browse files
Show More
@@ -1,352 +1,357 b''
1 1 # setdiscovery.py - improved discovery of common nodeset for mercurial
2 2 #
3 3 # Copyright 2010 Benoit Boissinot <bboissin@gmail.com>
4 4 # and Peter Arrenbrecht <peter@arrenbrecht.ch>
5 5 #
6 6 # This software may be used and distributed according to the terms of the
7 7 # GNU General Public License version 2 or any later version.
8 8 """
9 9 Algorithm works in the following way. You have two repository: local and
10 10 remote. They both contains a DAG of changelists.
11 11
12 12 The goal of the discovery protocol is to find one set of node *common*,
13 13 the set of nodes shared by local and remote.
14 14
15 15 One of the issue with the original protocol was latency, it could
16 16 potentially require lots of roundtrips to discover that the local repo was a
17 17 subset of remote (which is a very common case, you usually have few changes
18 18 compared to upstream, while upstream probably had lots of development).
19 19
20 20 The new protocol only requires one interface for the remote repo: `known()`,
21 21 which given a set of changelists tells you if they are present in the DAG.
22 22
23 23 The algorithm then works as follow:
24 24
25 25 - We will be using three sets, `common`, `missing`, `unknown`. Originally
26 26 all nodes are in `unknown`.
27 27 - Take a sample from `unknown`, call `remote.known(sample)`
28 28 - For each node that remote knows, move it and all its ancestors to `common`
29 29 - For each node that remote doesn't know, move it and all its descendants
30 30 to `missing`
31 31 - Iterate until `unknown` is empty
32 32
33 33 There are a couple optimizations, first is instead of starting with a random
34 34 sample of missing, start by sending all heads, in the case where the local
35 35 repo is a subset, you computed the answer in one round trip.
36 36
37 37 Then you can do something similar to the bisecting strategy used when
38 38 finding faulty changesets. Instead of random samples, you can try picking
39 39 nodes that will maximize the number of nodes that will be
40 40 classified with it (since all ancestors or descendants will be marked as well).
41 41 """
42 42
43 43 from __future__ import absolute_import
44 44
45 45 import collections
46 46 import random
47 47
48 48 from .i18n import _
49 49 from .node import (
50 50 nullid,
51 51 nullrev,
52 52 )
53 53 from . import (
54 54 error,
55 55 util,
56 56 )
57 57
58 58 def _updatesample(revs, heads, sample, parentfn, quicksamplesize=0):
59 59 """update an existing sample to match the expected size
60 60
61 61 The sample is updated with revs exponentially distant from each head of the
62 62 <revs> set. (H~1, H~2, H~4, H~8, etc).
63 63
64 64 If a target size is specified, the sampling will stop once this size is
65 65 reached. Otherwise sampling will happen until roots of the <revs> set are
66 66 reached.
67 67
68 68 :revs: set of revs we want to discover (if None, assume the whole dag)
69 69 :heads: set of DAG head revs
70 70 :sample: a sample to update
71 71 :parentfn: a callable to resolve parents for a revision
72 72 :quicksamplesize: optional target size of the sample"""
73 73 dist = {}
74 74 visit = collections.deque(heads)
75 75 seen = set()
76 76 factor = 1
77 77 while visit:
78 78 curr = visit.popleft()
79 79 if curr in seen:
80 80 continue
81 81 d = dist.setdefault(curr, 1)
82 82 if d > factor:
83 83 factor *= 2
84 84 if d == factor:
85 85 sample.add(curr)
86 86 if quicksamplesize and (len(sample) >= quicksamplesize):
87 87 return
88 88 seen.add(curr)
89 89
90 90 for p in parentfn(curr):
91 91 if p != nullrev and (not revs or p in revs):
92 92 dist.setdefault(p, d + 1)
93 93 visit.append(p)
94 94
95 95 def _takequicksample(repo, headrevs, revs, size):
96 96 """takes a quick sample of size <size>
97 97
98 98 It is meant for initial sampling and focuses on querying heads and close
99 99 ancestors of heads.
100 100
101 101 :dag: a dag object
102 102 :headrevs: set of head revisions in local DAG to consider
103 103 :revs: set of revs to discover
104 104 :size: the maximum size of the sample"""
105 105 if len(revs) <= size:
106 106 return list(revs)
107 107 sample = set(repo.revs('heads(%ld)', revs))
108 108
109 109 if len(sample) >= size:
110 110 return _limitsample(sample, size)
111 111
112 112 _updatesample(None, headrevs, sample, repo.changelog.parentrevs,
113 113 quicksamplesize=size)
114 114 return sample
115 115
116 116 def _takefullsample(repo, headrevs, revs, size):
117 117 if len(revs) <= size:
118 118 return list(revs)
119 119 sample = set(repo.revs('heads(%ld)', revs))
120 120
121 121 # update from heads
122 122 revsheads = set(repo.revs('heads(%ld)', revs))
123 123 _updatesample(revs, revsheads, sample, repo.changelog.parentrevs)
124 124
125 125 # update from roots
126 126 revsroots = set(repo.revs('roots(%ld)', revs))
127 127
128 128 # _updatesample() essentially does interaction over revisions to look up
129 129 # their children. This lookup is expensive and doing it in a loop is
130 130 # quadratic. We precompute the children for all relevant revisions and
131 131 # make the lookup in _updatesample() a simple dict lookup.
132 132 #
133 133 # Because this function can be called multiple times during discovery, we
134 134 # may still perform redundant work and there is room to optimize this by
135 135 # keeping a persistent cache of children across invocations.
136 136 children = {}
137 137
138 138 parentrevs = repo.changelog.parentrevs
139 139 for rev in repo.changelog.revs(start=min(revsroots)):
140 140 # Always ensure revision has an entry so we don't need to worry about
141 141 # missing keys.
142 142 children.setdefault(rev, [])
143 143
144 144 for prev in parentrevs(rev):
145 145 if prev == nullrev:
146 146 continue
147 147
148 148 children.setdefault(prev, []).append(rev)
149 149
150 150 _updatesample(revs, revsroots, sample, children.__getitem__)
151 151 assert sample
152 152 sample = _limitsample(sample, size)
153 153 if len(sample) < size:
154 154 more = size - len(sample)
155 155 sample.update(random.sample(list(revs - sample), more))
156 156 return sample
157 157
158 158 def _limitsample(sample, desiredlen):
159 159 """return a random subset of sample of at most desiredlen item"""
160 160 if len(sample) > desiredlen:
161 161 sample = set(random.sample(sample, desiredlen))
162 162 return sample
163 163
164 164 class partialdiscovery(object):
165 165 """an object representing ongoing discovery
166 166
167 167 Feed with data from the remote repository, this object keep track of the
168 168 current set of changeset in various states:
169 169
170 170 - common: own nodes I know we both know
171 171 - undecided: own nodes where I don't know if remote knows them
172 - missing: own nodes I know remote lacks
172 173 """
173 174
174 175 def __init__(self, repo, targetheads):
175 176 self._repo = repo
176 177 self._targetheads = targetheads
177 178 self._common = repo.changelog.incrementalmissingrevs()
178 179 self._undecided = None
180 self.missing = set()
179 181
180 182 def addcommons(self, commons):
181 183 """registrer nodes known as common"""
182 184 self._common.addbases(commons)
183 185 self._common.removeancestorsfrom(self.undecided)
184 186
187 def addmissings(self, missings):
188 """registrer some nodes as missing"""
189 if self.missing:
190 new = self._repo.revs('descendants(%ld) - descendants(%ld)',
191 missings, self.missing)
192 self.missing.update(new)
193 else:
194 self.missing.update(self._repo.revs('descendants(%ld)', missings))
195
196 self.undecided.difference_update(self.missing)
197
185 198 def hasinfo(self):
186 199 """return True is we have any clue about the remote state"""
187 200 return self._common.hasbases()
188 201
189 202 def iscomplete(self):
190 203 """True if all the necessary data have been gathered"""
191 204 return self._undecided is not None and not self._undecided
192 205
193 206 @property
194 207 def undecided(self):
195 208 if self._undecided is not None:
196 209 return self._undecided
197 210 self._undecided = set(self._common.missingancestors(self._targetheads))
198 211 return self._undecided
199 212
200 213 def commonheads(self):
201 214 """the heads of the known common set"""
202 215 # heads(common) == heads(common.bases) since common represents
203 216 # common.bases and all its ancestors
204 217 # The presence of nullrev will confuse heads(). So filter it out.
205 218 return set(self._repo.revs('heads(%ld)',
206 219 self._common.bases - {nullrev}))
207 220
208 221 def findcommonheads(ui, local, remote,
209 222 initialsamplesize=100,
210 223 fullsamplesize=200,
211 224 abortwhenunrelated=True,
212 225 ancestorsof=None):
213 226 '''Return a tuple (common, anyincoming, remoteheads) used to identify
214 227 missing nodes from or in remote.
215 228 '''
216 229 start = util.timer()
217 230
218 231 roundtrips = 0
219 232 cl = local.changelog
220 233 clnode = cl.node
221 234 clrev = cl.rev
222 235
223 236 if ancestorsof is not None:
224 237 ownheads = [clrev(n) for n in ancestorsof]
225 238 else:
226 239 ownheads = [rev for rev in cl.headrevs() if rev != nullrev]
227 240
228 241 # early exit if we know all the specified remote heads already
229 242 ui.debug("query 1; heads\n")
230 243 roundtrips += 1
231 244 sample = _limitsample(ownheads, initialsamplesize)
232 245 # indices between sample and externalized version must match
233 246 sample = list(sample)
234 247
235 248 with remote.commandexecutor() as e:
236 249 fheads = e.callcommand('heads', {})
237 250 fknown = e.callcommand('known', {
238 251 'nodes': [clnode(r) for r in sample],
239 252 })
240 253
241 254 srvheadhashes, yesno = fheads.result(), fknown.result()
242 255
243 256 if cl.tip() == nullid:
244 257 if srvheadhashes != [nullid]:
245 258 return [nullid], True, srvheadhashes
246 259 return [nullid], False, []
247 260
248 261 # start actual discovery (we note this before the next "if" for
249 262 # compatibility reasons)
250 263 ui.status(_("searching for changes\n"))
251 264
252 265 srvheads = []
253 266 for node in srvheadhashes:
254 267 if node == nullid:
255 268 continue
256 269
257 270 try:
258 271 srvheads.append(clrev(node))
259 272 # Catches unknown and filtered nodes.
260 273 except error.LookupError:
261 274 continue
262 275
263 276 if len(srvheads) == len(srvheadhashes):
264 277 ui.debug("all remote heads known locally\n")
265 278 return srvheadhashes, False, srvheadhashes
266 279
267 280 if len(sample) == len(ownheads) and all(yesno):
268 281 ui.note(_("all local heads known remotely\n"))
269 282 ownheadhashes = [clnode(r) for r in ownheads]
270 283 return ownheadhashes, True, srvheadhashes
271 284
272 285 # full blown discovery
273 286
274 287 disco = partialdiscovery(local, ownheads)
275 288 # treat remote heads (and maybe own heads) as a first implicit sample
276 289 # response
277 290 disco.addcommons(srvheads)
278 291 commoninsample = set(n for i, n in enumerate(sample) if yesno[i])
279 292 disco.addcommons(commoninsample)
280 # own nodes I know remote lacks
281 missing = set()
282 293
283 294 full = False
284 295 progress = ui.makeprogress(_('searching'), unit=_('queries'))
285 296 while not disco.iscomplete():
286 297
287 298 if sample:
288 299 missinginsample = [n for i, n in enumerate(sample) if not yesno[i]]
300 disco.addmissings(missinginsample)
289 301
290 if missing:
291 missing.update(local.revs('descendants(%ld) - descendants(%ld)',
292 missinginsample, missing))
293 else:
294 missing.update(local.revs('descendants(%ld)', missinginsample))
295
296 disco.undecided.difference_update(missing)
297 302
298 303 if disco.iscomplete():
299 304 break
300 305
301 306 if full or disco.hasinfo():
302 307 if full:
303 308 ui.note(_("sampling from both directions\n"))
304 309 else:
305 310 ui.debug("taking initial sample\n")
306 311 samplefunc = _takefullsample
307 312 targetsize = fullsamplesize
308 313 else:
309 314 # use even cheaper initial sample
310 315 ui.debug("taking quick initial sample\n")
311 316 samplefunc = _takequicksample
312 317 targetsize = initialsamplesize
313 318 sample = samplefunc(local, ownheads, disco.undecided, targetsize)
314 319
315 320 roundtrips += 1
316 321 progress.update(roundtrips)
317 322 ui.debug("query %i; still undecided: %i, sample size is: %i\n"
318 323 % (roundtrips, len(disco.undecided), len(sample)))
319 324 # indices between sample and externalized version must match
320 325 sample = list(sample)
321 326
322 327 with remote.commandexecutor() as e:
323 328 yesno = e.callcommand('known', {
324 329 'nodes': [clnode(r) for r in sample],
325 330 }).result()
326 331
327 332 full = True
328 333
329 334 if sample:
330 335 commoninsample = set(n for i, n in enumerate(sample) if yesno[i])
331 336 disco.addcommons(commoninsample)
332 337
333 338 result = disco.commonheads()
334 339 elapsed = util.timer() - start
335 340 progress.complete()
336 341 ui.debug("%d total queries in %.4fs\n" % (roundtrips, elapsed))
337 342 msg = ('found %d common and %d unknown server heads,'
338 343 ' %d roundtrips in %.4fs\n')
339 344 missing = set(result) - set(srvheads)
340 345 ui.log('discovery', msg, len(result), len(missing), roundtrips,
341 346 elapsed)
342 347
343 348 if not result and srvheadhashes != [nullid]:
344 349 if abortwhenunrelated:
345 350 raise error.Abort(_("repository is unrelated"))
346 351 else:
347 352 ui.warn(_("warning: repository is unrelated\n"))
348 353 return ({nullid}, True, srvheadhashes,)
349 354
350 355 anyincoming = (srvheadhashes != [nullid])
351 356 result = {clnode(r) for r in result}
352 357 return result, anyincoming, srvheadhashes
General Comments 0
You need to be logged in to leave comments. Login now