##// END OF EJS Templates
discovery: fix embarrassing typo in slice definition...
marmoute -
r42145:0d467e4d default
parent child Browse files
Show More
@@ -1,375 +1,375 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 _limitsample(sample, desiredlen):
96 96 """return a random subset of sample of at most desiredlen item"""
97 97 if len(sample) > desiredlen:
98 98 sample = set(random.sample(sample, desiredlen))
99 99 return sample
100 100
101 101 class partialdiscovery(object):
102 102 """an object representing ongoing discovery
103 103
104 104 Feed with data from the remote repository, this object keep track of the
105 105 current set of changeset in various states:
106 106
107 107 - common: revs also known remotely
108 108 - undecided: revs we don't have information on yet
109 109 - missing: revs missing remotely
110 110 (all tracked revisions are known locally)
111 111 """
112 112
113 113 def __init__(self, repo, targetheads):
114 114 self._repo = repo
115 115 self._targetheads = targetheads
116 116 self._common = repo.changelog.incrementalmissingrevs()
117 117 self._undecided = None
118 118 self.missing = set()
119 119 self._childrenmap = None
120 120
121 121 def addcommons(self, commons):
122 122 """registrer nodes known as common"""
123 123 self._common.addbases(commons)
124 124 if self._undecided is not None:
125 125 self._common.removeancestorsfrom(self._undecided)
126 126
127 127 def addmissings(self, missings):
128 128 """registrer some nodes as missing"""
129 129 newmissing = self._repo.revs('%ld::%ld', missings, self.undecided)
130 130 if newmissing:
131 131 self.missing.update(newmissing)
132 132 self.undecided.difference_update(newmissing)
133 133
134 134 def addinfo(self, sample):
135 135 """consume an iterable of (rev, known) tuples"""
136 136 common = set()
137 137 missing = set()
138 138 for rev, known in sample:
139 139 if known:
140 140 common.add(rev)
141 141 else:
142 142 missing.add(rev)
143 143 if common:
144 144 self.addcommons(common)
145 145 if missing:
146 146 self.addmissings(missing)
147 147
148 148 def hasinfo(self):
149 149 """return True is we have any clue about the remote state"""
150 150 return self._common.hasbases()
151 151
152 152 def iscomplete(self):
153 153 """True if all the necessary data have been gathered"""
154 154 return self._undecided is not None and not self._undecided
155 155
156 156 @property
157 157 def undecided(self):
158 158 if self._undecided is not None:
159 159 return self._undecided
160 160 self._undecided = set(self._common.missingancestors(self._targetheads))
161 161 return self._undecided
162 162
163 163 def commonheads(self):
164 164 """the heads of the known common set"""
165 165 # heads(common) == heads(common.bases) since common represents
166 166 # common.bases and all its ancestors
167 167 return self._common.basesheads()
168 168
169 169 def _parentsgetter(self):
170 170 getrev = self._repo.changelog.index.__getitem__
171 171 def getparents(r):
172 return getrev(r)[5:6]
172 return getrev(r)[5:7]
173 173 return getparents
174 174
175 175 def _childrengetter(self):
176 176
177 177 if self._childrenmap is not None:
178 178 # During discovery, the `undecided` set keep shrinking.
179 179 # Therefore, the map computed for an iteration N will be
180 180 # valid for iteration N+1. Instead of computing the same
181 181 # data over and over we cached it the first time.
182 182 return self._childrenmap.__getitem__
183 183
184 184 # _updatesample() essentially does interaction over revisions to look
185 185 # up their children. This lookup is expensive and doing it in a loop is
186 186 # quadratic. We precompute the children for all relevant revisions and
187 187 # make the lookup in _updatesample() a simple dict lookup.
188 188 self._childrenmap = children = {}
189 189
190 190 parentrevs = self._parentsgetter()
191 191 revs = self.undecided
192 192
193 193 for rev in sorted(revs):
194 194 # Always ensure revision has an entry so we don't need to worry
195 195 # about missing keys.
196 196 children[rev] = []
197 197 for prev in parentrevs(rev):
198 198 if prev == nullrev:
199 199 continue
200 200 c = children.get(prev)
201 201 if c is not None:
202 202 c.append(rev)
203 203 return children.__getitem__
204 204
205 205 def takequicksample(self, headrevs, size):
206 206 """takes a quick sample of size <size>
207 207
208 208 It is meant for initial sampling and focuses on querying heads and close
209 209 ancestors of heads.
210 210
211 211 :headrevs: set of head revisions in local DAG to consider
212 212 :size: the maximum size of the sample"""
213 213 revs = self.undecided
214 214 if len(revs) <= size:
215 215 return list(revs)
216 216 sample = set(self._repo.revs('heads(%ld)', revs))
217 217
218 218 if len(sample) >= size:
219 219 return _limitsample(sample, size)
220 220
221 221 _updatesample(None, headrevs, sample, self._parentsgetter(),
222 222 quicksamplesize=size)
223 223 return sample
224 224
225 225 def takefullsample(self, headrevs, size):
226 226 revs = self.undecided
227 227 if len(revs) <= size:
228 228 return list(revs)
229 229 repo = self._repo
230 230 sample = set(repo.revs('heads(%ld)', revs))
231 231 parentrevs = self._parentsgetter()
232 232
233 233 # update from heads
234 234 revsheads = sample.copy()
235 235 _updatesample(revs, revsheads, sample, parentrevs)
236 236
237 237 # update from roots
238 238 revsroots = set(repo.revs('roots(%ld)', revs))
239 239
240 240 childrenrevs = self._childrengetter()
241 241
242 242 _updatesample(revs, revsroots, sample, childrenrevs)
243 243 assert sample
244 244 sample = _limitsample(sample, size)
245 245 if len(sample) < size:
246 246 more = size - len(sample)
247 247 sample.update(random.sample(list(revs - sample), more))
248 248 return sample
249 249
250 250 def findcommonheads(ui, local, remote,
251 251 initialsamplesize=100,
252 252 fullsamplesize=200,
253 253 abortwhenunrelated=True,
254 254 ancestorsof=None):
255 255 '''Return a tuple (common, anyincoming, remoteheads) used to identify
256 256 missing nodes from or in remote.
257 257 '''
258 258 start = util.timer()
259 259
260 260 roundtrips = 0
261 261 cl = local.changelog
262 262 clnode = cl.node
263 263 clrev = cl.rev
264 264
265 265 if ancestorsof is not None:
266 266 ownheads = [clrev(n) for n in ancestorsof]
267 267 else:
268 268 ownheads = [rev for rev in cl.headrevs() if rev != nullrev]
269 269
270 270 # early exit if we know all the specified remote heads already
271 271 ui.debug("query 1; heads\n")
272 272 roundtrips += 1
273 273 sample = _limitsample(ownheads, initialsamplesize)
274 274 # indices between sample and externalized version must match
275 275 sample = list(sample)
276 276
277 277 with remote.commandexecutor() as e:
278 278 fheads = e.callcommand('heads', {})
279 279 fknown = e.callcommand('known', {
280 280 'nodes': [clnode(r) for r in sample],
281 281 })
282 282
283 283 srvheadhashes, yesno = fheads.result(), fknown.result()
284 284
285 285 if cl.tip() == nullid:
286 286 if srvheadhashes != [nullid]:
287 287 return [nullid], True, srvheadhashes
288 288 return [nullid], False, []
289 289
290 290 # start actual discovery (we note this before the next "if" for
291 291 # compatibility reasons)
292 292 ui.status(_("searching for changes\n"))
293 293
294 294 knownsrvheads = [] # revnos of remote heads that are known locally
295 295 for node in srvheadhashes:
296 296 if node == nullid:
297 297 continue
298 298
299 299 try:
300 300 knownsrvheads.append(clrev(node))
301 301 # Catches unknown and filtered nodes.
302 302 except error.LookupError:
303 303 continue
304 304
305 305 if len(knownsrvheads) == len(srvheadhashes):
306 306 ui.debug("all remote heads known locally\n")
307 307 return srvheadhashes, False, srvheadhashes
308 308
309 309 if len(sample) == len(ownheads) and all(yesno):
310 310 ui.note(_("all local heads known remotely\n"))
311 311 ownheadhashes = [clnode(r) for r in ownheads]
312 312 return ownheadhashes, True, srvheadhashes
313 313
314 314 # full blown discovery
315 315
316 316 disco = partialdiscovery(local, ownheads)
317 317 # treat remote heads (and maybe own heads) as a first implicit sample
318 318 # response
319 319 disco.addcommons(knownsrvheads)
320 320 disco.addinfo(zip(sample, yesno))
321 321
322 322 full = False
323 323 progress = ui.makeprogress(_('searching'), unit=_('queries'))
324 324 while not disco.iscomplete():
325 325
326 326 if full or disco.hasinfo():
327 327 if full:
328 328 ui.note(_("sampling from both directions\n"))
329 329 else:
330 330 ui.debug("taking initial sample\n")
331 331 samplefunc = disco.takefullsample
332 332 targetsize = fullsamplesize
333 333 else:
334 334 # use even cheaper initial sample
335 335 ui.debug("taking quick initial sample\n")
336 336 samplefunc = disco.takequicksample
337 337 targetsize = initialsamplesize
338 338 sample = samplefunc(ownheads, targetsize)
339 339
340 340 roundtrips += 1
341 341 progress.update(roundtrips)
342 342 ui.debug("query %i; still undecided: %i, sample size is: %i\n"
343 343 % (roundtrips, len(disco.undecided), len(sample)))
344 344 # indices between sample and externalized version must match
345 345 sample = list(sample)
346 346
347 347 with remote.commandexecutor() as e:
348 348 yesno = e.callcommand('known', {
349 349 'nodes': [clnode(r) for r in sample],
350 350 }).result()
351 351
352 352 full = True
353 353
354 354 disco.addinfo(zip(sample, yesno))
355 355
356 356 result = disco.commonheads()
357 357 elapsed = util.timer() - start
358 358 progress.complete()
359 359 ui.debug("%d total queries in %.4fs\n" % (roundtrips, elapsed))
360 360 msg = ('found %d common and %d unknown server heads,'
361 361 ' %d roundtrips in %.4fs\n')
362 362 missing = set(result) - set(knownsrvheads)
363 363 ui.log('discovery', msg, len(result), len(missing), roundtrips,
364 364 elapsed)
365 365
366 366 if not result and srvheadhashes != [nullid]:
367 367 if abortwhenunrelated:
368 368 raise error.Abort(_("repository is unrelated"))
369 369 else:
370 370 ui.warn(_("warning: repository is unrelated\n"))
371 371 return ({nullid}, True, srvheadhashes,)
372 372
373 373 anyincoming = (srvheadhashes != [nullid])
374 374 result = {clnode(r) for r in result}
375 375 return result, anyincoming, srvheadhashes
General Comments 0
You need to be logged in to leave comments. Login now