##// END OF EJS Templates
generatorset: implement __len__...
Pierre-Yves David -
r22996:a43d929d default
parent child Browse files
Show More
@@ -1,2972 +1,2977 b''
1 1 # revset.py - revision set queries for mercurial
2 2 #
3 3 # Copyright 2010 Matt Mackall <mpm@selenic.com>
4 4 #
5 5 # This software may be used and distributed according to the terms of the
6 6 # GNU General Public License version 2 or any later version.
7 7
8 8 import re
9 9 import parser, util, error, discovery, hbisect, phases
10 10 import node
11 11 import heapq
12 12 import match as matchmod
13 13 import ancestor as ancestormod
14 14 from i18n import _
15 15 import encoding
16 16 import obsolete as obsmod
17 17 import pathutil
18 18 import repoview
19 19
20 20 def _revancestors(repo, revs, followfirst):
21 21 """Like revlog.ancestors(), but supports followfirst."""
22 22 cut = followfirst and 1 or None
23 23 cl = repo.changelog
24 24
25 25 def iterate():
26 26 revqueue, revsnode = None, None
27 27 h = []
28 28
29 29 revs.sort(reverse=True)
30 30 revqueue = util.deque(revs)
31 31 if revqueue:
32 32 revsnode = revqueue.popleft()
33 33 heapq.heappush(h, -revsnode)
34 34
35 35 seen = set([node.nullrev])
36 36 while h:
37 37 current = -heapq.heappop(h)
38 38 if current not in seen:
39 39 if revsnode and current == revsnode:
40 40 if revqueue:
41 41 revsnode = revqueue.popleft()
42 42 heapq.heappush(h, -revsnode)
43 43 seen.add(current)
44 44 yield current
45 45 for parent in cl.parentrevs(current)[:cut]:
46 46 if parent != node.nullrev:
47 47 heapq.heappush(h, -parent)
48 48
49 49 return generatorset(iterate(), iterasc=False)
50 50
51 51 def _revdescendants(repo, revs, followfirst):
52 52 """Like revlog.descendants() but supports followfirst."""
53 53 cut = followfirst and 1 or None
54 54
55 55 def iterate():
56 56 cl = repo.changelog
57 57 first = min(revs)
58 58 nullrev = node.nullrev
59 59 if first == nullrev:
60 60 # Are there nodes with a null first parent and a non-null
61 61 # second one? Maybe. Do we care? Probably not.
62 62 for i in cl:
63 63 yield i
64 64 else:
65 65 seen = set(revs)
66 66 for i in cl.revs(first + 1):
67 67 for x in cl.parentrevs(i)[:cut]:
68 68 if x != nullrev and x in seen:
69 69 seen.add(i)
70 70 yield i
71 71 break
72 72
73 73 return generatorset(iterate(), iterasc=True)
74 74
75 75 def _revsbetween(repo, roots, heads):
76 76 """Return all paths between roots and heads, inclusive of both endpoint
77 77 sets."""
78 78 if not roots:
79 79 return baseset()
80 80 parentrevs = repo.changelog.parentrevs
81 81 visit = list(heads)
82 82 reachable = set()
83 83 seen = {}
84 84 minroot = min(roots)
85 85 roots = set(roots)
86 86 # open-code the post-order traversal due to the tiny size of
87 87 # sys.getrecursionlimit()
88 88 while visit:
89 89 rev = visit.pop()
90 90 if rev in roots:
91 91 reachable.add(rev)
92 92 parents = parentrevs(rev)
93 93 seen[rev] = parents
94 94 for parent in parents:
95 95 if parent >= minroot and parent not in seen:
96 96 visit.append(parent)
97 97 if not reachable:
98 98 return baseset()
99 99 for rev in sorted(seen):
100 100 for parent in seen[rev]:
101 101 if parent in reachable:
102 102 reachable.add(rev)
103 103 return baseset(sorted(reachable))
104 104
105 105 elements = {
106 106 "(": (20, ("group", 1, ")"), ("func", 1, ")")),
107 107 "~": (18, None, ("ancestor", 18)),
108 108 "^": (18, None, ("parent", 18), ("parentpost", 18)),
109 109 "-": (5, ("negate", 19), ("minus", 5)),
110 110 "::": (17, ("dagrangepre", 17), ("dagrange", 17),
111 111 ("dagrangepost", 17)),
112 112 "..": (17, ("dagrangepre", 17), ("dagrange", 17),
113 113 ("dagrangepost", 17)),
114 114 ":": (15, ("rangepre", 15), ("range", 15), ("rangepost", 15)),
115 115 "not": (10, ("not", 10)),
116 116 "!": (10, ("not", 10)),
117 117 "and": (5, None, ("and", 5)),
118 118 "&": (5, None, ("and", 5)),
119 119 "or": (4, None, ("or", 4)),
120 120 "|": (4, None, ("or", 4)),
121 121 "+": (4, None, ("or", 4)),
122 122 ",": (2, None, ("list", 2)),
123 123 ")": (0, None, None),
124 124 "symbol": (0, ("symbol",), None),
125 125 "string": (0, ("string",), None),
126 126 "end": (0, None, None),
127 127 }
128 128
129 129 keywords = set(['and', 'or', 'not'])
130 130
131 131 def tokenize(program, lookup=None):
132 132 '''
133 133 Parse a revset statement into a stream of tokens
134 134
135 135 Check that @ is a valid unquoted token character (issue3686):
136 136 >>> list(tokenize("@::"))
137 137 [('symbol', '@', 0), ('::', None, 1), ('end', None, 3)]
138 138
139 139 '''
140 140
141 141 pos, l = 0, len(program)
142 142 while pos < l:
143 143 c = program[pos]
144 144 if c.isspace(): # skip inter-token whitespace
145 145 pass
146 146 elif c == ':' and program[pos:pos + 2] == '::': # look ahead carefully
147 147 yield ('::', None, pos)
148 148 pos += 1 # skip ahead
149 149 elif c == '.' and program[pos:pos + 2] == '..': # look ahead carefully
150 150 yield ('..', None, pos)
151 151 pos += 1 # skip ahead
152 152 elif c in "():,-|&+!~^": # handle simple operators
153 153 yield (c, None, pos)
154 154 elif (c in '"\'' or c == 'r' and
155 155 program[pos:pos + 2] in ("r'", 'r"')): # handle quoted strings
156 156 if c == 'r':
157 157 pos += 1
158 158 c = program[pos]
159 159 decode = lambda x: x
160 160 else:
161 161 decode = lambda x: x.decode('string-escape')
162 162 pos += 1
163 163 s = pos
164 164 while pos < l: # find closing quote
165 165 d = program[pos]
166 166 if d == '\\': # skip over escaped characters
167 167 pos += 2
168 168 continue
169 169 if d == c:
170 170 yield ('string', decode(program[s:pos]), s)
171 171 break
172 172 pos += 1
173 173 else:
174 174 raise error.ParseError(_("unterminated string"), s)
175 175 # gather up a symbol/keyword
176 176 elif c.isalnum() or c in '._@' or ord(c) > 127:
177 177 s = pos
178 178 pos += 1
179 179 while pos < l: # find end of symbol
180 180 d = program[pos]
181 181 if not (d.isalnum() or d in "-._/@" or ord(d) > 127):
182 182 break
183 183 if d == '.' and program[pos - 1] == '.': # special case for ..
184 184 pos -= 1
185 185 break
186 186 pos += 1
187 187 sym = program[s:pos]
188 188 if sym in keywords: # operator keywords
189 189 yield (sym, None, s)
190 190 elif '-' in sym:
191 191 # some jerk gave us foo-bar-baz, try to check if it's a symbol
192 192 if lookup and lookup(sym):
193 193 # looks like a real symbol
194 194 yield ('symbol', sym, s)
195 195 else:
196 196 # looks like an expression
197 197 parts = sym.split('-')
198 198 for p in parts[:-1]:
199 199 if p: # possible consecutive -
200 200 yield ('symbol', p, s)
201 201 s += len(p)
202 202 yield ('-', None, pos)
203 203 s += 1
204 204 if parts[-1]: # possible trailing -
205 205 yield ('symbol', parts[-1], s)
206 206 else:
207 207 yield ('symbol', sym, s)
208 208 pos -= 1
209 209 else:
210 210 raise error.ParseError(_("syntax error"), pos)
211 211 pos += 1
212 212 yield ('end', None, pos)
213 213
214 214 # helpers
215 215
216 216 def getstring(x, err):
217 217 if x and (x[0] == 'string' or x[0] == 'symbol'):
218 218 return x[1]
219 219 raise error.ParseError(err)
220 220
221 221 def getlist(x):
222 222 if not x:
223 223 return []
224 224 if x[0] == 'list':
225 225 return getlist(x[1]) + [x[2]]
226 226 return [x]
227 227
228 228 def getargs(x, min, max, err):
229 229 l = getlist(x)
230 230 if len(l) < min or (max >= 0 and len(l) > max):
231 231 raise error.ParseError(err)
232 232 return l
233 233
234 234 def getset(repo, subset, x):
235 235 if not x:
236 236 raise error.ParseError(_("missing argument"))
237 237 s = methods[x[0]](repo, subset, *x[1:])
238 238 if util.safehasattr(s, 'isascending'):
239 239 return s
240 240 return baseset(s)
241 241
242 242 def _getrevsource(repo, r):
243 243 extra = repo[r].extra()
244 244 for label in ('source', 'transplant_source', 'rebase_source'):
245 245 if label in extra:
246 246 try:
247 247 return repo[extra[label]].rev()
248 248 except error.RepoLookupError:
249 249 pass
250 250 return None
251 251
252 252 # operator methods
253 253
254 254 def stringset(repo, subset, x):
255 255 x = repo[x].rev()
256 256 if x == -1 and len(subset) == len(repo):
257 257 return baseset([-1])
258 258 if len(subset) == len(repo) or x in subset:
259 259 return baseset([x])
260 260 return baseset()
261 261
262 262 def symbolset(repo, subset, x):
263 263 if x in symbols:
264 264 raise error.ParseError(_("can't use %s here") % x)
265 265 return stringset(repo, subset, x)
266 266
267 267 def rangeset(repo, subset, x, y):
268 268 cl = baseset(repo.changelog)
269 269 m = getset(repo, cl, x)
270 270 n = getset(repo, cl, y)
271 271
272 272 if not m or not n:
273 273 return baseset()
274 274 m, n = m.first(), n.last()
275 275
276 276 if m < n:
277 277 r = spanset(repo, m, n + 1)
278 278 else:
279 279 r = spanset(repo, m, n - 1)
280 280 return r & subset
281 281
282 282 def dagrange(repo, subset, x, y):
283 283 r = spanset(repo)
284 284 xs = _revsbetween(repo, getset(repo, r, x), getset(repo, r, y))
285 285 return xs & subset
286 286
287 287 def andset(repo, subset, x, y):
288 288 return getset(repo, getset(repo, subset, x), y)
289 289
290 290 def orset(repo, subset, x, y):
291 291 xl = getset(repo, subset, x)
292 292 yl = getset(repo, subset - xl, y)
293 293 return xl + yl
294 294
295 295 def notset(repo, subset, x):
296 296 return subset - getset(repo, subset, x)
297 297
298 298 def listset(repo, subset, a, b):
299 299 raise error.ParseError(_("can't use a list in this context"))
300 300
301 301 def func(repo, subset, a, b):
302 302 if a[0] == 'symbol' and a[1] in symbols:
303 303 return symbols[a[1]](repo, subset, b)
304 304 raise error.ParseError(_("not a function: %s") % a[1])
305 305
306 306 # functions
307 307
308 308 def adds(repo, subset, x):
309 309 """``adds(pattern)``
310 310 Changesets that add a file matching pattern.
311 311
312 312 The pattern without explicit kind like ``glob:`` is expected to be
313 313 relative to the current directory and match against a file or a
314 314 directory.
315 315 """
316 316 # i18n: "adds" is a keyword
317 317 pat = getstring(x, _("adds requires a pattern"))
318 318 return checkstatus(repo, subset, pat, 1)
319 319
320 320 def ancestor(repo, subset, x):
321 321 """``ancestor(*changeset)``
322 322 A greatest common ancestor of the changesets.
323 323
324 324 Accepts 0 or more changesets.
325 325 Will return empty list when passed no args.
326 326 Greatest common ancestor of a single changeset is that changeset.
327 327 """
328 328 # i18n: "ancestor" is a keyword
329 329 l = getlist(x)
330 330 rl = spanset(repo)
331 331 anc = None
332 332
333 333 # (getset(repo, rl, i) for i in l) generates a list of lists
334 334 for revs in (getset(repo, rl, i) for i in l):
335 335 for r in revs:
336 336 if anc is None:
337 337 anc = repo[r]
338 338 else:
339 339 anc = anc.ancestor(repo[r])
340 340
341 341 if anc is not None and anc.rev() in subset:
342 342 return baseset([anc.rev()])
343 343 return baseset()
344 344
345 345 def _ancestors(repo, subset, x, followfirst=False):
346 346 heads = getset(repo, spanset(repo), x)
347 347 if not heads:
348 348 return baseset()
349 349 s = _revancestors(repo, heads, followfirst)
350 350 return subset.filter(s.__contains__)
351 351
352 352 def ancestors(repo, subset, x):
353 353 """``ancestors(set)``
354 354 Changesets that are ancestors of a changeset in set.
355 355 """
356 356 return _ancestors(repo, subset, x)
357 357
358 358 def _firstancestors(repo, subset, x):
359 359 # ``_firstancestors(set)``
360 360 # Like ``ancestors(set)`` but follows only the first parents.
361 361 return _ancestors(repo, subset, x, followfirst=True)
362 362
363 363 def ancestorspec(repo, subset, x, n):
364 364 """``set~n``
365 365 Changesets that are the Nth ancestor (first parents only) of a changeset
366 366 in set.
367 367 """
368 368 try:
369 369 n = int(n[1])
370 370 except (TypeError, ValueError):
371 371 raise error.ParseError(_("~ expects a number"))
372 372 ps = set()
373 373 cl = repo.changelog
374 374 for r in getset(repo, baseset(cl), x):
375 375 for i in range(n):
376 376 r = cl.parentrevs(r)[0]
377 377 ps.add(r)
378 378 return subset & ps
379 379
380 380 def author(repo, subset, x):
381 381 """``author(string)``
382 382 Alias for ``user(string)``.
383 383 """
384 384 # i18n: "author" is a keyword
385 385 n = encoding.lower(getstring(x, _("author requires a string")))
386 386 kind, pattern, matcher = _substringmatcher(n)
387 387 return subset.filter(lambda x: matcher(encoding.lower(repo[x].user())))
388 388
389 389 def only(repo, subset, x):
390 390 """``only(set, [set])``
391 391 Changesets that are ancestors of the first set that are not ancestors
392 392 of any other head in the repo. If a second set is specified, the result
393 393 is ancestors of the first set that are not ancestors of the second set
394 394 (i.e. ::<set1> - ::<set2>).
395 395 """
396 396 cl = repo.changelog
397 397 # i18n: "only" is a keyword
398 398 args = getargs(x, 1, 2, _('only takes one or two arguments'))
399 399 include = getset(repo, spanset(repo), args[0])
400 400 if len(args) == 1:
401 401 if len(include) == 0:
402 402 return baseset()
403 403
404 404 descendants = set(_revdescendants(repo, include, False))
405 405 exclude = [rev for rev in cl.headrevs()
406 406 if not rev in descendants and not rev in include]
407 407 else:
408 408 exclude = getset(repo, spanset(repo), args[1])
409 409
410 410 results = set(ancestormod.missingancestors(include, exclude, cl.parentrevs))
411 411 return filteredset(subset, results.__contains__)
412 412
413 413 def bisect(repo, subset, x):
414 414 """``bisect(string)``
415 415 Changesets marked in the specified bisect status:
416 416
417 417 - ``good``, ``bad``, ``skip``: csets explicitly marked as good/bad/skip
418 418 - ``goods``, ``bads`` : csets topologically good/bad
419 419 - ``range`` : csets taking part in the bisection
420 420 - ``pruned`` : csets that are goods, bads or skipped
421 421 - ``untested`` : csets whose fate is yet unknown
422 422 - ``ignored`` : csets ignored due to DAG topology
423 423 - ``current`` : the cset currently being bisected
424 424 """
425 425 # i18n: "bisect" is a keyword
426 426 status = getstring(x, _("bisect requires a string")).lower()
427 427 state = set(hbisect.get(repo, status))
428 428 return subset & state
429 429
430 430 # Backward-compatibility
431 431 # - no help entry so that we do not advertise it any more
432 432 def bisected(repo, subset, x):
433 433 return bisect(repo, subset, x)
434 434
435 435 def bookmark(repo, subset, x):
436 436 """``bookmark([name])``
437 437 The named bookmark or all bookmarks.
438 438
439 439 If `name` starts with `re:`, the remainder of the name is treated as
440 440 a regular expression. To match a bookmark that actually starts with `re:`,
441 441 use the prefix `literal:`.
442 442 """
443 443 # i18n: "bookmark" is a keyword
444 444 args = getargs(x, 0, 1, _('bookmark takes one or no arguments'))
445 445 if args:
446 446 bm = getstring(args[0],
447 447 # i18n: "bookmark" is a keyword
448 448 _('the argument to bookmark must be a string'))
449 449 kind, pattern, matcher = _stringmatcher(bm)
450 450 bms = set()
451 451 if kind == 'literal':
452 452 bmrev = repo._bookmarks.get(pattern, None)
453 453 if not bmrev:
454 454 raise util.Abort(_("bookmark '%s' does not exist") % bm)
455 455 bms.add(repo[bmrev].rev())
456 456 else:
457 457 matchrevs = set()
458 458 for name, bmrev in repo._bookmarks.iteritems():
459 459 if matcher(name):
460 460 matchrevs.add(bmrev)
461 461 if not matchrevs:
462 462 raise util.Abort(_("no bookmarks exist that match '%s'")
463 463 % pattern)
464 464 for bmrev in matchrevs:
465 465 bms.add(repo[bmrev].rev())
466 466 else:
467 467 bms = set([repo[r].rev()
468 468 for r in repo._bookmarks.values()])
469 469 bms -= set([node.nullrev])
470 470 return subset & bms
471 471
472 472 def branch(repo, subset, x):
473 473 """``branch(string or set)``
474 474 All changesets belonging to the given branch or the branches of the given
475 475 changesets.
476 476
477 477 If `string` starts with `re:`, the remainder of the name is treated as
478 478 a regular expression. To match a branch that actually starts with `re:`,
479 479 use the prefix `literal:`.
480 480 """
481 481 try:
482 482 b = getstring(x, '')
483 483 except error.ParseError:
484 484 # not a string, but another revspec, e.g. tip()
485 485 pass
486 486 else:
487 487 kind, pattern, matcher = _stringmatcher(b)
488 488 if kind == 'literal':
489 489 # note: falls through to the revspec case if no branch with
490 490 # this name exists
491 491 if pattern in repo.branchmap():
492 492 return subset.filter(lambda r: matcher(repo[r].branch()))
493 493 else:
494 494 return subset.filter(lambda r: matcher(repo[r].branch()))
495 495
496 496 s = getset(repo, spanset(repo), x)
497 497 b = set()
498 498 for r in s:
499 499 b.add(repo[r].branch())
500 500 c = s.__contains__
501 501 return subset.filter(lambda r: c(r) or repo[r].branch() in b)
502 502
503 503 def bumped(repo, subset, x):
504 504 """``bumped()``
505 505 Mutable changesets marked as successors of public changesets.
506 506
507 507 Only non-public and non-obsolete changesets can be `bumped`.
508 508 """
509 509 # i18n: "bumped" is a keyword
510 510 getargs(x, 0, 0, _("bumped takes no arguments"))
511 511 bumped = obsmod.getrevs(repo, 'bumped')
512 512 return subset & bumped
513 513
514 514 def bundle(repo, subset, x):
515 515 """``bundle()``
516 516 Changesets in the bundle.
517 517
518 518 Bundle must be specified by the -R option."""
519 519
520 520 try:
521 521 bundlerevs = repo.changelog.bundlerevs
522 522 except AttributeError:
523 523 raise util.Abort(_("no bundle provided - specify with -R"))
524 524 return subset & bundlerevs
525 525
526 526 def checkstatus(repo, subset, pat, field):
527 527 hasset = matchmod.patkind(pat) == 'set'
528 528
529 529 def matches(x):
530 530 m = None
531 531 fname = None
532 532 c = repo[x]
533 533 if not m or hasset:
534 534 m = matchmod.match(repo.root, repo.getcwd(), [pat], ctx=c)
535 535 if not m.anypats() and len(m.files()) == 1:
536 536 fname = m.files()[0]
537 537 if fname is not None:
538 538 if fname not in c.files():
539 539 return False
540 540 else:
541 541 for f in c.files():
542 542 if m(f):
543 543 break
544 544 else:
545 545 return False
546 546 files = repo.status(c.p1().node(), c.node())[field]
547 547 if fname is not None:
548 548 if fname in files:
549 549 return True
550 550 else:
551 551 for f in files:
552 552 if m(f):
553 553 return True
554 554
555 555 return subset.filter(matches)
556 556
557 557 def _children(repo, narrow, parentset):
558 558 cs = set()
559 559 if not parentset:
560 560 return baseset(cs)
561 561 pr = repo.changelog.parentrevs
562 562 minrev = min(parentset)
563 563 for r in narrow:
564 564 if r <= minrev:
565 565 continue
566 566 for p in pr(r):
567 567 if p in parentset:
568 568 cs.add(r)
569 569 return baseset(cs)
570 570
571 571 def children(repo, subset, x):
572 572 """``children(set)``
573 573 Child changesets of changesets in set.
574 574 """
575 575 s = getset(repo, baseset(repo), x)
576 576 cs = _children(repo, subset, s)
577 577 return subset & cs
578 578
579 579 def closed(repo, subset, x):
580 580 """``closed()``
581 581 Changeset is closed.
582 582 """
583 583 # i18n: "closed" is a keyword
584 584 getargs(x, 0, 0, _("closed takes no arguments"))
585 585 return subset.filter(lambda r: repo[r].closesbranch())
586 586
587 587 def contains(repo, subset, x):
588 588 """``contains(pattern)``
589 589 The revision's manifest contains a file matching pattern (but might not
590 590 modify it). See :hg:`help patterns` for information about file patterns.
591 591
592 592 The pattern without explicit kind like ``glob:`` is expected to be
593 593 relative to the current directory and match against a file exactly
594 594 for efficiency.
595 595 """
596 596 # i18n: "contains" is a keyword
597 597 pat = getstring(x, _("contains requires a pattern"))
598 598
599 599 def matches(x):
600 600 if not matchmod.patkind(pat):
601 601 pats = pathutil.canonpath(repo.root, repo.getcwd(), pat)
602 602 if pats in repo[x]:
603 603 return True
604 604 else:
605 605 c = repo[x]
606 606 m = matchmod.match(repo.root, repo.getcwd(), [pat], ctx=c)
607 607 for f in c.manifest():
608 608 if m(f):
609 609 return True
610 610 return False
611 611
612 612 return subset.filter(matches)
613 613
614 614 def converted(repo, subset, x):
615 615 """``converted([id])``
616 616 Changesets converted from the given identifier in the old repository if
617 617 present, or all converted changesets if no identifier is specified.
618 618 """
619 619
620 620 # There is exactly no chance of resolving the revision, so do a simple
621 621 # string compare and hope for the best
622 622
623 623 rev = None
624 624 # i18n: "converted" is a keyword
625 625 l = getargs(x, 0, 1, _('converted takes one or no arguments'))
626 626 if l:
627 627 # i18n: "converted" is a keyword
628 628 rev = getstring(l[0], _('converted requires a revision'))
629 629
630 630 def _matchvalue(r):
631 631 source = repo[r].extra().get('convert_revision', None)
632 632 return source is not None and (rev is None or source.startswith(rev))
633 633
634 634 return subset.filter(lambda r: _matchvalue(r))
635 635
636 636 def date(repo, subset, x):
637 637 """``date(interval)``
638 638 Changesets within the interval, see :hg:`help dates`.
639 639 """
640 640 # i18n: "date" is a keyword
641 641 ds = getstring(x, _("date requires a string"))
642 642 dm = util.matchdate(ds)
643 643 return subset.filter(lambda x: dm(repo[x].date()[0]))
644 644
645 645 def desc(repo, subset, x):
646 646 """``desc(string)``
647 647 Search commit message for string. The match is case-insensitive.
648 648 """
649 649 # i18n: "desc" is a keyword
650 650 ds = encoding.lower(getstring(x, _("desc requires a string")))
651 651
652 652 def matches(x):
653 653 c = repo[x]
654 654 return ds in encoding.lower(c.description())
655 655
656 656 return subset.filter(matches)
657 657
658 658 def _descendants(repo, subset, x, followfirst=False):
659 659 roots = getset(repo, spanset(repo), x)
660 660 if not roots:
661 661 return baseset()
662 662 s = _revdescendants(repo, roots, followfirst)
663 663
664 664 # Both sets need to be ascending in order to lazily return the union
665 665 # in the correct order.
666 666 base = subset & roots
667 667 desc = subset & s
668 668 result = base + desc
669 669 if subset.isascending():
670 670 result.sort()
671 671 elif subset.isdescending():
672 672 result.sort(reverse=True)
673 673 else:
674 674 result = subset & result
675 675 return result
676 676
677 677 def descendants(repo, subset, x):
678 678 """``descendants(set)``
679 679 Changesets which are descendants of changesets in set.
680 680 """
681 681 return _descendants(repo, subset, x)
682 682
683 683 def _firstdescendants(repo, subset, x):
684 684 # ``_firstdescendants(set)``
685 685 # Like ``descendants(set)`` but follows only the first parents.
686 686 return _descendants(repo, subset, x, followfirst=True)
687 687
688 688 def destination(repo, subset, x):
689 689 """``destination([set])``
690 690 Changesets that were created by a graft, transplant or rebase operation,
691 691 with the given revisions specified as the source. Omitting the optional set
692 692 is the same as passing all().
693 693 """
694 694 if x is not None:
695 695 sources = getset(repo, spanset(repo), x)
696 696 else:
697 697 sources = getall(repo, spanset(repo), x)
698 698
699 699 dests = set()
700 700
701 701 # subset contains all of the possible destinations that can be returned, so
702 702 # iterate over them and see if their source(s) were provided in the arg set.
703 703 # Even if the immediate src of r is not in the arg set, src's source (or
704 704 # further back) may be. Scanning back further than the immediate src allows
705 705 # transitive transplants and rebases to yield the same results as transitive
706 706 # grafts.
707 707 for r in subset:
708 708 src = _getrevsource(repo, r)
709 709 lineage = None
710 710
711 711 while src is not None:
712 712 if lineage is None:
713 713 lineage = list()
714 714
715 715 lineage.append(r)
716 716
717 717 # The visited lineage is a match if the current source is in the arg
718 718 # set. Since every candidate dest is visited by way of iterating
719 719 # subset, any dests further back in the lineage will be tested by a
720 720 # different iteration over subset. Likewise, if the src was already
721 721 # selected, the current lineage can be selected without going back
722 722 # further.
723 723 if src in sources or src in dests:
724 724 dests.update(lineage)
725 725 break
726 726
727 727 r = src
728 728 src = _getrevsource(repo, r)
729 729
730 730 return subset.filter(dests.__contains__)
731 731
732 732 def divergent(repo, subset, x):
733 733 """``divergent()``
734 734 Final successors of changesets with an alternative set of final successors.
735 735 """
736 736 # i18n: "divergent" is a keyword
737 737 getargs(x, 0, 0, _("divergent takes no arguments"))
738 738 divergent = obsmod.getrevs(repo, 'divergent')
739 739 return subset & divergent
740 740
741 741 def draft(repo, subset, x):
742 742 """``draft()``
743 743 Changeset in draft phase."""
744 744 # i18n: "draft" is a keyword
745 745 getargs(x, 0, 0, _("draft takes no arguments"))
746 746 pc = repo._phasecache
747 747 return subset.filter(lambda r: pc.phase(repo, r) == phases.draft)
748 748
749 749 def extinct(repo, subset, x):
750 750 """``extinct()``
751 751 Obsolete changesets with obsolete descendants only.
752 752 """
753 753 # i18n: "extinct" is a keyword
754 754 getargs(x, 0, 0, _("extinct takes no arguments"))
755 755 extincts = obsmod.getrevs(repo, 'extinct')
756 756 return subset & extincts
757 757
758 758 def extra(repo, subset, x):
759 759 """``extra(label, [value])``
760 760 Changesets with the given label in the extra metadata, with the given
761 761 optional value.
762 762
763 763 If `value` starts with `re:`, the remainder of the value is treated as
764 764 a regular expression. To match a value that actually starts with `re:`,
765 765 use the prefix `literal:`.
766 766 """
767 767
768 768 # i18n: "extra" is a keyword
769 769 l = getargs(x, 1, 2, _('extra takes at least 1 and at most 2 arguments'))
770 770 # i18n: "extra" is a keyword
771 771 label = getstring(l[0], _('first argument to extra must be a string'))
772 772 value = None
773 773
774 774 if len(l) > 1:
775 775 # i18n: "extra" is a keyword
776 776 value = getstring(l[1], _('second argument to extra must be a string'))
777 777 kind, value, matcher = _stringmatcher(value)
778 778
779 779 def _matchvalue(r):
780 780 extra = repo[r].extra()
781 781 return label in extra and (value is None or matcher(extra[label]))
782 782
783 783 return subset.filter(lambda r: _matchvalue(r))
784 784
785 785 def filelog(repo, subset, x):
786 786 """``filelog(pattern)``
787 787 Changesets connected to the specified filelog.
788 788
789 789 For performance reasons, visits only revisions mentioned in the file-level
790 790 filelog, rather than filtering through all changesets (much faster, but
791 791 doesn't include deletes or duplicate changes). For a slower, more accurate
792 792 result, use ``file()``.
793 793
794 794 The pattern without explicit kind like ``glob:`` is expected to be
795 795 relative to the current directory and match against a file exactly
796 796 for efficiency.
797 797 """
798 798
799 799 # i18n: "filelog" is a keyword
800 800 pat = getstring(x, _("filelog requires a pattern"))
801 801 s = set()
802 802
803 803 if not matchmod.patkind(pat):
804 804 f = pathutil.canonpath(repo.root, repo.getcwd(), pat)
805 805 fl = repo.file(f)
806 806 for fr in fl:
807 807 s.add(fl.linkrev(fr))
808 808 else:
809 809 m = matchmod.match(repo.root, repo.getcwd(), [pat], ctx=repo[None])
810 810 for f in repo[None]:
811 811 if m(f):
812 812 fl = repo.file(f)
813 813 for fr in fl:
814 814 s.add(fl.linkrev(fr))
815 815
816 816 return subset & s
817 817
818 818 def first(repo, subset, x):
819 819 """``first(set, [n])``
820 820 An alias for limit().
821 821 """
822 822 return limit(repo, subset, x)
823 823
824 824 def _follow(repo, subset, x, name, followfirst=False):
825 825 l = getargs(x, 0, 1, _("%s takes no arguments or a filename") % name)
826 826 c = repo['.']
827 827 if l:
828 828 x = getstring(l[0], _("%s expected a filename") % name)
829 829 if x in c:
830 830 cx = c[x]
831 831 s = set(ctx.rev() for ctx in cx.ancestors(followfirst=followfirst))
832 832 # include the revision responsible for the most recent version
833 833 s.add(cx.linkrev())
834 834 else:
835 835 return baseset()
836 836 else:
837 837 s = _revancestors(repo, baseset([c.rev()]), followfirst)
838 838
839 839 return subset & s
840 840
841 841 def follow(repo, subset, x):
842 842 """``follow([file])``
843 843 An alias for ``::.`` (ancestors of the working copy's first parent).
844 844 If a filename is specified, the history of the given file is followed,
845 845 including copies.
846 846 """
847 847 return _follow(repo, subset, x, 'follow')
848 848
849 849 def _followfirst(repo, subset, x):
850 850 # ``followfirst([file])``
851 851 # Like ``follow([file])`` but follows only the first parent of
852 852 # every revision or file revision.
853 853 return _follow(repo, subset, x, '_followfirst', followfirst=True)
854 854
855 855 def getall(repo, subset, x):
856 856 """``all()``
857 857 All changesets, the same as ``0:tip``.
858 858 """
859 859 # i18n: "all" is a keyword
860 860 getargs(x, 0, 0, _("all takes no arguments"))
861 861 return subset
862 862
863 863 def grep(repo, subset, x):
864 864 """``grep(regex)``
865 865 Like ``keyword(string)`` but accepts a regex. Use ``grep(r'...')``
866 866 to ensure special escape characters are handled correctly. Unlike
867 867 ``keyword(string)``, the match is case-sensitive.
868 868 """
869 869 try:
870 870 # i18n: "grep" is a keyword
871 871 gr = re.compile(getstring(x, _("grep requires a string")))
872 872 except re.error, e:
873 873 raise error.ParseError(_('invalid match pattern: %s') % e)
874 874
875 875 def matches(x):
876 876 c = repo[x]
877 877 for e in c.files() + [c.user(), c.description()]:
878 878 if gr.search(e):
879 879 return True
880 880 return False
881 881
882 882 return subset.filter(matches)
883 883
884 884 def _matchfiles(repo, subset, x):
885 885 # _matchfiles takes a revset list of prefixed arguments:
886 886 #
887 887 # [p:foo, i:bar, x:baz]
888 888 #
889 889 # builds a match object from them and filters subset. Allowed
890 890 # prefixes are 'p:' for regular patterns, 'i:' for include
891 891 # patterns and 'x:' for exclude patterns. Use 'r:' prefix to pass
892 892 # a revision identifier, or the empty string to reference the
893 893 # working directory, from which the match object is
894 894 # initialized. Use 'd:' to set the default matching mode, default
895 895 # to 'glob'. At most one 'r:' and 'd:' argument can be passed.
896 896
897 897 # i18n: "_matchfiles" is a keyword
898 898 l = getargs(x, 1, -1, _("_matchfiles requires at least one argument"))
899 899 pats, inc, exc = [], [], []
900 900 hasset = False
901 901 rev, default = None, None
902 902 for arg in l:
903 903 # i18n: "_matchfiles" is a keyword
904 904 s = getstring(arg, _("_matchfiles requires string arguments"))
905 905 prefix, value = s[:2], s[2:]
906 906 if prefix == 'p:':
907 907 pats.append(value)
908 908 elif prefix == 'i:':
909 909 inc.append(value)
910 910 elif prefix == 'x:':
911 911 exc.append(value)
912 912 elif prefix == 'r:':
913 913 if rev is not None:
914 914 # i18n: "_matchfiles" is a keyword
915 915 raise error.ParseError(_('_matchfiles expected at most one '
916 916 'revision'))
917 917 rev = value
918 918 elif prefix == 'd:':
919 919 if default is not None:
920 920 # i18n: "_matchfiles" is a keyword
921 921 raise error.ParseError(_('_matchfiles expected at most one '
922 922 'default mode'))
923 923 default = value
924 924 else:
925 925 # i18n: "_matchfiles" is a keyword
926 926 raise error.ParseError(_('invalid _matchfiles prefix: %s') % prefix)
927 927 if not hasset and matchmod.patkind(value) == 'set':
928 928 hasset = True
929 929 if not default:
930 930 default = 'glob'
931 931
932 932 def matches(x):
933 933 m = None
934 934 c = repo[x]
935 935 if not m or (hasset and rev is None):
936 936 ctx = c
937 937 if rev is not None:
938 938 ctx = repo[rev or None]
939 939 m = matchmod.match(repo.root, repo.getcwd(), pats, include=inc,
940 940 exclude=exc, ctx=ctx, default=default)
941 941 for f in c.files():
942 942 if m(f):
943 943 return True
944 944 return False
945 945
946 946 return subset.filter(matches)
947 947
948 948 def hasfile(repo, subset, x):
949 949 """``file(pattern)``
950 950 Changesets affecting files matched by pattern.
951 951
952 952 For a faster but less accurate result, consider using ``filelog()``
953 953 instead.
954 954
955 955 This predicate uses ``glob:`` as the default kind of pattern.
956 956 """
957 957 # i18n: "file" is a keyword
958 958 pat = getstring(x, _("file requires a pattern"))
959 959 return _matchfiles(repo, subset, ('string', 'p:' + pat))
960 960
961 961 def head(repo, subset, x):
962 962 """``head()``
963 963 Changeset is a named branch head.
964 964 """
965 965 # i18n: "head" is a keyword
966 966 getargs(x, 0, 0, _("head takes no arguments"))
967 967 hs = set()
968 968 for b, ls in repo.branchmap().iteritems():
969 969 hs.update(repo[h].rev() for h in ls)
970 970 return baseset(hs).filter(subset.__contains__)
971 971
972 972 def heads(repo, subset, x):
973 973 """``heads(set)``
974 974 Members of set with no children in set.
975 975 """
976 976 s = getset(repo, subset, x)
977 977 ps = parents(repo, subset, x)
978 978 return s - ps
979 979
980 980 def hidden(repo, subset, x):
981 981 """``hidden()``
982 982 Hidden changesets.
983 983 """
984 984 # i18n: "hidden" is a keyword
985 985 getargs(x, 0, 0, _("hidden takes no arguments"))
986 986 hiddenrevs = repoview.filterrevs(repo, 'visible')
987 987 return subset & hiddenrevs
988 988
989 989 def keyword(repo, subset, x):
990 990 """``keyword(string)``
991 991 Search commit message, user name, and names of changed files for
992 992 string. The match is case-insensitive.
993 993 """
994 994 # i18n: "keyword" is a keyword
995 995 kw = encoding.lower(getstring(x, _("keyword requires a string")))
996 996
997 997 def matches(r):
998 998 c = repo[r]
999 999 return util.any(kw in encoding.lower(t) for t in c.files() + [c.user(),
1000 1000 c.description()])
1001 1001
1002 1002 return subset.filter(matches)
1003 1003
1004 1004 def limit(repo, subset, x):
1005 1005 """``limit(set, [n])``
1006 1006 First n members of set, defaulting to 1.
1007 1007 """
1008 1008 # i18n: "limit" is a keyword
1009 1009 l = getargs(x, 1, 2, _("limit requires one or two arguments"))
1010 1010 try:
1011 1011 lim = 1
1012 1012 if len(l) == 2:
1013 1013 # i18n: "limit" is a keyword
1014 1014 lim = int(getstring(l[1], _("limit requires a number")))
1015 1015 except (TypeError, ValueError):
1016 1016 # i18n: "limit" is a keyword
1017 1017 raise error.ParseError(_("limit expects a number"))
1018 1018 ss = subset
1019 1019 os = getset(repo, spanset(repo), l[0])
1020 1020 result = []
1021 1021 it = iter(os)
1022 1022 for x in xrange(lim):
1023 1023 try:
1024 1024 y = it.next()
1025 1025 if y in ss:
1026 1026 result.append(y)
1027 1027 except (StopIteration):
1028 1028 break
1029 1029 return baseset(result)
1030 1030
1031 1031 def last(repo, subset, x):
1032 1032 """``last(set, [n])``
1033 1033 Last n members of set, defaulting to 1.
1034 1034 """
1035 1035 # i18n: "last" is a keyword
1036 1036 l = getargs(x, 1, 2, _("last requires one or two arguments"))
1037 1037 try:
1038 1038 lim = 1
1039 1039 if len(l) == 2:
1040 1040 # i18n: "last" is a keyword
1041 1041 lim = int(getstring(l[1], _("last requires a number")))
1042 1042 except (TypeError, ValueError):
1043 1043 # i18n: "last" is a keyword
1044 1044 raise error.ParseError(_("last expects a number"))
1045 1045 ss = subset
1046 1046 os = getset(repo, spanset(repo), l[0])
1047 1047 os.reverse()
1048 1048 result = []
1049 1049 it = iter(os)
1050 1050 for x in xrange(lim):
1051 1051 try:
1052 1052 y = it.next()
1053 1053 if y in ss:
1054 1054 result.append(y)
1055 1055 except (StopIteration):
1056 1056 break
1057 1057 return baseset(result)
1058 1058
1059 1059 def maxrev(repo, subset, x):
1060 1060 """``max(set)``
1061 1061 Changeset with highest revision number in set.
1062 1062 """
1063 1063 os = getset(repo, spanset(repo), x)
1064 1064 if os:
1065 1065 m = os.max()
1066 1066 if m in subset:
1067 1067 return baseset([m])
1068 1068 return baseset()
1069 1069
1070 1070 def merge(repo, subset, x):
1071 1071 """``merge()``
1072 1072 Changeset is a merge changeset.
1073 1073 """
1074 1074 # i18n: "merge" is a keyword
1075 1075 getargs(x, 0, 0, _("merge takes no arguments"))
1076 1076 cl = repo.changelog
1077 1077 return subset.filter(lambda r: cl.parentrevs(r)[1] != -1)
1078 1078
1079 1079 def branchpoint(repo, subset, x):
1080 1080 """``branchpoint()``
1081 1081 Changesets with more than one child.
1082 1082 """
1083 1083 # i18n: "branchpoint" is a keyword
1084 1084 getargs(x, 0, 0, _("branchpoint takes no arguments"))
1085 1085 cl = repo.changelog
1086 1086 if not subset:
1087 1087 return baseset()
1088 1088 baserev = min(subset)
1089 1089 parentscount = [0]*(len(repo) - baserev)
1090 1090 for r in cl.revs(start=baserev + 1):
1091 1091 for p in cl.parentrevs(r):
1092 1092 if p >= baserev:
1093 1093 parentscount[p - baserev] += 1
1094 1094 return subset.filter(lambda r: parentscount[r - baserev] > 1)
1095 1095
1096 1096 def minrev(repo, subset, x):
1097 1097 """``min(set)``
1098 1098 Changeset with lowest revision number in set.
1099 1099 """
1100 1100 os = getset(repo, spanset(repo), x)
1101 1101 if os:
1102 1102 m = os.min()
1103 1103 if m in subset:
1104 1104 return baseset([m])
1105 1105 return baseset()
1106 1106
1107 1107 def modifies(repo, subset, x):
1108 1108 """``modifies(pattern)``
1109 1109 Changesets modifying files matched by pattern.
1110 1110
1111 1111 The pattern without explicit kind like ``glob:`` is expected to be
1112 1112 relative to the current directory and match against a file or a
1113 1113 directory.
1114 1114 """
1115 1115 # i18n: "modifies" is a keyword
1116 1116 pat = getstring(x, _("modifies requires a pattern"))
1117 1117 return checkstatus(repo, subset, pat, 0)
1118 1118
1119 1119 def node_(repo, subset, x):
1120 1120 """``id(string)``
1121 1121 Revision non-ambiguously specified by the given hex string prefix.
1122 1122 """
1123 1123 # i18n: "id" is a keyword
1124 1124 l = getargs(x, 1, 1, _("id requires one argument"))
1125 1125 # i18n: "id" is a keyword
1126 1126 n = getstring(l[0], _("id requires a string"))
1127 1127 if len(n) == 40:
1128 1128 rn = repo[n].rev()
1129 1129 else:
1130 1130 rn = None
1131 1131 pm = repo.changelog._partialmatch(n)
1132 1132 if pm is not None:
1133 1133 rn = repo.changelog.rev(pm)
1134 1134
1135 1135 return subset.filter(lambda r: r == rn)
1136 1136
1137 1137 def obsolete(repo, subset, x):
1138 1138 """``obsolete()``
1139 1139 Mutable changeset with a newer version."""
1140 1140 # i18n: "obsolete" is a keyword
1141 1141 getargs(x, 0, 0, _("obsolete takes no arguments"))
1142 1142 obsoletes = obsmod.getrevs(repo, 'obsolete')
1143 1143 return subset & obsoletes
1144 1144
1145 1145 def origin(repo, subset, x):
1146 1146 """``origin([set])``
1147 1147 Changesets that were specified as a source for the grafts, transplants or
1148 1148 rebases that created the given revisions. Omitting the optional set is the
1149 1149 same as passing all(). If a changeset created by these operations is itself
1150 1150 specified as a source for one of these operations, only the source changeset
1151 1151 for the first operation is selected.
1152 1152 """
1153 1153 if x is not None:
1154 1154 dests = getset(repo, spanset(repo), x)
1155 1155 else:
1156 1156 dests = getall(repo, spanset(repo), x)
1157 1157
1158 1158 def _firstsrc(rev):
1159 1159 src = _getrevsource(repo, rev)
1160 1160 if src is None:
1161 1161 return None
1162 1162
1163 1163 while True:
1164 1164 prev = _getrevsource(repo, src)
1165 1165
1166 1166 if prev is None:
1167 1167 return src
1168 1168 src = prev
1169 1169
1170 1170 o = set([_firstsrc(r) for r in dests])
1171 1171 o -= set([None])
1172 1172 return subset & o
1173 1173
1174 1174 def outgoing(repo, subset, x):
1175 1175 """``outgoing([path])``
1176 1176 Changesets not found in the specified destination repository, or the
1177 1177 default push location.
1178 1178 """
1179 1179 import hg # avoid start-up nasties
1180 1180 # i18n: "outgoing" is a keyword
1181 1181 l = getargs(x, 0, 1, _("outgoing takes one or no arguments"))
1182 1182 # i18n: "outgoing" is a keyword
1183 1183 dest = l and getstring(l[0], _("outgoing requires a repository path")) or ''
1184 1184 dest = repo.ui.expandpath(dest or 'default-push', dest or 'default')
1185 1185 dest, branches = hg.parseurl(dest)
1186 1186 revs, checkout = hg.addbranchrevs(repo, repo, branches, [])
1187 1187 if revs:
1188 1188 revs = [repo.lookup(rev) for rev in revs]
1189 1189 other = hg.peer(repo, {}, dest)
1190 1190 repo.ui.pushbuffer()
1191 1191 outgoing = discovery.findcommonoutgoing(repo, other, onlyheads=revs)
1192 1192 repo.ui.popbuffer()
1193 1193 cl = repo.changelog
1194 1194 o = set([cl.rev(r) for r in outgoing.missing])
1195 1195 return subset & o
1196 1196
1197 1197 def p1(repo, subset, x):
1198 1198 """``p1([set])``
1199 1199 First parent of changesets in set, or the working directory.
1200 1200 """
1201 1201 if x is None:
1202 1202 p = repo[x].p1().rev()
1203 1203 if p >= 0:
1204 1204 return subset & baseset([p])
1205 1205 return baseset()
1206 1206
1207 1207 ps = set()
1208 1208 cl = repo.changelog
1209 1209 for r in getset(repo, spanset(repo), x):
1210 1210 ps.add(cl.parentrevs(r)[0])
1211 1211 ps -= set([node.nullrev])
1212 1212 return subset & ps
1213 1213
1214 1214 def p2(repo, subset, x):
1215 1215 """``p2([set])``
1216 1216 Second parent of changesets in set, or the working directory.
1217 1217 """
1218 1218 if x is None:
1219 1219 ps = repo[x].parents()
1220 1220 try:
1221 1221 p = ps[1].rev()
1222 1222 if p >= 0:
1223 1223 return subset & baseset([p])
1224 1224 return baseset()
1225 1225 except IndexError:
1226 1226 return baseset()
1227 1227
1228 1228 ps = set()
1229 1229 cl = repo.changelog
1230 1230 for r in getset(repo, spanset(repo), x):
1231 1231 ps.add(cl.parentrevs(r)[1])
1232 1232 ps -= set([node.nullrev])
1233 1233 return subset & ps
1234 1234
1235 1235 def parents(repo, subset, x):
1236 1236 """``parents([set])``
1237 1237 The set of all parents for all changesets in set, or the working directory.
1238 1238 """
1239 1239 if x is None:
1240 1240 ps = set(p.rev() for p in repo[x].parents())
1241 1241 else:
1242 1242 ps = set()
1243 1243 cl = repo.changelog
1244 1244 for r in getset(repo, spanset(repo), x):
1245 1245 ps.update(cl.parentrevs(r))
1246 1246 ps -= set([node.nullrev])
1247 1247 return subset & ps
1248 1248
1249 1249 def parentspec(repo, subset, x, n):
1250 1250 """``set^0``
1251 1251 The set.
1252 1252 ``set^1`` (or ``set^``), ``set^2``
1253 1253 First or second parent, respectively, of all changesets in set.
1254 1254 """
1255 1255 try:
1256 1256 n = int(n[1])
1257 1257 if n not in (0, 1, 2):
1258 1258 raise ValueError
1259 1259 except (TypeError, ValueError):
1260 1260 raise error.ParseError(_("^ expects a number 0, 1, or 2"))
1261 1261 ps = set()
1262 1262 cl = repo.changelog
1263 1263 for r in getset(repo, baseset(cl), x):
1264 1264 if n == 0:
1265 1265 ps.add(r)
1266 1266 elif n == 1:
1267 1267 ps.add(cl.parentrevs(r)[0])
1268 1268 elif n == 2:
1269 1269 parents = cl.parentrevs(r)
1270 1270 if len(parents) > 1:
1271 1271 ps.add(parents[1])
1272 1272 return subset & ps
1273 1273
1274 1274 def present(repo, subset, x):
1275 1275 """``present(set)``
1276 1276 An empty set, if any revision in set isn't found; otherwise,
1277 1277 all revisions in set.
1278 1278
1279 1279 If any of specified revisions is not present in the local repository,
1280 1280 the query is normally aborted. But this predicate allows the query
1281 1281 to continue even in such cases.
1282 1282 """
1283 1283 try:
1284 1284 return getset(repo, subset, x)
1285 1285 except error.RepoLookupError:
1286 1286 return baseset()
1287 1287
1288 1288 def public(repo, subset, x):
1289 1289 """``public()``
1290 1290 Changeset in public phase."""
1291 1291 # i18n: "public" is a keyword
1292 1292 getargs(x, 0, 0, _("public takes no arguments"))
1293 1293 pc = repo._phasecache
1294 1294 return subset.filter(lambda r: pc.phase(repo, r) == phases.public)
1295 1295
1296 1296 def remote(repo, subset, x):
1297 1297 """``remote([id [,path]])``
1298 1298 Local revision that corresponds to the given identifier in a
1299 1299 remote repository, if present. Here, the '.' identifier is a
1300 1300 synonym for the current local branch.
1301 1301 """
1302 1302
1303 1303 import hg # avoid start-up nasties
1304 1304 # i18n: "remote" is a keyword
1305 1305 l = getargs(x, 0, 2, _("remote takes one, two or no arguments"))
1306 1306
1307 1307 q = '.'
1308 1308 if len(l) > 0:
1309 1309 # i18n: "remote" is a keyword
1310 1310 q = getstring(l[0], _("remote requires a string id"))
1311 1311 if q == '.':
1312 1312 q = repo['.'].branch()
1313 1313
1314 1314 dest = ''
1315 1315 if len(l) > 1:
1316 1316 # i18n: "remote" is a keyword
1317 1317 dest = getstring(l[1], _("remote requires a repository path"))
1318 1318 dest = repo.ui.expandpath(dest or 'default')
1319 1319 dest, branches = hg.parseurl(dest)
1320 1320 revs, checkout = hg.addbranchrevs(repo, repo, branches, [])
1321 1321 if revs:
1322 1322 revs = [repo.lookup(rev) for rev in revs]
1323 1323 other = hg.peer(repo, {}, dest)
1324 1324 n = other.lookup(q)
1325 1325 if n in repo:
1326 1326 r = repo[n].rev()
1327 1327 if r in subset:
1328 1328 return baseset([r])
1329 1329 return baseset()
1330 1330
1331 1331 def removes(repo, subset, x):
1332 1332 """``removes(pattern)``
1333 1333 Changesets which remove files matching pattern.
1334 1334
1335 1335 The pattern without explicit kind like ``glob:`` is expected to be
1336 1336 relative to the current directory and match against a file or a
1337 1337 directory.
1338 1338 """
1339 1339 # i18n: "removes" is a keyword
1340 1340 pat = getstring(x, _("removes requires a pattern"))
1341 1341 return checkstatus(repo, subset, pat, 2)
1342 1342
1343 1343 def rev(repo, subset, x):
1344 1344 """``rev(number)``
1345 1345 Revision with the given numeric identifier.
1346 1346 """
1347 1347 # i18n: "rev" is a keyword
1348 1348 l = getargs(x, 1, 1, _("rev requires one argument"))
1349 1349 try:
1350 1350 # i18n: "rev" is a keyword
1351 1351 l = int(getstring(l[0], _("rev requires a number")))
1352 1352 except (TypeError, ValueError):
1353 1353 # i18n: "rev" is a keyword
1354 1354 raise error.ParseError(_("rev expects a number"))
1355 1355 return subset & baseset([l])
1356 1356
1357 1357 def matching(repo, subset, x):
1358 1358 """``matching(revision [, field])``
1359 1359 Changesets in which a given set of fields match the set of fields in the
1360 1360 selected revision or set.
1361 1361
1362 1362 To match more than one field pass the list of fields to match separated
1363 1363 by spaces (e.g. ``author description``).
1364 1364
1365 1365 Valid fields are most regular revision fields and some special fields.
1366 1366
1367 1367 Regular revision fields are ``description``, ``author``, ``branch``,
1368 1368 ``date``, ``files``, ``phase``, ``parents``, ``substate``, ``user``
1369 1369 and ``diff``.
1370 1370 Note that ``author`` and ``user`` are synonyms. ``diff`` refers to the
1371 1371 contents of the revision. Two revisions matching their ``diff`` will
1372 1372 also match their ``files``.
1373 1373
1374 1374 Special fields are ``summary`` and ``metadata``:
1375 1375 ``summary`` matches the first line of the description.
1376 1376 ``metadata`` is equivalent to matching ``description user date``
1377 1377 (i.e. it matches the main metadata fields).
1378 1378
1379 1379 ``metadata`` is the default field which is used when no fields are
1380 1380 specified. You can match more than one field at a time.
1381 1381 """
1382 1382 # i18n: "matching" is a keyword
1383 1383 l = getargs(x, 1, 2, _("matching takes 1 or 2 arguments"))
1384 1384
1385 1385 revs = getset(repo, baseset(repo.changelog), l[0])
1386 1386
1387 1387 fieldlist = ['metadata']
1388 1388 if len(l) > 1:
1389 1389 fieldlist = getstring(l[1],
1390 1390 # i18n: "matching" is a keyword
1391 1391 _("matching requires a string "
1392 1392 "as its second argument")).split()
1393 1393
1394 1394 # Make sure that there are no repeated fields,
1395 1395 # expand the 'special' 'metadata' field type
1396 1396 # and check the 'files' whenever we check the 'diff'
1397 1397 fields = []
1398 1398 for field in fieldlist:
1399 1399 if field == 'metadata':
1400 1400 fields += ['user', 'description', 'date']
1401 1401 elif field == 'diff':
1402 1402 # a revision matching the diff must also match the files
1403 1403 # since matching the diff is very costly, make sure to
1404 1404 # also match the files first
1405 1405 fields += ['files', 'diff']
1406 1406 else:
1407 1407 if field == 'author':
1408 1408 field = 'user'
1409 1409 fields.append(field)
1410 1410 fields = set(fields)
1411 1411 if 'summary' in fields and 'description' in fields:
1412 1412 # If a revision matches its description it also matches its summary
1413 1413 fields.discard('summary')
1414 1414
1415 1415 # We may want to match more than one field
1416 1416 # Not all fields take the same amount of time to be matched
1417 1417 # Sort the selected fields in order of increasing matching cost
1418 1418 fieldorder = ['phase', 'parents', 'user', 'date', 'branch', 'summary',
1419 1419 'files', 'description', 'substate', 'diff']
1420 1420 def fieldkeyfunc(f):
1421 1421 try:
1422 1422 return fieldorder.index(f)
1423 1423 except ValueError:
1424 1424 # assume an unknown field is very costly
1425 1425 return len(fieldorder)
1426 1426 fields = list(fields)
1427 1427 fields.sort(key=fieldkeyfunc)
1428 1428
1429 1429 # Each field will be matched with its own "getfield" function
1430 1430 # which will be added to the getfieldfuncs array of functions
1431 1431 getfieldfuncs = []
1432 1432 _funcs = {
1433 1433 'user': lambda r: repo[r].user(),
1434 1434 'branch': lambda r: repo[r].branch(),
1435 1435 'date': lambda r: repo[r].date(),
1436 1436 'description': lambda r: repo[r].description(),
1437 1437 'files': lambda r: repo[r].files(),
1438 1438 'parents': lambda r: repo[r].parents(),
1439 1439 'phase': lambda r: repo[r].phase(),
1440 1440 'substate': lambda r: repo[r].substate,
1441 1441 'summary': lambda r: repo[r].description().splitlines()[0],
1442 1442 'diff': lambda r: list(repo[r].diff(git=True),)
1443 1443 }
1444 1444 for info in fields:
1445 1445 getfield = _funcs.get(info, None)
1446 1446 if getfield is None:
1447 1447 raise error.ParseError(
1448 1448 # i18n: "matching" is a keyword
1449 1449 _("unexpected field name passed to matching: %s") % info)
1450 1450 getfieldfuncs.append(getfield)
1451 1451 # convert the getfield array of functions into a "getinfo" function
1452 1452 # which returns an array of field values (or a single value if there
1453 1453 # is only one field to match)
1454 1454 getinfo = lambda r: [f(r) for f in getfieldfuncs]
1455 1455
1456 1456 def matches(x):
1457 1457 for rev in revs:
1458 1458 target = getinfo(rev)
1459 1459 match = True
1460 1460 for n, f in enumerate(getfieldfuncs):
1461 1461 if target[n] != f(x):
1462 1462 match = False
1463 1463 if match:
1464 1464 return True
1465 1465 return False
1466 1466
1467 1467 return subset.filter(matches)
1468 1468
1469 1469 def reverse(repo, subset, x):
1470 1470 """``reverse(set)``
1471 1471 Reverse order of set.
1472 1472 """
1473 1473 l = getset(repo, subset, x)
1474 1474 l.reverse()
1475 1475 return l
1476 1476
1477 1477 def roots(repo, subset, x):
1478 1478 """``roots(set)``
1479 1479 Changesets in set with no parent changeset in set.
1480 1480 """
1481 1481 s = getset(repo, spanset(repo), x)
1482 1482 subset = baseset([r for r in s if r in subset])
1483 1483 cs = _children(repo, subset, s)
1484 1484 return subset - cs
1485 1485
1486 1486 def secret(repo, subset, x):
1487 1487 """``secret()``
1488 1488 Changeset in secret phase."""
1489 1489 # i18n: "secret" is a keyword
1490 1490 getargs(x, 0, 0, _("secret takes no arguments"))
1491 1491 pc = repo._phasecache
1492 1492 return subset.filter(lambda x: pc.phase(repo, x) == phases.secret)
1493 1493
1494 1494 def sort(repo, subset, x):
1495 1495 """``sort(set[, [-]key...])``
1496 1496 Sort set by keys. The default sort order is ascending, specify a key
1497 1497 as ``-key`` to sort in descending order.
1498 1498
1499 1499 The keys can be:
1500 1500
1501 1501 - ``rev`` for the revision number,
1502 1502 - ``branch`` for the branch name,
1503 1503 - ``desc`` for the commit message (description),
1504 1504 - ``user`` for user name (``author`` can be used as an alias),
1505 1505 - ``date`` for the commit date
1506 1506 """
1507 1507 # i18n: "sort" is a keyword
1508 1508 l = getargs(x, 1, 2, _("sort requires one or two arguments"))
1509 1509 keys = "rev"
1510 1510 if len(l) == 2:
1511 1511 # i18n: "sort" is a keyword
1512 1512 keys = getstring(l[1], _("sort spec must be a string"))
1513 1513
1514 1514 s = l[0]
1515 1515 keys = keys.split()
1516 1516 l = []
1517 1517 def invert(s):
1518 1518 return "".join(chr(255 - ord(c)) for c in s)
1519 1519 revs = getset(repo, subset, s)
1520 1520 if keys == ["rev"]:
1521 1521 revs.sort()
1522 1522 return revs
1523 1523 elif keys == ["-rev"]:
1524 1524 revs.sort(reverse=True)
1525 1525 return revs
1526 1526 for r in revs:
1527 1527 c = repo[r]
1528 1528 e = []
1529 1529 for k in keys:
1530 1530 if k == 'rev':
1531 1531 e.append(r)
1532 1532 elif k == '-rev':
1533 1533 e.append(-r)
1534 1534 elif k == 'branch':
1535 1535 e.append(c.branch())
1536 1536 elif k == '-branch':
1537 1537 e.append(invert(c.branch()))
1538 1538 elif k == 'desc':
1539 1539 e.append(c.description())
1540 1540 elif k == '-desc':
1541 1541 e.append(invert(c.description()))
1542 1542 elif k in 'user author':
1543 1543 e.append(c.user())
1544 1544 elif k in '-user -author':
1545 1545 e.append(invert(c.user()))
1546 1546 elif k == 'date':
1547 1547 e.append(c.date()[0])
1548 1548 elif k == '-date':
1549 1549 e.append(-c.date()[0])
1550 1550 else:
1551 1551 raise error.ParseError(_("unknown sort key %r") % k)
1552 1552 e.append(r)
1553 1553 l.append(e)
1554 1554 l.sort()
1555 1555 return baseset([e[-1] for e in l])
1556 1556
1557 1557 def _stringmatcher(pattern):
1558 1558 """
1559 1559 accepts a string, possibly starting with 're:' or 'literal:' prefix.
1560 1560 returns the matcher name, pattern, and matcher function.
1561 1561 missing or unknown prefixes are treated as literal matches.
1562 1562
1563 1563 helper for tests:
1564 1564 >>> def test(pattern, *tests):
1565 1565 ... kind, pattern, matcher = _stringmatcher(pattern)
1566 1566 ... return (kind, pattern, [bool(matcher(t)) for t in tests])
1567 1567
1568 1568 exact matching (no prefix):
1569 1569 >>> test('abcdefg', 'abc', 'def', 'abcdefg')
1570 1570 ('literal', 'abcdefg', [False, False, True])
1571 1571
1572 1572 regex matching ('re:' prefix)
1573 1573 >>> test('re:a.+b', 'nomatch', 'fooadef', 'fooadefbar')
1574 1574 ('re', 'a.+b', [False, False, True])
1575 1575
1576 1576 force exact matches ('literal:' prefix)
1577 1577 >>> test('literal:re:foobar', 'foobar', 're:foobar')
1578 1578 ('literal', 're:foobar', [False, True])
1579 1579
1580 1580 unknown prefixes are ignored and treated as literals
1581 1581 >>> test('foo:bar', 'foo', 'bar', 'foo:bar')
1582 1582 ('literal', 'foo:bar', [False, False, True])
1583 1583 """
1584 1584 if pattern.startswith('re:'):
1585 1585 pattern = pattern[3:]
1586 1586 try:
1587 1587 regex = re.compile(pattern)
1588 1588 except re.error, e:
1589 1589 raise error.ParseError(_('invalid regular expression: %s')
1590 1590 % e)
1591 1591 return 're', pattern, regex.search
1592 1592 elif pattern.startswith('literal:'):
1593 1593 pattern = pattern[8:]
1594 1594 return 'literal', pattern, pattern.__eq__
1595 1595
1596 1596 def _substringmatcher(pattern):
1597 1597 kind, pattern, matcher = _stringmatcher(pattern)
1598 1598 if kind == 'literal':
1599 1599 matcher = lambda s: pattern in s
1600 1600 return kind, pattern, matcher
1601 1601
1602 1602 def tag(repo, subset, x):
1603 1603 """``tag([name])``
1604 1604 The specified tag by name, or all tagged revisions if no name is given.
1605 1605
1606 1606 If `name` starts with `re:`, the remainder of the name is treated as
1607 1607 a regular expression. To match a tag that actually starts with `re:`,
1608 1608 use the prefix `literal:`.
1609 1609 """
1610 1610 # i18n: "tag" is a keyword
1611 1611 args = getargs(x, 0, 1, _("tag takes one or no arguments"))
1612 1612 cl = repo.changelog
1613 1613 if args:
1614 1614 pattern = getstring(args[0],
1615 1615 # i18n: "tag" is a keyword
1616 1616 _('the argument to tag must be a string'))
1617 1617 kind, pattern, matcher = _stringmatcher(pattern)
1618 1618 if kind == 'literal':
1619 1619 # avoid resolving all tags
1620 1620 tn = repo._tagscache.tags.get(pattern, None)
1621 1621 if tn is None:
1622 1622 raise util.Abort(_("tag '%s' does not exist") % pattern)
1623 1623 s = set([repo[tn].rev()])
1624 1624 else:
1625 1625 s = set([cl.rev(n) for t, n in repo.tagslist() if matcher(t)])
1626 1626 else:
1627 1627 s = set([cl.rev(n) for t, n in repo.tagslist() if t != 'tip'])
1628 1628 return subset & s
1629 1629
1630 1630 def tagged(repo, subset, x):
1631 1631 return tag(repo, subset, x)
1632 1632
1633 1633 def unstable(repo, subset, x):
1634 1634 """``unstable()``
1635 1635 Non-obsolete changesets with obsolete ancestors.
1636 1636 """
1637 1637 # i18n: "unstable" is a keyword
1638 1638 getargs(x, 0, 0, _("unstable takes no arguments"))
1639 1639 unstables = obsmod.getrevs(repo, 'unstable')
1640 1640 return subset & unstables
1641 1641
1642 1642
1643 1643 def user(repo, subset, x):
1644 1644 """``user(string)``
1645 1645 User name contains string. The match is case-insensitive.
1646 1646
1647 1647 If `string` starts with `re:`, the remainder of the string is treated as
1648 1648 a regular expression. To match a user that actually contains `re:`, use
1649 1649 the prefix `literal:`.
1650 1650 """
1651 1651 return author(repo, subset, x)
1652 1652
1653 1653 # for internal use
1654 1654 def _list(repo, subset, x):
1655 1655 s = getstring(x, "internal error")
1656 1656 if not s:
1657 1657 return baseset()
1658 1658 ls = [repo[r].rev() for r in s.split('\0')]
1659 1659 s = subset
1660 1660 return baseset([r for r in ls if r in s])
1661 1661
1662 1662 # for internal use
1663 1663 def _intlist(repo, subset, x):
1664 1664 s = getstring(x, "internal error")
1665 1665 if not s:
1666 1666 return baseset()
1667 1667 ls = [int(r) for r in s.split('\0')]
1668 1668 s = subset
1669 1669 return baseset([r for r in ls if r in s])
1670 1670
1671 1671 # for internal use
1672 1672 def _hexlist(repo, subset, x):
1673 1673 s = getstring(x, "internal error")
1674 1674 if not s:
1675 1675 return baseset()
1676 1676 cl = repo.changelog
1677 1677 ls = [cl.rev(node.bin(r)) for r in s.split('\0')]
1678 1678 s = subset
1679 1679 return baseset([r for r in ls if r in s])
1680 1680
1681 1681 symbols = {
1682 1682 "adds": adds,
1683 1683 "all": getall,
1684 1684 "ancestor": ancestor,
1685 1685 "ancestors": ancestors,
1686 1686 "_firstancestors": _firstancestors,
1687 1687 "author": author,
1688 1688 "only": only,
1689 1689 "bisect": bisect,
1690 1690 "bisected": bisected,
1691 1691 "bookmark": bookmark,
1692 1692 "branch": branch,
1693 1693 "branchpoint": branchpoint,
1694 1694 "bumped": bumped,
1695 1695 "bundle": bundle,
1696 1696 "children": children,
1697 1697 "closed": closed,
1698 1698 "contains": contains,
1699 1699 "converted": converted,
1700 1700 "date": date,
1701 1701 "desc": desc,
1702 1702 "descendants": descendants,
1703 1703 "_firstdescendants": _firstdescendants,
1704 1704 "destination": destination,
1705 1705 "divergent": divergent,
1706 1706 "draft": draft,
1707 1707 "extinct": extinct,
1708 1708 "extra": extra,
1709 1709 "file": hasfile,
1710 1710 "filelog": filelog,
1711 1711 "first": first,
1712 1712 "follow": follow,
1713 1713 "_followfirst": _followfirst,
1714 1714 "grep": grep,
1715 1715 "head": head,
1716 1716 "heads": heads,
1717 1717 "hidden": hidden,
1718 1718 "id": node_,
1719 1719 "keyword": keyword,
1720 1720 "last": last,
1721 1721 "limit": limit,
1722 1722 "_matchfiles": _matchfiles,
1723 1723 "max": maxrev,
1724 1724 "merge": merge,
1725 1725 "min": minrev,
1726 1726 "modifies": modifies,
1727 1727 "obsolete": obsolete,
1728 1728 "origin": origin,
1729 1729 "outgoing": outgoing,
1730 1730 "p1": p1,
1731 1731 "p2": p2,
1732 1732 "parents": parents,
1733 1733 "present": present,
1734 1734 "public": public,
1735 1735 "remote": remote,
1736 1736 "removes": removes,
1737 1737 "rev": rev,
1738 1738 "reverse": reverse,
1739 1739 "roots": roots,
1740 1740 "sort": sort,
1741 1741 "secret": secret,
1742 1742 "matching": matching,
1743 1743 "tag": tag,
1744 1744 "tagged": tagged,
1745 1745 "user": user,
1746 1746 "unstable": unstable,
1747 1747 "_list": _list,
1748 1748 "_intlist": _intlist,
1749 1749 "_hexlist": _hexlist,
1750 1750 }
1751 1751
1752 1752 # symbols which can't be used for a DoS attack for any given input
1753 1753 # (e.g. those which accept regexes as plain strings shouldn't be included)
1754 1754 # functions that just return a lot of changesets (like all) don't count here
1755 1755 safesymbols = set([
1756 1756 "adds",
1757 1757 "all",
1758 1758 "ancestor",
1759 1759 "ancestors",
1760 1760 "_firstancestors",
1761 1761 "author",
1762 1762 "bisect",
1763 1763 "bisected",
1764 1764 "bookmark",
1765 1765 "branch",
1766 1766 "branchpoint",
1767 1767 "bumped",
1768 1768 "bundle",
1769 1769 "children",
1770 1770 "closed",
1771 1771 "converted",
1772 1772 "date",
1773 1773 "desc",
1774 1774 "descendants",
1775 1775 "_firstdescendants",
1776 1776 "destination",
1777 1777 "divergent",
1778 1778 "draft",
1779 1779 "extinct",
1780 1780 "extra",
1781 1781 "file",
1782 1782 "filelog",
1783 1783 "first",
1784 1784 "follow",
1785 1785 "_followfirst",
1786 1786 "head",
1787 1787 "heads",
1788 1788 "hidden",
1789 1789 "id",
1790 1790 "keyword",
1791 1791 "last",
1792 1792 "limit",
1793 1793 "_matchfiles",
1794 1794 "max",
1795 1795 "merge",
1796 1796 "min",
1797 1797 "modifies",
1798 1798 "obsolete",
1799 1799 "origin",
1800 1800 "outgoing",
1801 1801 "p1",
1802 1802 "p2",
1803 1803 "parents",
1804 1804 "present",
1805 1805 "public",
1806 1806 "remote",
1807 1807 "removes",
1808 1808 "rev",
1809 1809 "reverse",
1810 1810 "roots",
1811 1811 "sort",
1812 1812 "secret",
1813 1813 "matching",
1814 1814 "tag",
1815 1815 "tagged",
1816 1816 "user",
1817 1817 "unstable",
1818 1818 "_list",
1819 1819 "_intlist",
1820 1820 "_hexlist",
1821 1821 ])
1822 1822
1823 1823 methods = {
1824 1824 "range": rangeset,
1825 1825 "dagrange": dagrange,
1826 1826 "string": stringset,
1827 1827 "symbol": symbolset,
1828 1828 "and": andset,
1829 1829 "or": orset,
1830 1830 "not": notset,
1831 1831 "list": listset,
1832 1832 "func": func,
1833 1833 "ancestor": ancestorspec,
1834 1834 "parent": parentspec,
1835 1835 "parentpost": p1,
1836 1836 }
1837 1837
1838 1838 def optimize(x, small):
1839 1839 if x is None:
1840 1840 return 0, x
1841 1841
1842 1842 smallbonus = 1
1843 1843 if small:
1844 1844 smallbonus = .5
1845 1845
1846 1846 op = x[0]
1847 1847 if op == 'minus':
1848 1848 return optimize(('and', x[1], ('not', x[2])), small)
1849 1849 elif op == 'dagrangepre':
1850 1850 return optimize(('func', ('symbol', 'ancestors'), x[1]), small)
1851 1851 elif op == 'dagrangepost':
1852 1852 return optimize(('func', ('symbol', 'descendants'), x[1]), small)
1853 1853 elif op == 'rangepre':
1854 1854 return optimize(('range', ('string', '0'), x[1]), small)
1855 1855 elif op == 'rangepost':
1856 1856 return optimize(('range', x[1], ('string', 'tip')), small)
1857 1857 elif op == 'negate':
1858 1858 return optimize(('string',
1859 1859 '-' + getstring(x[1], _("can't negate that"))), small)
1860 1860 elif op in 'string symbol negate':
1861 1861 return smallbonus, x # single revisions are small
1862 1862 elif op == 'and':
1863 1863 wa, ta = optimize(x[1], True)
1864 1864 wb, tb = optimize(x[2], True)
1865 1865
1866 1866 # (::x and not ::y)/(not ::y and ::x) have a fast path
1867 1867 def isonly(revs, bases):
1868 1868 return (
1869 1869 revs[0] == 'func'
1870 1870 and getstring(revs[1], _('not a symbol')) == 'ancestors'
1871 1871 and bases[0] == 'not'
1872 1872 and bases[1][0] == 'func'
1873 1873 and getstring(bases[1][1], _('not a symbol')) == 'ancestors')
1874 1874
1875 1875 w = min(wa, wb)
1876 1876 if isonly(ta, tb):
1877 1877 return w, ('func', ('symbol', 'only'), ('list', ta[2], tb[1][2]))
1878 1878 if isonly(tb, ta):
1879 1879 return w, ('func', ('symbol', 'only'), ('list', tb[2], ta[1][2]))
1880 1880
1881 1881 if wa > wb:
1882 1882 return w, (op, tb, ta)
1883 1883 return w, (op, ta, tb)
1884 1884 elif op == 'or':
1885 1885 wa, ta = optimize(x[1], False)
1886 1886 wb, tb = optimize(x[2], False)
1887 1887 if wb < wa:
1888 1888 wb, wa = wa, wb
1889 1889 return max(wa, wb), (op, ta, tb)
1890 1890 elif op == 'not':
1891 1891 o = optimize(x[1], not small)
1892 1892 return o[0], (op, o[1])
1893 1893 elif op == 'parentpost':
1894 1894 o = optimize(x[1], small)
1895 1895 return o[0], (op, o[1])
1896 1896 elif op == 'group':
1897 1897 return optimize(x[1], small)
1898 1898 elif op in 'dagrange range list parent ancestorspec':
1899 1899 if op == 'parent':
1900 1900 # x^:y means (x^) : y, not x ^ (:y)
1901 1901 post = ('parentpost', x[1])
1902 1902 if x[2][0] == 'dagrangepre':
1903 1903 return optimize(('dagrange', post, x[2][1]), small)
1904 1904 elif x[2][0] == 'rangepre':
1905 1905 return optimize(('range', post, x[2][1]), small)
1906 1906
1907 1907 wa, ta = optimize(x[1], small)
1908 1908 wb, tb = optimize(x[2], small)
1909 1909 return wa + wb, (op, ta, tb)
1910 1910 elif op == 'func':
1911 1911 f = getstring(x[1], _("not a symbol"))
1912 1912 wa, ta = optimize(x[2], small)
1913 1913 if f in ("author branch closed date desc file grep keyword "
1914 1914 "outgoing user"):
1915 1915 w = 10 # slow
1916 1916 elif f in "modifies adds removes":
1917 1917 w = 30 # slower
1918 1918 elif f == "contains":
1919 1919 w = 100 # very slow
1920 1920 elif f == "ancestor":
1921 1921 w = 1 * smallbonus
1922 1922 elif f in "reverse limit first _intlist":
1923 1923 w = 0
1924 1924 elif f in "sort":
1925 1925 w = 10 # assume most sorts look at changelog
1926 1926 else:
1927 1927 w = 1
1928 1928 return w + wa, (op, x[1], ta)
1929 1929 return 1, x
1930 1930
1931 1931 _aliasarg = ('func', ('symbol', '_aliasarg'))
1932 1932 def _getaliasarg(tree):
1933 1933 """If tree matches ('func', ('symbol', '_aliasarg'), ('string', X))
1934 1934 return X, None otherwise.
1935 1935 """
1936 1936 if (len(tree) == 3 and tree[:2] == _aliasarg
1937 1937 and tree[2][0] == 'string'):
1938 1938 return tree[2][1]
1939 1939 return None
1940 1940
1941 1941 def _checkaliasarg(tree, known=None):
1942 1942 """Check tree contains no _aliasarg construct or only ones which
1943 1943 value is in known. Used to avoid alias placeholders injection.
1944 1944 """
1945 1945 if isinstance(tree, tuple):
1946 1946 arg = _getaliasarg(tree)
1947 1947 if arg is not None and (not known or arg not in known):
1948 1948 raise error.ParseError(_("not a function: %s") % '_aliasarg')
1949 1949 for t in tree:
1950 1950 _checkaliasarg(t, known)
1951 1951
1952 1952 class revsetalias(object):
1953 1953 funcre = re.compile('^([^(]+)\(([^)]+)\)$')
1954 1954 args = None
1955 1955
1956 1956 def __init__(self, name, value):
1957 1957 '''Aliases like:
1958 1958
1959 1959 h = heads(default)
1960 1960 b($1) = ancestors($1) - ancestors(default)
1961 1961 '''
1962 1962 m = self.funcre.search(name)
1963 1963 if m:
1964 1964 self.name = m.group(1)
1965 1965 self.tree = ('func', ('symbol', m.group(1)))
1966 1966 self.args = [x.strip() for x in m.group(2).split(',')]
1967 1967 for arg in self.args:
1968 1968 # _aliasarg() is an unknown symbol only used separate
1969 1969 # alias argument placeholders from regular strings.
1970 1970 value = value.replace(arg, '_aliasarg(%r)' % (arg,))
1971 1971 else:
1972 1972 self.name = name
1973 1973 self.tree = ('symbol', name)
1974 1974
1975 1975 self.replacement, pos = parse(value)
1976 1976 if pos != len(value):
1977 1977 raise error.ParseError(_('invalid token'), pos)
1978 1978 # Check for placeholder injection
1979 1979 _checkaliasarg(self.replacement, self.args)
1980 1980
1981 1981 def _getalias(aliases, tree):
1982 1982 """If tree looks like an unexpanded alias, return it. Return None
1983 1983 otherwise.
1984 1984 """
1985 1985 if isinstance(tree, tuple) and tree:
1986 1986 if tree[0] == 'symbol' and len(tree) == 2:
1987 1987 name = tree[1]
1988 1988 alias = aliases.get(name)
1989 1989 if alias and alias.args is None and alias.tree == tree:
1990 1990 return alias
1991 1991 if tree[0] == 'func' and len(tree) > 1:
1992 1992 if tree[1][0] == 'symbol' and len(tree[1]) == 2:
1993 1993 name = tree[1][1]
1994 1994 alias = aliases.get(name)
1995 1995 if alias and alias.args is not None and alias.tree == tree[:2]:
1996 1996 return alias
1997 1997 return None
1998 1998
1999 1999 def _expandargs(tree, args):
2000 2000 """Replace _aliasarg instances with the substitution value of the
2001 2001 same name in args, recursively.
2002 2002 """
2003 2003 if not tree or not isinstance(tree, tuple):
2004 2004 return tree
2005 2005 arg = _getaliasarg(tree)
2006 2006 if arg is not None:
2007 2007 return args[arg]
2008 2008 return tuple(_expandargs(t, args) for t in tree)
2009 2009
2010 2010 def _expandaliases(aliases, tree, expanding, cache):
2011 2011 """Expand aliases in tree, recursively.
2012 2012
2013 2013 'aliases' is a dictionary mapping user defined aliases to
2014 2014 revsetalias objects.
2015 2015 """
2016 2016 if not isinstance(tree, tuple):
2017 2017 # Do not expand raw strings
2018 2018 return tree
2019 2019 alias = _getalias(aliases, tree)
2020 2020 if alias is not None:
2021 2021 if alias in expanding:
2022 2022 raise error.ParseError(_('infinite expansion of revset alias "%s" '
2023 2023 'detected') % alias.name)
2024 2024 expanding.append(alias)
2025 2025 if alias.name not in cache:
2026 2026 cache[alias.name] = _expandaliases(aliases, alias.replacement,
2027 2027 expanding, cache)
2028 2028 result = cache[alias.name]
2029 2029 expanding.pop()
2030 2030 if alias.args is not None:
2031 2031 l = getlist(tree[2])
2032 2032 if len(l) != len(alias.args):
2033 2033 raise error.ParseError(
2034 2034 _('invalid number of arguments: %s') % len(l))
2035 2035 l = [_expandaliases(aliases, a, [], cache) for a in l]
2036 2036 result = _expandargs(result, dict(zip(alias.args, l)))
2037 2037 else:
2038 2038 result = tuple(_expandaliases(aliases, t, expanding, cache)
2039 2039 for t in tree)
2040 2040 return result
2041 2041
2042 2042 def findaliases(ui, tree):
2043 2043 _checkaliasarg(tree)
2044 2044 aliases = {}
2045 2045 for k, v in ui.configitems('revsetalias'):
2046 2046 alias = revsetalias(k, v)
2047 2047 aliases[alias.name] = alias
2048 2048 return _expandaliases(aliases, tree, [], {})
2049 2049
2050 2050 def parse(spec, lookup=None):
2051 2051 p = parser.parser(tokenize, elements)
2052 2052 return p.parse(spec, lookup=lookup)
2053 2053
2054 2054 def match(ui, spec, repo=None):
2055 2055 if not spec:
2056 2056 raise error.ParseError(_("empty query"))
2057 2057 lookup = None
2058 2058 if repo:
2059 2059 lookup = repo.__contains__
2060 2060 tree, pos = parse(spec, lookup)
2061 2061 if (pos != len(spec)):
2062 2062 raise error.ParseError(_("invalid token"), pos)
2063 2063 if ui:
2064 2064 tree = findaliases(ui, tree)
2065 2065 weight, tree = optimize(tree, True)
2066 2066 def mfunc(repo, subset):
2067 2067 if util.safehasattr(subset, 'isascending'):
2068 2068 result = getset(repo, subset, tree)
2069 2069 else:
2070 2070 result = getset(repo, baseset(subset), tree)
2071 2071 return result
2072 2072 return mfunc
2073 2073
2074 2074 def formatspec(expr, *args):
2075 2075 '''
2076 2076 This is a convenience function for using revsets internally, and
2077 2077 escapes arguments appropriately. Aliases are intentionally ignored
2078 2078 so that intended expression behavior isn't accidentally subverted.
2079 2079
2080 2080 Supported arguments:
2081 2081
2082 2082 %r = revset expression, parenthesized
2083 2083 %d = int(arg), no quoting
2084 2084 %s = string(arg), escaped and single-quoted
2085 2085 %b = arg.branch(), escaped and single-quoted
2086 2086 %n = hex(arg), single-quoted
2087 2087 %% = a literal '%'
2088 2088
2089 2089 Prefixing the type with 'l' specifies a parenthesized list of that type.
2090 2090
2091 2091 >>> formatspec('%r:: and %lr', '10 or 11', ("this()", "that()"))
2092 2092 '(10 or 11):: and ((this()) or (that()))'
2093 2093 >>> formatspec('%d:: and not %d::', 10, 20)
2094 2094 '10:: and not 20::'
2095 2095 >>> formatspec('%ld or %ld', [], [1])
2096 2096 "_list('') or 1"
2097 2097 >>> formatspec('keyword(%s)', 'foo\\xe9')
2098 2098 "keyword('foo\\\\xe9')"
2099 2099 >>> b = lambda: 'default'
2100 2100 >>> b.branch = b
2101 2101 >>> formatspec('branch(%b)', b)
2102 2102 "branch('default')"
2103 2103 >>> formatspec('root(%ls)', ['a', 'b', 'c', 'd'])
2104 2104 "root(_list('a\\x00b\\x00c\\x00d'))"
2105 2105 '''
2106 2106
2107 2107 def quote(s):
2108 2108 return repr(str(s))
2109 2109
2110 2110 def argtype(c, arg):
2111 2111 if c == 'd':
2112 2112 return str(int(arg))
2113 2113 elif c == 's':
2114 2114 return quote(arg)
2115 2115 elif c == 'r':
2116 2116 parse(arg) # make sure syntax errors are confined
2117 2117 return '(%s)' % arg
2118 2118 elif c == 'n':
2119 2119 return quote(node.hex(arg))
2120 2120 elif c == 'b':
2121 2121 return quote(arg.branch())
2122 2122
2123 2123 def listexp(s, t):
2124 2124 l = len(s)
2125 2125 if l == 0:
2126 2126 return "_list('')"
2127 2127 elif l == 1:
2128 2128 return argtype(t, s[0])
2129 2129 elif t == 'd':
2130 2130 return "_intlist('%s')" % "\0".join(str(int(a)) for a in s)
2131 2131 elif t == 's':
2132 2132 return "_list('%s')" % "\0".join(s)
2133 2133 elif t == 'n':
2134 2134 return "_hexlist('%s')" % "\0".join(node.hex(a) for a in s)
2135 2135 elif t == 'b':
2136 2136 return "_list('%s')" % "\0".join(a.branch() for a in s)
2137 2137
2138 2138 m = l // 2
2139 2139 return '(%s or %s)' % (listexp(s[:m], t), listexp(s[m:], t))
2140 2140
2141 2141 ret = ''
2142 2142 pos = 0
2143 2143 arg = 0
2144 2144 while pos < len(expr):
2145 2145 c = expr[pos]
2146 2146 if c == '%':
2147 2147 pos += 1
2148 2148 d = expr[pos]
2149 2149 if d == '%':
2150 2150 ret += d
2151 2151 elif d in 'dsnbr':
2152 2152 ret += argtype(d, args[arg])
2153 2153 arg += 1
2154 2154 elif d == 'l':
2155 2155 # a list of some type
2156 2156 pos += 1
2157 2157 d = expr[pos]
2158 2158 ret += listexp(list(args[arg]), d)
2159 2159 arg += 1
2160 2160 else:
2161 2161 raise util.Abort('unexpected revspec format character %s' % d)
2162 2162 else:
2163 2163 ret += c
2164 2164 pos += 1
2165 2165
2166 2166 return ret
2167 2167
2168 2168 def prettyformat(tree):
2169 2169 def _prettyformat(tree, level, lines):
2170 2170 if not isinstance(tree, tuple) or tree[0] in ('string', 'symbol'):
2171 2171 lines.append((level, str(tree)))
2172 2172 else:
2173 2173 lines.append((level, '(%s' % tree[0]))
2174 2174 for s in tree[1:]:
2175 2175 _prettyformat(s, level + 1, lines)
2176 2176 lines[-1:] = [(lines[-1][0], lines[-1][1] + ')')]
2177 2177
2178 2178 lines = []
2179 2179 _prettyformat(tree, 0, lines)
2180 2180 output = '\n'.join((' '*l + s) for l, s in lines)
2181 2181 return output
2182 2182
2183 2183 def depth(tree):
2184 2184 if isinstance(tree, tuple):
2185 2185 return max(map(depth, tree)) + 1
2186 2186 else:
2187 2187 return 0
2188 2188
2189 2189 def funcsused(tree):
2190 2190 if not isinstance(tree, tuple) or tree[0] in ('string', 'symbol'):
2191 2191 return set()
2192 2192 else:
2193 2193 funcs = set()
2194 2194 for s in tree[1:]:
2195 2195 funcs |= funcsused(s)
2196 2196 if tree[0] == 'func':
2197 2197 funcs.add(tree[1][1])
2198 2198 return funcs
2199 2199
2200 2200 class abstractsmartset(object):
2201 2201
2202 2202 def __nonzero__(self):
2203 2203 """True if the smartset is not empty"""
2204 2204 raise NotImplementedError()
2205 2205
2206 2206 def __contains__(self, rev):
2207 2207 """provide fast membership testing"""
2208 2208 raise NotImplementedError()
2209 2209
2210 2210 def __iter__(self):
2211 2211 """iterate the set in the order it is supposed to be iterated"""
2212 2212 raise NotImplementedError()
2213 2213
2214 2214 # Attributes containing a function to perform a fast iteration in a given
2215 2215 # direction. A smartset can have none, one, or both defined.
2216 2216 #
2217 2217 # Default value is None instead of a function returning None to avoid
2218 2218 # initializing an iterator just for testing if a fast method exists.
2219 2219 fastasc = None
2220 2220 fastdesc = None
2221 2221
2222 2222 def isascending(self):
2223 2223 """True if the set will iterate in ascending order"""
2224 2224 raise NotImplementedError()
2225 2225
2226 2226 def isdescending(self):
2227 2227 """True if the set will iterate in descending order"""
2228 2228 raise NotImplementedError()
2229 2229
2230 2230 def min(self):
2231 2231 """return the minimum element in the set"""
2232 2232 if self.fastasc is not None:
2233 2233 for r in self.fastasc():
2234 2234 return r
2235 2235 raise ValueError('arg is an empty sequence')
2236 2236 return min(self)
2237 2237
2238 2238 def max(self):
2239 2239 """return the maximum element in the set"""
2240 2240 if self.fastdesc is not None:
2241 2241 for r in self.fastdesc():
2242 2242 return r
2243 2243 raise ValueError('arg is an empty sequence')
2244 2244 return max(self)
2245 2245
2246 2246 def first(self):
2247 2247 """return the first element in the set (user iteration perspective)
2248 2248
2249 2249 Return None if the set is empty"""
2250 2250 raise NotImplementedError()
2251 2251
2252 2252 def last(self):
2253 2253 """return the last element in the set (user iteration perspective)
2254 2254
2255 2255 Return None if the set is empty"""
2256 2256 raise NotImplementedError()
2257 2257
2258 2258 def __len__(self):
2259 2259 """return the length of the smartsets
2260 2260
2261 2261 This can be expensive on smartset that could be lazy otherwise."""
2262 2262 raise NotImplementedError()
2263 2263
2264 2264 def reverse(self):
2265 2265 """reverse the expected iteration order"""
2266 2266 raise NotImplementedError()
2267 2267
2268 2268 def sort(self, reverse=True):
2269 2269 """get the set to iterate in an ascending or descending order"""
2270 2270 raise NotImplementedError()
2271 2271
2272 2272 def __and__(self, other):
2273 2273 """Returns a new object with the intersection of the two collections.
2274 2274
2275 2275 This is part of the mandatory API for smartset."""
2276 2276 return self.filter(other.__contains__, cache=False)
2277 2277
2278 2278 def __add__(self, other):
2279 2279 """Returns a new object with the union of the two collections.
2280 2280
2281 2281 This is part of the mandatory API for smartset."""
2282 2282 return addset(self, other)
2283 2283
2284 2284 def __sub__(self, other):
2285 2285 """Returns a new object with the substraction of the two collections.
2286 2286
2287 2287 This is part of the mandatory API for smartset."""
2288 2288 c = other.__contains__
2289 2289 return self.filter(lambda r: not c(r), cache=False)
2290 2290
2291 2291 def filter(self, condition, cache=True):
2292 2292 """Returns this smartset filtered by condition as a new smartset.
2293 2293
2294 2294 `condition` is a callable which takes a revision number and returns a
2295 2295 boolean.
2296 2296
2297 2297 This is part of the mandatory API for smartset."""
2298 2298 # builtin cannot be cached. but do not needs to
2299 2299 if cache and util.safehasattr(condition, 'func_code'):
2300 2300 condition = util.cachefunc(condition)
2301 2301 return filteredset(self, condition)
2302 2302
2303 2303 class baseset(abstractsmartset):
2304 2304 """Basic data structure that represents a revset and contains the basic
2305 2305 operation that it should be able to perform.
2306 2306
2307 2307 Every method in this class should be implemented by any smartset class.
2308 2308 """
2309 2309 def __init__(self, data=()):
2310 2310 if not isinstance(data, list):
2311 2311 data = list(data)
2312 2312 self._list = data
2313 2313 self._ascending = None
2314 2314
2315 2315 @util.propertycache
2316 2316 def _set(self):
2317 2317 return set(self._list)
2318 2318
2319 2319 @util.propertycache
2320 2320 def _asclist(self):
2321 2321 asclist = self._list[:]
2322 2322 asclist.sort()
2323 2323 return asclist
2324 2324
2325 2325 def __iter__(self):
2326 2326 if self._ascending is None:
2327 2327 return iter(self._list)
2328 2328 elif self._ascending:
2329 2329 return iter(self._asclist)
2330 2330 else:
2331 2331 return reversed(self._asclist)
2332 2332
2333 2333 def fastasc(self):
2334 2334 return iter(self._asclist)
2335 2335
2336 2336 def fastdesc(self):
2337 2337 return reversed(self._asclist)
2338 2338
2339 2339 @util.propertycache
2340 2340 def __contains__(self):
2341 2341 return self._set.__contains__
2342 2342
2343 2343 def __nonzero__(self):
2344 2344 return bool(self._list)
2345 2345
2346 2346 def sort(self, reverse=False):
2347 2347 self._ascending = not bool(reverse)
2348 2348
2349 2349 def reverse(self):
2350 2350 if self._ascending is None:
2351 2351 self._list.reverse()
2352 2352 else:
2353 2353 self._ascending = not self._ascending
2354 2354
2355 2355 def __len__(self):
2356 2356 return len(self._list)
2357 2357
2358 2358 def isascending(self):
2359 2359 """Returns True if the collection is ascending order, False if not.
2360 2360
2361 2361 This is part of the mandatory API for smartset."""
2362 2362 if len(self) <= 1:
2363 2363 return True
2364 2364 return self._ascending is not None and self._ascending
2365 2365
2366 2366 def isdescending(self):
2367 2367 """Returns True if the collection is descending order, False if not.
2368 2368
2369 2369 This is part of the mandatory API for smartset."""
2370 2370 if len(self) <= 1:
2371 2371 return True
2372 2372 return self._ascending is not None and not self._ascending
2373 2373
2374 2374 def first(self):
2375 2375 if self:
2376 2376 if self._ascending is None:
2377 2377 return self._list[0]
2378 2378 elif self._ascending:
2379 2379 return self._asclist[0]
2380 2380 else:
2381 2381 return self._asclist[-1]
2382 2382 return None
2383 2383
2384 2384 def last(self):
2385 2385 if self:
2386 2386 if self._ascending is None:
2387 2387 return self._list[-1]
2388 2388 elif self._ascending:
2389 2389 return self._asclist[-1]
2390 2390 else:
2391 2391 return self._asclist[0]
2392 2392 return None
2393 2393
2394 2394 class filteredset(abstractsmartset):
2395 2395 """Duck type for baseset class which iterates lazily over the revisions in
2396 2396 the subset and contains a function which tests for membership in the
2397 2397 revset
2398 2398 """
2399 2399 def __init__(self, subset, condition=lambda x: True):
2400 2400 """
2401 2401 condition: a function that decide whether a revision in the subset
2402 2402 belongs to the revset or not.
2403 2403 """
2404 2404 self._subset = subset
2405 2405 self._condition = condition
2406 2406 self._cache = {}
2407 2407
2408 2408 def __contains__(self, x):
2409 2409 c = self._cache
2410 2410 if x not in c:
2411 2411 v = c[x] = x in self._subset and self._condition(x)
2412 2412 return v
2413 2413 return c[x]
2414 2414
2415 2415 def __iter__(self):
2416 2416 return self._iterfilter(self._subset)
2417 2417
2418 2418 def _iterfilter(self, it):
2419 2419 cond = self._condition
2420 2420 for x in it:
2421 2421 if cond(x):
2422 2422 yield x
2423 2423
2424 2424 @property
2425 2425 def fastasc(self):
2426 2426 it = self._subset.fastasc
2427 2427 if it is None:
2428 2428 return None
2429 2429 return lambda: self._iterfilter(it())
2430 2430
2431 2431 @property
2432 2432 def fastdesc(self):
2433 2433 it = self._subset.fastdesc
2434 2434 if it is None:
2435 2435 return None
2436 2436 return lambda: self._iterfilter(it())
2437 2437
2438 2438 def __nonzero__(self):
2439 2439 for r in self:
2440 2440 return True
2441 2441 return False
2442 2442
2443 2443 def __len__(self):
2444 2444 # Basic implementation to be changed in future patches.
2445 2445 l = baseset([r for r in self])
2446 2446 return len(l)
2447 2447
2448 2448 def __getitem__(self, x):
2449 2449 # Basic implementation to be changed in future patches.
2450 2450 l = baseset([r for r in self])
2451 2451 return l[x]
2452 2452
2453 2453 def sort(self, reverse=False):
2454 2454 self._subset.sort(reverse=reverse)
2455 2455
2456 2456 def reverse(self):
2457 2457 self._subset.reverse()
2458 2458
2459 2459 def isascending(self):
2460 2460 return self._subset.isascending()
2461 2461
2462 2462 def isdescending(self):
2463 2463 return self._subset.isdescending()
2464 2464
2465 2465 def first(self):
2466 2466 for x in self:
2467 2467 return x
2468 2468 return None
2469 2469
2470 2470 def last(self):
2471 2471 it = None
2472 2472 if self._subset.isascending:
2473 2473 it = self.fastdesc
2474 2474 elif self._subset.isdescending:
2475 2475 it = self.fastdesc
2476 2476 if it is None:
2477 2477 # slowly consume everything. This needs improvement
2478 2478 it = lambda: reversed(list(self))
2479 2479 for x in it():
2480 2480 return x
2481 2481 return None
2482 2482
2483 2483 class addset(abstractsmartset):
2484 2484 """Represent the addition of two sets
2485 2485
2486 2486 Wrapper structure for lazily adding two structures without losing much
2487 2487 performance on the __contains__ method
2488 2488
2489 2489 If the ascending attribute is set, that means the two structures are
2490 2490 ordered in either an ascending or descending way. Therefore, we can add
2491 2491 them maintaining the order by iterating over both at the same time
2492 2492 """
2493 2493 def __init__(self, revs1, revs2, ascending=None):
2494 2494 self._r1 = revs1
2495 2495 self._r2 = revs2
2496 2496 self._iter = None
2497 2497 self._ascending = ascending
2498 2498 self._genlist = None
2499 2499 self._asclist = None
2500 2500
2501 2501 def __len__(self):
2502 2502 return len(self._list)
2503 2503
2504 2504 def __nonzero__(self):
2505 2505 return bool(self._r1 or self._r2)
2506 2506
2507 2507 @util.propertycache
2508 2508 def _list(self):
2509 2509 if not self._genlist:
2510 2510 self._genlist = baseset(self._iterator())
2511 2511 return self._genlist
2512 2512
2513 2513 def _iterator(self):
2514 2514 """Iterate over both collections without repeating elements
2515 2515
2516 2516 If the ascending attribute is not set, iterate over the first one and
2517 2517 then over the second one checking for membership on the first one so we
2518 2518 dont yield any duplicates.
2519 2519
2520 2520 If the ascending attribute is set, iterate over both collections at the
2521 2521 same time, yielding only one value at a time in the given order.
2522 2522 """
2523 2523 if self._ascending is None:
2524 2524 def gen():
2525 2525 for r in self._r1:
2526 2526 yield r
2527 2527 inr1 = self._r1.__contains__
2528 2528 for r in self._r2:
2529 2529 if not inr1(r):
2530 2530 yield r
2531 2531 gen = gen()
2532 2532 else:
2533 2533 iter1 = iter(self._r1)
2534 2534 iter2 = iter(self._r2)
2535 2535 gen = self._iterordered(self._ascending, iter1, iter2)
2536 2536 return gen
2537 2537
2538 2538 def __iter__(self):
2539 2539 if self._ascending is None:
2540 2540 if self._genlist:
2541 2541 return iter(self._genlist)
2542 2542 return iter(self._iterator())
2543 2543 self._trysetasclist()
2544 2544 if self._ascending:
2545 2545 it = self.fastasc
2546 2546 else:
2547 2547 it = self.fastdesc
2548 2548 if it is None:
2549 2549 # consume the gen and try again
2550 2550 self._list
2551 2551 return iter(self)
2552 2552 return it()
2553 2553
2554 2554 def _trysetasclist(self):
2555 2555 """populate the _asclist attribut if possible and necessary"""
2556 2556 if self._genlist is not None and self._asclist is None:
2557 2557 self._asclist = sorted(self._genlist)
2558 2558
2559 2559 @property
2560 2560 def fastasc(self):
2561 2561 self._trysetasclist()
2562 2562 if self._asclist is not None:
2563 2563 return self._asclist.__iter__
2564 2564 iter1 = self._r1.fastasc
2565 2565 iter2 = self._r2.fastasc
2566 2566 if None in (iter1, iter2):
2567 2567 return None
2568 2568 return lambda: self._iterordered(True, iter1(), iter2())
2569 2569
2570 2570 @property
2571 2571 def fastdesc(self):
2572 2572 self._trysetasclist()
2573 2573 if self._asclist is not None:
2574 2574 return self._asclist.__reversed__
2575 2575 iter1 = self._r1.fastdesc
2576 2576 iter2 = self._r2.fastdesc
2577 2577 if None in (iter1, iter2):
2578 2578 return None
2579 2579 return lambda: self._iterordered(False, iter1(), iter2())
2580 2580
2581 2581 def _iterordered(self, ascending, iter1, iter2):
2582 2582 """produce an ordered iteration from two iterators with the same order
2583 2583
2584 2584 The ascending is used to indicated the iteration direction.
2585 2585 """
2586 2586 choice = max
2587 2587 if ascending:
2588 2588 choice = min
2589 2589
2590 2590 val1 = None
2591 2591 val2 = None
2592 2592
2593 2593 choice = max
2594 2594 if ascending:
2595 2595 choice = min
2596 2596 try:
2597 2597 # Consume both iterators in an ordered way until one is
2598 2598 # empty
2599 2599 while True:
2600 2600 if val1 is None:
2601 2601 val1 = iter1.next()
2602 2602 if val2 is None:
2603 2603 val2 = iter2.next()
2604 2604 next = choice(val1, val2)
2605 2605 yield next
2606 2606 if val1 == next:
2607 2607 val1 = None
2608 2608 if val2 == next:
2609 2609 val2 = None
2610 2610 except StopIteration:
2611 2611 # Flush any remaining values and consume the other one
2612 2612 it = iter2
2613 2613 if val1 is not None:
2614 2614 yield val1
2615 2615 it = iter1
2616 2616 elif val2 is not None:
2617 2617 # might have been equality and both are empty
2618 2618 yield val2
2619 2619 for val in it:
2620 2620 yield val
2621 2621
2622 2622 def __contains__(self, x):
2623 2623 return x in self._r1 or x in self._r2
2624 2624
2625 2625 def sort(self, reverse=False):
2626 2626 """Sort the added set
2627 2627
2628 2628 For this we use the cached list with all the generated values and if we
2629 2629 know they are ascending or descending we can sort them in a smart way.
2630 2630 """
2631 2631 self._ascending = not reverse
2632 2632
2633 2633 def isascending(self):
2634 2634 return self._ascending is not None and self._ascending
2635 2635
2636 2636 def isdescending(self):
2637 2637 return self._ascending is not None and not self._ascending
2638 2638
2639 2639 def reverse(self):
2640 2640 if self._ascending is None:
2641 2641 self._list.reverse()
2642 2642 else:
2643 2643 self._ascending = not self._ascending
2644 2644
2645 2645 def first(self):
2646 2646 if self:
2647 2647 return self._list.first()
2648 2648 return None
2649 2649
2650 2650 def last(self):
2651 2651 if self:
2652 2652 return self._list.last()
2653 2653 return None
2654 2654
2655 2655 class generatorset(abstractsmartset):
2656 2656 """Wrap a generator for lazy iteration
2657 2657
2658 2658 Wrapper structure for generators that provides lazy membership and can
2659 2659 be iterated more than once.
2660 2660 When asked for membership it generates values until either it finds the
2661 2661 requested one or has gone through all the elements in the generator
2662 2662 """
2663 2663 def __init__(self, gen, iterasc=None):
2664 2664 """
2665 2665 gen: a generator producing the values for the generatorset.
2666 2666 """
2667 2667 self._gen = gen
2668 2668 self._asclist = None
2669 2669 self._cache = {}
2670 2670 self._genlist = []
2671 2671 self._finished = False
2672 2672 self._ascending = True
2673 2673 if iterasc is not None:
2674 2674 if iterasc:
2675 2675 self.fastasc = self._iterator
2676 2676 self.__contains__ = self._asccontains
2677 2677 else:
2678 2678 self.fastdesc = self._iterator
2679 2679 self.__contains__ = self._desccontains
2680 2680
2681 2681 def __nonzero__(self):
2682 2682 for r in self:
2683 2683 return True
2684 2684 return False
2685 2685
2686 2686 def __contains__(self, x):
2687 2687 if x in self._cache:
2688 2688 return self._cache[x]
2689 2689
2690 2690 # Use new values only, as existing values would be cached.
2691 2691 for l in self._consumegen():
2692 2692 if l == x:
2693 2693 return True
2694 2694
2695 2695 self._cache[x] = False
2696 2696 return False
2697 2697
2698 2698 def _asccontains(self, x):
2699 2699 """version of contains optimised for ascending generator"""
2700 2700 if x in self._cache:
2701 2701 return self._cache[x]
2702 2702
2703 2703 # Use new values only, as existing values would be cached.
2704 2704 for l in self._consumegen():
2705 2705 if l == x:
2706 2706 return True
2707 2707 if l > x:
2708 2708 break
2709 2709
2710 2710 self._cache[x] = False
2711 2711 return False
2712 2712
2713 2713 def _desccontains(self, x):
2714 2714 """version of contains optimised for descending generator"""
2715 2715 if x in self._cache:
2716 2716 return self._cache[x]
2717 2717
2718 2718 # Use new values only, as existing values would be cached.
2719 2719 for l in self._consumegen():
2720 2720 if l == x:
2721 2721 return True
2722 2722 if l < x:
2723 2723 break
2724 2724
2725 2725 self._cache[x] = False
2726 2726 return False
2727 2727
2728 2728 def __iter__(self):
2729 2729 if self._ascending:
2730 2730 it = self.fastasc
2731 2731 else:
2732 2732 it = self.fastdesc
2733 2733 if it is not None:
2734 2734 return it()
2735 2735 # we need to consume the iterator
2736 2736 for x in self._consumegen():
2737 2737 pass
2738 2738 # recall the same code
2739 2739 return iter(self)
2740 2740
2741 2741 def _iterator(self):
2742 2742 if self._finished:
2743 2743 return iter(self._genlist)
2744 2744
2745 2745 # We have to use this complex iteration strategy to allow multiple
2746 2746 # iterations at the same time. We need to be able to catch revision
2747 2747 # removed from `consumegen` and added to genlist in another instance.
2748 2748 #
2749 2749 # Getting rid of it would provide an about 15% speed up on this
2750 2750 # iteration.
2751 2751 genlist = self._genlist
2752 2752 nextrev = self._consumegen().next
2753 2753 _len = len # cache global lookup
2754 2754 def gen():
2755 2755 i = 0
2756 2756 while True:
2757 2757 if i < _len(genlist):
2758 2758 yield genlist[i]
2759 2759 else:
2760 2760 yield nextrev()
2761 2761 i += 1
2762 2762 return gen()
2763 2763
2764 2764 def _consumegen(self):
2765 2765 cache = self._cache
2766 2766 genlist = self._genlist.append
2767 2767 for item in self._gen:
2768 2768 cache[item] = True
2769 2769 genlist(item)
2770 2770 yield item
2771 2771 if not self._finished:
2772 2772 self._finished = True
2773 2773 asc = self._genlist[:]
2774 2774 asc.sort()
2775 2775 self._asclist = asc
2776 2776 self.fastasc = asc.__iter__
2777 2777 self.fastdesc = asc.__reversed__
2778 2778
2779 def __len__(self):
2780 for x in self._consumegen():
2781 pass
2782 return len(self._genlist)
2783
2779 2784 def sort(self, reverse=False):
2780 2785 self._ascending = not reverse
2781 2786
2782 2787 def reverse(self):
2783 2788 self._ascending = not self._ascending
2784 2789
2785 2790 def isascending(self):
2786 2791 return self._ascending
2787 2792
2788 2793 def isdescending(self):
2789 2794 return not self._ascending
2790 2795
2791 2796 def first(self):
2792 2797 if self._ascending:
2793 2798 it = self.fastasc
2794 2799 else:
2795 2800 it = self.fastdesc
2796 2801 if it is None:
2797 2802 # we need to consume all and try again
2798 2803 for x in self._consumegen():
2799 2804 pass
2800 2805 return self.first()
2801 2806 if self:
2802 2807 return it.next()
2803 2808 return None
2804 2809
2805 2810 def last(self):
2806 2811 if self._ascending:
2807 2812 it = self.fastdesc
2808 2813 else:
2809 2814 it = self.fastasc
2810 2815 if it is None:
2811 2816 # we need to consume all and try again
2812 2817 for x in self._consumegen():
2813 2818 pass
2814 2819 return self.first()
2815 2820 if self:
2816 2821 return it.next()
2817 2822 return None
2818 2823
2819 2824 def spanset(repo, start=None, end=None):
2820 2825 """factory function to dispatch between fullreposet and actual spanset
2821 2826
2822 2827 Feel free to update all spanset call sites and kill this function at some
2823 2828 point.
2824 2829 """
2825 2830 if start is None and end is None:
2826 2831 return fullreposet(repo)
2827 2832 return _spanset(repo, start, end)
2828 2833
2829 2834
2830 2835 class _spanset(abstractsmartset):
2831 2836 """Duck type for baseset class which represents a range of revisions and
2832 2837 can work lazily and without having all the range in memory
2833 2838
2834 2839 Note that spanset(x, y) behave almost like xrange(x, y) except for two
2835 2840 notable points:
2836 2841 - when x < y it will be automatically descending,
2837 2842 - revision filtered with this repoview will be skipped.
2838 2843
2839 2844 """
2840 2845 def __init__(self, repo, start=0, end=None):
2841 2846 """
2842 2847 start: first revision included the set
2843 2848 (default to 0)
2844 2849 end: first revision excluded (last+1)
2845 2850 (default to len(repo)
2846 2851
2847 2852 Spanset will be descending if `end` < `start`.
2848 2853 """
2849 2854 if end is None:
2850 2855 end = len(repo)
2851 2856 self._ascending = start <= end
2852 2857 if not self._ascending:
2853 2858 start, end = end + 1, start +1
2854 2859 self._start = start
2855 2860 self._end = end
2856 2861 self._hiddenrevs = repo.changelog.filteredrevs
2857 2862
2858 2863 def sort(self, reverse=False):
2859 2864 self._ascending = not reverse
2860 2865
2861 2866 def reverse(self):
2862 2867 self._ascending = not self._ascending
2863 2868
2864 2869 def _iterfilter(self, iterrange):
2865 2870 s = self._hiddenrevs
2866 2871 for r in iterrange:
2867 2872 if r not in s:
2868 2873 yield r
2869 2874
2870 2875 def __iter__(self):
2871 2876 if self._ascending:
2872 2877 return self.fastasc()
2873 2878 else:
2874 2879 return self.fastdesc()
2875 2880
2876 2881 def fastasc(self):
2877 2882 iterrange = xrange(self._start, self._end)
2878 2883 if self._hiddenrevs:
2879 2884 return self._iterfilter(iterrange)
2880 2885 return iter(iterrange)
2881 2886
2882 2887 def fastdesc(self):
2883 2888 iterrange = xrange(self._end - 1, self._start - 1, -1)
2884 2889 if self._hiddenrevs:
2885 2890 return self._iterfilter(iterrange)
2886 2891 return iter(iterrange)
2887 2892
2888 2893 def __contains__(self, rev):
2889 2894 hidden = self._hiddenrevs
2890 2895 return ((self._start <= rev < self._end)
2891 2896 and not (hidden and rev in hidden))
2892 2897
2893 2898 def __nonzero__(self):
2894 2899 for r in self:
2895 2900 return True
2896 2901 return False
2897 2902
2898 2903 def __len__(self):
2899 2904 if not self._hiddenrevs:
2900 2905 return abs(self._end - self._start)
2901 2906 else:
2902 2907 count = 0
2903 2908 start = self._start
2904 2909 end = self._end
2905 2910 for rev in self._hiddenrevs:
2906 2911 if (end < rev <= start) or (start <= rev < end):
2907 2912 count += 1
2908 2913 return abs(self._end - self._start) - count
2909 2914
2910 2915 def __getitem__(self, x):
2911 2916 # Basic implementation to be changed in future patches.
2912 2917 l = baseset([r for r in self])
2913 2918 return l[x]
2914 2919
2915 2920 def isascending(self):
2916 2921 return self._start <= self._end
2917 2922
2918 2923 def isdescending(self):
2919 2924 return self._start >= self._end
2920 2925
2921 2926 def first(self):
2922 2927 if self._ascending:
2923 2928 it = self.fastasc
2924 2929 else:
2925 2930 it = self.fastdesc
2926 2931 for x in it():
2927 2932 return x
2928 2933 return None
2929 2934
2930 2935 def last(self):
2931 2936 if self._ascending:
2932 2937 it = self.fastdesc
2933 2938 else:
2934 2939 it = self.fastasc
2935 2940 for x in it():
2936 2941 return x
2937 2942 return None
2938 2943
2939 2944 class fullreposet(_spanset):
2940 2945 """a set containing all revisions in the repo
2941 2946
2942 2947 This class exists to host special optimisation.
2943 2948 """
2944 2949
2945 2950 def __init__(self, repo):
2946 2951 super(fullreposet, self).__init__(repo)
2947 2952
2948 2953 def __and__(self, other):
2949 2954 """fullrepo & other -> other
2950 2955
2951 2956 As self contains the whole repo, all of the other set should also be in
2952 2957 self. Therefor `self & other = other`.
2953 2958
2954 2959 This boldly assumes the other contains valid revs only.
2955 2960 """
2956 2961 # other not a smartset, make is so
2957 2962 if not util.safehasattr(other, 'isascending'):
2958 2963 # filter out hidden revision
2959 2964 # (this boldly assumes all smartset are pure)
2960 2965 #
2961 2966 # `other` was used with "&", let's assume this is a set like
2962 2967 # object.
2963 2968 other = baseset(other - self._hiddenrevs)
2964 2969
2965 2970 if self.isascending():
2966 2971 other.sort()
2967 2972 else:
2968 2973 other.sort(reverse)
2969 2974 return other
2970 2975
2971 2976 # tell hggettext to extract docstrings from these functions:
2972 2977 i18nfunctions = symbols.values()
General Comments 0
You need to be logged in to leave comments. Login now