##// END OF EJS Templates
logcmdutil: create hunksfilter and filematcher even if no diff option given...
Yuya Nishihara -
r36022:dd77e36e default
parent child Browse files
Show More
@@ -1,5633 +1,5633 b''
1 1 # commands.py - command processing for mercurial
2 2 #
3 3 # Copyright 2005-2007 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 from __future__ import absolute_import
9 9
10 10 import difflib
11 11 import errno
12 12 import os
13 13 import re
14 14 import sys
15 15
16 16 from .i18n import _
17 17 from .node import (
18 18 hex,
19 19 nullid,
20 20 nullrev,
21 21 short,
22 22 )
23 23 from . import (
24 24 archival,
25 25 bookmarks,
26 26 bundle2,
27 27 changegroup,
28 28 cmdutil,
29 29 copies,
30 30 debugcommands as debugcommandsmod,
31 31 destutil,
32 32 dirstateguard,
33 33 discovery,
34 34 encoding,
35 35 error,
36 36 exchange,
37 37 extensions,
38 38 formatter,
39 39 graphmod,
40 40 hbisect,
41 41 help,
42 42 hg,
43 43 lock as lockmod,
44 44 logcmdutil,
45 45 merge as mergemod,
46 46 obsolete,
47 47 obsutil,
48 48 patch,
49 49 phases,
50 50 pycompat,
51 51 rcutil,
52 52 registrar,
53 53 revsetlang,
54 54 rewriteutil,
55 55 scmutil,
56 56 server,
57 57 streamclone,
58 58 tags as tagsmod,
59 59 templatekw,
60 60 ui as uimod,
61 61 util,
62 62 wireprotoserver,
63 63 )
64 64
65 65 release = lockmod.release
66 66
67 67 table = {}
68 68 table.update(debugcommandsmod.command._table)
69 69
70 70 command = registrar.command(table)
71 71 readonly = registrar.command.readonly
72 72
73 73 # common command options
74 74
75 75 globalopts = [
76 76 ('R', 'repository', '',
77 77 _('repository root directory or name of overlay bundle file'),
78 78 _('REPO')),
79 79 ('', 'cwd', '',
80 80 _('change working directory'), _('DIR')),
81 81 ('y', 'noninteractive', None,
82 82 _('do not prompt, automatically pick the first choice for all prompts')),
83 83 ('q', 'quiet', None, _('suppress output')),
84 84 ('v', 'verbose', None, _('enable additional output')),
85 85 ('', 'color', '',
86 86 # i18n: 'always', 'auto', 'never', and 'debug' are keywords
87 87 # and should not be translated
88 88 _("when to colorize (boolean, always, auto, never, or debug)"),
89 89 _('TYPE')),
90 90 ('', 'config', [],
91 91 _('set/override config option (use \'section.name=value\')'),
92 92 _('CONFIG')),
93 93 ('', 'debug', None, _('enable debugging output')),
94 94 ('', 'debugger', None, _('start debugger')),
95 95 ('', 'encoding', encoding.encoding, _('set the charset encoding'),
96 96 _('ENCODE')),
97 97 ('', 'encodingmode', encoding.encodingmode,
98 98 _('set the charset encoding mode'), _('MODE')),
99 99 ('', 'traceback', None, _('always print a traceback on exception')),
100 100 ('', 'time', None, _('time how long the command takes')),
101 101 ('', 'profile', None, _('print command execution profile')),
102 102 ('', 'version', None, _('output version information and exit')),
103 103 ('h', 'help', None, _('display help and exit')),
104 104 ('', 'hidden', False, _('consider hidden changesets')),
105 105 ('', 'pager', 'auto',
106 106 _("when to paginate (boolean, always, auto, or never)"), _('TYPE')),
107 107 ]
108 108
109 109 dryrunopts = cmdutil.dryrunopts
110 110 remoteopts = cmdutil.remoteopts
111 111 walkopts = cmdutil.walkopts
112 112 commitopts = cmdutil.commitopts
113 113 commitopts2 = cmdutil.commitopts2
114 114 formatteropts = cmdutil.formatteropts
115 115 templateopts = cmdutil.templateopts
116 116 logopts = cmdutil.logopts
117 117 diffopts = cmdutil.diffopts
118 118 diffwsopts = cmdutil.diffwsopts
119 119 diffopts2 = cmdutil.diffopts2
120 120 mergetoolopts = cmdutil.mergetoolopts
121 121 similarityopts = cmdutil.similarityopts
122 122 subrepoopts = cmdutil.subrepoopts
123 123 debugrevlogopts = cmdutil.debugrevlogopts
124 124
125 125 # Commands start here, listed alphabetically
126 126
127 127 @command('^add',
128 128 walkopts + subrepoopts + dryrunopts,
129 129 _('[OPTION]... [FILE]...'),
130 130 inferrepo=True)
131 131 def add(ui, repo, *pats, **opts):
132 132 """add the specified files on the next commit
133 133
134 134 Schedule files to be version controlled and added to the
135 135 repository.
136 136
137 137 The files will be added to the repository at the next commit. To
138 138 undo an add before that, see :hg:`forget`.
139 139
140 140 If no names are given, add all files to the repository (except
141 141 files matching ``.hgignore``).
142 142
143 143 .. container:: verbose
144 144
145 145 Examples:
146 146
147 147 - New (unknown) files are added
148 148 automatically by :hg:`add`::
149 149
150 150 $ ls
151 151 foo.c
152 152 $ hg status
153 153 ? foo.c
154 154 $ hg add
155 155 adding foo.c
156 156 $ hg status
157 157 A foo.c
158 158
159 159 - Specific files to be added can be specified::
160 160
161 161 $ ls
162 162 bar.c foo.c
163 163 $ hg status
164 164 ? bar.c
165 165 ? foo.c
166 166 $ hg add bar.c
167 167 $ hg status
168 168 A bar.c
169 169 ? foo.c
170 170
171 171 Returns 0 if all files are successfully added.
172 172 """
173 173
174 174 m = scmutil.match(repo[None], pats, pycompat.byteskwargs(opts))
175 175 rejected = cmdutil.add(ui, repo, m, "", False, **opts)
176 176 return rejected and 1 or 0
177 177
178 178 @command('addremove',
179 179 similarityopts + subrepoopts + walkopts + dryrunopts,
180 180 _('[OPTION]... [FILE]...'),
181 181 inferrepo=True)
182 182 def addremove(ui, repo, *pats, **opts):
183 183 """add all new files, delete all missing files
184 184
185 185 Add all new files and remove all missing files from the
186 186 repository.
187 187
188 188 Unless names are given, new files are ignored if they match any of
189 189 the patterns in ``.hgignore``. As with add, these changes take
190 190 effect at the next commit.
191 191
192 192 Use the -s/--similarity option to detect renamed files. This
193 193 option takes a percentage between 0 (disabled) and 100 (files must
194 194 be identical) as its parameter. With a parameter greater than 0,
195 195 this compares every removed file with every added file and records
196 196 those similar enough as renames. Detecting renamed files this way
197 197 can be expensive. After using this option, :hg:`status -C` can be
198 198 used to check which files were identified as moved or renamed. If
199 199 not specified, -s/--similarity defaults to 100 and only renames of
200 200 identical files are detected.
201 201
202 202 .. container:: verbose
203 203
204 204 Examples:
205 205
206 206 - A number of files (bar.c and foo.c) are new,
207 207 while foobar.c has been removed (without using :hg:`remove`)
208 208 from the repository::
209 209
210 210 $ ls
211 211 bar.c foo.c
212 212 $ hg status
213 213 ! foobar.c
214 214 ? bar.c
215 215 ? foo.c
216 216 $ hg addremove
217 217 adding bar.c
218 218 adding foo.c
219 219 removing foobar.c
220 220 $ hg status
221 221 A bar.c
222 222 A foo.c
223 223 R foobar.c
224 224
225 225 - A file foobar.c was moved to foo.c without using :hg:`rename`.
226 226 Afterwards, it was edited slightly::
227 227
228 228 $ ls
229 229 foo.c
230 230 $ hg status
231 231 ! foobar.c
232 232 ? foo.c
233 233 $ hg addremove --similarity 90
234 234 removing foobar.c
235 235 adding foo.c
236 236 recording removal of foobar.c as rename to foo.c (94% similar)
237 237 $ hg status -C
238 238 A foo.c
239 239 foobar.c
240 240 R foobar.c
241 241
242 242 Returns 0 if all files are successfully added.
243 243 """
244 244 opts = pycompat.byteskwargs(opts)
245 245 try:
246 246 sim = float(opts.get('similarity') or 100)
247 247 except ValueError:
248 248 raise error.Abort(_('similarity must be a number'))
249 249 if sim < 0 or sim > 100:
250 250 raise error.Abort(_('similarity must be between 0 and 100'))
251 251 matcher = scmutil.match(repo[None], pats, opts)
252 252 return scmutil.addremove(repo, matcher, "", opts, similarity=sim / 100.0)
253 253
254 254 @command('^annotate|blame',
255 255 [('r', 'rev', '', _('annotate the specified revision'), _('REV')),
256 256 ('', 'follow', None,
257 257 _('follow copies/renames and list the filename (DEPRECATED)')),
258 258 ('', 'no-follow', None, _("don't follow copies and renames")),
259 259 ('a', 'text', None, _('treat all files as text')),
260 260 ('u', 'user', None, _('list the author (long with -v)')),
261 261 ('f', 'file', None, _('list the filename')),
262 262 ('d', 'date', None, _('list the date (short with -q)')),
263 263 ('n', 'number', None, _('list the revision number (default)')),
264 264 ('c', 'changeset', None, _('list the changeset')),
265 265 ('l', 'line-number', None, _('show line number at the first appearance')),
266 266 ('', 'skip', [], _('revision to not display (EXPERIMENTAL)'), _('REV')),
267 267 ] + diffwsopts + walkopts + formatteropts,
268 268 _('[-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] FILE...'),
269 269 inferrepo=True)
270 270 def annotate(ui, repo, *pats, **opts):
271 271 """show changeset information by line for each file
272 272
273 273 List changes in files, showing the revision id responsible for
274 274 each line.
275 275
276 276 This command is useful for discovering when a change was made and
277 277 by whom.
278 278
279 279 If you include --file, --user, or --date, the revision number is
280 280 suppressed unless you also include --number.
281 281
282 282 Without the -a/--text option, annotate will avoid processing files
283 283 it detects as binary. With -a, annotate will annotate the file
284 284 anyway, although the results will probably be neither useful
285 285 nor desirable.
286 286
287 287 Returns 0 on success.
288 288 """
289 289 opts = pycompat.byteskwargs(opts)
290 290 if not pats:
291 291 raise error.Abort(_('at least one filename or pattern is required'))
292 292
293 293 if opts.get('follow'):
294 294 # --follow is deprecated and now just an alias for -f/--file
295 295 # to mimic the behavior of Mercurial before version 1.5
296 296 opts['file'] = True
297 297
298 298 rev = opts.get('rev')
299 299 if rev:
300 300 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
301 301 ctx = scmutil.revsingle(repo, rev)
302 302
303 303 rootfm = ui.formatter('annotate', opts)
304 304 if ui.quiet:
305 305 datefunc = util.shortdate
306 306 else:
307 307 datefunc = util.datestr
308 308 if ctx.rev() is None:
309 309 def hexfn(node):
310 310 if node is None:
311 311 return None
312 312 else:
313 313 return rootfm.hexfunc(node)
314 314 if opts.get('changeset'):
315 315 # omit "+" suffix which is appended to node hex
316 316 def formatrev(rev):
317 317 if rev is None:
318 318 return '%d' % ctx.p1().rev()
319 319 else:
320 320 return '%d' % rev
321 321 else:
322 322 def formatrev(rev):
323 323 if rev is None:
324 324 return '%d+' % ctx.p1().rev()
325 325 else:
326 326 return '%d ' % rev
327 327 def formathex(hex):
328 328 if hex is None:
329 329 return '%s+' % rootfm.hexfunc(ctx.p1().node())
330 330 else:
331 331 return '%s ' % hex
332 332 else:
333 333 hexfn = rootfm.hexfunc
334 334 formatrev = formathex = pycompat.bytestr
335 335
336 336 opmap = [('user', ' ', lambda x: x.fctx.user(), ui.shortuser),
337 337 ('number', ' ', lambda x: x.fctx.rev(), formatrev),
338 338 ('changeset', ' ', lambda x: hexfn(x.fctx.node()), formathex),
339 339 ('date', ' ', lambda x: x.fctx.date(), util.cachefunc(datefunc)),
340 340 ('file', ' ', lambda x: x.fctx.path(), str),
341 341 ('line_number', ':', lambda x: x.lineno, str),
342 342 ]
343 343 fieldnamemap = {'number': 'rev', 'changeset': 'node'}
344 344
345 345 if (not opts.get('user') and not opts.get('changeset')
346 346 and not opts.get('date') and not opts.get('file')):
347 347 opts['number'] = True
348 348
349 349 linenumber = opts.get('line_number') is not None
350 350 if linenumber and (not opts.get('changeset')) and (not opts.get('number')):
351 351 raise error.Abort(_('at least one of -n/-c is required for -l'))
352 352
353 353 ui.pager('annotate')
354 354
355 355 if rootfm.isplain():
356 356 def makefunc(get, fmt):
357 357 return lambda x: fmt(get(x))
358 358 else:
359 359 def makefunc(get, fmt):
360 360 return get
361 361 funcmap = [(makefunc(get, fmt), sep) for op, sep, get, fmt in opmap
362 362 if opts.get(op)]
363 363 funcmap[0] = (funcmap[0][0], '') # no separator in front of first column
364 364 fields = ' '.join(fieldnamemap.get(op, op) for op, sep, get, fmt in opmap
365 365 if opts.get(op))
366 366
367 367 def bad(x, y):
368 368 raise error.Abort("%s: %s" % (x, y))
369 369
370 370 m = scmutil.match(ctx, pats, opts, badfn=bad)
371 371
372 372 follow = not opts.get('no_follow')
373 373 diffopts = patch.difffeatureopts(ui, opts, section='annotate',
374 374 whitespace=True)
375 375 skiprevs = opts.get('skip')
376 376 if skiprevs:
377 377 skiprevs = scmutil.revrange(repo, skiprevs)
378 378
379 379 for abs in ctx.walk(m):
380 380 fctx = ctx[abs]
381 381 rootfm.startitem()
382 382 rootfm.data(abspath=abs, path=m.rel(abs))
383 383 if not opts.get('text') and fctx.isbinary():
384 384 rootfm.plain(_("%s: binary file\n")
385 385 % ((pats and m.rel(abs)) or abs))
386 386 continue
387 387
388 388 fm = rootfm.nested('lines')
389 389 lines = fctx.annotate(follow=follow, linenumber=linenumber,
390 390 skiprevs=skiprevs, diffopts=diffopts)
391 391 if not lines:
392 392 fm.end()
393 393 continue
394 394 formats = []
395 395 pieces = []
396 396
397 397 for f, sep in funcmap:
398 398 l = [f(n) for n, dummy in lines]
399 399 if fm.isplain():
400 400 sizes = [encoding.colwidth(x) for x in l]
401 401 ml = max(sizes)
402 402 formats.append([sep + ' ' * (ml - w) + '%s' for w in sizes])
403 403 else:
404 404 formats.append(['%s' for x in l])
405 405 pieces.append(l)
406 406
407 407 for f, p, l in zip(zip(*formats), zip(*pieces), lines):
408 408 fm.startitem()
409 409 fm.write(fields, "".join(f), *p)
410 410 if l[0].skip:
411 411 fmt = "* %s"
412 412 else:
413 413 fmt = ": %s"
414 414 fm.write('line', fmt, l[1])
415 415
416 416 if not lines[-1][1].endswith('\n'):
417 417 fm.plain('\n')
418 418 fm.end()
419 419
420 420 rootfm.end()
421 421
422 422 @command('archive',
423 423 [('', 'no-decode', None, _('do not pass files through decoders')),
424 424 ('p', 'prefix', '', _('directory prefix for files in archive'),
425 425 _('PREFIX')),
426 426 ('r', 'rev', '', _('revision to distribute'), _('REV')),
427 427 ('t', 'type', '', _('type of distribution to create'), _('TYPE')),
428 428 ] + subrepoopts + walkopts,
429 429 _('[OPTION]... DEST'))
430 430 def archive(ui, repo, dest, **opts):
431 431 '''create an unversioned archive of a repository revision
432 432
433 433 By default, the revision used is the parent of the working
434 434 directory; use -r/--rev to specify a different revision.
435 435
436 436 The archive type is automatically detected based on file
437 437 extension (to override, use -t/--type).
438 438
439 439 .. container:: verbose
440 440
441 441 Examples:
442 442
443 443 - create a zip file containing the 1.0 release::
444 444
445 445 hg archive -r 1.0 project-1.0.zip
446 446
447 447 - create a tarball excluding .hg files::
448 448
449 449 hg archive project.tar.gz -X ".hg*"
450 450
451 451 Valid types are:
452 452
453 453 :``files``: a directory full of files (default)
454 454 :``tar``: tar archive, uncompressed
455 455 :``tbz2``: tar archive, compressed using bzip2
456 456 :``tgz``: tar archive, compressed using gzip
457 457 :``uzip``: zip archive, uncompressed
458 458 :``zip``: zip archive, compressed using deflate
459 459
460 460 The exact name of the destination archive or directory is given
461 461 using a format string; see :hg:`help export` for details.
462 462
463 463 Each member added to an archive file has a directory prefix
464 464 prepended. Use -p/--prefix to specify a format string for the
465 465 prefix. The default is the basename of the archive, with suffixes
466 466 removed.
467 467
468 468 Returns 0 on success.
469 469 '''
470 470
471 471 opts = pycompat.byteskwargs(opts)
472 472 rev = opts.get('rev')
473 473 if rev:
474 474 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
475 475 ctx = scmutil.revsingle(repo, rev)
476 476 if not ctx:
477 477 raise error.Abort(_('no working directory: please specify a revision'))
478 478 node = ctx.node()
479 479 dest = cmdutil.makefilename(repo, dest, node)
480 480 if os.path.realpath(dest) == repo.root:
481 481 raise error.Abort(_('repository root cannot be destination'))
482 482
483 483 kind = opts.get('type') or archival.guesskind(dest) or 'files'
484 484 prefix = opts.get('prefix')
485 485
486 486 if dest == '-':
487 487 if kind == 'files':
488 488 raise error.Abort(_('cannot archive plain files to stdout'))
489 489 dest = cmdutil.makefileobj(repo, dest)
490 490 if not prefix:
491 491 prefix = os.path.basename(repo.root) + '-%h'
492 492
493 493 prefix = cmdutil.makefilename(repo, prefix, node)
494 494 match = scmutil.match(ctx, [], opts)
495 495 archival.archive(repo, dest, node, kind, not opts.get('no_decode'),
496 496 match, prefix, subrepos=opts.get('subrepos'))
497 497
498 498 @command('backout',
499 499 [('', 'merge', None, _('merge with old dirstate parent after backout')),
500 500 ('', 'commit', None,
501 501 _('commit if no conflicts were encountered (DEPRECATED)')),
502 502 ('', 'no-commit', None, _('do not commit')),
503 503 ('', 'parent', '',
504 504 _('parent to choose when backing out merge (DEPRECATED)'), _('REV')),
505 505 ('r', 'rev', '', _('revision to backout'), _('REV')),
506 506 ('e', 'edit', False, _('invoke editor on commit messages')),
507 507 ] + mergetoolopts + walkopts + commitopts + commitopts2,
508 508 _('[OPTION]... [-r] REV'))
509 509 def backout(ui, repo, node=None, rev=None, **opts):
510 510 '''reverse effect of earlier changeset
511 511
512 512 Prepare a new changeset with the effect of REV undone in the
513 513 current working directory. If no conflicts were encountered,
514 514 it will be committed immediately.
515 515
516 516 If REV is the parent of the working directory, then this new changeset
517 517 is committed automatically (unless --no-commit is specified).
518 518
519 519 .. note::
520 520
521 521 :hg:`backout` cannot be used to fix either an unwanted or
522 522 incorrect merge.
523 523
524 524 .. container:: verbose
525 525
526 526 Examples:
527 527
528 528 - Reverse the effect of the parent of the working directory.
529 529 This backout will be committed immediately::
530 530
531 531 hg backout -r .
532 532
533 533 - Reverse the effect of previous bad revision 23::
534 534
535 535 hg backout -r 23
536 536
537 537 - Reverse the effect of previous bad revision 23 and
538 538 leave changes uncommitted::
539 539
540 540 hg backout -r 23 --no-commit
541 541 hg commit -m "Backout revision 23"
542 542
543 543 By default, the pending changeset will have one parent,
544 544 maintaining a linear history. With --merge, the pending
545 545 changeset will instead have two parents: the old parent of the
546 546 working directory and a new child of REV that simply undoes REV.
547 547
548 548 Before version 1.7, the behavior without --merge was equivalent
549 549 to specifying --merge followed by :hg:`update --clean .` to
550 550 cancel the merge and leave the child of REV as a head to be
551 551 merged separately.
552 552
553 553 See :hg:`help dates` for a list of formats valid for -d/--date.
554 554
555 555 See :hg:`help revert` for a way to restore files to the state
556 556 of another revision.
557 557
558 558 Returns 0 on success, 1 if nothing to backout or there are unresolved
559 559 files.
560 560 '''
561 561 wlock = lock = None
562 562 try:
563 563 wlock = repo.wlock()
564 564 lock = repo.lock()
565 565 return _dobackout(ui, repo, node, rev, **opts)
566 566 finally:
567 567 release(lock, wlock)
568 568
569 569 def _dobackout(ui, repo, node=None, rev=None, **opts):
570 570 opts = pycompat.byteskwargs(opts)
571 571 if opts.get('commit') and opts.get('no_commit'):
572 572 raise error.Abort(_("cannot use --commit with --no-commit"))
573 573 if opts.get('merge') and opts.get('no_commit'):
574 574 raise error.Abort(_("cannot use --merge with --no-commit"))
575 575
576 576 if rev and node:
577 577 raise error.Abort(_("please specify just one revision"))
578 578
579 579 if not rev:
580 580 rev = node
581 581
582 582 if not rev:
583 583 raise error.Abort(_("please specify a revision to backout"))
584 584
585 585 date = opts.get('date')
586 586 if date:
587 587 opts['date'] = util.parsedate(date)
588 588
589 589 cmdutil.checkunfinished(repo)
590 590 cmdutil.bailifchanged(repo)
591 591 node = scmutil.revsingle(repo, rev).node()
592 592
593 593 op1, op2 = repo.dirstate.parents()
594 594 if not repo.changelog.isancestor(node, op1):
595 595 raise error.Abort(_('cannot backout change that is not an ancestor'))
596 596
597 597 p1, p2 = repo.changelog.parents(node)
598 598 if p1 == nullid:
599 599 raise error.Abort(_('cannot backout a change with no parents'))
600 600 if p2 != nullid:
601 601 if not opts.get('parent'):
602 602 raise error.Abort(_('cannot backout a merge changeset'))
603 603 p = repo.lookup(opts['parent'])
604 604 if p not in (p1, p2):
605 605 raise error.Abort(_('%s is not a parent of %s') %
606 606 (short(p), short(node)))
607 607 parent = p
608 608 else:
609 609 if opts.get('parent'):
610 610 raise error.Abort(_('cannot use --parent on non-merge changeset'))
611 611 parent = p1
612 612
613 613 # the backout should appear on the same branch
614 614 branch = repo.dirstate.branch()
615 615 bheads = repo.branchheads(branch)
616 616 rctx = scmutil.revsingle(repo, hex(parent))
617 617 if not opts.get('merge') and op1 != node:
618 618 dsguard = dirstateguard.dirstateguard(repo, 'backout')
619 619 try:
620 620 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''),
621 621 'backout')
622 622 stats = mergemod.update(repo, parent, True, True, node, False)
623 623 repo.setparents(op1, op2)
624 624 dsguard.close()
625 625 hg._showstats(repo, stats)
626 626 if stats[3]:
627 627 repo.ui.status(_("use 'hg resolve' to retry unresolved "
628 628 "file merges\n"))
629 629 return 1
630 630 finally:
631 631 ui.setconfig('ui', 'forcemerge', '', '')
632 632 lockmod.release(dsguard)
633 633 else:
634 634 hg.clean(repo, node, show_stats=False)
635 635 repo.dirstate.setbranch(branch)
636 636 cmdutil.revert(ui, repo, rctx, repo.dirstate.parents())
637 637
638 638 if opts.get('no_commit'):
639 639 msg = _("changeset %s backed out, "
640 640 "don't forget to commit.\n")
641 641 ui.status(msg % short(node))
642 642 return 0
643 643
644 644 def commitfunc(ui, repo, message, match, opts):
645 645 editform = 'backout'
646 646 e = cmdutil.getcommiteditor(editform=editform,
647 647 **pycompat.strkwargs(opts))
648 648 if not message:
649 649 # we don't translate commit messages
650 650 message = "Backed out changeset %s" % short(node)
651 651 e = cmdutil.getcommiteditor(edit=True, editform=editform)
652 652 return repo.commit(message, opts.get('user'), opts.get('date'),
653 653 match, editor=e)
654 654 newnode = cmdutil.commit(ui, repo, commitfunc, [], opts)
655 655 if not newnode:
656 656 ui.status(_("nothing changed\n"))
657 657 return 1
658 658 cmdutil.commitstatus(repo, newnode, branch, bheads)
659 659
660 660 def nice(node):
661 661 return '%d:%s' % (repo.changelog.rev(node), short(node))
662 662 ui.status(_('changeset %s backs out changeset %s\n') %
663 663 (nice(repo.changelog.tip()), nice(node)))
664 664 if opts.get('merge') and op1 != node:
665 665 hg.clean(repo, op1, show_stats=False)
666 666 ui.status(_('merging with changeset %s\n')
667 667 % nice(repo.changelog.tip()))
668 668 try:
669 669 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''),
670 670 'backout')
671 671 return hg.merge(repo, hex(repo.changelog.tip()))
672 672 finally:
673 673 ui.setconfig('ui', 'forcemerge', '', '')
674 674 return 0
675 675
676 676 @command('bisect',
677 677 [('r', 'reset', False, _('reset bisect state')),
678 678 ('g', 'good', False, _('mark changeset good')),
679 679 ('b', 'bad', False, _('mark changeset bad')),
680 680 ('s', 'skip', False, _('skip testing changeset')),
681 681 ('e', 'extend', False, _('extend the bisect range')),
682 682 ('c', 'command', '', _('use command to check changeset state'), _('CMD')),
683 683 ('U', 'noupdate', False, _('do not update to target'))],
684 684 _("[-gbsr] [-U] [-c CMD] [REV]"))
685 685 def bisect(ui, repo, rev=None, extra=None, command=None,
686 686 reset=None, good=None, bad=None, skip=None, extend=None,
687 687 noupdate=None):
688 688 """subdivision search of changesets
689 689
690 690 This command helps to find changesets which introduce problems. To
691 691 use, mark the earliest changeset you know exhibits the problem as
692 692 bad, then mark the latest changeset which is free from the problem
693 693 as good. Bisect will update your working directory to a revision
694 694 for testing (unless the -U/--noupdate option is specified). Once
695 695 you have performed tests, mark the working directory as good or
696 696 bad, and bisect will either update to another candidate changeset
697 697 or announce that it has found the bad revision.
698 698
699 699 As a shortcut, you can also use the revision argument to mark a
700 700 revision as good or bad without checking it out first.
701 701
702 702 If you supply a command, it will be used for automatic bisection.
703 703 The environment variable HG_NODE will contain the ID of the
704 704 changeset being tested. The exit status of the command will be
705 705 used to mark revisions as good or bad: status 0 means good, 125
706 706 means to skip the revision, 127 (command not found) will abort the
707 707 bisection, and any other non-zero exit status means the revision
708 708 is bad.
709 709
710 710 .. container:: verbose
711 711
712 712 Some examples:
713 713
714 714 - start a bisection with known bad revision 34, and good revision 12::
715 715
716 716 hg bisect --bad 34
717 717 hg bisect --good 12
718 718
719 719 - advance the current bisection by marking current revision as good or
720 720 bad::
721 721
722 722 hg bisect --good
723 723 hg bisect --bad
724 724
725 725 - mark the current revision, or a known revision, to be skipped (e.g. if
726 726 that revision is not usable because of another issue)::
727 727
728 728 hg bisect --skip
729 729 hg bisect --skip 23
730 730
731 731 - skip all revisions that do not touch directories ``foo`` or ``bar``::
732 732
733 733 hg bisect --skip "!( file('path:foo') & file('path:bar') )"
734 734
735 735 - forget the current bisection::
736 736
737 737 hg bisect --reset
738 738
739 739 - use 'make && make tests' to automatically find the first broken
740 740 revision::
741 741
742 742 hg bisect --reset
743 743 hg bisect --bad 34
744 744 hg bisect --good 12
745 745 hg bisect --command "make && make tests"
746 746
747 747 - see all changesets whose states are already known in the current
748 748 bisection::
749 749
750 750 hg log -r "bisect(pruned)"
751 751
752 752 - see the changeset currently being bisected (especially useful
753 753 if running with -U/--noupdate)::
754 754
755 755 hg log -r "bisect(current)"
756 756
757 757 - see all changesets that took part in the current bisection::
758 758
759 759 hg log -r "bisect(range)"
760 760
761 761 - you can even get a nice graph::
762 762
763 763 hg log --graph -r "bisect(range)"
764 764
765 765 See :hg:`help revisions.bisect` for more about the `bisect()` predicate.
766 766
767 767 Returns 0 on success.
768 768 """
769 769 # backward compatibility
770 770 if rev in "good bad reset init".split():
771 771 ui.warn(_("(use of 'hg bisect <cmd>' is deprecated)\n"))
772 772 cmd, rev, extra = rev, extra, None
773 773 if cmd == "good":
774 774 good = True
775 775 elif cmd == "bad":
776 776 bad = True
777 777 else:
778 778 reset = True
779 779 elif extra:
780 780 raise error.Abort(_('incompatible arguments'))
781 781
782 782 incompatibles = {
783 783 '--bad': bad,
784 784 '--command': bool(command),
785 785 '--extend': extend,
786 786 '--good': good,
787 787 '--reset': reset,
788 788 '--skip': skip,
789 789 }
790 790
791 791 enabled = [x for x in incompatibles if incompatibles[x]]
792 792
793 793 if len(enabled) > 1:
794 794 raise error.Abort(_('%s and %s are incompatible') %
795 795 tuple(sorted(enabled)[0:2]))
796 796
797 797 if reset:
798 798 hbisect.resetstate(repo)
799 799 return
800 800
801 801 state = hbisect.load_state(repo)
802 802
803 803 # update state
804 804 if good or bad or skip:
805 805 if rev:
806 806 nodes = [repo.lookup(i) for i in scmutil.revrange(repo, [rev])]
807 807 else:
808 808 nodes = [repo.lookup('.')]
809 809 if good:
810 810 state['good'] += nodes
811 811 elif bad:
812 812 state['bad'] += nodes
813 813 elif skip:
814 814 state['skip'] += nodes
815 815 hbisect.save_state(repo, state)
816 816 if not (state['good'] and state['bad']):
817 817 return
818 818
819 819 def mayupdate(repo, node, show_stats=True):
820 820 """common used update sequence"""
821 821 if noupdate:
822 822 return
823 823 cmdutil.checkunfinished(repo)
824 824 cmdutil.bailifchanged(repo)
825 825 return hg.clean(repo, node, show_stats=show_stats)
826 826
827 827 displayer = logcmdutil.changesetdisplayer(ui, repo, {})
828 828
829 829 if command:
830 830 changesets = 1
831 831 if noupdate:
832 832 try:
833 833 node = state['current'][0]
834 834 except LookupError:
835 835 raise error.Abort(_('current bisect revision is unknown - '
836 836 'start a new bisect to fix'))
837 837 else:
838 838 node, p2 = repo.dirstate.parents()
839 839 if p2 != nullid:
840 840 raise error.Abort(_('current bisect revision is a merge'))
841 841 if rev:
842 842 node = repo[scmutil.revsingle(repo, rev, node)].node()
843 843 try:
844 844 while changesets:
845 845 # update state
846 846 state['current'] = [node]
847 847 hbisect.save_state(repo, state)
848 848 status = ui.system(command, environ={'HG_NODE': hex(node)},
849 849 blockedtag='bisect_check')
850 850 if status == 125:
851 851 transition = "skip"
852 852 elif status == 0:
853 853 transition = "good"
854 854 # status < 0 means process was killed
855 855 elif status == 127:
856 856 raise error.Abort(_("failed to execute %s") % command)
857 857 elif status < 0:
858 858 raise error.Abort(_("%s killed") % command)
859 859 else:
860 860 transition = "bad"
861 861 state[transition].append(node)
862 862 ctx = repo[node]
863 863 ui.status(_('changeset %d:%s: %s\n') % (ctx, ctx, transition))
864 864 hbisect.checkstate(state)
865 865 # bisect
866 866 nodes, changesets, bgood = hbisect.bisect(repo, state)
867 867 # update to next check
868 868 node = nodes[0]
869 869 mayupdate(repo, node, show_stats=False)
870 870 finally:
871 871 state['current'] = [node]
872 872 hbisect.save_state(repo, state)
873 873 hbisect.printresult(ui, repo, state, displayer, nodes, bgood)
874 874 return
875 875
876 876 hbisect.checkstate(state)
877 877
878 878 # actually bisect
879 879 nodes, changesets, good = hbisect.bisect(repo, state)
880 880 if extend:
881 881 if not changesets:
882 882 extendnode = hbisect.extendrange(repo, state, nodes, good)
883 883 if extendnode is not None:
884 884 ui.write(_("Extending search to changeset %d:%s\n")
885 885 % (extendnode.rev(), extendnode))
886 886 state['current'] = [extendnode.node()]
887 887 hbisect.save_state(repo, state)
888 888 return mayupdate(repo, extendnode.node())
889 889 raise error.Abort(_("nothing to extend"))
890 890
891 891 if changesets == 0:
892 892 hbisect.printresult(ui, repo, state, displayer, nodes, good)
893 893 else:
894 894 assert len(nodes) == 1 # only a single node can be tested next
895 895 node = nodes[0]
896 896 # compute the approximate number of remaining tests
897 897 tests, size = 0, 2
898 898 while size <= changesets:
899 899 tests, size = tests + 1, size * 2
900 900 rev = repo.changelog.rev(node)
901 901 ui.write(_("Testing changeset %d:%s "
902 902 "(%d changesets remaining, ~%d tests)\n")
903 903 % (rev, short(node), changesets, tests))
904 904 state['current'] = [node]
905 905 hbisect.save_state(repo, state)
906 906 return mayupdate(repo, node)
907 907
908 908 @command('bookmarks|bookmark',
909 909 [('f', 'force', False, _('force')),
910 910 ('r', 'rev', '', _('revision for bookmark action'), _('REV')),
911 911 ('d', 'delete', False, _('delete a given bookmark')),
912 912 ('m', 'rename', '', _('rename a given bookmark'), _('OLD')),
913 913 ('i', 'inactive', False, _('mark a bookmark inactive')),
914 914 ] + formatteropts,
915 915 _('hg bookmarks [OPTIONS]... [NAME]...'))
916 916 def bookmark(ui, repo, *names, **opts):
917 917 '''create a new bookmark or list existing bookmarks
918 918
919 919 Bookmarks are labels on changesets to help track lines of development.
920 920 Bookmarks are unversioned and can be moved, renamed and deleted.
921 921 Deleting or moving a bookmark has no effect on the associated changesets.
922 922
923 923 Creating or updating to a bookmark causes it to be marked as 'active'.
924 924 The active bookmark is indicated with a '*'.
925 925 When a commit is made, the active bookmark will advance to the new commit.
926 926 A plain :hg:`update` will also advance an active bookmark, if possible.
927 927 Updating away from a bookmark will cause it to be deactivated.
928 928
929 929 Bookmarks can be pushed and pulled between repositories (see
930 930 :hg:`help push` and :hg:`help pull`). If a shared bookmark has
931 931 diverged, a new 'divergent bookmark' of the form 'name@path' will
932 932 be created. Using :hg:`merge` will resolve the divergence.
933 933
934 934 Specifying bookmark as '.' to -m or -d options is equivalent to specifying
935 935 the active bookmark's name.
936 936
937 937 A bookmark named '@' has the special property that :hg:`clone` will
938 938 check it out by default if it exists.
939 939
940 940 .. container:: verbose
941 941
942 942 Examples:
943 943
944 944 - create an active bookmark for a new line of development::
945 945
946 946 hg book new-feature
947 947
948 948 - create an inactive bookmark as a place marker::
949 949
950 950 hg book -i reviewed
951 951
952 952 - create an inactive bookmark on another changeset::
953 953
954 954 hg book -r .^ tested
955 955
956 956 - rename bookmark turkey to dinner::
957 957
958 958 hg book -m turkey dinner
959 959
960 960 - move the '@' bookmark from another branch::
961 961
962 962 hg book -f @
963 963 '''
964 964 force = opts.get(r'force')
965 965 rev = opts.get(r'rev')
966 966 delete = opts.get(r'delete')
967 967 rename = opts.get(r'rename')
968 968 inactive = opts.get(r'inactive')
969 969
970 970 if delete and rename:
971 971 raise error.Abort(_("--delete and --rename are incompatible"))
972 972 if delete and rev:
973 973 raise error.Abort(_("--rev is incompatible with --delete"))
974 974 if rename and rev:
975 975 raise error.Abort(_("--rev is incompatible with --rename"))
976 976 if not names and (delete or rev):
977 977 raise error.Abort(_("bookmark name required"))
978 978
979 979 if delete or rename or names or inactive:
980 980 with repo.wlock(), repo.lock(), repo.transaction('bookmark') as tr:
981 981 if delete:
982 982 names = pycompat.maplist(repo._bookmarks.expandname, names)
983 983 bookmarks.delete(repo, tr, names)
984 984 elif rename:
985 985 if not names:
986 986 raise error.Abort(_("new bookmark name required"))
987 987 elif len(names) > 1:
988 988 raise error.Abort(_("only one new bookmark name allowed"))
989 989 rename = repo._bookmarks.expandname(rename)
990 990 bookmarks.rename(repo, tr, rename, names[0], force, inactive)
991 991 elif names:
992 992 bookmarks.addbookmarks(repo, tr, names, rev, force, inactive)
993 993 elif inactive:
994 994 if len(repo._bookmarks) == 0:
995 995 ui.status(_("no bookmarks set\n"))
996 996 elif not repo._activebookmark:
997 997 ui.status(_("no active bookmark\n"))
998 998 else:
999 999 bookmarks.deactivate(repo)
1000 1000 else: # show bookmarks
1001 1001 bookmarks.printbookmarks(ui, repo, **opts)
1002 1002
1003 1003 @command('branch',
1004 1004 [('f', 'force', None,
1005 1005 _('set branch name even if it shadows an existing branch')),
1006 1006 ('C', 'clean', None, _('reset branch name to parent branch name')),
1007 1007 ('r', 'rev', [], _('change branches of the given revs (EXPERIMENTAL)')),
1008 1008 ],
1009 1009 _('[-fC] [NAME]'))
1010 1010 def branch(ui, repo, label=None, **opts):
1011 1011 """set or show the current branch name
1012 1012
1013 1013 .. note::
1014 1014
1015 1015 Branch names are permanent and global. Use :hg:`bookmark` to create a
1016 1016 light-weight bookmark instead. See :hg:`help glossary` for more
1017 1017 information about named branches and bookmarks.
1018 1018
1019 1019 With no argument, show the current branch name. With one argument,
1020 1020 set the working directory branch name (the branch will not exist
1021 1021 in the repository until the next commit). Standard practice
1022 1022 recommends that primary development take place on the 'default'
1023 1023 branch.
1024 1024
1025 1025 Unless -f/--force is specified, branch will not let you set a
1026 1026 branch name that already exists.
1027 1027
1028 1028 Use -C/--clean to reset the working directory branch to that of
1029 1029 the parent of the working directory, negating a previous branch
1030 1030 change.
1031 1031
1032 1032 Use the command :hg:`update` to switch to an existing branch. Use
1033 1033 :hg:`commit --close-branch` to mark this branch head as closed.
1034 1034 When all heads of a branch are closed, the branch will be
1035 1035 considered closed.
1036 1036
1037 1037 Returns 0 on success.
1038 1038 """
1039 1039 opts = pycompat.byteskwargs(opts)
1040 1040 revs = opts.get('rev')
1041 1041 if label:
1042 1042 label = label.strip()
1043 1043
1044 1044 if not opts.get('clean') and not label:
1045 1045 if revs:
1046 1046 raise error.Abort(_("no branch name specified for the revisions"))
1047 1047 ui.write("%s\n" % repo.dirstate.branch())
1048 1048 return
1049 1049
1050 1050 with repo.wlock():
1051 1051 if opts.get('clean'):
1052 1052 label = repo[None].p1().branch()
1053 1053 repo.dirstate.setbranch(label)
1054 1054 ui.status(_('reset working directory to branch %s\n') % label)
1055 1055 elif label:
1056 1056
1057 1057 scmutil.checknewlabel(repo, label, 'branch')
1058 1058 if revs:
1059 1059 return cmdutil.changebranch(ui, repo, revs, label)
1060 1060
1061 1061 if not opts.get('force') and label in repo.branchmap():
1062 1062 if label not in [p.branch() for p in repo[None].parents()]:
1063 1063 raise error.Abort(_('a branch of the same name already'
1064 1064 ' exists'),
1065 1065 # i18n: "it" refers to an existing branch
1066 1066 hint=_("use 'hg update' to switch to it"))
1067 1067
1068 1068 repo.dirstate.setbranch(label)
1069 1069 ui.status(_('marked working directory as branch %s\n') % label)
1070 1070
1071 1071 # find any open named branches aside from default
1072 1072 others = [n for n, h, t, c in repo.branchmap().iterbranches()
1073 1073 if n != "default" and not c]
1074 1074 if not others:
1075 1075 ui.status(_('(branches are permanent and global, '
1076 1076 'did you want a bookmark?)\n'))
1077 1077
1078 1078 @command('branches',
1079 1079 [('a', 'active', False,
1080 1080 _('show only branches that have unmerged heads (DEPRECATED)')),
1081 1081 ('c', 'closed', False, _('show normal and closed branches')),
1082 1082 ] + formatteropts,
1083 1083 _('[-c]'), cmdtype=readonly)
1084 1084 def branches(ui, repo, active=False, closed=False, **opts):
1085 1085 """list repository named branches
1086 1086
1087 1087 List the repository's named branches, indicating which ones are
1088 1088 inactive. If -c/--closed is specified, also list branches which have
1089 1089 been marked closed (see :hg:`commit --close-branch`).
1090 1090
1091 1091 Use the command :hg:`update` to switch to an existing branch.
1092 1092
1093 1093 Returns 0.
1094 1094 """
1095 1095
1096 1096 opts = pycompat.byteskwargs(opts)
1097 1097 ui.pager('branches')
1098 1098 fm = ui.formatter('branches', opts)
1099 1099 hexfunc = fm.hexfunc
1100 1100
1101 1101 allheads = set(repo.heads())
1102 1102 branches = []
1103 1103 for tag, heads, tip, isclosed in repo.branchmap().iterbranches():
1104 1104 isactive = False
1105 1105 if not isclosed:
1106 1106 openheads = set(repo.branchmap().iteropen(heads))
1107 1107 isactive = bool(openheads & allheads)
1108 1108 branches.append((tag, repo[tip], isactive, not isclosed))
1109 1109 branches.sort(key=lambda i: (i[2], i[1].rev(), i[0], i[3]),
1110 1110 reverse=True)
1111 1111
1112 1112 for tag, ctx, isactive, isopen in branches:
1113 1113 if active and not isactive:
1114 1114 continue
1115 1115 if isactive:
1116 1116 label = 'branches.active'
1117 1117 notice = ''
1118 1118 elif not isopen:
1119 1119 if not closed:
1120 1120 continue
1121 1121 label = 'branches.closed'
1122 1122 notice = _(' (closed)')
1123 1123 else:
1124 1124 label = 'branches.inactive'
1125 1125 notice = _(' (inactive)')
1126 1126 current = (tag == repo.dirstate.branch())
1127 1127 if current:
1128 1128 label = 'branches.current'
1129 1129
1130 1130 fm.startitem()
1131 1131 fm.write('branch', '%s', tag, label=label)
1132 1132 rev = ctx.rev()
1133 1133 padsize = max(31 - len(str(rev)) - encoding.colwidth(tag), 0)
1134 1134 fmt = ' ' * padsize + ' %d:%s'
1135 1135 fm.condwrite(not ui.quiet, 'rev node', fmt, rev, hexfunc(ctx.node()),
1136 1136 label='log.changeset changeset.%s' % ctx.phasestr())
1137 1137 fm.context(ctx=ctx)
1138 1138 fm.data(active=isactive, closed=not isopen, current=current)
1139 1139 if not ui.quiet:
1140 1140 fm.plain(notice)
1141 1141 fm.plain('\n')
1142 1142 fm.end()
1143 1143
1144 1144 @command('bundle',
1145 1145 [('f', 'force', None, _('run even when the destination is unrelated')),
1146 1146 ('r', 'rev', [], _('a changeset intended to be added to the destination'),
1147 1147 _('REV')),
1148 1148 ('b', 'branch', [], _('a specific branch you would like to bundle'),
1149 1149 _('BRANCH')),
1150 1150 ('', 'base', [],
1151 1151 _('a base changeset assumed to be available at the destination'),
1152 1152 _('REV')),
1153 1153 ('a', 'all', None, _('bundle all changesets in the repository')),
1154 1154 ('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE')),
1155 1155 ] + remoteopts,
1156 1156 _('[-f] [-t BUNDLESPEC] [-a] [-r REV]... [--base REV]... FILE [DEST]'))
1157 1157 def bundle(ui, repo, fname, dest=None, **opts):
1158 1158 """create a bundle file
1159 1159
1160 1160 Generate a bundle file containing data to be added to a repository.
1161 1161
1162 1162 To create a bundle containing all changesets, use -a/--all
1163 1163 (or --base null). Otherwise, hg assumes the destination will have
1164 1164 all the nodes you specify with --base parameters. Otherwise, hg
1165 1165 will assume the repository has all the nodes in destination, or
1166 1166 default-push/default if no destination is specified.
1167 1167
1168 1168 You can change bundle format with the -t/--type option. See
1169 1169 :hg:`help bundlespec` for documentation on this format. By default,
1170 1170 the most appropriate format is used and compression defaults to
1171 1171 bzip2.
1172 1172
1173 1173 The bundle file can then be transferred using conventional means
1174 1174 and applied to another repository with the unbundle or pull
1175 1175 command. This is useful when direct push and pull are not
1176 1176 available or when exporting an entire repository is undesirable.
1177 1177
1178 1178 Applying bundles preserves all changeset contents including
1179 1179 permissions, copy/rename information, and revision history.
1180 1180
1181 1181 Returns 0 on success, 1 if no changes found.
1182 1182 """
1183 1183 opts = pycompat.byteskwargs(opts)
1184 1184 revs = None
1185 1185 if 'rev' in opts:
1186 1186 revstrings = opts['rev']
1187 1187 revs = scmutil.revrange(repo, revstrings)
1188 1188 if revstrings and not revs:
1189 1189 raise error.Abort(_('no commits to bundle'))
1190 1190
1191 1191 bundletype = opts.get('type', 'bzip2').lower()
1192 1192 try:
1193 1193 bcompression, cgversion, params = exchange.parsebundlespec(
1194 1194 repo, bundletype, strict=False)
1195 1195 except error.UnsupportedBundleSpecification as e:
1196 1196 raise error.Abort(str(e),
1197 1197 hint=_("see 'hg help bundlespec' for supported "
1198 1198 "values for --type"))
1199 1199
1200 1200 # Packed bundles are a pseudo bundle format for now.
1201 1201 if cgversion == 's1':
1202 1202 raise error.Abort(_('packed bundles cannot be produced by "hg bundle"'),
1203 1203 hint=_("use 'hg debugcreatestreamclonebundle'"))
1204 1204
1205 1205 if opts.get('all'):
1206 1206 if dest:
1207 1207 raise error.Abort(_("--all is incompatible with specifying "
1208 1208 "a destination"))
1209 1209 if opts.get('base'):
1210 1210 ui.warn(_("ignoring --base because --all was specified\n"))
1211 1211 base = ['null']
1212 1212 else:
1213 1213 base = scmutil.revrange(repo, opts.get('base'))
1214 1214 if cgversion not in changegroup.supportedoutgoingversions(repo):
1215 1215 raise error.Abort(_("repository does not support bundle version %s") %
1216 1216 cgversion)
1217 1217
1218 1218 if base:
1219 1219 if dest:
1220 1220 raise error.Abort(_("--base is incompatible with specifying "
1221 1221 "a destination"))
1222 1222 common = [repo.lookup(rev) for rev in base]
1223 1223 heads = [repo.lookup(r) for r in revs] if revs else None
1224 1224 outgoing = discovery.outgoing(repo, common, heads)
1225 1225 else:
1226 1226 dest = ui.expandpath(dest or 'default-push', dest or 'default')
1227 1227 dest, branches = hg.parseurl(dest, opts.get('branch'))
1228 1228 other = hg.peer(repo, opts, dest)
1229 1229 revs, checkout = hg.addbranchrevs(repo, repo, branches, revs)
1230 1230 heads = revs and map(repo.lookup, revs) or revs
1231 1231 outgoing = discovery.findcommonoutgoing(repo, other,
1232 1232 onlyheads=heads,
1233 1233 force=opts.get('force'),
1234 1234 portable=True)
1235 1235
1236 1236 if not outgoing.missing:
1237 1237 scmutil.nochangesfound(ui, repo, not base and outgoing.excluded)
1238 1238 return 1
1239 1239
1240 1240 if cgversion == '01': #bundle1
1241 1241 if bcompression is None:
1242 1242 bcompression = 'UN'
1243 1243 bversion = 'HG10' + bcompression
1244 1244 bcompression = None
1245 1245 elif cgversion in ('02', '03'):
1246 1246 bversion = 'HG20'
1247 1247 else:
1248 1248 raise error.ProgrammingError(
1249 1249 'bundle: unexpected changegroup version %s' % cgversion)
1250 1250
1251 1251 # TODO compression options should be derived from bundlespec parsing.
1252 1252 # This is a temporary hack to allow adjusting bundle compression
1253 1253 # level without a) formalizing the bundlespec changes to declare it
1254 1254 # b) introducing a command flag.
1255 1255 compopts = {}
1256 1256 complevel = ui.configint('experimental', 'bundlecomplevel')
1257 1257 if complevel is not None:
1258 1258 compopts['level'] = complevel
1259 1259
1260 1260
1261 1261 contentopts = {'cg.version': cgversion}
1262 1262 if repo.ui.configbool('experimental', 'evolution.bundle-obsmarker'):
1263 1263 contentopts['obsolescence'] = True
1264 1264 if repo.ui.configbool('experimental', 'bundle-phases'):
1265 1265 contentopts['phases'] = True
1266 1266 bundle2.writenewbundle(ui, repo, 'bundle', fname, bversion, outgoing,
1267 1267 contentopts, compression=bcompression,
1268 1268 compopts=compopts)
1269 1269
1270 1270 @command('cat',
1271 1271 [('o', 'output', '',
1272 1272 _('print output to file with formatted name'), _('FORMAT')),
1273 1273 ('r', 'rev', '', _('print the given revision'), _('REV')),
1274 1274 ('', 'decode', None, _('apply any matching decode filter')),
1275 1275 ] + walkopts + formatteropts,
1276 1276 _('[OPTION]... FILE...'),
1277 1277 inferrepo=True, cmdtype=readonly)
1278 1278 def cat(ui, repo, file1, *pats, **opts):
1279 1279 """output the current or given revision of files
1280 1280
1281 1281 Print the specified files as they were at the given revision. If
1282 1282 no revision is given, the parent of the working directory is used.
1283 1283
1284 1284 Output may be to a file, in which case the name of the file is
1285 1285 given using a format string. The formatting rules as follows:
1286 1286
1287 1287 :``%%``: literal "%" character
1288 1288 :``%s``: basename of file being printed
1289 1289 :``%d``: dirname of file being printed, or '.' if in repository root
1290 1290 :``%p``: root-relative path name of file being printed
1291 1291 :``%H``: changeset hash (40 hexadecimal digits)
1292 1292 :``%R``: changeset revision number
1293 1293 :``%h``: short-form changeset hash (12 hexadecimal digits)
1294 1294 :``%r``: zero-padded changeset revision number
1295 1295 :``%b``: basename of the exporting repository
1296 1296
1297 1297 Returns 0 on success.
1298 1298 """
1299 1299 opts = pycompat.byteskwargs(opts)
1300 1300 rev = opts.get('rev')
1301 1301 if rev:
1302 1302 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
1303 1303 ctx = scmutil.revsingle(repo, rev)
1304 1304 m = scmutil.match(ctx, (file1,) + pats, opts)
1305 1305 fntemplate = opts.pop('output', '')
1306 1306 if cmdutil.isstdiofilename(fntemplate):
1307 1307 fntemplate = ''
1308 1308
1309 1309 if fntemplate:
1310 1310 fm = formatter.nullformatter(ui, 'cat')
1311 1311 else:
1312 1312 ui.pager('cat')
1313 1313 fm = ui.formatter('cat', opts)
1314 1314 with fm:
1315 1315 return cmdutil.cat(ui, repo, ctx, m, fm, fntemplate, '',
1316 1316 **pycompat.strkwargs(opts))
1317 1317
1318 1318 @command('^clone',
1319 1319 [('U', 'noupdate', None, _('the clone will include an empty working '
1320 1320 'directory (only a repository)')),
1321 1321 ('u', 'updaterev', '', _('revision, tag, or branch to check out'),
1322 1322 _('REV')),
1323 1323 ('r', 'rev', [], _('include the specified changeset'), _('REV')),
1324 1324 ('b', 'branch', [], _('clone only the specified branch'), _('BRANCH')),
1325 1325 ('', 'pull', None, _('use pull protocol to copy metadata')),
1326 1326 ('', 'uncompressed', None,
1327 1327 _('an alias to --stream (DEPRECATED)')),
1328 1328 ('', 'stream', None,
1329 1329 _('clone with minimal data processing')),
1330 1330 ] + remoteopts,
1331 1331 _('[OPTION]... SOURCE [DEST]'),
1332 1332 norepo=True)
1333 1333 def clone(ui, source, dest=None, **opts):
1334 1334 """make a copy of an existing repository
1335 1335
1336 1336 Create a copy of an existing repository in a new directory.
1337 1337
1338 1338 If no destination directory name is specified, it defaults to the
1339 1339 basename of the source.
1340 1340
1341 1341 The location of the source is added to the new repository's
1342 1342 ``.hg/hgrc`` file, as the default to be used for future pulls.
1343 1343
1344 1344 Only local paths and ``ssh://`` URLs are supported as
1345 1345 destinations. For ``ssh://`` destinations, no working directory or
1346 1346 ``.hg/hgrc`` will be created on the remote side.
1347 1347
1348 1348 If the source repository has a bookmark called '@' set, that
1349 1349 revision will be checked out in the new repository by default.
1350 1350
1351 1351 To check out a particular version, use -u/--update, or
1352 1352 -U/--noupdate to create a clone with no working directory.
1353 1353
1354 1354 To pull only a subset of changesets, specify one or more revisions
1355 1355 identifiers with -r/--rev or branches with -b/--branch. The
1356 1356 resulting clone will contain only the specified changesets and
1357 1357 their ancestors. These options (or 'clone src#rev dest') imply
1358 1358 --pull, even for local source repositories.
1359 1359
1360 1360 In normal clone mode, the remote normalizes repository data into a common
1361 1361 exchange format and the receiving end translates this data into its local
1362 1362 storage format. --stream activates a different clone mode that essentially
1363 1363 copies repository files from the remote with minimal data processing. This
1364 1364 significantly reduces the CPU cost of a clone both remotely and locally.
1365 1365 However, it often increases the transferred data size by 30-40%. This can
1366 1366 result in substantially faster clones where I/O throughput is plentiful,
1367 1367 especially for larger repositories. A side-effect of --stream clones is
1368 1368 that storage settings and requirements on the remote are applied locally:
1369 1369 a modern client may inherit legacy or inefficient storage used by the
1370 1370 remote or a legacy Mercurial client may not be able to clone from a
1371 1371 modern Mercurial remote.
1372 1372
1373 1373 .. note::
1374 1374
1375 1375 Specifying a tag will include the tagged changeset but not the
1376 1376 changeset containing the tag.
1377 1377
1378 1378 .. container:: verbose
1379 1379
1380 1380 For efficiency, hardlinks are used for cloning whenever the
1381 1381 source and destination are on the same filesystem (note this
1382 1382 applies only to the repository data, not to the working
1383 1383 directory). Some filesystems, such as AFS, implement hardlinking
1384 1384 incorrectly, but do not report errors. In these cases, use the
1385 1385 --pull option to avoid hardlinking.
1386 1386
1387 1387 Mercurial will update the working directory to the first applicable
1388 1388 revision from this list:
1389 1389
1390 1390 a) null if -U or the source repository has no changesets
1391 1391 b) if -u . and the source repository is local, the first parent of
1392 1392 the source repository's working directory
1393 1393 c) the changeset specified with -u (if a branch name, this means the
1394 1394 latest head of that branch)
1395 1395 d) the changeset specified with -r
1396 1396 e) the tipmost head specified with -b
1397 1397 f) the tipmost head specified with the url#branch source syntax
1398 1398 g) the revision marked with the '@' bookmark, if present
1399 1399 h) the tipmost head of the default branch
1400 1400 i) tip
1401 1401
1402 1402 When cloning from servers that support it, Mercurial may fetch
1403 1403 pre-generated data from a server-advertised URL. When this is done,
1404 1404 hooks operating on incoming changesets and changegroups may fire twice,
1405 1405 once for the bundle fetched from the URL and another for any additional
1406 1406 data not fetched from this URL. In addition, if an error occurs, the
1407 1407 repository may be rolled back to a partial clone. This behavior may
1408 1408 change in future releases. See :hg:`help -e clonebundles` for more.
1409 1409
1410 1410 Examples:
1411 1411
1412 1412 - clone a remote repository to a new directory named hg/::
1413 1413
1414 1414 hg clone https://www.mercurial-scm.org/repo/hg/
1415 1415
1416 1416 - create a lightweight local clone::
1417 1417
1418 1418 hg clone project/ project-feature/
1419 1419
1420 1420 - clone from an absolute path on an ssh server (note double-slash)::
1421 1421
1422 1422 hg clone ssh://user@server//home/projects/alpha/
1423 1423
1424 1424 - do a streaming clone while checking out a specified version::
1425 1425
1426 1426 hg clone --stream http://server/repo -u 1.5
1427 1427
1428 1428 - create a repository without changesets after a particular revision::
1429 1429
1430 1430 hg clone -r 04e544 experimental/ good/
1431 1431
1432 1432 - clone (and track) a particular named branch::
1433 1433
1434 1434 hg clone https://www.mercurial-scm.org/repo/hg/#stable
1435 1435
1436 1436 See :hg:`help urls` for details on specifying URLs.
1437 1437
1438 1438 Returns 0 on success.
1439 1439 """
1440 1440 opts = pycompat.byteskwargs(opts)
1441 1441 if opts.get('noupdate') and opts.get('updaterev'):
1442 1442 raise error.Abort(_("cannot specify both --noupdate and --updaterev"))
1443 1443
1444 1444 r = hg.clone(ui, opts, source, dest,
1445 1445 pull=opts.get('pull'),
1446 1446 stream=opts.get('stream') or opts.get('uncompressed'),
1447 1447 rev=opts.get('rev'),
1448 1448 update=opts.get('updaterev') or not opts.get('noupdate'),
1449 1449 branch=opts.get('branch'),
1450 1450 shareopts=opts.get('shareopts'))
1451 1451
1452 1452 return r is None
1453 1453
1454 1454 @command('^commit|ci',
1455 1455 [('A', 'addremove', None,
1456 1456 _('mark new/missing files as added/removed before committing')),
1457 1457 ('', 'close-branch', None,
1458 1458 _('mark a branch head as closed')),
1459 1459 ('', 'amend', None, _('amend the parent of the working directory')),
1460 1460 ('s', 'secret', None, _('use the secret phase for committing')),
1461 1461 ('e', 'edit', None, _('invoke editor on commit messages')),
1462 1462 ('i', 'interactive', None, _('use interactive mode')),
1463 1463 ] + walkopts + commitopts + commitopts2 + subrepoopts,
1464 1464 _('[OPTION]... [FILE]...'),
1465 1465 inferrepo=True)
1466 1466 def commit(ui, repo, *pats, **opts):
1467 1467 """commit the specified files or all outstanding changes
1468 1468
1469 1469 Commit changes to the given files into the repository. Unlike a
1470 1470 centralized SCM, this operation is a local operation. See
1471 1471 :hg:`push` for a way to actively distribute your changes.
1472 1472
1473 1473 If a list of files is omitted, all changes reported by :hg:`status`
1474 1474 will be committed.
1475 1475
1476 1476 If you are committing the result of a merge, do not provide any
1477 1477 filenames or -I/-X filters.
1478 1478
1479 1479 If no commit message is specified, Mercurial starts your
1480 1480 configured editor where you can enter a message. In case your
1481 1481 commit fails, you will find a backup of your message in
1482 1482 ``.hg/last-message.txt``.
1483 1483
1484 1484 The --close-branch flag can be used to mark the current branch
1485 1485 head closed. When all heads of a branch are closed, the branch
1486 1486 will be considered closed and no longer listed.
1487 1487
1488 1488 The --amend flag can be used to amend the parent of the
1489 1489 working directory with a new commit that contains the changes
1490 1490 in the parent in addition to those currently reported by :hg:`status`,
1491 1491 if there are any. The old commit is stored in a backup bundle in
1492 1492 ``.hg/strip-backup`` (see :hg:`help bundle` and :hg:`help unbundle`
1493 1493 on how to restore it).
1494 1494
1495 1495 Message, user and date are taken from the amended commit unless
1496 1496 specified. When a message isn't specified on the command line,
1497 1497 the editor will open with the message of the amended commit.
1498 1498
1499 1499 It is not possible to amend public changesets (see :hg:`help phases`)
1500 1500 or changesets that have children.
1501 1501
1502 1502 See :hg:`help dates` for a list of formats valid for -d/--date.
1503 1503
1504 1504 Returns 0 on success, 1 if nothing changed.
1505 1505
1506 1506 .. container:: verbose
1507 1507
1508 1508 Examples:
1509 1509
1510 1510 - commit all files ending in .py::
1511 1511
1512 1512 hg commit --include "set:**.py"
1513 1513
1514 1514 - commit all non-binary files::
1515 1515
1516 1516 hg commit --exclude "set:binary()"
1517 1517
1518 1518 - amend the current commit and set the date to now::
1519 1519
1520 1520 hg commit --amend --date now
1521 1521 """
1522 1522 wlock = lock = None
1523 1523 try:
1524 1524 wlock = repo.wlock()
1525 1525 lock = repo.lock()
1526 1526 return _docommit(ui, repo, *pats, **opts)
1527 1527 finally:
1528 1528 release(lock, wlock)
1529 1529
1530 1530 def _docommit(ui, repo, *pats, **opts):
1531 1531 if opts.get(r'interactive'):
1532 1532 opts.pop(r'interactive')
1533 1533 ret = cmdutil.dorecord(ui, repo, commit, None, False,
1534 1534 cmdutil.recordfilter, *pats,
1535 1535 **opts)
1536 1536 # ret can be 0 (no changes to record) or the value returned by
1537 1537 # commit(), 1 if nothing changed or None on success.
1538 1538 return 1 if ret == 0 else ret
1539 1539
1540 1540 opts = pycompat.byteskwargs(opts)
1541 1541 if opts.get('subrepos'):
1542 1542 if opts.get('amend'):
1543 1543 raise error.Abort(_('cannot amend with --subrepos'))
1544 1544 # Let --subrepos on the command line override config setting.
1545 1545 ui.setconfig('ui', 'commitsubrepos', True, 'commit')
1546 1546
1547 1547 cmdutil.checkunfinished(repo, commit=True)
1548 1548
1549 1549 branch = repo[None].branch()
1550 1550 bheads = repo.branchheads(branch)
1551 1551
1552 1552 extra = {}
1553 1553 if opts.get('close_branch'):
1554 1554 extra['close'] = 1
1555 1555
1556 1556 if not bheads:
1557 1557 raise error.Abort(_('can only close branch heads'))
1558 1558 elif opts.get('amend'):
1559 1559 if repo[None].parents()[0].p1().branch() != branch and \
1560 1560 repo[None].parents()[0].p2().branch() != branch:
1561 1561 raise error.Abort(_('can only close branch heads'))
1562 1562
1563 1563 if opts.get('amend'):
1564 1564 if ui.configbool('ui', 'commitsubrepos'):
1565 1565 raise error.Abort(_('cannot amend with ui.commitsubrepos enabled'))
1566 1566
1567 1567 old = repo['.']
1568 1568 rewriteutil.precheck(repo, [old.rev()], 'amend')
1569 1569
1570 1570 # Currently histedit gets confused if an amend happens while histedit
1571 1571 # is in progress. Since we have a checkunfinished command, we are
1572 1572 # temporarily honoring it.
1573 1573 #
1574 1574 # Note: eventually this guard will be removed. Please do not expect
1575 1575 # this behavior to remain.
1576 1576 if not obsolete.isenabled(repo, obsolete.createmarkersopt):
1577 1577 cmdutil.checkunfinished(repo)
1578 1578
1579 1579 node = cmdutil.amend(ui, repo, old, extra, pats, opts)
1580 1580 if node == old.node():
1581 1581 ui.status(_("nothing changed\n"))
1582 1582 return 1
1583 1583 else:
1584 1584 def commitfunc(ui, repo, message, match, opts):
1585 1585 overrides = {}
1586 1586 if opts.get('secret'):
1587 1587 overrides[('phases', 'new-commit')] = 'secret'
1588 1588
1589 1589 baseui = repo.baseui
1590 1590 with baseui.configoverride(overrides, 'commit'):
1591 1591 with ui.configoverride(overrides, 'commit'):
1592 1592 editform = cmdutil.mergeeditform(repo[None],
1593 1593 'commit.normal')
1594 1594 editor = cmdutil.getcommiteditor(
1595 1595 editform=editform, **pycompat.strkwargs(opts))
1596 1596 return repo.commit(message,
1597 1597 opts.get('user'),
1598 1598 opts.get('date'),
1599 1599 match,
1600 1600 editor=editor,
1601 1601 extra=extra)
1602 1602
1603 1603 node = cmdutil.commit(ui, repo, commitfunc, pats, opts)
1604 1604
1605 1605 if not node:
1606 1606 stat = cmdutil.postcommitstatus(repo, pats, opts)
1607 1607 if stat[3]:
1608 1608 ui.status(_("nothing changed (%d missing files, see "
1609 1609 "'hg status')\n") % len(stat[3]))
1610 1610 else:
1611 1611 ui.status(_("nothing changed\n"))
1612 1612 return 1
1613 1613
1614 1614 cmdutil.commitstatus(repo, node, branch, bheads, opts)
1615 1615
1616 1616 @command('config|showconfig|debugconfig',
1617 1617 [('u', 'untrusted', None, _('show untrusted configuration options')),
1618 1618 ('e', 'edit', None, _('edit user config')),
1619 1619 ('l', 'local', None, _('edit repository config')),
1620 1620 ('g', 'global', None, _('edit global config'))] + formatteropts,
1621 1621 _('[-u] [NAME]...'),
1622 1622 optionalrepo=True, cmdtype=readonly)
1623 1623 def config(ui, repo, *values, **opts):
1624 1624 """show combined config settings from all hgrc files
1625 1625
1626 1626 With no arguments, print names and values of all config items.
1627 1627
1628 1628 With one argument of the form section.name, print just the value
1629 1629 of that config item.
1630 1630
1631 1631 With multiple arguments, print names and values of all config
1632 1632 items with matching section names.
1633 1633
1634 1634 With --edit, start an editor on the user-level config file. With
1635 1635 --global, edit the system-wide config file. With --local, edit the
1636 1636 repository-level config file.
1637 1637
1638 1638 With --debug, the source (filename and line number) is printed
1639 1639 for each config item.
1640 1640
1641 1641 See :hg:`help config` for more information about config files.
1642 1642
1643 1643 Returns 0 on success, 1 if NAME does not exist.
1644 1644
1645 1645 """
1646 1646
1647 1647 opts = pycompat.byteskwargs(opts)
1648 1648 if opts.get('edit') or opts.get('local') or opts.get('global'):
1649 1649 if opts.get('local') and opts.get('global'):
1650 1650 raise error.Abort(_("can't use --local and --global together"))
1651 1651
1652 1652 if opts.get('local'):
1653 1653 if not repo:
1654 1654 raise error.Abort(_("can't use --local outside a repository"))
1655 1655 paths = [repo.vfs.join('hgrc')]
1656 1656 elif opts.get('global'):
1657 1657 paths = rcutil.systemrcpath()
1658 1658 else:
1659 1659 paths = rcutil.userrcpath()
1660 1660
1661 1661 for f in paths:
1662 1662 if os.path.exists(f):
1663 1663 break
1664 1664 else:
1665 1665 if opts.get('global'):
1666 1666 samplehgrc = uimod.samplehgrcs['global']
1667 1667 elif opts.get('local'):
1668 1668 samplehgrc = uimod.samplehgrcs['local']
1669 1669 else:
1670 1670 samplehgrc = uimod.samplehgrcs['user']
1671 1671
1672 1672 f = paths[0]
1673 1673 fp = open(f, "wb")
1674 1674 fp.write(util.tonativeeol(samplehgrc))
1675 1675 fp.close()
1676 1676
1677 1677 editor = ui.geteditor()
1678 1678 ui.system("%s \"%s\"" % (editor, f),
1679 1679 onerr=error.Abort, errprefix=_("edit failed"),
1680 1680 blockedtag='config_edit')
1681 1681 return
1682 1682 ui.pager('config')
1683 1683 fm = ui.formatter('config', opts)
1684 1684 for t, f in rcutil.rccomponents():
1685 1685 if t == 'path':
1686 1686 ui.debug('read config from: %s\n' % f)
1687 1687 elif t == 'items':
1688 1688 for section, name, value, source in f:
1689 1689 ui.debug('set config by: %s\n' % source)
1690 1690 else:
1691 1691 raise error.ProgrammingError('unknown rctype: %s' % t)
1692 1692 untrusted = bool(opts.get('untrusted'))
1693 1693 if values:
1694 1694 sections = [v for v in values if '.' not in v]
1695 1695 items = [v for v in values if '.' in v]
1696 1696 if len(items) > 1 or items and sections:
1697 1697 raise error.Abort(_('only one config item permitted'))
1698 1698 matched = False
1699 1699 for section, name, value in ui.walkconfig(untrusted=untrusted):
1700 1700 source = ui.configsource(section, name, untrusted)
1701 1701 value = pycompat.bytestr(value)
1702 1702 if fm.isplain():
1703 1703 source = source or 'none'
1704 1704 value = value.replace('\n', '\\n')
1705 1705 entryname = section + '.' + name
1706 1706 if values:
1707 1707 for v in values:
1708 1708 if v == section:
1709 1709 fm.startitem()
1710 1710 fm.condwrite(ui.debugflag, 'source', '%s: ', source)
1711 1711 fm.write('name value', '%s=%s\n', entryname, value)
1712 1712 matched = True
1713 1713 elif v == entryname:
1714 1714 fm.startitem()
1715 1715 fm.condwrite(ui.debugflag, 'source', '%s: ', source)
1716 1716 fm.write('value', '%s\n', value)
1717 1717 fm.data(name=entryname)
1718 1718 matched = True
1719 1719 else:
1720 1720 fm.startitem()
1721 1721 fm.condwrite(ui.debugflag, 'source', '%s: ', source)
1722 1722 fm.write('name value', '%s=%s\n', entryname, value)
1723 1723 matched = True
1724 1724 fm.end()
1725 1725 if matched:
1726 1726 return 0
1727 1727 return 1
1728 1728
1729 1729 @command('copy|cp',
1730 1730 [('A', 'after', None, _('record a copy that has already occurred')),
1731 1731 ('f', 'force', None, _('forcibly copy over an existing managed file')),
1732 1732 ] + walkopts + dryrunopts,
1733 1733 _('[OPTION]... [SOURCE]... DEST'))
1734 1734 def copy(ui, repo, *pats, **opts):
1735 1735 """mark files as copied for the next commit
1736 1736
1737 1737 Mark dest as having copies of source files. If dest is a
1738 1738 directory, copies are put in that directory. If dest is a file,
1739 1739 the source must be a single file.
1740 1740
1741 1741 By default, this command copies the contents of files as they
1742 1742 exist in the working directory. If invoked with -A/--after, the
1743 1743 operation is recorded, but no copying is performed.
1744 1744
1745 1745 This command takes effect with the next commit. To undo a copy
1746 1746 before that, see :hg:`revert`.
1747 1747
1748 1748 Returns 0 on success, 1 if errors are encountered.
1749 1749 """
1750 1750 opts = pycompat.byteskwargs(opts)
1751 1751 with repo.wlock(False):
1752 1752 return cmdutil.copy(ui, repo, pats, opts)
1753 1753
1754 1754 @command('debugcommands', [], _('[COMMAND]'), norepo=True)
1755 1755 def debugcommands(ui, cmd='', *args):
1756 1756 """list all available commands and options"""
1757 1757 for cmd, vals in sorted(table.iteritems()):
1758 1758 cmd = cmd.split('|')[0].strip('^')
1759 1759 opts = ', '.join([i[1] for i in vals[1]])
1760 1760 ui.write('%s: %s\n' % (cmd, opts))
1761 1761
1762 1762 @command('debugcomplete',
1763 1763 [('o', 'options', None, _('show the command options'))],
1764 1764 _('[-o] CMD'),
1765 1765 norepo=True)
1766 1766 def debugcomplete(ui, cmd='', **opts):
1767 1767 """returns the completion list associated with the given command"""
1768 1768
1769 1769 if opts.get(r'options'):
1770 1770 options = []
1771 1771 otables = [globalopts]
1772 1772 if cmd:
1773 1773 aliases, entry = cmdutil.findcmd(cmd, table, False)
1774 1774 otables.append(entry[1])
1775 1775 for t in otables:
1776 1776 for o in t:
1777 1777 if "(DEPRECATED)" in o[3]:
1778 1778 continue
1779 1779 if o[0]:
1780 1780 options.append('-%s' % o[0])
1781 1781 options.append('--%s' % o[1])
1782 1782 ui.write("%s\n" % "\n".join(options))
1783 1783 return
1784 1784
1785 1785 cmdlist, unused_allcmds = cmdutil.findpossible(cmd, table)
1786 1786 if ui.verbose:
1787 1787 cmdlist = [' '.join(c[0]) for c in cmdlist.values()]
1788 1788 ui.write("%s\n" % "\n".join(sorted(cmdlist)))
1789 1789
1790 1790 @command('^diff',
1791 1791 [('r', 'rev', [], _('revision'), _('REV')),
1792 1792 ('c', 'change', '', _('change made by revision'), _('REV'))
1793 1793 ] + diffopts + diffopts2 + walkopts + subrepoopts,
1794 1794 _('[OPTION]... ([-c REV] | [-r REV1 [-r REV2]]) [FILE]...'),
1795 1795 inferrepo=True, cmdtype=readonly)
1796 1796 def diff(ui, repo, *pats, **opts):
1797 1797 """diff repository (or selected files)
1798 1798
1799 1799 Show differences between revisions for the specified files.
1800 1800
1801 1801 Differences between files are shown using the unified diff format.
1802 1802
1803 1803 .. note::
1804 1804
1805 1805 :hg:`diff` may generate unexpected results for merges, as it will
1806 1806 default to comparing against the working directory's first
1807 1807 parent changeset if no revisions are specified.
1808 1808
1809 1809 When two revision arguments are given, then changes are shown
1810 1810 between those revisions. If only one revision is specified then
1811 1811 that revision is compared to the working directory, and, when no
1812 1812 revisions are specified, the working directory files are compared
1813 1813 to its first parent.
1814 1814
1815 1815 Alternatively you can specify -c/--change with a revision to see
1816 1816 the changes in that changeset relative to its first parent.
1817 1817
1818 1818 Without the -a/--text option, diff will avoid generating diffs of
1819 1819 files it detects as binary. With -a, diff will generate a diff
1820 1820 anyway, probably with undesirable results.
1821 1821
1822 1822 Use the -g/--git option to generate diffs in the git extended diff
1823 1823 format. For more information, read :hg:`help diffs`.
1824 1824
1825 1825 .. container:: verbose
1826 1826
1827 1827 Examples:
1828 1828
1829 1829 - compare a file in the current working directory to its parent::
1830 1830
1831 1831 hg diff foo.c
1832 1832
1833 1833 - compare two historical versions of a directory, with rename info::
1834 1834
1835 1835 hg diff --git -r 1.0:1.2 lib/
1836 1836
1837 1837 - get change stats relative to the last change on some date::
1838 1838
1839 1839 hg diff --stat -r "date('may 2')"
1840 1840
1841 1841 - diff all newly-added files that contain a keyword::
1842 1842
1843 1843 hg diff "set:added() and grep(GNU)"
1844 1844
1845 1845 - compare a revision and its parents::
1846 1846
1847 1847 hg diff -c 9353 # compare against first parent
1848 1848 hg diff -r 9353^:9353 # same using revset syntax
1849 1849 hg diff -r 9353^2:9353 # compare against the second parent
1850 1850
1851 1851 Returns 0 on success.
1852 1852 """
1853 1853
1854 1854 opts = pycompat.byteskwargs(opts)
1855 1855 revs = opts.get('rev')
1856 1856 change = opts.get('change')
1857 1857 stat = opts.get('stat')
1858 1858 reverse = opts.get('reverse')
1859 1859
1860 1860 if revs and change:
1861 1861 msg = _('cannot specify --rev and --change at the same time')
1862 1862 raise error.Abort(msg)
1863 1863 elif change:
1864 1864 repo = scmutil.unhidehashlikerevs(repo, [change], 'nowarn')
1865 1865 node2 = scmutil.revsingle(repo, change, None).node()
1866 1866 node1 = repo[node2].p1().node()
1867 1867 else:
1868 1868 repo = scmutil.unhidehashlikerevs(repo, revs, 'nowarn')
1869 1869 node1, node2 = scmutil.revpair(repo, revs)
1870 1870
1871 1871 if reverse:
1872 1872 node1, node2 = node2, node1
1873 1873
1874 1874 diffopts = patch.diffallopts(ui, opts)
1875 1875 m = scmutil.match(repo[node2], pats, opts)
1876 1876 ui.pager('diff')
1877 1877 logcmdutil.diffordiffstat(ui, repo, diffopts, node1, node2, m, stat=stat,
1878 1878 listsubrepos=opts.get('subrepos'),
1879 1879 root=opts.get('root'))
1880 1880
1881 1881 @command('^export',
1882 1882 [('o', 'output', '',
1883 1883 _('print output to file with formatted name'), _('FORMAT')),
1884 1884 ('', 'switch-parent', None, _('diff against the second parent')),
1885 1885 ('r', 'rev', [], _('revisions to export'), _('REV')),
1886 1886 ] + diffopts,
1887 1887 _('[OPTION]... [-o OUTFILESPEC] [-r] [REV]...'), cmdtype=readonly)
1888 1888 def export(ui, repo, *changesets, **opts):
1889 1889 """dump the header and diffs for one or more changesets
1890 1890
1891 1891 Print the changeset header and diffs for one or more revisions.
1892 1892 If no revision is given, the parent of the working directory is used.
1893 1893
1894 1894 The information shown in the changeset header is: author, date,
1895 1895 branch name (if non-default), changeset hash, parent(s) and commit
1896 1896 comment.
1897 1897
1898 1898 .. note::
1899 1899
1900 1900 :hg:`export` may generate unexpected diff output for merge
1901 1901 changesets, as it will compare the merge changeset against its
1902 1902 first parent only.
1903 1903
1904 1904 Output may be to a file, in which case the name of the file is
1905 1905 given using a format string. The formatting rules are as follows:
1906 1906
1907 1907 :``%%``: literal "%" character
1908 1908 :``%H``: changeset hash (40 hexadecimal digits)
1909 1909 :``%N``: number of patches being generated
1910 1910 :``%R``: changeset revision number
1911 1911 :``%b``: basename of the exporting repository
1912 1912 :``%h``: short-form changeset hash (12 hexadecimal digits)
1913 1913 :``%m``: first line of the commit message (only alphanumeric characters)
1914 1914 :``%n``: zero-padded sequence number, starting at 1
1915 1915 :``%r``: zero-padded changeset revision number
1916 1916
1917 1917 Without the -a/--text option, export will avoid generating diffs
1918 1918 of files it detects as binary. With -a, export will generate a
1919 1919 diff anyway, probably with undesirable results.
1920 1920
1921 1921 Use the -g/--git option to generate diffs in the git extended diff
1922 1922 format. See :hg:`help diffs` for more information.
1923 1923
1924 1924 With the --switch-parent option, the diff will be against the
1925 1925 second parent. It can be useful to review a merge.
1926 1926
1927 1927 .. container:: verbose
1928 1928
1929 1929 Examples:
1930 1930
1931 1931 - use export and import to transplant a bugfix to the current
1932 1932 branch::
1933 1933
1934 1934 hg export -r 9353 | hg import -
1935 1935
1936 1936 - export all the changesets between two revisions to a file with
1937 1937 rename information::
1938 1938
1939 1939 hg export --git -r 123:150 > changes.txt
1940 1940
1941 1941 - split outgoing changes into a series of patches with
1942 1942 descriptive names::
1943 1943
1944 1944 hg export -r "outgoing()" -o "%n-%m.patch"
1945 1945
1946 1946 Returns 0 on success.
1947 1947 """
1948 1948 opts = pycompat.byteskwargs(opts)
1949 1949 changesets += tuple(opts.get('rev', []))
1950 1950 if not changesets:
1951 1951 changesets = ['.']
1952 1952 repo = scmutil.unhidehashlikerevs(repo, changesets, 'nowarn')
1953 1953 revs = scmutil.revrange(repo, changesets)
1954 1954 if not revs:
1955 1955 raise error.Abort(_("export requires at least one changeset"))
1956 1956 if len(revs) > 1:
1957 1957 ui.note(_('exporting patches:\n'))
1958 1958 else:
1959 1959 ui.note(_('exporting patch:\n'))
1960 1960 ui.pager('export')
1961 1961 cmdutil.export(repo, revs, fntemplate=opts.get('output'),
1962 1962 switch_parent=opts.get('switch_parent'),
1963 1963 opts=patch.diffallopts(ui, opts))
1964 1964
1965 1965 @command('files',
1966 1966 [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
1967 1967 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
1968 1968 ] + walkopts + formatteropts + subrepoopts,
1969 1969 _('[OPTION]... [FILE]...'), cmdtype=readonly)
1970 1970 def files(ui, repo, *pats, **opts):
1971 1971 """list tracked files
1972 1972
1973 1973 Print files under Mercurial control in the working directory or
1974 1974 specified revision for given files (excluding removed files).
1975 1975 Files can be specified as filenames or filesets.
1976 1976
1977 1977 If no files are given to match, this command prints the names
1978 1978 of all files under Mercurial control.
1979 1979
1980 1980 .. container:: verbose
1981 1981
1982 1982 Examples:
1983 1983
1984 1984 - list all files under the current directory::
1985 1985
1986 1986 hg files .
1987 1987
1988 1988 - shows sizes and flags for current revision::
1989 1989
1990 1990 hg files -vr .
1991 1991
1992 1992 - list all files named README::
1993 1993
1994 1994 hg files -I "**/README"
1995 1995
1996 1996 - list all binary files::
1997 1997
1998 1998 hg files "set:binary()"
1999 1999
2000 2000 - find files containing a regular expression::
2001 2001
2002 2002 hg files "set:grep('bob')"
2003 2003
2004 2004 - search tracked file contents with xargs and grep::
2005 2005
2006 2006 hg files -0 | xargs -0 grep foo
2007 2007
2008 2008 See :hg:`help patterns` and :hg:`help filesets` for more information
2009 2009 on specifying file patterns.
2010 2010
2011 2011 Returns 0 if a match is found, 1 otherwise.
2012 2012
2013 2013 """
2014 2014
2015 2015 opts = pycompat.byteskwargs(opts)
2016 2016 rev = opts.get('rev')
2017 2017 if rev:
2018 2018 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
2019 2019 ctx = scmutil.revsingle(repo, rev, None)
2020 2020
2021 2021 end = '\n'
2022 2022 if opts.get('print0'):
2023 2023 end = '\0'
2024 2024 fmt = '%s' + end
2025 2025
2026 2026 m = scmutil.match(ctx, pats, opts)
2027 2027 ui.pager('files')
2028 2028 with ui.formatter('files', opts) as fm:
2029 2029 return cmdutil.files(ui, ctx, m, fm, fmt, opts.get('subrepos'))
2030 2030
2031 2031 @command('^forget', walkopts, _('[OPTION]... FILE...'), inferrepo=True)
2032 2032 def forget(ui, repo, *pats, **opts):
2033 2033 """forget the specified files on the next commit
2034 2034
2035 2035 Mark the specified files so they will no longer be tracked
2036 2036 after the next commit.
2037 2037
2038 2038 This only removes files from the current branch, not from the
2039 2039 entire project history, and it does not delete them from the
2040 2040 working directory.
2041 2041
2042 2042 To delete the file from the working directory, see :hg:`remove`.
2043 2043
2044 2044 To undo a forget before the next commit, see :hg:`add`.
2045 2045
2046 2046 .. container:: verbose
2047 2047
2048 2048 Examples:
2049 2049
2050 2050 - forget newly-added binary files::
2051 2051
2052 2052 hg forget "set:added() and binary()"
2053 2053
2054 2054 - forget files that would be excluded by .hgignore::
2055 2055
2056 2056 hg forget "set:hgignore()"
2057 2057
2058 2058 Returns 0 on success.
2059 2059 """
2060 2060
2061 2061 opts = pycompat.byteskwargs(opts)
2062 2062 if not pats:
2063 2063 raise error.Abort(_('no files specified'))
2064 2064
2065 2065 m = scmutil.match(repo[None], pats, opts)
2066 2066 rejected = cmdutil.forget(ui, repo, m, prefix="", explicitonly=False)[0]
2067 2067 return rejected and 1 or 0
2068 2068
2069 2069 @command(
2070 2070 'graft',
2071 2071 [('r', 'rev', [], _('revisions to graft'), _('REV')),
2072 2072 ('c', 'continue', False, _('resume interrupted graft')),
2073 2073 ('e', 'edit', False, _('invoke editor on commit messages')),
2074 2074 ('', 'log', None, _('append graft info to log message')),
2075 2075 ('f', 'force', False, _('force graft')),
2076 2076 ('D', 'currentdate', False,
2077 2077 _('record the current date as commit date')),
2078 2078 ('U', 'currentuser', False,
2079 2079 _('record the current user as committer'), _('DATE'))]
2080 2080 + commitopts2 + mergetoolopts + dryrunopts,
2081 2081 _('[OPTION]... [-r REV]... REV...'))
2082 2082 def graft(ui, repo, *revs, **opts):
2083 2083 '''copy changes from other branches onto the current branch
2084 2084
2085 2085 This command uses Mercurial's merge logic to copy individual
2086 2086 changes from other branches without merging branches in the
2087 2087 history graph. This is sometimes known as 'backporting' or
2088 2088 'cherry-picking'. By default, graft will copy user, date, and
2089 2089 description from the source changesets.
2090 2090
2091 2091 Changesets that are ancestors of the current revision, that have
2092 2092 already been grafted, or that are merges will be skipped.
2093 2093
2094 2094 If --log is specified, log messages will have a comment appended
2095 2095 of the form::
2096 2096
2097 2097 (grafted from CHANGESETHASH)
2098 2098
2099 2099 If --force is specified, revisions will be grafted even if they
2100 2100 are already ancestors of, or have been grafted to, the destination.
2101 2101 This is useful when the revisions have since been backed out.
2102 2102
2103 2103 If a graft merge results in conflicts, the graft process is
2104 2104 interrupted so that the current merge can be manually resolved.
2105 2105 Once all conflicts are addressed, the graft process can be
2106 2106 continued with the -c/--continue option.
2107 2107
2108 2108 .. note::
2109 2109
2110 2110 The -c/--continue option does not reapply earlier options, except
2111 2111 for --force.
2112 2112
2113 2113 .. container:: verbose
2114 2114
2115 2115 Examples:
2116 2116
2117 2117 - copy a single change to the stable branch and edit its description::
2118 2118
2119 2119 hg update stable
2120 2120 hg graft --edit 9393
2121 2121
2122 2122 - graft a range of changesets with one exception, updating dates::
2123 2123
2124 2124 hg graft -D "2085::2093 and not 2091"
2125 2125
2126 2126 - continue a graft after resolving conflicts::
2127 2127
2128 2128 hg graft -c
2129 2129
2130 2130 - show the source of a grafted changeset::
2131 2131
2132 2132 hg log --debug -r .
2133 2133
2134 2134 - show revisions sorted by date::
2135 2135
2136 2136 hg log -r "sort(all(), date)"
2137 2137
2138 2138 See :hg:`help revisions` for more about specifying revisions.
2139 2139
2140 2140 Returns 0 on successful completion.
2141 2141 '''
2142 2142 with repo.wlock():
2143 2143 return _dograft(ui, repo, *revs, **opts)
2144 2144
2145 2145 def _dograft(ui, repo, *revs, **opts):
2146 2146 opts = pycompat.byteskwargs(opts)
2147 2147 if revs and opts.get('rev'):
2148 2148 ui.warn(_('warning: inconsistent use of --rev might give unexpected '
2149 2149 'revision ordering!\n'))
2150 2150
2151 2151 revs = list(revs)
2152 2152 revs.extend(opts.get('rev'))
2153 2153
2154 2154 if not opts.get('user') and opts.get('currentuser'):
2155 2155 opts['user'] = ui.username()
2156 2156 if not opts.get('date') and opts.get('currentdate'):
2157 2157 opts['date'] = "%d %d" % util.makedate()
2158 2158
2159 2159 editor = cmdutil.getcommiteditor(editform='graft',
2160 2160 **pycompat.strkwargs(opts))
2161 2161
2162 2162 cont = False
2163 2163 if opts.get('continue'):
2164 2164 cont = True
2165 2165 if revs:
2166 2166 raise error.Abort(_("can't specify --continue and revisions"))
2167 2167 # read in unfinished revisions
2168 2168 try:
2169 2169 nodes = repo.vfs.read('graftstate').splitlines()
2170 2170 revs = [repo[node].rev() for node in nodes]
2171 2171 except IOError as inst:
2172 2172 if inst.errno != errno.ENOENT:
2173 2173 raise
2174 2174 cmdutil.wrongtooltocontinue(repo, _('graft'))
2175 2175 else:
2176 2176 cmdutil.checkunfinished(repo)
2177 2177 cmdutil.bailifchanged(repo)
2178 2178 if not revs:
2179 2179 raise error.Abort(_('no revisions specified'))
2180 2180 revs = scmutil.revrange(repo, revs)
2181 2181
2182 2182 skipped = set()
2183 2183 # check for merges
2184 2184 for rev in repo.revs('%ld and merge()', revs):
2185 2185 ui.warn(_('skipping ungraftable merge revision %d\n') % rev)
2186 2186 skipped.add(rev)
2187 2187 revs = [r for r in revs if r not in skipped]
2188 2188 if not revs:
2189 2189 return -1
2190 2190
2191 2191 # Don't check in the --continue case, in effect retaining --force across
2192 2192 # --continues. That's because without --force, any revisions we decided to
2193 2193 # skip would have been filtered out here, so they wouldn't have made their
2194 2194 # way to the graftstate. With --force, any revisions we would have otherwise
2195 2195 # skipped would not have been filtered out, and if they hadn't been applied
2196 2196 # already, they'd have been in the graftstate.
2197 2197 if not (cont or opts.get('force')):
2198 2198 # check for ancestors of dest branch
2199 2199 crev = repo['.'].rev()
2200 2200 ancestors = repo.changelog.ancestors([crev], inclusive=True)
2201 2201 # XXX make this lazy in the future
2202 2202 # don't mutate while iterating, create a copy
2203 2203 for rev in list(revs):
2204 2204 if rev in ancestors:
2205 2205 ui.warn(_('skipping ancestor revision %d:%s\n') %
2206 2206 (rev, repo[rev]))
2207 2207 # XXX remove on list is slow
2208 2208 revs.remove(rev)
2209 2209 if not revs:
2210 2210 return -1
2211 2211
2212 2212 # analyze revs for earlier grafts
2213 2213 ids = {}
2214 2214 for ctx in repo.set("%ld", revs):
2215 2215 ids[ctx.hex()] = ctx.rev()
2216 2216 n = ctx.extra().get('source')
2217 2217 if n:
2218 2218 ids[n] = ctx.rev()
2219 2219
2220 2220 # check ancestors for earlier grafts
2221 2221 ui.debug('scanning for duplicate grafts\n')
2222 2222
2223 2223 # The only changesets we can be sure doesn't contain grafts of any
2224 2224 # revs, are the ones that are common ancestors of *all* revs:
2225 2225 for rev in repo.revs('only(%d,ancestor(%ld))', crev, revs):
2226 2226 ctx = repo[rev]
2227 2227 n = ctx.extra().get('source')
2228 2228 if n in ids:
2229 2229 try:
2230 2230 r = repo[n].rev()
2231 2231 except error.RepoLookupError:
2232 2232 r = None
2233 2233 if r in revs:
2234 2234 ui.warn(_('skipping revision %d:%s '
2235 2235 '(already grafted to %d:%s)\n')
2236 2236 % (r, repo[r], rev, ctx))
2237 2237 revs.remove(r)
2238 2238 elif ids[n] in revs:
2239 2239 if r is None:
2240 2240 ui.warn(_('skipping already grafted revision %d:%s '
2241 2241 '(%d:%s also has unknown origin %s)\n')
2242 2242 % (ids[n], repo[ids[n]], rev, ctx, n[:12]))
2243 2243 else:
2244 2244 ui.warn(_('skipping already grafted revision %d:%s '
2245 2245 '(%d:%s also has origin %d:%s)\n')
2246 2246 % (ids[n], repo[ids[n]], rev, ctx, r, n[:12]))
2247 2247 revs.remove(ids[n])
2248 2248 elif ctx.hex() in ids:
2249 2249 r = ids[ctx.hex()]
2250 2250 ui.warn(_('skipping already grafted revision %d:%s '
2251 2251 '(was grafted from %d:%s)\n') %
2252 2252 (r, repo[r], rev, ctx))
2253 2253 revs.remove(r)
2254 2254 if not revs:
2255 2255 return -1
2256 2256
2257 2257 for pos, ctx in enumerate(repo.set("%ld", revs)):
2258 2258 desc = '%d:%s "%s"' % (ctx.rev(), ctx,
2259 2259 ctx.description().split('\n', 1)[0])
2260 2260 names = repo.nodetags(ctx.node()) + repo.nodebookmarks(ctx.node())
2261 2261 if names:
2262 2262 desc += ' (%s)' % ' '.join(names)
2263 2263 ui.status(_('grafting %s\n') % desc)
2264 2264 if opts.get('dry_run'):
2265 2265 continue
2266 2266
2267 2267 source = ctx.extra().get('source')
2268 2268 extra = {}
2269 2269 if source:
2270 2270 extra['source'] = source
2271 2271 extra['intermediate-source'] = ctx.hex()
2272 2272 else:
2273 2273 extra['source'] = ctx.hex()
2274 2274 user = ctx.user()
2275 2275 if opts.get('user'):
2276 2276 user = opts['user']
2277 2277 date = ctx.date()
2278 2278 if opts.get('date'):
2279 2279 date = opts['date']
2280 2280 message = ctx.description()
2281 2281 if opts.get('log'):
2282 2282 message += '\n(grafted from %s)' % ctx.hex()
2283 2283
2284 2284 # we don't merge the first commit when continuing
2285 2285 if not cont:
2286 2286 # perform the graft merge with p1(rev) as 'ancestor'
2287 2287 try:
2288 2288 # ui.forcemerge is an internal variable, do not document
2289 2289 repo.ui.setconfig('ui', 'forcemerge', opts.get('tool', ''),
2290 2290 'graft')
2291 2291 stats = mergemod.graft(repo, ctx, ctx.p1(),
2292 2292 ['local', 'graft'])
2293 2293 finally:
2294 2294 repo.ui.setconfig('ui', 'forcemerge', '', 'graft')
2295 2295 # report any conflicts
2296 2296 if stats and stats[3] > 0:
2297 2297 # write out state for --continue
2298 2298 nodelines = [repo[rev].hex() + "\n" for rev in revs[pos:]]
2299 2299 repo.vfs.write('graftstate', ''.join(nodelines))
2300 2300 extra = ''
2301 2301 if opts.get('user'):
2302 2302 extra += ' --user %s' % util.shellquote(opts['user'])
2303 2303 if opts.get('date'):
2304 2304 extra += ' --date %s' % util.shellquote(opts['date'])
2305 2305 if opts.get('log'):
2306 2306 extra += ' --log'
2307 2307 hint=_("use 'hg resolve' and 'hg graft --continue%s'") % extra
2308 2308 raise error.Abort(
2309 2309 _("unresolved conflicts, can't continue"),
2310 2310 hint=hint)
2311 2311 else:
2312 2312 cont = False
2313 2313
2314 2314 # commit
2315 2315 node = repo.commit(text=message, user=user,
2316 2316 date=date, extra=extra, editor=editor)
2317 2317 if node is None:
2318 2318 ui.warn(
2319 2319 _('note: graft of %d:%s created no changes to commit\n') %
2320 2320 (ctx.rev(), ctx))
2321 2321
2322 2322 # remove state when we complete successfully
2323 2323 if not opts.get('dry_run'):
2324 2324 repo.vfs.unlinkpath('graftstate', ignoremissing=True)
2325 2325
2326 2326 return 0
2327 2327
2328 2328 @command('grep',
2329 2329 [('0', 'print0', None, _('end fields with NUL')),
2330 2330 ('', 'all', None, _('print all revisions that match')),
2331 2331 ('a', 'text', None, _('treat all files as text')),
2332 2332 ('f', 'follow', None,
2333 2333 _('follow changeset history,'
2334 2334 ' or file history across copies and renames')),
2335 2335 ('i', 'ignore-case', None, _('ignore case when matching')),
2336 2336 ('l', 'files-with-matches', None,
2337 2337 _('print only filenames and revisions that match')),
2338 2338 ('n', 'line-number', None, _('print matching line numbers')),
2339 2339 ('r', 'rev', [],
2340 2340 _('only search files changed within revision range'), _('REV')),
2341 2341 ('u', 'user', None, _('list the author (long with -v)')),
2342 2342 ('d', 'date', None, _('list the date (short with -q)')),
2343 2343 ] + formatteropts + walkopts,
2344 2344 _('[OPTION]... PATTERN [FILE]...'),
2345 2345 inferrepo=True, cmdtype=readonly)
2346 2346 def grep(ui, repo, pattern, *pats, **opts):
2347 2347 """search revision history for a pattern in specified files
2348 2348
2349 2349 Search revision history for a regular expression in the specified
2350 2350 files or the entire project.
2351 2351
2352 2352 By default, grep prints the most recent revision number for each
2353 2353 file in which it finds a match. To get it to print every revision
2354 2354 that contains a change in match status ("-" for a match that becomes
2355 2355 a non-match, or "+" for a non-match that becomes a match), use the
2356 2356 --all flag.
2357 2357
2358 2358 PATTERN can be any Python (roughly Perl-compatible) regular
2359 2359 expression.
2360 2360
2361 2361 If no FILEs are specified (and -f/--follow isn't set), all files in
2362 2362 the repository are searched, including those that don't exist in the
2363 2363 current branch or have been deleted in a prior changeset.
2364 2364
2365 2365 Returns 0 if a match is found, 1 otherwise.
2366 2366 """
2367 2367 opts = pycompat.byteskwargs(opts)
2368 2368 reflags = re.M
2369 2369 if opts.get('ignore_case'):
2370 2370 reflags |= re.I
2371 2371 try:
2372 2372 regexp = util.re.compile(pattern, reflags)
2373 2373 except re.error as inst:
2374 2374 ui.warn(_("grep: invalid match pattern: %s\n") % inst)
2375 2375 return 1
2376 2376 sep, eol = ':', '\n'
2377 2377 if opts.get('print0'):
2378 2378 sep = eol = '\0'
2379 2379
2380 2380 getfile = util.lrucachefunc(repo.file)
2381 2381
2382 2382 def matchlines(body):
2383 2383 begin = 0
2384 2384 linenum = 0
2385 2385 while begin < len(body):
2386 2386 match = regexp.search(body, begin)
2387 2387 if not match:
2388 2388 break
2389 2389 mstart, mend = match.span()
2390 2390 linenum += body.count('\n', begin, mstart) + 1
2391 2391 lstart = body.rfind('\n', begin, mstart) + 1 or begin
2392 2392 begin = body.find('\n', mend) + 1 or len(body) + 1
2393 2393 lend = begin - 1
2394 2394 yield linenum, mstart - lstart, mend - lstart, body[lstart:lend]
2395 2395
2396 2396 class linestate(object):
2397 2397 def __init__(self, line, linenum, colstart, colend):
2398 2398 self.line = line
2399 2399 self.linenum = linenum
2400 2400 self.colstart = colstart
2401 2401 self.colend = colend
2402 2402
2403 2403 def __hash__(self):
2404 2404 return hash((self.linenum, self.line))
2405 2405
2406 2406 def __eq__(self, other):
2407 2407 return self.line == other.line
2408 2408
2409 2409 def findpos(self):
2410 2410 """Iterate all (start, end) indices of matches"""
2411 2411 yield self.colstart, self.colend
2412 2412 p = self.colend
2413 2413 while p < len(self.line):
2414 2414 m = regexp.search(self.line, p)
2415 2415 if not m:
2416 2416 break
2417 2417 yield m.span()
2418 2418 p = m.end()
2419 2419
2420 2420 matches = {}
2421 2421 copies = {}
2422 2422 def grepbody(fn, rev, body):
2423 2423 matches[rev].setdefault(fn, [])
2424 2424 m = matches[rev][fn]
2425 2425 for lnum, cstart, cend, line in matchlines(body):
2426 2426 s = linestate(line, lnum, cstart, cend)
2427 2427 m.append(s)
2428 2428
2429 2429 def difflinestates(a, b):
2430 2430 sm = difflib.SequenceMatcher(None, a, b)
2431 2431 for tag, alo, ahi, blo, bhi in sm.get_opcodes():
2432 2432 if tag == 'insert':
2433 2433 for i in xrange(blo, bhi):
2434 2434 yield ('+', b[i])
2435 2435 elif tag == 'delete':
2436 2436 for i in xrange(alo, ahi):
2437 2437 yield ('-', a[i])
2438 2438 elif tag == 'replace':
2439 2439 for i in xrange(alo, ahi):
2440 2440 yield ('-', a[i])
2441 2441 for i in xrange(blo, bhi):
2442 2442 yield ('+', b[i])
2443 2443
2444 2444 def display(fm, fn, ctx, pstates, states):
2445 2445 rev = ctx.rev()
2446 2446 if fm.isplain():
2447 2447 formatuser = ui.shortuser
2448 2448 else:
2449 2449 formatuser = str
2450 2450 if ui.quiet:
2451 2451 datefmt = '%Y-%m-%d'
2452 2452 else:
2453 2453 datefmt = '%a %b %d %H:%M:%S %Y %1%2'
2454 2454 found = False
2455 2455 @util.cachefunc
2456 2456 def binary():
2457 2457 flog = getfile(fn)
2458 2458 return util.binary(flog.read(ctx.filenode(fn)))
2459 2459
2460 2460 fieldnamemap = {'filename': 'file', 'linenumber': 'line_number'}
2461 2461 if opts.get('all'):
2462 2462 iter = difflinestates(pstates, states)
2463 2463 else:
2464 2464 iter = [('', l) for l in states]
2465 2465 for change, l in iter:
2466 2466 fm.startitem()
2467 2467 fm.data(node=fm.hexfunc(ctx.node()))
2468 2468 cols = [
2469 2469 ('filename', fn, True),
2470 2470 ('rev', rev, True),
2471 2471 ('linenumber', l.linenum, opts.get('line_number')),
2472 2472 ]
2473 2473 if opts.get('all'):
2474 2474 cols.append(('change', change, True))
2475 2475 cols.extend([
2476 2476 ('user', formatuser(ctx.user()), opts.get('user')),
2477 2477 ('date', fm.formatdate(ctx.date(), datefmt), opts.get('date')),
2478 2478 ])
2479 2479 lastcol = next(name for name, data, cond in reversed(cols) if cond)
2480 2480 for name, data, cond in cols:
2481 2481 field = fieldnamemap.get(name, name)
2482 2482 fm.condwrite(cond, field, '%s', data, label='grep.%s' % name)
2483 2483 if cond and name != lastcol:
2484 2484 fm.plain(sep, label='grep.sep')
2485 2485 if not opts.get('files_with_matches'):
2486 2486 fm.plain(sep, label='grep.sep')
2487 2487 if not opts.get('text') and binary():
2488 2488 fm.plain(_(" Binary file matches"))
2489 2489 else:
2490 2490 displaymatches(fm.nested('texts'), l)
2491 2491 fm.plain(eol)
2492 2492 found = True
2493 2493 if opts.get('files_with_matches'):
2494 2494 break
2495 2495 return found
2496 2496
2497 2497 def displaymatches(fm, l):
2498 2498 p = 0
2499 2499 for s, e in l.findpos():
2500 2500 if p < s:
2501 2501 fm.startitem()
2502 2502 fm.write('text', '%s', l.line[p:s])
2503 2503 fm.data(matched=False)
2504 2504 fm.startitem()
2505 2505 fm.write('text', '%s', l.line[s:e], label='grep.match')
2506 2506 fm.data(matched=True)
2507 2507 p = e
2508 2508 if p < len(l.line):
2509 2509 fm.startitem()
2510 2510 fm.write('text', '%s', l.line[p:])
2511 2511 fm.data(matched=False)
2512 2512 fm.end()
2513 2513
2514 2514 skip = {}
2515 2515 revfiles = {}
2516 2516 match = scmutil.match(repo[None], pats, opts)
2517 2517 found = False
2518 2518 follow = opts.get('follow')
2519 2519
2520 2520 def prep(ctx, fns):
2521 2521 rev = ctx.rev()
2522 2522 pctx = ctx.p1()
2523 2523 parent = pctx.rev()
2524 2524 matches.setdefault(rev, {})
2525 2525 matches.setdefault(parent, {})
2526 2526 files = revfiles.setdefault(rev, [])
2527 2527 for fn in fns:
2528 2528 flog = getfile(fn)
2529 2529 try:
2530 2530 fnode = ctx.filenode(fn)
2531 2531 except error.LookupError:
2532 2532 continue
2533 2533
2534 2534 copied = flog.renamed(fnode)
2535 2535 copy = follow and copied and copied[0]
2536 2536 if copy:
2537 2537 copies.setdefault(rev, {})[fn] = copy
2538 2538 if fn in skip:
2539 2539 if copy:
2540 2540 skip[copy] = True
2541 2541 continue
2542 2542 files.append(fn)
2543 2543
2544 2544 if fn not in matches[rev]:
2545 2545 grepbody(fn, rev, flog.read(fnode))
2546 2546
2547 2547 pfn = copy or fn
2548 2548 if pfn not in matches[parent]:
2549 2549 try:
2550 2550 fnode = pctx.filenode(pfn)
2551 2551 grepbody(pfn, parent, flog.read(fnode))
2552 2552 except error.LookupError:
2553 2553 pass
2554 2554
2555 2555 ui.pager('grep')
2556 2556 fm = ui.formatter('grep', opts)
2557 2557 for ctx in cmdutil.walkchangerevs(repo, match, opts, prep):
2558 2558 rev = ctx.rev()
2559 2559 parent = ctx.p1().rev()
2560 2560 for fn in sorted(revfiles.get(rev, [])):
2561 2561 states = matches[rev][fn]
2562 2562 copy = copies.get(rev, {}).get(fn)
2563 2563 if fn in skip:
2564 2564 if copy:
2565 2565 skip[copy] = True
2566 2566 continue
2567 2567 pstates = matches.get(parent, {}).get(copy or fn, [])
2568 2568 if pstates or states:
2569 2569 r = display(fm, fn, ctx, pstates, states)
2570 2570 found = found or r
2571 2571 if r and not opts.get('all'):
2572 2572 skip[fn] = True
2573 2573 if copy:
2574 2574 skip[copy] = True
2575 2575 del matches[rev]
2576 2576 del revfiles[rev]
2577 2577 fm.end()
2578 2578
2579 2579 return not found
2580 2580
2581 2581 @command('heads',
2582 2582 [('r', 'rev', '',
2583 2583 _('show only heads which are descendants of STARTREV'), _('STARTREV')),
2584 2584 ('t', 'topo', False, _('show topological heads only')),
2585 2585 ('a', 'active', False, _('show active branchheads only (DEPRECATED)')),
2586 2586 ('c', 'closed', False, _('show normal and closed branch heads')),
2587 2587 ] + templateopts,
2588 2588 _('[-ct] [-r STARTREV] [REV]...'), cmdtype=readonly)
2589 2589 def heads(ui, repo, *branchrevs, **opts):
2590 2590 """show branch heads
2591 2591
2592 2592 With no arguments, show all open branch heads in the repository.
2593 2593 Branch heads are changesets that have no descendants on the
2594 2594 same branch. They are where development generally takes place and
2595 2595 are the usual targets for update and merge operations.
2596 2596
2597 2597 If one or more REVs are given, only open branch heads on the
2598 2598 branches associated with the specified changesets are shown. This
2599 2599 means that you can use :hg:`heads .` to see the heads on the
2600 2600 currently checked-out branch.
2601 2601
2602 2602 If -c/--closed is specified, also show branch heads marked closed
2603 2603 (see :hg:`commit --close-branch`).
2604 2604
2605 2605 If STARTREV is specified, only those heads that are descendants of
2606 2606 STARTREV will be displayed.
2607 2607
2608 2608 If -t/--topo is specified, named branch mechanics will be ignored and only
2609 2609 topological heads (changesets with no children) will be shown.
2610 2610
2611 2611 Returns 0 if matching heads are found, 1 if not.
2612 2612 """
2613 2613
2614 2614 opts = pycompat.byteskwargs(opts)
2615 2615 start = None
2616 2616 rev = opts.get('rev')
2617 2617 if rev:
2618 2618 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
2619 2619 start = scmutil.revsingle(repo, rev, None).node()
2620 2620
2621 2621 if opts.get('topo'):
2622 2622 heads = [repo[h] for h in repo.heads(start)]
2623 2623 else:
2624 2624 heads = []
2625 2625 for branch in repo.branchmap():
2626 2626 heads += repo.branchheads(branch, start, opts.get('closed'))
2627 2627 heads = [repo[h] for h in heads]
2628 2628
2629 2629 if branchrevs:
2630 2630 branches = set(repo[br].branch() for br in branchrevs)
2631 2631 heads = [h for h in heads if h.branch() in branches]
2632 2632
2633 2633 if opts.get('active') and branchrevs:
2634 2634 dagheads = repo.heads(start)
2635 2635 heads = [h for h in heads if h.node() in dagheads]
2636 2636
2637 2637 if branchrevs:
2638 2638 haveheads = set(h.branch() for h in heads)
2639 2639 if branches - haveheads:
2640 2640 headless = ', '.join(b for b in branches - haveheads)
2641 2641 msg = _('no open branch heads found on branches %s')
2642 2642 if opts.get('rev'):
2643 2643 msg += _(' (started at %s)') % opts['rev']
2644 2644 ui.warn((msg + '\n') % headless)
2645 2645
2646 2646 if not heads:
2647 2647 return 1
2648 2648
2649 2649 ui.pager('heads')
2650 2650 heads = sorted(heads, key=lambda x: -x.rev())
2651 2651 displayer = logcmdutil.changesetdisplayer(ui, repo, opts)
2652 2652 for ctx in heads:
2653 2653 displayer.show(ctx)
2654 2654 displayer.close()
2655 2655
2656 2656 @command('help',
2657 2657 [('e', 'extension', None, _('show only help for extensions')),
2658 2658 ('c', 'command', None, _('show only help for commands')),
2659 2659 ('k', 'keyword', None, _('show topics matching keyword')),
2660 2660 ('s', 'system', [], _('show help for specific platform(s)')),
2661 2661 ],
2662 2662 _('[-ecks] [TOPIC]'),
2663 2663 norepo=True, cmdtype=readonly)
2664 2664 def help_(ui, name=None, **opts):
2665 2665 """show help for a given topic or a help overview
2666 2666
2667 2667 With no arguments, print a list of commands with short help messages.
2668 2668
2669 2669 Given a topic, extension, or command name, print help for that
2670 2670 topic.
2671 2671
2672 2672 Returns 0 if successful.
2673 2673 """
2674 2674
2675 2675 keep = opts.get(r'system') or []
2676 2676 if len(keep) == 0:
2677 2677 if pycompat.sysplatform.startswith('win'):
2678 2678 keep.append('windows')
2679 2679 elif pycompat.sysplatform == 'OpenVMS':
2680 2680 keep.append('vms')
2681 2681 elif pycompat.sysplatform == 'plan9':
2682 2682 keep.append('plan9')
2683 2683 else:
2684 2684 keep.append('unix')
2685 2685 keep.append(pycompat.sysplatform.lower())
2686 2686 if ui.verbose:
2687 2687 keep.append('verbose')
2688 2688
2689 2689 commands = sys.modules[__name__]
2690 2690 formatted = help.formattedhelp(ui, commands, name, keep=keep, **opts)
2691 2691 ui.pager('help')
2692 2692 ui.write(formatted)
2693 2693
2694 2694
2695 2695 @command('identify|id',
2696 2696 [('r', 'rev', '',
2697 2697 _('identify the specified revision'), _('REV')),
2698 2698 ('n', 'num', None, _('show local revision number')),
2699 2699 ('i', 'id', None, _('show global revision id')),
2700 2700 ('b', 'branch', None, _('show branch')),
2701 2701 ('t', 'tags', None, _('show tags')),
2702 2702 ('B', 'bookmarks', None, _('show bookmarks')),
2703 2703 ] + remoteopts + formatteropts,
2704 2704 _('[-nibtB] [-r REV] [SOURCE]'),
2705 2705 optionalrepo=True, cmdtype=readonly)
2706 2706 def identify(ui, repo, source=None, rev=None,
2707 2707 num=None, id=None, branch=None, tags=None, bookmarks=None, **opts):
2708 2708 """identify the working directory or specified revision
2709 2709
2710 2710 Print a summary identifying the repository state at REV using one or
2711 2711 two parent hash identifiers, followed by a "+" if the working
2712 2712 directory has uncommitted changes, the branch name (if not default),
2713 2713 a list of tags, and a list of bookmarks.
2714 2714
2715 2715 When REV is not given, print a summary of the current state of the
2716 2716 repository including the working directory. Specify -r. to get information
2717 2717 of the working directory parent without scanning uncommitted changes.
2718 2718
2719 2719 Specifying a path to a repository root or Mercurial bundle will
2720 2720 cause lookup to operate on that repository/bundle.
2721 2721
2722 2722 .. container:: verbose
2723 2723
2724 2724 Examples:
2725 2725
2726 2726 - generate a build identifier for the working directory::
2727 2727
2728 2728 hg id --id > build-id.dat
2729 2729
2730 2730 - find the revision corresponding to a tag::
2731 2731
2732 2732 hg id -n -r 1.3
2733 2733
2734 2734 - check the most recent revision of a remote repository::
2735 2735
2736 2736 hg id -r tip https://www.mercurial-scm.org/repo/hg/
2737 2737
2738 2738 See :hg:`log` for generating more information about specific revisions,
2739 2739 including full hash identifiers.
2740 2740
2741 2741 Returns 0 if successful.
2742 2742 """
2743 2743
2744 2744 opts = pycompat.byteskwargs(opts)
2745 2745 if not repo and not source:
2746 2746 raise error.Abort(_("there is no Mercurial repository here "
2747 2747 "(.hg not found)"))
2748 2748
2749 2749 if ui.debugflag:
2750 2750 hexfunc = hex
2751 2751 else:
2752 2752 hexfunc = short
2753 2753 default = not (num or id or branch or tags or bookmarks)
2754 2754 output = []
2755 2755 revs = []
2756 2756
2757 2757 if source:
2758 2758 source, branches = hg.parseurl(ui.expandpath(source))
2759 2759 peer = hg.peer(repo or ui, opts, source) # only pass ui when no repo
2760 2760 repo = peer.local()
2761 2761 revs, checkout = hg.addbranchrevs(repo, peer, branches, None)
2762 2762
2763 2763 fm = ui.formatter('identify', opts)
2764 2764 fm.startitem()
2765 2765
2766 2766 if not repo:
2767 2767 if num or branch or tags:
2768 2768 raise error.Abort(
2769 2769 _("can't query remote revision number, branch, or tags"))
2770 2770 if not rev and revs:
2771 2771 rev = revs[0]
2772 2772 if not rev:
2773 2773 rev = "tip"
2774 2774
2775 2775 remoterev = peer.lookup(rev)
2776 2776 hexrev = hexfunc(remoterev)
2777 2777 if default or id:
2778 2778 output = [hexrev]
2779 2779 fm.data(id=hexrev)
2780 2780
2781 2781 def getbms():
2782 2782 bms = []
2783 2783
2784 2784 if 'bookmarks' in peer.listkeys('namespaces'):
2785 2785 hexremoterev = hex(remoterev)
2786 2786 bms = [bm for bm, bmr in peer.listkeys('bookmarks').iteritems()
2787 2787 if bmr == hexremoterev]
2788 2788
2789 2789 return sorted(bms)
2790 2790
2791 2791 bms = getbms()
2792 2792 if bookmarks:
2793 2793 output.extend(bms)
2794 2794 elif default and not ui.quiet:
2795 2795 # multiple bookmarks for a single parent separated by '/'
2796 2796 bm = '/'.join(bms)
2797 2797 if bm:
2798 2798 output.append(bm)
2799 2799
2800 2800 fm.data(node=hex(remoterev))
2801 2801 fm.data(bookmarks=fm.formatlist(bms, name='bookmark'))
2802 2802 else:
2803 2803 if rev:
2804 2804 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
2805 2805 ctx = scmutil.revsingle(repo, rev, None)
2806 2806
2807 2807 if ctx.rev() is None:
2808 2808 ctx = repo[None]
2809 2809 parents = ctx.parents()
2810 2810 taglist = []
2811 2811 for p in parents:
2812 2812 taglist.extend(p.tags())
2813 2813
2814 2814 dirty = ""
2815 2815 if ctx.dirty(missing=True, merge=False, branch=False):
2816 2816 dirty = '+'
2817 2817 fm.data(dirty=dirty)
2818 2818
2819 2819 hexoutput = [hexfunc(p.node()) for p in parents]
2820 2820 if default or id:
2821 2821 output = ["%s%s" % ('+'.join(hexoutput), dirty)]
2822 2822 fm.data(id="%s%s" % ('+'.join(hexoutput), dirty))
2823 2823
2824 2824 if num:
2825 2825 numoutput = ["%d" % p.rev() for p in parents]
2826 2826 output.append("%s%s" % ('+'.join(numoutput), dirty))
2827 2827
2828 2828 fn = fm.nested('parents')
2829 2829 for p in parents:
2830 2830 fn.startitem()
2831 2831 fn.data(rev=p.rev())
2832 2832 fn.data(node=p.hex())
2833 2833 fn.context(ctx=p)
2834 2834 fn.end()
2835 2835 else:
2836 2836 hexoutput = hexfunc(ctx.node())
2837 2837 if default or id:
2838 2838 output = [hexoutput]
2839 2839 fm.data(id=hexoutput)
2840 2840
2841 2841 if num:
2842 2842 output.append(pycompat.bytestr(ctx.rev()))
2843 2843 taglist = ctx.tags()
2844 2844
2845 2845 if default and not ui.quiet:
2846 2846 b = ctx.branch()
2847 2847 if b != 'default':
2848 2848 output.append("(%s)" % b)
2849 2849
2850 2850 # multiple tags for a single parent separated by '/'
2851 2851 t = '/'.join(taglist)
2852 2852 if t:
2853 2853 output.append(t)
2854 2854
2855 2855 # multiple bookmarks for a single parent separated by '/'
2856 2856 bm = '/'.join(ctx.bookmarks())
2857 2857 if bm:
2858 2858 output.append(bm)
2859 2859 else:
2860 2860 if branch:
2861 2861 output.append(ctx.branch())
2862 2862
2863 2863 if tags:
2864 2864 output.extend(taglist)
2865 2865
2866 2866 if bookmarks:
2867 2867 output.extend(ctx.bookmarks())
2868 2868
2869 2869 fm.data(node=ctx.hex())
2870 2870 fm.data(branch=ctx.branch())
2871 2871 fm.data(tags=fm.formatlist(taglist, name='tag', sep=':'))
2872 2872 fm.data(bookmarks=fm.formatlist(ctx.bookmarks(), name='bookmark'))
2873 2873 fm.context(ctx=ctx)
2874 2874
2875 2875 fm.plain("%s\n" % ' '.join(output))
2876 2876 fm.end()
2877 2877
2878 2878 @command('import|patch',
2879 2879 [('p', 'strip', 1,
2880 2880 _('directory strip option for patch. This has the same '
2881 2881 'meaning as the corresponding patch option'), _('NUM')),
2882 2882 ('b', 'base', '', _('base path (DEPRECATED)'), _('PATH')),
2883 2883 ('e', 'edit', False, _('invoke editor on commit messages')),
2884 2884 ('f', 'force', None,
2885 2885 _('skip check for outstanding uncommitted changes (DEPRECATED)')),
2886 2886 ('', 'no-commit', None,
2887 2887 _("don't commit, just update the working directory")),
2888 2888 ('', 'bypass', None,
2889 2889 _("apply patch without touching the working directory")),
2890 2890 ('', 'partial', None,
2891 2891 _('commit even if some hunks fail')),
2892 2892 ('', 'exact', None,
2893 2893 _('abort if patch would apply lossily')),
2894 2894 ('', 'prefix', '',
2895 2895 _('apply patch to subdirectory'), _('DIR')),
2896 2896 ('', 'import-branch', None,
2897 2897 _('use any branch information in patch (implied by --exact)'))] +
2898 2898 commitopts + commitopts2 + similarityopts,
2899 2899 _('[OPTION]... PATCH...'))
2900 2900 def import_(ui, repo, patch1=None, *patches, **opts):
2901 2901 """import an ordered set of patches
2902 2902
2903 2903 Import a list of patches and commit them individually (unless
2904 2904 --no-commit is specified).
2905 2905
2906 2906 To read a patch from standard input (stdin), use "-" as the patch
2907 2907 name. If a URL is specified, the patch will be downloaded from
2908 2908 there.
2909 2909
2910 2910 Import first applies changes to the working directory (unless
2911 2911 --bypass is specified), import will abort if there are outstanding
2912 2912 changes.
2913 2913
2914 2914 Use --bypass to apply and commit patches directly to the
2915 2915 repository, without affecting the working directory. Without
2916 2916 --exact, patches will be applied on top of the working directory
2917 2917 parent revision.
2918 2918
2919 2919 You can import a patch straight from a mail message. Even patches
2920 2920 as attachments work (to use the body part, it must have type
2921 2921 text/plain or text/x-patch). From and Subject headers of email
2922 2922 message are used as default committer and commit message. All
2923 2923 text/plain body parts before first diff are added to the commit
2924 2924 message.
2925 2925
2926 2926 If the imported patch was generated by :hg:`export`, user and
2927 2927 description from patch override values from message headers and
2928 2928 body. Values given on command line with -m/--message and -u/--user
2929 2929 override these.
2930 2930
2931 2931 If --exact is specified, import will set the working directory to
2932 2932 the parent of each patch before applying it, and will abort if the
2933 2933 resulting changeset has a different ID than the one recorded in
2934 2934 the patch. This will guard against various ways that portable
2935 2935 patch formats and mail systems might fail to transfer Mercurial
2936 2936 data or metadata. See :hg:`bundle` for lossless transmission.
2937 2937
2938 2938 Use --partial to ensure a changeset will be created from the patch
2939 2939 even if some hunks fail to apply. Hunks that fail to apply will be
2940 2940 written to a <target-file>.rej file. Conflicts can then be resolved
2941 2941 by hand before :hg:`commit --amend` is run to update the created
2942 2942 changeset. This flag exists to let people import patches that
2943 2943 partially apply without losing the associated metadata (author,
2944 2944 date, description, ...).
2945 2945
2946 2946 .. note::
2947 2947
2948 2948 When no hunks apply cleanly, :hg:`import --partial` will create
2949 2949 an empty changeset, importing only the patch metadata.
2950 2950
2951 2951 With -s/--similarity, hg will attempt to discover renames and
2952 2952 copies in the patch in the same way as :hg:`addremove`.
2953 2953
2954 2954 It is possible to use external patch programs to perform the patch
2955 2955 by setting the ``ui.patch`` configuration option. For the default
2956 2956 internal tool, the fuzz can also be configured via ``patch.fuzz``.
2957 2957 See :hg:`help config` for more information about configuration
2958 2958 files and how to use these options.
2959 2959
2960 2960 See :hg:`help dates` for a list of formats valid for -d/--date.
2961 2961
2962 2962 .. container:: verbose
2963 2963
2964 2964 Examples:
2965 2965
2966 2966 - import a traditional patch from a website and detect renames::
2967 2967
2968 2968 hg import -s 80 http://example.com/bugfix.patch
2969 2969
2970 2970 - import a changeset from an hgweb server::
2971 2971
2972 2972 hg import https://www.mercurial-scm.org/repo/hg/rev/5ca8c111e9aa
2973 2973
2974 2974 - import all the patches in an Unix-style mbox::
2975 2975
2976 2976 hg import incoming-patches.mbox
2977 2977
2978 2978 - import patches from stdin::
2979 2979
2980 2980 hg import -
2981 2981
2982 2982 - attempt to exactly restore an exported changeset (not always
2983 2983 possible)::
2984 2984
2985 2985 hg import --exact proposed-fix.patch
2986 2986
2987 2987 - use an external tool to apply a patch which is too fuzzy for
2988 2988 the default internal tool.
2989 2989
2990 2990 hg import --config ui.patch="patch --merge" fuzzy.patch
2991 2991
2992 2992 - change the default fuzzing from 2 to a less strict 7
2993 2993
2994 2994 hg import --config ui.fuzz=7 fuzz.patch
2995 2995
2996 2996 Returns 0 on success, 1 on partial success (see --partial).
2997 2997 """
2998 2998
2999 2999 opts = pycompat.byteskwargs(opts)
3000 3000 if not patch1:
3001 3001 raise error.Abort(_('need at least one patch to import'))
3002 3002
3003 3003 patches = (patch1,) + patches
3004 3004
3005 3005 date = opts.get('date')
3006 3006 if date:
3007 3007 opts['date'] = util.parsedate(date)
3008 3008
3009 3009 exact = opts.get('exact')
3010 3010 update = not opts.get('bypass')
3011 3011 if not update and opts.get('no_commit'):
3012 3012 raise error.Abort(_('cannot use --no-commit with --bypass'))
3013 3013 try:
3014 3014 sim = float(opts.get('similarity') or 0)
3015 3015 except ValueError:
3016 3016 raise error.Abort(_('similarity must be a number'))
3017 3017 if sim < 0 or sim > 100:
3018 3018 raise error.Abort(_('similarity must be between 0 and 100'))
3019 3019 if sim and not update:
3020 3020 raise error.Abort(_('cannot use --similarity with --bypass'))
3021 3021 if exact:
3022 3022 if opts.get('edit'):
3023 3023 raise error.Abort(_('cannot use --exact with --edit'))
3024 3024 if opts.get('prefix'):
3025 3025 raise error.Abort(_('cannot use --exact with --prefix'))
3026 3026
3027 3027 base = opts["base"]
3028 3028 wlock = dsguard = lock = tr = None
3029 3029 msgs = []
3030 3030 ret = 0
3031 3031
3032 3032
3033 3033 try:
3034 3034 wlock = repo.wlock()
3035 3035
3036 3036 if update:
3037 3037 cmdutil.checkunfinished(repo)
3038 3038 if (exact or not opts.get('force')):
3039 3039 cmdutil.bailifchanged(repo)
3040 3040
3041 3041 if not opts.get('no_commit'):
3042 3042 lock = repo.lock()
3043 3043 tr = repo.transaction('import')
3044 3044 else:
3045 3045 dsguard = dirstateguard.dirstateguard(repo, 'import')
3046 3046 parents = repo[None].parents()
3047 3047 for patchurl in patches:
3048 3048 if patchurl == '-':
3049 3049 ui.status(_('applying patch from stdin\n'))
3050 3050 patchfile = ui.fin
3051 3051 patchurl = 'stdin' # for error message
3052 3052 else:
3053 3053 patchurl = os.path.join(base, patchurl)
3054 3054 ui.status(_('applying %s\n') % patchurl)
3055 3055 patchfile = hg.openpath(ui, patchurl)
3056 3056
3057 3057 haspatch = False
3058 3058 for hunk in patch.split(patchfile):
3059 3059 (msg, node, rej) = cmdutil.tryimportone(ui, repo, hunk,
3060 3060 parents, opts,
3061 3061 msgs, hg.clean)
3062 3062 if msg:
3063 3063 haspatch = True
3064 3064 ui.note(msg + '\n')
3065 3065 if update or exact:
3066 3066 parents = repo[None].parents()
3067 3067 else:
3068 3068 parents = [repo[node]]
3069 3069 if rej:
3070 3070 ui.write_err(_("patch applied partially\n"))
3071 3071 ui.write_err(_("(fix the .rej files and run "
3072 3072 "`hg commit --amend`)\n"))
3073 3073 ret = 1
3074 3074 break
3075 3075
3076 3076 if not haspatch:
3077 3077 raise error.Abort(_('%s: no diffs found') % patchurl)
3078 3078
3079 3079 if tr:
3080 3080 tr.close()
3081 3081 if msgs:
3082 3082 repo.savecommitmessage('\n* * *\n'.join(msgs))
3083 3083 if dsguard:
3084 3084 dsguard.close()
3085 3085 return ret
3086 3086 finally:
3087 3087 if tr:
3088 3088 tr.release()
3089 3089 release(lock, dsguard, wlock)
3090 3090
3091 3091 @command('incoming|in',
3092 3092 [('f', 'force', None,
3093 3093 _('run even if remote repository is unrelated')),
3094 3094 ('n', 'newest-first', None, _('show newest record first')),
3095 3095 ('', 'bundle', '',
3096 3096 _('file to store the bundles into'), _('FILE')),
3097 3097 ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
3098 3098 ('B', 'bookmarks', False, _("compare bookmarks")),
3099 3099 ('b', 'branch', [],
3100 3100 _('a specific branch you would like to pull'), _('BRANCH')),
3101 3101 ] + logopts + remoteopts + subrepoopts,
3102 3102 _('[-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [SOURCE]'))
3103 3103 def incoming(ui, repo, source="default", **opts):
3104 3104 """show new changesets found in source
3105 3105
3106 3106 Show new changesets found in the specified path/URL or the default
3107 3107 pull location. These are the changesets that would have been pulled
3108 3108 by :hg:`pull` at the time you issued this command.
3109 3109
3110 3110 See pull for valid source format details.
3111 3111
3112 3112 .. container:: verbose
3113 3113
3114 3114 With -B/--bookmarks, the result of bookmark comparison between
3115 3115 local and remote repositories is displayed. With -v/--verbose,
3116 3116 status is also displayed for each bookmark like below::
3117 3117
3118 3118 BM1 01234567890a added
3119 3119 BM2 1234567890ab advanced
3120 3120 BM3 234567890abc diverged
3121 3121 BM4 34567890abcd changed
3122 3122
3123 3123 The action taken locally when pulling depends on the
3124 3124 status of each bookmark:
3125 3125
3126 3126 :``added``: pull will create it
3127 3127 :``advanced``: pull will update it
3128 3128 :``diverged``: pull will create a divergent bookmark
3129 3129 :``changed``: result depends on remote changesets
3130 3130
3131 3131 From the point of view of pulling behavior, bookmark
3132 3132 existing only in the remote repository are treated as ``added``,
3133 3133 even if it is in fact locally deleted.
3134 3134
3135 3135 .. container:: verbose
3136 3136
3137 3137 For remote repository, using --bundle avoids downloading the
3138 3138 changesets twice if the incoming is followed by a pull.
3139 3139
3140 3140 Examples:
3141 3141
3142 3142 - show incoming changes with patches and full description::
3143 3143
3144 3144 hg incoming -vp
3145 3145
3146 3146 - show incoming changes excluding merges, store a bundle::
3147 3147
3148 3148 hg in -vpM --bundle incoming.hg
3149 3149 hg pull incoming.hg
3150 3150
3151 3151 - briefly list changes inside a bundle::
3152 3152
3153 3153 hg in changes.hg -T "{desc|firstline}\\n"
3154 3154
3155 3155 Returns 0 if there are incoming changes, 1 otherwise.
3156 3156 """
3157 3157 opts = pycompat.byteskwargs(opts)
3158 3158 if opts.get('graph'):
3159 3159 logcmdutil.checkunsupportedgraphflags([], opts)
3160 3160 def display(other, chlist, displayer):
3161 3161 revdag = logcmdutil.graphrevs(other, chlist, opts)
3162 3162 logcmdutil.displaygraph(ui, repo, revdag, displayer,
3163 3163 graphmod.asciiedges)
3164 3164
3165 3165 hg._incoming(display, lambda: 1, ui, repo, source, opts, buffered=True)
3166 3166 return 0
3167 3167
3168 3168 if opts.get('bundle') and opts.get('subrepos'):
3169 3169 raise error.Abort(_('cannot combine --bundle and --subrepos'))
3170 3170
3171 3171 if opts.get('bookmarks'):
3172 3172 source, branches = hg.parseurl(ui.expandpath(source),
3173 3173 opts.get('branch'))
3174 3174 other = hg.peer(repo, opts, source)
3175 3175 if 'bookmarks' not in other.listkeys('namespaces'):
3176 3176 ui.warn(_("remote doesn't support bookmarks\n"))
3177 3177 return 0
3178 3178 ui.pager('incoming')
3179 3179 ui.status(_('comparing with %s\n') % util.hidepassword(source))
3180 3180 return bookmarks.incoming(ui, repo, other)
3181 3181
3182 3182 repo._subtoppath = ui.expandpath(source)
3183 3183 try:
3184 3184 return hg.incoming(ui, repo, source, opts)
3185 3185 finally:
3186 3186 del repo._subtoppath
3187 3187
3188 3188
3189 3189 @command('^init', remoteopts, _('[-e CMD] [--remotecmd CMD] [DEST]'),
3190 3190 norepo=True)
3191 3191 def init(ui, dest=".", **opts):
3192 3192 """create a new repository in the given directory
3193 3193
3194 3194 Initialize a new repository in the given directory. If the given
3195 3195 directory does not exist, it will be created.
3196 3196
3197 3197 If no directory is given, the current directory is used.
3198 3198
3199 3199 It is possible to specify an ``ssh://`` URL as the destination.
3200 3200 See :hg:`help urls` for more information.
3201 3201
3202 3202 Returns 0 on success.
3203 3203 """
3204 3204 opts = pycompat.byteskwargs(opts)
3205 3205 hg.peer(ui, opts, ui.expandpath(dest), create=True)
3206 3206
3207 3207 @command('locate',
3208 3208 [('r', 'rev', '', _('search the repository as it is in REV'), _('REV')),
3209 3209 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
3210 3210 ('f', 'fullpath', None, _('print complete paths from the filesystem root')),
3211 3211 ] + walkopts,
3212 3212 _('[OPTION]... [PATTERN]...'))
3213 3213 def locate(ui, repo, *pats, **opts):
3214 3214 """locate files matching specific patterns (DEPRECATED)
3215 3215
3216 3216 Print files under Mercurial control in the working directory whose
3217 3217 names match the given patterns.
3218 3218
3219 3219 By default, this command searches all directories in the working
3220 3220 directory. To search just the current directory and its
3221 3221 subdirectories, use "--include .".
3222 3222
3223 3223 If no patterns are given to match, this command prints the names
3224 3224 of all files under Mercurial control in the working directory.
3225 3225
3226 3226 If you want to feed the output of this command into the "xargs"
3227 3227 command, use the -0 option to both this command and "xargs". This
3228 3228 will avoid the problem of "xargs" treating single filenames that
3229 3229 contain whitespace as multiple filenames.
3230 3230
3231 3231 See :hg:`help files` for a more versatile command.
3232 3232
3233 3233 Returns 0 if a match is found, 1 otherwise.
3234 3234 """
3235 3235 opts = pycompat.byteskwargs(opts)
3236 3236 if opts.get('print0'):
3237 3237 end = '\0'
3238 3238 else:
3239 3239 end = '\n'
3240 3240 rev = scmutil.revsingle(repo, opts.get('rev'), None).node()
3241 3241
3242 3242 ret = 1
3243 3243 ctx = repo[rev]
3244 3244 m = scmutil.match(ctx, pats, opts, default='relglob',
3245 3245 badfn=lambda x, y: False)
3246 3246
3247 3247 ui.pager('locate')
3248 3248 for abs in ctx.matches(m):
3249 3249 if opts.get('fullpath'):
3250 3250 ui.write(repo.wjoin(abs), end)
3251 3251 else:
3252 3252 ui.write(((pats and m.rel(abs)) or abs), end)
3253 3253 ret = 0
3254 3254
3255 3255 return ret
3256 3256
3257 3257 @command('^log|history',
3258 3258 [('f', 'follow', None,
3259 3259 _('follow changeset history, or file history across copies and renames')),
3260 3260 ('', 'follow-first', None,
3261 3261 _('only follow the first parent of merge changesets (DEPRECATED)')),
3262 3262 ('d', 'date', '', _('show revisions matching date spec'), _('DATE')),
3263 3263 ('C', 'copies', None, _('show copied files')),
3264 3264 ('k', 'keyword', [],
3265 3265 _('do case-insensitive search for a given text'), _('TEXT')),
3266 3266 ('r', 'rev', [], _('show the specified revision or revset'), _('REV')),
3267 3267 ('L', 'line-range', [],
3268 3268 _('follow line range of specified file (EXPERIMENTAL)'),
3269 3269 _('FILE,RANGE')),
3270 3270 ('', 'removed', None, _('include revisions where files were removed')),
3271 3271 ('m', 'only-merges', None, _('show only merges (DEPRECATED)')),
3272 3272 ('u', 'user', [], _('revisions committed by user'), _('USER')),
3273 3273 ('', 'only-branch', [],
3274 3274 _('show only changesets within the given named branch (DEPRECATED)'),
3275 3275 _('BRANCH')),
3276 3276 ('b', 'branch', [],
3277 3277 _('show changesets within the given named branch'), _('BRANCH')),
3278 3278 ('P', 'prune', [],
3279 3279 _('do not display revision or any of its ancestors'), _('REV')),
3280 3280 ] + logopts + walkopts,
3281 3281 _('[OPTION]... [FILE]'),
3282 3282 inferrepo=True, cmdtype=readonly)
3283 3283 def log(ui, repo, *pats, **opts):
3284 3284 """show revision history of entire repository or files
3285 3285
3286 3286 Print the revision history of the specified files or the entire
3287 3287 project.
3288 3288
3289 3289 If no revision range is specified, the default is ``tip:0`` unless
3290 3290 --follow is set, in which case the working directory parent is
3291 3291 used as the starting revision.
3292 3292
3293 3293 File history is shown without following rename or copy history of
3294 3294 files. Use -f/--follow with a filename to follow history across
3295 3295 renames and copies. --follow without a filename will only show
3296 3296 ancestors of the starting revision.
3297 3297
3298 3298 By default this command prints revision number and changeset id,
3299 3299 tags, non-trivial parents, user, date and time, and a summary for
3300 3300 each commit. When the -v/--verbose switch is used, the list of
3301 3301 changed files and full commit message are shown.
3302 3302
3303 3303 With --graph the revisions are shown as an ASCII art DAG with the most
3304 3304 recent changeset at the top.
3305 3305 'o' is a changeset, '@' is a working directory parent, 'x' is obsolete,
3306 3306 and '+' represents a fork where the changeset from the lines below is a
3307 3307 parent of the 'o' merge on the same line.
3308 3308 Paths in the DAG are represented with '|', '/' and so forth. ':' in place
3309 3309 of a '|' indicates one or more revisions in a path are omitted.
3310 3310
3311 3311 .. container:: verbose
3312 3312
3313 3313 Use -L/--line-range FILE,M:N options to follow the history of lines
3314 3314 from M to N in FILE. With -p/--patch only diff hunks affecting
3315 3315 specified line range will be shown. This option requires --follow;
3316 3316 it can be specified multiple times. Currently, this option is not
3317 3317 compatible with --graph. This option is experimental.
3318 3318
3319 3319 .. note::
3320 3320
3321 3321 :hg:`log --patch` may generate unexpected diff output for merge
3322 3322 changesets, as it will only compare the merge changeset against
3323 3323 its first parent. Also, only files different from BOTH parents
3324 3324 will appear in files:.
3325 3325
3326 3326 .. note::
3327 3327
3328 3328 For performance reasons, :hg:`log FILE` may omit duplicate changes
3329 3329 made on branches and will not show removals or mode changes. To
3330 3330 see all such changes, use the --removed switch.
3331 3331
3332 3332 .. container:: verbose
3333 3333
3334 3334 .. note::
3335 3335
3336 3336 The history resulting from -L/--line-range options depends on diff
3337 3337 options; for instance if white-spaces are ignored, respective changes
3338 3338 with only white-spaces in specified line range will not be listed.
3339 3339
3340 3340 .. container:: verbose
3341 3341
3342 3342 Some examples:
3343 3343
3344 3344 - changesets with full descriptions and file lists::
3345 3345
3346 3346 hg log -v
3347 3347
3348 3348 - changesets ancestral to the working directory::
3349 3349
3350 3350 hg log -f
3351 3351
3352 3352 - last 10 commits on the current branch::
3353 3353
3354 3354 hg log -l 10 -b .
3355 3355
3356 3356 - changesets showing all modifications of a file, including removals::
3357 3357
3358 3358 hg log --removed file.c
3359 3359
3360 3360 - all changesets that touch a directory, with diffs, excluding merges::
3361 3361
3362 3362 hg log -Mp lib/
3363 3363
3364 3364 - all revision numbers that match a keyword::
3365 3365
3366 3366 hg log -k bug --template "{rev}\\n"
3367 3367
3368 3368 - the full hash identifier of the working directory parent::
3369 3369
3370 3370 hg log -r . --template "{node}\\n"
3371 3371
3372 3372 - list available log templates::
3373 3373
3374 3374 hg log -T list
3375 3375
3376 3376 - check if a given changeset is included in a tagged release::
3377 3377
3378 3378 hg log -r "a21ccf and ancestor(1.9)"
3379 3379
3380 3380 - find all changesets by some user in a date range::
3381 3381
3382 3382 hg log -k alice -d "may 2008 to jul 2008"
3383 3383
3384 3384 - summary of all changesets after the last tag::
3385 3385
3386 3386 hg log -r "last(tagged())::" --template "{desc|firstline}\\n"
3387 3387
3388 3388 - changesets touching lines 13 to 23 for file.c::
3389 3389
3390 3390 hg log -L file.c,13:23
3391 3391
3392 3392 - changesets touching lines 13 to 23 for file.c and lines 2 to 6 of
3393 3393 main.c with patch::
3394 3394
3395 3395 hg log -L file.c,13:23 -L main.c,2:6 -p
3396 3396
3397 3397 See :hg:`help dates` for a list of formats valid for -d/--date.
3398 3398
3399 3399 See :hg:`help revisions` for more about specifying and ordering
3400 3400 revisions.
3401 3401
3402 3402 See :hg:`help templates` for more about pre-packaged styles and
3403 3403 specifying custom templates. The default template used by the log
3404 3404 command can be customized via the ``ui.logtemplate`` configuration
3405 3405 setting.
3406 3406
3407 3407 Returns 0 on success.
3408 3408
3409 3409 """
3410 3410 opts = pycompat.byteskwargs(opts)
3411 3411 linerange = opts.get('line_range')
3412 3412
3413 3413 if linerange and not opts.get('follow'):
3414 3414 raise error.Abort(_('--line-range requires --follow'))
3415 3415
3416 3416 if linerange and pats:
3417 3417 raise error.Abort(
3418 3418 _('FILE arguments are not compatible with --line-range option')
3419 3419 )
3420 3420
3421 3421 repo = scmutil.unhidehashlikerevs(repo, opts.get('rev'), 'nowarn')
3422 3422 revs, filematcher = logcmdutil.getrevs(repo, pats, opts)
3423 3423 hunksfilter = None
3424 3424
3425 3425 if opts.get('graph'):
3426 3426 if linerange:
3427 3427 raise error.Abort(_('graph not supported with line range patterns'))
3428 3428 return logcmdutil.graphlog(ui, repo, revs, filematcher, opts)
3429 3429
3430 3430 if linerange:
3431 3431 revs, lrfilematcher, hunksfilter = logcmdutil.getlinerangerevs(
3432 3432 repo, revs, opts)
3433 3433
3434 if filematcher is not None and lrfilematcher is not None:
3434 if filematcher is not None:
3435 3435 basefilematcher = filematcher
3436 3436
3437 3437 def filematcher(rev):
3438 3438 files = (basefilematcher(rev).files()
3439 3439 + lrfilematcher(rev).files())
3440 3440 return scmutil.matchfiles(repo, files)
3441 3441
3442 3442 elif filematcher is None:
3443 3443 filematcher = lrfilematcher
3444 3444
3445 3445 getrenamed = None
3446 3446 if opts.get('copies'):
3447 3447 endrev = None
3448 3448 if opts.get('rev'):
3449 3449 endrev = scmutil.revrange(repo, opts.get('rev')).max() + 1
3450 3450 getrenamed = templatekw.getrenamedfn(repo, endrev=endrev)
3451 3451
3452 3452 ui.pager('log')
3453 3453 displayer = logcmdutil.changesetdisplayer(ui, repo, opts,
3454 3454 makefilematcher=filematcher,
3455 3455 makehunksfilter=hunksfilter,
3456 3456 buffered=True)
3457 3457 for rev in revs:
3458 3458 ctx = repo[rev]
3459 3459 copies = None
3460 3460 if getrenamed is not None and rev:
3461 3461 copies = []
3462 3462 for fn in ctx.files():
3463 3463 rename = getrenamed(fn, rev)
3464 3464 if rename:
3465 3465 copies.append((fn, rename[0]))
3466 3466 displayer.show(ctx, copies=copies)
3467 3467 displayer.flush(ctx)
3468 3468
3469 3469 displayer.close()
3470 3470
3471 3471 @command('manifest',
3472 3472 [('r', 'rev', '', _('revision to display'), _('REV')),
3473 3473 ('', 'all', False, _("list files from all revisions"))]
3474 3474 + formatteropts,
3475 3475 _('[-r REV]'), cmdtype=readonly)
3476 3476 def manifest(ui, repo, node=None, rev=None, **opts):
3477 3477 """output the current or given revision of the project manifest
3478 3478
3479 3479 Print a list of version controlled files for the given revision.
3480 3480 If no revision is given, the first parent of the working directory
3481 3481 is used, or the null revision if no revision is checked out.
3482 3482
3483 3483 With -v, print file permissions, symlink and executable bits.
3484 3484 With --debug, print file revision hashes.
3485 3485
3486 3486 If option --all is specified, the list of all files from all revisions
3487 3487 is printed. This includes deleted and renamed files.
3488 3488
3489 3489 Returns 0 on success.
3490 3490 """
3491 3491 opts = pycompat.byteskwargs(opts)
3492 3492 fm = ui.formatter('manifest', opts)
3493 3493
3494 3494 if opts.get('all'):
3495 3495 if rev or node:
3496 3496 raise error.Abort(_("can't specify a revision with --all"))
3497 3497
3498 3498 res = []
3499 3499 prefix = "data/"
3500 3500 suffix = ".i"
3501 3501 plen = len(prefix)
3502 3502 slen = len(suffix)
3503 3503 with repo.lock():
3504 3504 for fn, b, size in repo.store.datafiles():
3505 3505 if size != 0 and fn[-slen:] == suffix and fn[:plen] == prefix:
3506 3506 res.append(fn[plen:-slen])
3507 3507 ui.pager('manifest')
3508 3508 for f in res:
3509 3509 fm.startitem()
3510 3510 fm.write("path", '%s\n', f)
3511 3511 fm.end()
3512 3512 return
3513 3513
3514 3514 if rev and node:
3515 3515 raise error.Abort(_("please specify just one revision"))
3516 3516
3517 3517 if not node:
3518 3518 node = rev
3519 3519
3520 3520 char = {'l': '@', 'x': '*', '': ''}
3521 3521 mode = {'l': '644', 'x': '755', '': '644'}
3522 3522 if node:
3523 3523 repo = scmutil.unhidehashlikerevs(repo, [node], 'nowarn')
3524 3524 ctx = scmutil.revsingle(repo, node)
3525 3525 mf = ctx.manifest()
3526 3526 ui.pager('manifest')
3527 3527 for f in ctx:
3528 3528 fm.startitem()
3529 3529 fl = ctx[f].flags()
3530 3530 fm.condwrite(ui.debugflag, 'hash', '%s ', hex(mf[f]))
3531 3531 fm.condwrite(ui.verbose, 'mode type', '%s %1s ', mode[fl], char[fl])
3532 3532 fm.write('path', '%s\n', f)
3533 3533 fm.end()
3534 3534
3535 3535 @command('^merge',
3536 3536 [('f', 'force', None,
3537 3537 _('force a merge including outstanding changes (DEPRECATED)')),
3538 3538 ('r', 'rev', '', _('revision to merge'), _('REV')),
3539 3539 ('P', 'preview', None,
3540 3540 _('review revisions to merge (no merge is performed)')),
3541 3541 ('', 'abort', None, _('abort the ongoing merge')),
3542 3542 ] + mergetoolopts,
3543 3543 _('[-P] [[-r] REV]'))
3544 3544 def merge(ui, repo, node=None, **opts):
3545 3545 """merge another revision into working directory
3546 3546
3547 3547 The current working directory is updated with all changes made in
3548 3548 the requested revision since the last common predecessor revision.
3549 3549
3550 3550 Files that changed between either parent are marked as changed for
3551 3551 the next commit and a commit must be performed before any further
3552 3552 updates to the repository are allowed. The next commit will have
3553 3553 two parents.
3554 3554
3555 3555 ``--tool`` can be used to specify the merge tool used for file
3556 3556 merges. It overrides the HGMERGE environment variable and your
3557 3557 configuration files. See :hg:`help merge-tools` for options.
3558 3558
3559 3559 If no revision is specified, the working directory's parent is a
3560 3560 head revision, and the current branch contains exactly one other
3561 3561 head, the other head is merged with by default. Otherwise, an
3562 3562 explicit revision with which to merge with must be provided.
3563 3563
3564 3564 See :hg:`help resolve` for information on handling file conflicts.
3565 3565
3566 3566 To undo an uncommitted merge, use :hg:`merge --abort` which
3567 3567 will check out a clean copy of the original merge parent, losing
3568 3568 all changes.
3569 3569
3570 3570 Returns 0 on success, 1 if there are unresolved files.
3571 3571 """
3572 3572
3573 3573 opts = pycompat.byteskwargs(opts)
3574 3574 abort = opts.get('abort')
3575 3575 if abort and repo.dirstate.p2() == nullid:
3576 3576 cmdutil.wrongtooltocontinue(repo, _('merge'))
3577 3577 if abort:
3578 3578 if node:
3579 3579 raise error.Abort(_("cannot specify a node with --abort"))
3580 3580 if opts.get('rev'):
3581 3581 raise error.Abort(_("cannot specify both --rev and --abort"))
3582 3582 if opts.get('preview'):
3583 3583 raise error.Abort(_("cannot specify --preview with --abort"))
3584 3584 if opts.get('rev') and node:
3585 3585 raise error.Abort(_("please specify just one revision"))
3586 3586 if not node:
3587 3587 node = opts.get('rev')
3588 3588
3589 3589 if node:
3590 3590 node = scmutil.revsingle(repo, node).node()
3591 3591
3592 3592 if not node and not abort:
3593 3593 node = repo[destutil.destmerge(repo)].node()
3594 3594
3595 3595 if opts.get('preview'):
3596 3596 # find nodes that are ancestors of p2 but not of p1
3597 3597 p1 = repo.lookup('.')
3598 3598 p2 = repo.lookup(node)
3599 3599 nodes = repo.changelog.findmissing(common=[p1], heads=[p2])
3600 3600
3601 3601 displayer = logcmdutil.changesetdisplayer(ui, repo, opts)
3602 3602 for node in nodes:
3603 3603 displayer.show(repo[node])
3604 3604 displayer.close()
3605 3605 return 0
3606 3606
3607 3607 try:
3608 3608 # ui.forcemerge is an internal variable, do not document
3609 3609 repo.ui.setconfig('ui', 'forcemerge', opts.get('tool', ''), 'merge')
3610 3610 force = opts.get('force')
3611 3611 labels = ['working copy', 'merge rev']
3612 3612 return hg.merge(repo, node, force=force, mergeforce=force,
3613 3613 labels=labels, abort=abort)
3614 3614 finally:
3615 3615 ui.setconfig('ui', 'forcemerge', '', 'merge')
3616 3616
3617 3617 @command('outgoing|out',
3618 3618 [('f', 'force', None, _('run even when the destination is unrelated')),
3619 3619 ('r', 'rev', [],
3620 3620 _('a changeset intended to be included in the destination'), _('REV')),
3621 3621 ('n', 'newest-first', None, _('show newest record first')),
3622 3622 ('B', 'bookmarks', False, _('compare bookmarks')),
3623 3623 ('b', 'branch', [], _('a specific branch you would like to push'),
3624 3624 _('BRANCH')),
3625 3625 ] + logopts + remoteopts + subrepoopts,
3626 3626 _('[-M] [-p] [-n] [-f] [-r REV]... [DEST]'))
3627 3627 def outgoing(ui, repo, dest=None, **opts):
3628 3628 """show changesets not found in the destination
3629 3629
3630 3630 Show changesets not found in the specified destination repository
3631 3631 or the default push location. These are the changesets that would
3632 3632 be pushed if a push was requested.
3633 3633
3634 3634 See pull for details of valid destination formats.
3635 3635
3636 3636 .. container:: verbose
3637 3637
3638 3638 With -B/--bookmarks, the result of bookmark comparison between
3639 3639 local and remote repositories is displayed. With -v/--verbose,
3640 3640 status is also displayed for each bookmark like below::
3641 3641
3642 3642 BM1 01234567890a added
3643 3643 BM2 deleted
3644 3644 BM3 234567890abc advanced
3645 3645 BM4 34567890abcd diverged
3646 3646 BM5 4567890abcde changed
3647 3647
3648 3648 The action taken when pushing depends on the
3649 3649 status of each bookmark:
3650 3650
3651 3651 :``added``: push with ``-B`` will create it
3652 3652 :``deleted``: push with ``-B`` will delete it
3653 3653 :``advanced``: push will update it
3654 3654 :``diverged``: push with ``-B`` will update it
3655 3655 :``changed``: push with ``-B`` will update it
3656 3656
3657 3657 From the point of view of pushing behavior, bookmarks
3658 3658 existing only in the remote repository are treated as
3659 3659 ``deleted``, even if it is in fact added remotely.
3660 3660
3661 3661 Returns 0 if there are outgoing changes, 1 otherwise.
3662 3662 """
3663 3663 opts = pycompat.byteskwargs(opts)
3664 3664 if opts.get('graph'):
3665 3665 logcmdutil.checkunsupportedgraphflags([], opts)
3666 3666 o, other = hg._outgoing(ui, repo, dest, opts)
3667 3667 if not o:
3668 3668 cmdutil.outgoinghooks(ui, repo, other, opts, o)
3669 3669 return
3670 3670
3671 3671 revdag = logcmdutil.graphrevs(repo, o, opts)
3672 3672 ui.pager('outgoing')
3673 3673 displayer = logcmdutil.changesetdisplayer(ui, repo, opts, buffered=True)
3674 3674 logcmdutil.displaygraph(ui, repo, revdag, displayer,
3675 3675 graphmod.asciiedges)
3676 3676 cmdutil.outgoinghooks(ui, repo, other, opts, o)
3677 3677 return 0
3678 3678
3679 3679 if opts.get('bookmarks'):
3680 3680 dest = ui.expandpath(dest or 'default-push', dest or 'default')
3681 3681 dest, branches = hg.parseurl(dest, opts.get('branch'))
3682 3682 other = hg.peer(repo, opts, dest)
3683 3683 if 'bookmarks' not in other.listkeys('namespaces'):
3684 3684 ui.warn(_("remote doesn't support bookmarks\n"))
3685 3685 return 0
3686 3686 ui.status(_('comparing with %s\n') % util.hidepassword(dest))
3687 3687 ui.pager('outgoing')
3688 3688 return bookmarks.outgoing(ui, repo, other)
3689 3689
3690 3690 repo._subtoppath = ui.expandpath(dest or 'default-push', dest or 'default')
3691 3691 try:
3692 3692 return hg.outgoing(ui, repo, dest, opts)
3693 3693 finally:
3694 3694 del repo._subtoppath
3695 3695
3696 3696 @command('parents',
3697 3697 [('r', 'rev', '', _('show parents of the specified revision'), _('REV')),
3698 3698 ] + templateopts,
3699 3699 _('[-r REV] [FILE]'),
3700 3700 inferrepo=True)
3701 3701 def parents(ui, repo, file_=None, **opts):
3702 3702 """show the parents of the working directory or revision (DEPRECATED)
3703 3703
3704 3704 Print the working directory's parent revisions. If a revision is
3705 3705 given via -r/--rev, the parent of that revision will be printed.
3706 3706 If a file argument is given, the revision in which the file was
3707 3707 last changed (before the working directory revision or the
3708 3708 argument to --rev if given) is printed.
3709 3709
3710 3710 This command is equivalent to::
3711 3711
3712 3712 hg log -r "p1()+p2()" or
3713 3713 hg log -r "p1(REV)+p2(REV)" or
3714 3714 hg log -r "max(::p1() and file(FILE))+max(::p2() and file(FILE))" or
3715 3715 hg log -r "max(::p1(REV) and file(FILE))+max(::p2(REV) and file(FILE))"
3716 3716
3717 3717 See :hg:`summary` and :hg:`help revsets` for related information.
3718 3718
3719 3719 Returns 0 on success.
3720 3720 """
3721 3721
3722 3722 opts = pycompat.byteskwargs(opts)
3723 3723 rev = opts.get('rev')
3724 3724 if rev:
3725 3725 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
3726 3726 ctx = scmutil.revsingle(repo, rev, None)
3727 3727
3728 3728 if file_:
3729 3729 m = scmutil.match(ctx, (file_,), opts)
3730 3730 if m.anypats() or len(m.files()) != 1:
3731 3731 raise error.Abort(_('can only specify an explicit filename'))
3732 3732 file_ = m.files()[0]
3733 3733 filenodes = []
3734 3734 for cp in ctx.parents():
3735 3735 if not cp:
3736 3736 continue
3737 3737 try:
3738 3738 filenodes.append(cp.filenode(file_))
3739 3739 except error.LookupError:
3740 3740 pass
3741 3741 if not filenodes:
3742 3742 raise error.Abort(_("'%s' not found in manifest!") % file_)
3743 3743 p = []
3744 3744 for fn in filenodes:
3745 3745 fctx = repo.filectx(file_, fileid=fn)
3746 3746 p.append(fctx.node())
3747 3747 else:
3748 3748 p = [cp.node() for cp in ctx.parents()]
3749 3749
3750 3750 displayer = logcmdutil.changesetdisplayer(ui, repo, opts)
3751 3751 for n in p:
3752 3752 if n != nullid:
3753 3753 displayer.show(repo[n])
3754 3754 displayer.close()
3755 3755
3756 3756 @command('paths', formatteropts, _('[NAME]'), optionalrepo=True,
3757 3757 cmdtype=readonly)
3758 3758 def paths(ui, repo, search=None, **opts):
3759 3759 """show aliases for remote repositories
3760 3760
3761 3761 Show definition of symbolic path name NAME. If no name is given,
3762 3762 show definition of all available names.
3763 3763
3764 3764 Option -q/--quiet suppresses all output when searching for NAME
3765 3765 and shows only the path names when listing all definitions.
3766 3766
3767 3767 Path names are defined in the [paths] section of your
3768 3768 configuration file and in ``/etc/mercurial/hgrc``. If run inside a
3769 3769 repository, ``.hg/hgrc`` is used, too.
3770 3770
3771 3771 The path names ``default`` and ``default-push`` have a special
3772 3772 meaning. When performing a push or pull operation, they are used
3773 3773 as fallbacks if no location is specified on the command-line.
3774 3774 When ``default-push`` is set, it will be used for push and
3775 3775 ``default`` will be used for pull; otherwise ``default`` is used
3776 3776 as the fallback for both. When cloning a repository, the clone
3777 3777 source is written as ``default`` in ``.hg/hgrc``.
3778 3778
3779 3779 .. note::
3780 3780
3781 3781 ``default`` and ``default-push`` apply to all inbound (e.g.
3782 3782 :hg:`incoming`) and outbound (e.g. :hg:`outgoing`, :hg:`email`
3783 3783 and :hg:`bundle`) operations.
3784 3784
3785 3785 See :hg:`help urls` for more information.
3786 3786
3787 3787 Returns 0 on success.
3788 3788 """
3789 3789
3790 3790 opts = pycompat.byteskwargs(opts)
3791 3791 ui.pager('paths')
3792 3792 if search:
3793 3793 pathitems = [(name, path) for name, path in ui.paths.iteritems()
3794 3794 if name == search]
3795 3795 else:
3796 3796 pathitems = sorted(ui.paths.iteritems())
3797 3797
3798 3798 fm = ui.formatter('paths', opts)
3799 3799 if fm.isplain():
3800 3800 hidepassword = util.hidepassword
3801 3801 else:
3802 3802 hidepassword = str
3803 3803 if ui.quiet:
3804 3804 namefmt = '%s\n'
3805 3805 else:
3806 3806 namefmt = '%s = '
3807 3807 showsubopts = not search and not ui.quiet
3808 3808
3809 3809 for name, path in pathitems:
3810 3810 fm.startitem()
3811 3811 fm.condwrite(not search, 'name', namefmt, name)
3812 3812 fm.condwrite(not ui.quiet, 'url', '%s\n', hidepassword(path.rawloc))
3813 3813 for subopt, value in sorted(path.suboptions.items()):
3814 3814 assert subopt not in ('name', 'url')
3815 3815 if showsubopts:
3816 3816 fm.plain('%s:%s = ' % (name, subopt))
3817 3817 fm.condwrite(showsubopts, subopt, '%s\n', value)
3818 3818
3819 3819 fm.end()
3820 3820
3821 3821 if search and not pathitems:
3822 3822 if not ui.quiet:
3823 3823 ui.warn(_("not found!\n"))
3824 3824 return 1
3825 3825 else:
3826 3826 return 0
3827 3827
3828 3828 @command('phase',
3829 3829 [('p', 'public', False, _('set changeset phase to public')),
3830 3830 ('d', 'draft', False, _('set changeset phase to draft')),
3831 3831 ('s', 'secret', False, _('set changeset phase to secret')),
3832 3832 ('f', 'force', False, _('allow to move boundary backward')),
3833 3833 ('r', 'rev', [], _('target revision'), _('REV')),
3834 3834 ],
3835 3835 _('[-p|-d|-s] [-f] [-r] [REV...]'))
3836 3836 def phase(ui, repo, *revs, **opts):
3837 3837 """set or show the current phase name
3838 3838
3839 3839 With no argument, show the phase name of the current revision(s).
3840 3840
3841 3841 With one of -p/--public, -d/--draft or -s/--secret, change the
3842 3842 phase value of the specified revisions.
3843 3843
3844 3844 Unless -f/--force is specified, :hg:`phase` won't move changesets from a
3845 3845 lower phase to a higher phase. Phases are ordered as follows::
3846 3846
3847 3847 public < draft < secret
3848 3848
3849 3849 Returns 0 on success, 1 if some phases could not be changed.
3850 3850
3851 3851 (For more information about the phases concept, see :hg:`help phases`.)
3852 3852 """
3853 3853 opts = pycompat.byteskwargs(opts)
3854 3854 # search for a unique phase argument
3855 3855 targetphase = None
3856 3856 for idx, name in enumerate(phases.phasenames):
3857 3857 if opts[name]:
3858 3858 if targetphase is not None:
3859 3859 raise error.Abort(_('only one phase can be specified'))
3860 3860 targetphase = idx
3861 3861
3862 3862 # look for specified revision
3863 3863 revs = list(revs)
3864 3864 revs.extend(opts['rev'])
3865 3865 if not revs:
3866 3866 # display both parents as the second parent phase can influence
3867 3867 # the phase of a merge commit
3868 3868 revs = [c.rev() for c in repo[None].parents()]
3869 3869
3870 3870 revs = scmutil.revrange(repo, revs)
3871 3871
3872 3872 ret = 0
3873 3873 if targetphase is None:
3874 3874 # display
3875 3875 for r in revs:
3876 3876 ctx = repo[r]
3877 3877 ui.write('%i: %s\n' % (ctx.rev(), ctx.phasestr()))
3878 3878 else:
3879 3879 with repo.lock(), repo.transaction("phase") as tr:
3880 3880 # set phase
3881 3881 if not revs:
3882 3882 raise error.Abort(_('empty revision set'))
3883 3883 nodes = [repo[r].node() for r in revs]
3884 3884 # moving revision from public to draft may hide them
3885 3885 # We have to check result on an unfiltered repository
3886 3886 unfi = repo.unfiltered()
3887 3887 getphase = unfi._phasecache.phase
3888 3888 olddata = [getphase(unfi, r) for r in unfi]
3889 3889 phases.advanceboundary(repo, tr, targetphase, nodes)
3890 3890 if opts['force']:
3891 3891 phases.retractboundary(repo, tr, targetphase, nodes)
3892 3892 getphase = unfi._phasecache.phase
3893 3893 newdata = [getphase(unfi, r) for r in unfi]
3894 3894 changes = sum(newdata[r] != olddata[r] for r in unfi)
3895 3895 cl = unfi.changelog
3896 3896 rejected = [n for n in nodes
3897 3897 if newdata[cl.rev(n)] < targetphase]
3898 3898 if rejected:
3899 3899 ui.warn(_('cannot move %i changesets to a higher '
3900 3900 'phase, use --force\n') % len(rejected))
3901 3901 ret = 1
3902 3902 if changes:
3903 3903 msg = _('phase changed for %i changesets\n') % changes
3904 3904 if ret:
3905 3905 ui.status(msg)
3906 3906 else:
3907 3907 ui.note(msg)
3908 3908 else:
3909 3909 ui.warn(_('no phases changed\n'))
3910 3910 return ret
3911 3911
3912 3912 def postincoming(ui, repo, modheads, optupdate, checkout, brev):
3913 3913 """Run after a changegroup has been added via pull/unbundle
3914 3914
3915 3915 This takes arguments below:
3916 3916
3917 3917 :modheads: change of heads by pull/unbundle
3918 3918 :optupdate: updating working directory is needed or not
3919 3919 :checkout: update destination revision (or None to default destination)
3920 3920 :brev: a name, which might be a bookmark to be activated after updating
3921 3921 """
3922 3922 if modheads == 0:
3923 3923 return
3924 3924 if optupdate:
3925 3925 try:
3926 3926 return hg.updatetotally(ui, repo, checkout, brev)
3927 3927 except error.UpdateAbort as inst:
3928 3928 msg = _("not updating: %s") % str(inst)
3929 3929 hint = inst.hint
3930 3930 raise error.UpdateAbort(msg, hint=hint)
3931 3931 if modheads > 1:
3932 3932 currentbranchheads = len(repo.branchheads())
3933 3933 if currentbranchheads == modheads:
3934 3934 ui.status(_("(run 'hg heads' to see heads, 'hg merge' to merge)\n"))
3935 3935 elif currentbranchheads > 1:
3936 3936 ui.status(_("(run 'hg heads .' to see heads, 'hg merge' to "
3937 3937 "merge)\n"))
3938 3938 else:
3939 3939 ui.status(_("(run 'hg heads' to see heads)\n"))
3940 3940 elif not ui.configbool('commands', 'update.requiredest'):
3941 3941 ui.status(_("(run 'hg update' to get a working copy)\n"))
3942 3942
3943 3943 @command('^pull',
3944 3944 [('u', 'update', None,
3945 3945 _('update to new branch head if new descendants were pulled')),
3946 3946 ('f', 'force', None, _('run even when remote repository is unrelated')),
3947 3947 ('r', 'rev', [], _('a remote changeset intended to be added'), _('REV')),
3948 3948 ('B', 'bookmark', [], _("bookmark to pull"), _('BOOKMARK')),
3949 3949 ('b', 'branch', [], _('a specific branch you would like to pull'),
3950 3950 _('BRANCH')),
3951 3951 ] + remoteopts,
3952 3952 _('[-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [SOURCE]'))
3953 3953 def pull(ui, repo, source="default", **opts):
3954 3954 """pull changes from the specified source
3955 3955
3956 3956 Pull changes from a remote repository to a local one.
3957 3957
3958 3958 This finds all changes from the repository at the specified path
3959 3959 or URL and adds them to a local repository (the current one unless
3960 3960 -R is specified). By default, this does not update the copy of the
3961 3961 project in the working directory.
3962 3962
3963 3963 Use :hg:`incoming` if you want to see what would have been added
3964 3964 by a pull at the time you issued this command. If you then decide
3965 3965 to add those changes to the repository, you should use :hg:`pull
3966 3966 -r X` where ``X`` is the last changeset listed by :hg:`incoming`.
3967 3967
3968 3968 If SOURCE is omitted, the 'default' path will be used.
3969 3969 See :hg:`help urls` for more information.
3970 3970
3971 3971 Specifying bookmark as ``.`` is equivalent to specifying the active
3972 3972 bookmark's name.
3973 3973
3974 3974 Returns 0 on success, 1 if an update had unresolved files.
3975 3975 """
3976 3976
3977 3977 opts = pycompat.byteskwargs(opts)
3978 3978 if ui.configbool('commands', 'update.requiredest') and opts.get('update'):
3979 3979 msg = _('update destination required by configuration')
3980 3980 hint = _('use hg pull followed by hg update DEST')
3981 3981 raise error.Abort(msg, hint=hint)
3982 3982
3983 3983 source, branches = hg.parseurl(ui.expandpath(source), opts.get('branch'))
3984 3984 ui.status(_('pulling from %s\n') % util.hidepassword(source))
3985 3985 other = hg.peer(repo, opts, source)
3986 3986 try:
3987 3987 revs, checkout = hg.addbranchrevs(repo, other, branches,
3988 3988 opts.get('rev'))
3989 3989
3990 3990
3991 3991 pullopargs = {}
3992 3992 if opts.get('bookmark'):
3993 3993 if not revs:
3994 3994 revs = []
3995 3995 # The list of bookmark used here is not the one used to actually
3996 3996 # update the bookmark name. This can result in the revision pulled
3997 3997 # not ending up with the name of the bookmark because of a race
3998 3998 # condition on the server. (See issue 4689 for details)
3999 3999 remotebookmarks = other.listkeys('bookmarks')
4000 4000 remotebookmarks = bookmarks.unhexlifybookmarks(remotebookmarks)
4001 4001 pullopargs['remotebookmarks'] = remotebookmarks
4002 4002 for b in opts['bookmark']:
4003 4003 b = repo._bookmarks.expandname(b)
4004 4004 if b not in remotebookmarks:
4005 4005 raise error.Abort(_('remote bookmark %s not found!') % b)
4006 4006 revs.append(hex(remotebookmarks[b]))
4007 4007
4008 4008 if revs:
4009 4009 try:
4010 4010 # When 'rev' is a bookmark name, we cannot guarantee that it
4011 4011 # will be updated with that name because of a race condition
4012 4012 # server side. (See issue 4689 for details)
4013 4013 oldrevs = revs
4014 4014 revs = [] # actually, nodes
4015 4015 for r in oldrevs:
4016 4016 node = other.lookup(r)
4017 4017 revs.append(node)
4018 4018 if r == checkout:
4019 4019 checkout = node
4020 4020 except error.CapabilityError:
4021 4021 err = _("other repository doesn't support revision lookup, "
4022 4022 "so a rev cannot be specified.")
4023 4023 raise error.Abort(err)
4024 4024
4025 4025 wlock = util.nullcontextmanager()
4026 4026 if opts.get('update'):
4027 4027 wlock = repo.wlock()
4028 4028 with wlock:
4029 4029 pullopargs.update(opts.get('opargs', {}))
4030 4030 modheads = exchange.pull(repo, other, heads=revs,
4031 4031 force=opts.get('force'),
4032 4032 bookmarks=opts.get('bookmark', ()),
4033 4033 opargs=pullopargs).cgresult
4034 4034
4035 4035 # brev is a name, which might be a bookmark to be activated at
4036 4036 # the end of the update. In other words, it is an explicit
4037 4037 # destination of the update
4038 4038 brev = None
4039 4039
4040 4040 if checkout:
4041 4041 checkout = str(repo.changelog.rev(checkout))
4042 4042
4043 4043 # order below depends on implementation of
4044 4044 # hg.addbranchrevs(). opts['bookmark'] is ignored,
4045 4045 # because 'checkout' is determined without it.
4046 4046 if opts.get('rev'):
4047 4047 brev = opts['rev'][0]
4048 4048 elif opts.get('branch'):
4049 4049 brev = opts['branch'][0]
4050 4050 else:
4051 4051 brev = branches[0]
4052 4052 repo._subtoppath = source
4053 4053 try:
4054 4054 ret = postincoming(ui, repo, modheads, opts.get('update'),
4055 4055 checkout, brev)
4056 4056
4057 4057 finally:
4058 4058 del repo._subtoppath
4059 4059
4060 4060 finally:
4061 4061 other.close()
4062 4062 return ret
4063 4063
4064 4064 @command('^push',
4065 4065 [('f', 'force', None, _('force push')),
4066 4066 ('r', 'rev', [],
4067 4067 _('a changeset intended to be included in the destination'),
4068 4068 _('REV')),
4069 4069 ('B', 'bookmark', [], _("bookmark to push"), _('BOOKMARK')),
4070 4070 ('b', 'branch', [],
4071 4071 _('a specific branch you would like to push'), _('BRANCH')),
4072 4072 ('', 'new-branch', False, _('allow pushing a new branch')),
4073 4073 ('', 'pushvars', [], _('variables that can be sent to server (ADVANCED)')),
4074 4074 ] + remoteopts,
4075 4075 _('[-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]'))
4076 4076 def push(ui, repo, dest=None, **opts):
4077 4077 """push changes to the specified destination
4078 4078
4079 4079 Push changesets from the local repository to the specified
4080 4080 destination.
4081 4081
4082 4082 This operation is symmetrical to pull: it is identical to a pull
4083 4083 in the destination repository from the current one.
4084 4084
4085 4085 By default, push will not allow creation of new heads at the
4086 4086 destination, since multiple heads would make it unclear which head
4087 4087 to use. In this situation, it is recommended to pull and merge
4088 4088 before pushing.
4089 4089
4090 4090 Use --new-branch if you want to allow push to create a new named
4091 4091 branch that is not present at the destination. This allows you to
4092 4092 only create a new branch without forcing other changes.
4093 4093
4094 4094 .. note::
4095 4095
4096 4096 Extra care should be taken with the -f/--force option,
4097 4097 which will push all new heads on all branches, an action which will
4098 4098 almost always cause confusion for collaborators.
4099 4099
4100 4100 If -r/--rev is used, the specified revision and all its ancestors
4101 4101 will be pushed to the remote repository.
4102 4102
4103 4103 If -B/--bookmark is used, the specified bookmarked revision, its
4104 4104 ancestors, and the bookmark will be pushed to the remote
4105 4105 repository. Specifying ``.`` is equivalent to specifying the active
4106 4106 bookmark's name.
4107 4107
4108 4108 Please see :hg:`help urls` for important details about ``ssh://``
4109 4109 URLs. If DESTINATION is omitted, a default path will be used.
4110 4110
4111 4111 .. container:: verbose
4112 4112
4113 4113 The --pushvars option sends strings to the server that become
4114 4114 environment variables prepended with ``HG_USERVAR_``. For example,
4115 4115 ``--pushvars ENABLE_FEATURE=true``, provides the server side hooks with
4116 4116 ``HG_USERVAR_ENABLE_FEATURE=true`` as part of their environment.
4117 4117
4118 4118 pushvars can provide for user-overridable hooks as well as set debug
4119 4119 levels. One example is having a hook that blocks commits containing
4120 4120 conflict markers, but enables the user to override the hook if the file
4121 4121 is using conflict markers for testing purposes or the file format has
4122 4122 strings that look like conflict markers.
4123 4123
4124 4124 By default, servers will ignore `--pushvars`. To enable it add the
4125 4125 following to your configuration file::
4126 4126
4127 4127 [push]
4128 4128 pushvars.server = true
4129 4129
4130 4130 Returns 0 if push was successful, 1 if nothing to push.
4131 4131 """
4132 4132
4133 4133 opts = pycompat.byteskwargs(opts)
4134 4134 if opts.get('bookmark'):
4135 4135 ui.setconfig('bookmarks', 'pushing', opts['bookmark'], 'push')
4136 4136 for b in opts['bookmark']:
4137 4137 # translate -B options to -r so changesets get pushed
4138 4138 b = repo._bookmarks.expandname(b)
4139 4139 if b in repo._bookmarks:
4140 4140 opts.setdefault('rev', []).append(b)
4141 4141 else:
4142 4142 # if we try to push a deleted bookmark, translate it to null
4143 4143 # this lets simultaneous -r, -b options continue working
4144 4144 opts.setdefault('rev', []).append("null")
4145 4145
4146 4146 path = ui.paths.getpath(dest, default=('default-push', 'default'))
4147 4147 if not path:
4148 4148 raise error.Abort(_('default repository not configured!'),
4149 4149 hint=_("see 'hg help config.paths'"))
4150 4150 dest = path.pushloc or path.loc
4151 4151 branches = (path.branch, opts.get('branch') or [])
4152 4152 ui.status(_('pushing to %s\n') % util.hidepassword(dest))
4153 4153 revs, checkout = hg.addbranchrevs(repo, repo, branches, opts.get('rev'))
4154 4154 other = hg.peer(repo, opts, dest)
4155 4155
4156 4156 if revs:
4157 4157 revs = [repo.lookup(r) for r in scmutil.revrange(repo, revs)]
4158 4158 if not revs:
4159 4159 raise error.Abort(_("specified revisions evaluate to an empty set"),
4160 4160 hint=_("use different revision arguments"))
4161 4161 elif path.pushrev:
4162 4162 # It doesn't make any sense to specify ancestor revisions. So limit
4163 4163 # to DAG heads to make discovery simpler.
4164 4164 expr = revsetlang.formatspec('heads(%r)', path.pushrev)
4165 4165 revs = scmutil.revrange(repo, [expr])
4166 4166 revs = [repo[rev].node() for rev in revs]
4167 4167 if not revs:
4168 4168 raise error.Abort(_('default push revset for path evaluates to an '
4169 4169 'empty set'))
4170 4170
4171 4171 repo._subtoppath = dest
4172 4172 try:
4173 4173 # push subrepos depth-first for coherent ordering
4174 4174 c = repo['']
4175 4175 subs = c.substate # only repos that are committed
4176 4176 for s in sorted(subs):
4177 4177 result = c.sub(s).push(opts)
4178 4178 if result == 0:
4179 4179 return not result
4180 4180 finally:
4181 4181 del repo._subtoppath
4182 4182
4183 4183 opargs = dict(opts.get('opargs', {})) # copy opargs since we may mutate it
4184 4184 opargs.setdefault('pushvars', []).extend(opts.get('pushvars', []))
4185 4185
4186 4186 pushop = exchange.push(repo, other, opts.get('force'), revs=revs,
4187 4187 newbranch=opts.get('new_branch'),
4188 4188 bookmarks=opts.get('bookmark', ()),
4189 4189 opargs=opargs)
4190 4190
4191 4191 result = not pushop.cgresult
4192 4192
4193 4193 if pushop.bkresult is not None:
4194 4194 if pushop.bkresult == 2:
4195 4195 result = 2
4196 4196 elif not result and pushop.bkresult:
4197 4197 result = 2
4198 4198
4199 4199 return result
4200 4200
4201 4201 @command('recover', [])
4202 4202 def recover(ui, repo):
4203 4203 """roll back an interrupted transaction
4204 4204
4205 4205 Recover from an interrupted commit or pull.
4206 4206
4207 4207 This command tries to fix the repository status after an
4208 4208 interrupted operation. It should only be necessary when Mercurial
4209 4209 suggests it.
4210 4210
4211 4211 Returns 0 if successful, 1 if nothing to recover or verify fails.
4212 4212 """
4213 4213 if repo.recover():
4214 4214 return hg.verify(repo)
4215 4215 return 1
4216 4216
4217 4217 @command('^remove|rm',
4218 4218 [('A', 'after', None, _('record delete for missing files')),
4219 4219 ('f', 'force', None,
4220 4220 _('forget added files, delete modified files')),
4221 4221 ] + subrepoopts + walkopts,
4222 4222 _('[OPTION]... FILE...'),
4223 4223 inferrepo=True)
4224 4224 def remove(ui, repo, *pats, **opts):
4225 4225 """remove the specified files on the next commit
4226 4226
4227 4227 Schedule the indicated files for removal from the current branch.
4228 4228
4229 4229 This command schedules the files to be removed at the next commit.
4230 4230 To undo a remove before that, see :hg:`revert`. To undo added
4231 4231 files, see :hg:`forget`.
4232 4232
4233 4233 .. container:: verbose
4234 4234
4235 4235 -A/--after can be used to remove only files that have already
4236 4236 been deleted, -f/--force can be used to force deletion, and -Af
4237 4237 can be used to remove files from the next revision without
4238 4238 deleting them from the working directory.
4239 4239
4240 4240 The following table details the behavior of remove for different
4241 4241 file states (columns) and option combinations (rows). The file
4242 4242 states are Added [A], Clean [C], Modified [M] and Missing [!]
4243 4243 (as reported by :hg:`status`). The actions are Warn, Remove
4244 4244 (from branch) and Delete (from disk):
4245 4245
4246 4246 ========= == == == ==
4247 4247 opt/state A C M !
4248 4248 ========= == == == ==
4249 4249 none W RD W R
4250 4250 -f R RD RD R
4251 4251 -A W W W R
4252 4252 -Af R R R R
4253 4253 ========= == == == ==
4254 4254
4255 4255 .. note::
4256 4256
4257 4257 :hg:`remove` never deletes files in Added [A] state from the
4258 4258 working directory, not even if ``--force`` is specified.
4259 4259
4260 4260 Returns 0 on success, 1 if any warnings encountered.
4261 4261 """
4262 4262
4263 4263 opts = pycompat.byteskwargs(opts)
4264 4264 after, force = opts.get('after'), opts.get('force')
4265 4265 if not pats and not after:
4266 4266 raise error.Abort(_('no files specified'))
4267 4267
4268 4268 m = scmutil.match(repo[None], pats, opts)
4269 4269 subrepos = opts.get('subrepos')
4270 4270 return cmdutil.remove(ui, repo, m, "", after, force, subrepos)
4271 4271
4272 4272 @command('rename|move|mv',
4273 4273 [('A', 'after', None, _('record a rename that has already occurred')),
4274 4274 ('f', 'force', None, _('forcibly copy over an existing managed file')),
4275 4275 ] + walkopts + dryrunopts,
4276 4276 _('[OPTION]... SOURCE... DEST'))
4277 4277 def rename(ui, repo, *pats, **opts):
4278 4278 """rename files; equivalent of copy + remove
4279 4279
4280 4280 Mark dest as copies of sources; mark sources for deletion. If dest
4281 4281 is a directory, copies are put in that directory. If dest is a
4282 4282 file, there can only be one source.
4283 4283
4284 4284 By default, this command copies the contents of files as they
4285 4285 exist in the working directory. If invoked with -A/--after, the
4286 4286 operation is recorded, but no copying is performed.
4287 4287
4288 4288 This command takes effect at the next commit. To undo a rename
4289 4289 before that, see :hg:`revert`.
4290 4290
4291 4291 Returns 0 on success, 1 if errors are encountered.
4292 4292 """
4293 4293 opts = pycompat.byteskwargs(opts)
4294 4294 with repo.wlock(False):
4295 4295 return cmdutil.copy(ui, repo, pats, opts, rename=True)
4296 4296
4297 4297 @command('resolve',
4298 4298 [('a', 'all', None, _('select all unresolved files')),
4299 4299 ('l', 'list', None, _('list state of files needing merge')),
4300 4300 ('m', 'mark', None, _('mark files as resolved')),
4301 4301 ('u', 'unmark', None, _('mark files as unresolved')),
4302 4302 ('n', 'no-status', None, _('hide status prefix'))]
4303 4303 + mergetoolopts + walkopts + formatteropts,
4304 4304 _('[OPTION]... [FILE]...'),
4305 4305 inferrepo=True)
4306 4306 def resolve(ui, repo, *pats, **opts):
4307 4307 """redo merges or set/view the merge status of files
4308 4308
4309 4309 Merges with unresolved conflicts are often the result of
4310 4310 non-interactive merging using the ``internal:merge`` configuration
4311 4311 setting, or a command-line merge tool like ``diff3``. The resolve
4312 4312 command is used to manage the files involved in a merge, after
4313 4313 :hg:`merge` has been run, and before :hg:`commit` is run (i.e. the
4314 4314 working directory must have two parents). See :hg:`help
4315 4315 merge-tools` for information on configuring merge tools.
4316 4316
4317 4317 The resolve command can be used in the following ways:
4318 4318
4319 4319 - :hg:`resolve [--tool TOOL] FILE...`: attempt to re-merge the specified
4320 4320 files, discarding any previous merge attempts. Re-merging is not
4321 4321 performed for files already marked as resolved. Use ``--all/-a``
4322 4322 to select all unresolved files. ``--tool`` can be used to specify
4323 4323 the merge tool used for the given files. It overrides the HGMERGE
4324 4324 environment variable and your configuration files. Previous file
4325 4325 contents are saved with a ``.orig`` suffix.
4326 4326
4327 4327 - :hg:`resolve -m [FILE]`: mark a file as having been resolved
4328 4328 (e.g. after having manually fixed-up the files). The default is
4329 4329 to mark all unresolved files.
4330 4330
4331 4331 - :hg:`resolve -u [FILE]...`: mark a file as unresolved. The
4332 4332 default is to mark all resolved files.
4333 4333
4334 4334 - :hg:`resolve -l`: list files which had or still have conflicts.
4335 4335 In the printed list, ``U`` = unresolved and ``R`` = resolved.
4336 4336 You can use ``set:unresolved()`` or ``set:resolved()`` to filter
4337 4337 the list. See :hg:`help filesets` for details.
4338 4338
4339 4339 .. note::
4340 4340
4341 4341 Mercurial will not let you commit files with unresolved merge
4342 4342 conflicts. You must use :hg:`resolve -m ...` before you can
4343 4343 commit after a conflicting merge.
4344 4344
4345 4345 Returns 0 on success, 1 if any files fail a resolve attempt.
4346 4346 """
4347 4347
4348 4348 opts = pycompat.byteskwargs(opts)
4349 4349 flaglist = 'all mark unmark list no_status'.split()
4350 4350 all, mark, unmark, show, nostatus = \
4351 4351 [opts.get(o) for o in flaglist]
4352 4352
4353 4353 if (show and (mark or unmark)) or (mark and unmark):
4354 4354 raise error.Abort(_("too many options specified"))
4355 4355 if pats and all:
4356 4356 raise error.Abort(_("can't specify --all and patterns"))
4357 4357 if not (all or pats or show or mark or unmark):
4358 4358 raise error.Abort(_('no files or directories specified'),
4359 4359 hint=('use --all to re-merge all unresolved files'))
4360 4360
4361 4361 if show:
4362 4362 ui.pager('resolve')
4363 4363 fm = ui.formatter('resolve', opts)
4364 4364 ms = mergemod.mergestate.read(repo)
4365 4365 m = scmutil.match(repo[None], pats, opts)
4366 4366
4367 4367 # Labels and keys based on merge state. Unresolved path conflicts show
4368 4368 # as 'P'. Resolved path conflicts show as 'R', the same as normal
4369 4369 # resolved conflicts.
4370 4370 mergestateinfo = {
4371 4371 'u': ('resolve.unresolved', 'U'),
4372 4372 'r': ('resolve.resolved', 'R'),
4373 4373 'pu': ('resolve.unresolved', 'P'),
4374 4374 'pr': ('resolve.resolved', 'R'),
4375 4375 'd': ('resolve.driverresolved', 'D'),
4376 4376 }
4377 4377
4378 4378 for f in ms:
4379 4379 if not m(f):
4380 4380 continue
4381 4381
4382 4382 label, key = mergestateinfo[ms[f]]
4383 4383 fm.startitem()
4384 4384 fm.condwrite(not nostatus, 'status', '%s ', key, label=label)
4385 4385 fm.write('path', '%s\n', f, label=label)
4386 4386 fm.end()
4387 4387 return 0
4388 4388
4389 4389 with repo.wlock():
4390 4390 ms = mergemod.mergestate.read(repo)
4391 4391
4392 4392 if not (ms.active() or repo.dirstate.p2() != nullid):
4393 4393 raise error.Abort(
4394 4394 _('resolve command not applicable when not merging'))
4395 4395
4396 4396 wctx = repo[None]
4397 4397
4398 4398 if ms.mergedriver and ms.mdstate() == 'u':
4399 4399 proceed = mergemod.driverpreprocess(repo, ms, wctx)
4400 4400 ms.commit()
4401 4401 # allow mark and unmark to go through
4402 4402 if not mark and not unmark and not proceed:
4403 4403 return 1
4404 4404
4405 4405 m = scmutil.match(wctx, pats, opts)
4406 4406 ret = 0
4407 4407 didwork = False
4408 4408 runconclude = False
4409 4409
4410 4410 tocomplete = []
4411 4411 for f in ms:
4412 4412 if not m(f):
4413 4413 continue
4414 4414
4415 4415 didwork = True
4416 4416
4417 4417 # don't let driver-resolved files be marked, and run the conclude
4418 4418 # step if asked to resolve
4419 4419 if ms[f] == "d":
4420 4420 exact = m.exact(f)
4421 4421 if mark:
4422 4422 if exact:
4423 4423 ui.warn(_('not marking %s as it is driver-resolved\n')
4424 4424 % f)
4425 4425 elif unmark:
4426 4426 if exact:
4427 4427 ui.warn(_('not unmarking %s as it is driver-resolved\n')
4428 4428 % f)
4429 4429 else:
4430 4430 runconclude = True
4431 4431 continue
4432 4432
4433 4433 # path conflicts must be resolved manually
4434 4434 if ms[f] in ("pu", "pr"):
4435 4435 if mark:
4436 4436 ms.mark(f, "pr")
4437 4437 elif unmark:
4438 4438 ms.mark(f, "pu")
4439 4439 elif ms[f] == "pu":
4440 4440 ui.warn(_('%s: path conflict must be resolved manually\n')
4441 4441 % f)
4442 4442 continue
4443 4443
4444 4444 if mark:
4445 4445 ms.mark(f, "r")
4446 4446 elif unmark:
4447 4447 ms.mark(f, "u")
4448 4448 else:
4449 4449 # backup pre-resolve (merge uses .orig for its own purposes)
4450 4450 a = repo.wjoin(f)
4451 4451 try:
4452 4452 util.copyfile(a, a + ".resolve")
4453 4453 except (IOError, OSError) as inst:
4454 4454 if inst.errno != errno.ENOENT:
4455 4455 raise
4456 4456
4457 4457 try:
4458 4458 # preresolve file
4459 4459 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''),
4460 4460 'resolve')
4461 4461 complete, r = ms.preresolve(f, wctx)
4462 4462 if not complete:
4463 4463 tocomplete.append(f)
4464 4464 elif r:
4465 4465 ret = 1
4466 4466 finally:
4467 4467 ui.setconfig('ui', 'forcemerge', '', 'resolve')
4468 4468 ms.commit()
4469 4469
4470 4470 # replace filemerge's .orig file with our resolve file, but only
4471 4471 # for merges that are complete
4472 4472 if complete:
4473 4473 try:
4474 4474 util.rename(a + ".resolve",
4475 4475 scmutil.origpath(ui, repo, a))
4476 4476 except OSError as inst:
4477 4477 if inst.errno != errno.ENOENT:
4478 4478 raise
4479 4479
4480 4480 for f in tocomplete:
4481 4481 try:
4482 4482 # resolve file
4483 4483 ui.setconfig('ui', 'forcemerge', opts.get('tool', ''),
4484 4484 'resolve')
4485 4485 r = ms.resolve(f, wctx)
4486 4486 if r:
4487 4487 ret = 1
4488 4488 finally:
4489 4489 ui.setconfig('ui', 'forcemerge', '', 'resolve')
4490 4490 ms.commit()
4491 4491
4492 4492 # replace filemerge's .orig file with our resolve file
4493 4493 a = repo.wjoin(f)
4494 4494 try:
4495 4495 util.rename(a + ".resolve", scmutil.origpath(ui, repo, a))
4496 4496 except OSError as inst:
4497 4497 if inst.errno != errno.ENOENT:
4498 4498 raise
4499 4499
4500 4500 ms.commit()
4501 4501 ms.recordactions()
4502 4502
4503 4503 if not didwork and pats:
4504 4504 hint = None
4505 4505 if not any([p for p in pats if p.find(':') >= 0]):
4506 4506 pats = ['path:%s' % p for p in pats]
4507 4507 m = scmutil.match(wctx, pats, opts)
4508 4508 for f in ms:
4509 4509 if not m(f):
4510 4510 continue
4511 4511 flags = ''.join(['-%s ' % o[0] for o in flaglist
4512 4512 if opts.get(o)])
4513 4513 hint = _("(try: hg resolve %s%s)\n") % (
4514 4514 flags,
4515 4515 ' '.join(pats))
4516 4516 break
4517 4517 ui.warn(_("arguments do not match paths that need resolving\n"))
4518 4518 if hint:
4519 4519 ui.warn(hint)
4520 4520 elif ms.mergedriver and ms.mdstate() != 's':
4521 4521 # run conclude step when either a driver-resolved file is requested
4522 4522 # or there are no driver-resolved files
4523 4523 # we can't use 'ret' to determine whether any files are unresolved
4524 4524 # because we might not have tried to resolve some
4525 4525 if ((runconclude or not list(ms.driverresolved()))
4526 4526 and not list(ms.unresolved())):
4527 4527 proceed = mergemod.driverconclude(repo, ms, wctx)
4528 4528 ms.commit()
4529 4529 if not proceed:
4530 4530 return 1
4531 4531
4532 4532 # Nudge users into finishing an unfinished operation
4533 4533 unresolvedf = list(ms.unresolved())
4534 4534 driverresolvedf = list(ms.driverresolved())
4535 4535 if not unresolvedf and not driverresolvedf:
4536 4536 ui.status(_('(no more unresolved files)\n'))
4537 4537 cmdutil.checkafterresolved(repo)
4538 4538 elif not unresolvedf:
4539 4539 ui.status(_('(no more unresolved files -- '
4540 4540 'run "hg resolve --all" to conclude)\n'))
4541 4541
4542 4542 return ret
4543 4543
4544 4544 @command('revert',
4545 4545 [('a', 'all', None, _('revert all changes when no arguments given')),
4546 4546 ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
4547 4547 ('r', 'rev', '', _('revert to the specified revision'), _('REV')),
4548 4548 ('C', 'no-backup', None, _('do not save backup copies of files')),
4549 4549 ('i', 'interactive', None, _('interactively select the changes')),
4550 4550 ] + walkopts + dryrunopts,
4551 4551 _('[OPTION]... [-r REV] [NAME]...'))
4552 4552 def revert(ui, repo, *pats, **opts):
4553 4553 """restore files to their checkout state
4554 4554
4555 4555 .. note::
4556 4556
4557 4557 To check out earlier revisions, you should use :hg:`update REV`.
4558 4558 To cancel an uncommitted merge (and lose your changes),
4559 4559 use :hg:`merge --abort`.
4560 4560
4561 4561 With no revision specified, revert the specified files or directories
4562 4562 to the contents they had in the parent of the working directory.
4563 4563 This restores the contents of files to an unmodified
4564 4564 state and unschedules adds, removes, copies, and renames. If the
4565 4565 working directory has two parents, you must explicitly specify a
4566 4566 revision.
4567 4567
4568 4568 Using the -r/--rev or -d/--date options, revert the given files or
4569 4569 directories to their states as of a specific revision. Because
4570 4570 revert does not change the working directory parents, this will
4571 4571 cause these files to appear modified. This can be helpful to "back
4572 4572 out" some or all of an earlier change. See :hg:`backout` for a
4573 4573 related method.
4574 4574
4575 4575 Modified files are saved with a .orig suffix before reverting.
4576 4576 To disable these backups, use --no-backup. It is possible to store
4577 4577 the backup files in a custom directory relative to the root of the
4578 4578 repository by setting the ``ui.origbackuppath`` configuration
4579 4579 option.
4580 4580
4581 4581 See :hg:`help dates` for a list of formats valid for -d/--date.
4582 4582
4583 4583 See :hg:`help backout` for a way to reverse the effect of an
4584 4584 earlier changeset.
4585 4585
4586 4586 Returns 0 on success.
4587 4587 """
4588 4588
4589 4589 opts = pycompat.byteskwargs(opts)
4590 4590 if opts.get("date"):
4591 4591 if opts.get("rev"):
4592 4592 raise error.Abort(_("you can't specify a revision and a date"))
4593 4593 opts["rev"] = cmdutil.finddate(ui, repo, opts["date"])
4594 4594
4595 4595 parent, p2 = repo.dirstate.parents()
4596 4596 if not opts.get('rev') and p2 != nullid:
4597 4597 # revert after merge is a trap for new users (issue2915)
4598 4598 raise error.Abort(_('uncommitted merge with no revision specified'),
4599 4599 hint=_("use 'hg update' or see 'hg help revert'"))
4600 4600
4601 4601 rev = opts.get('rev')
4602 4602 if rev:
4603 4603 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
4604 4604 ctx = scmutil.revsingle(repo, rev)
4605 4605
4606 4606 if (not (pats or opts.get('include') or opts.get('exclude') or
4607 4607 opts.get('all') or opts.get('interactive'))):
4608 4608 msg = _("no files or directories specified")
4609 4609 if p2 != nullid:
4610 4610 hint = _("uncommitted merge, use --all to discard all changes,"
4611 4611 " or 'hg update -C .' to abort the merge")
4612 4612 raise error.Abort(msg, hint=hint)
4613 4613 dirty = any(repo.status())
4614 4614 node = ctx.node()
4615 4615 if node != parent:
4616 4616 if dirty:
4617 4617 hint = _("uncommitted changes, use --all to discard all"
4618 4618 " changes, or 'hg update %s' to update") % ctx.rev()
4619 4619 else:
4620 4620 hint = _("use --all to revert all files,"
4621 4621 " or 'hg update %s' to update") % ctx.rev()
4622 4622 elif dirty:
4623 4623 hint = _("uncommitted changes, use --all to discard all changes")
4624 4624 else:
4625 4625 hint = _("use --all to revert all files")
4626 4626 raise error.Abort(msg, hint=hint)
4627 4627
4628 4628 return cmdutil.revert(ui, repo, ctx, (parent, p2), *pats,
4629 4629 **pycompat.strkwargs(opts))
4630 4630
4631 4631 @command('rollback', dryrunopts +
4632 4632 [('f', 'force', False, _('ignore safety measures'))])
4633 4633 def rollback(ui, repo, **opts):
4634 4634 """roll back the last transaction (DANGEROUS) (DEPRECATED)
4635 4635
4636 4636 Please use :hg:`commit --amend` instead of rollback to correct
4637 4637 mistakes in the last commit.
4638 4638
4639 4639 This command should be used with care. There is only one level of
4640 4640 rollback, and there is no way to undo a rollback. It will also
4641 4641 restore the dirstate at the time of the last transaction, losing
4642 4642 any dirstate changes since that time. This command does not alter
4643 4643 the working directory.
4644 4644
4645 4645 Transactions are used to encapsulate the effects of all commands
4646 4646 that create new changesets or propagate existing changesets into a
4647 4647 repository.
4648 4648
4649 4649 .. container:: verbose
4650 4650
4651 4651 For example, the following commands are transactional, and their
4652 4652 effects can be rolled back:
4653 4653
4654 4654 - commit
4655 4655 - import
4656 4656 - pull
4657 4657 - push (with this repository as the destination)
4658 4658 - unbundle
4659 4659
4660 4660 To avoid permanent data loss, rollback will refuse to rollback a
4661 4661 commit transaction if it isn't checked out. Use --force to
4662 4662 override this protection.
4663 4663
4664 4664 The rollback command can be entirely disabled by setting the
4665 4665 ``ui.rollback`` configuration setting to false. If you're here
4666 4666 because you want to use rollback and it's disabled, you can
4667 4667 re-enable the command by setting ``ui.rollback`` to true.
4668 4668
4669 4669 This command is not intended for use on public repositories. Once
4670 4670 changes are visible for pull by other users, rolling a transaction
4671 4671 back locally is ineffective (someone else may already have pulled
4672 4672 the changes). Furthermore, a race is possible with readers of the
4673 4673 repository; for example an in-progress pull from the repository
4674 4674 may fail if a rollback is performed.
4675 4675
4676 4676 Returns 0 on success, 1 if no rollback data is available.
4677 4677 """
4678 4678 if not ui.configbool('ui', 'rollback'):
4679 4679 raise error.Abort(_('rollback is disabled because it is unsafe'),
4680 4680 hint=('see `hg help -v rollback` for information'))
4681 4681 return repo.rollback(dryrun=opts.get(r'dry_run'),
4682 4682 force=opts.get(r'force'))
4683 4683
4684 4684 @command('root', [], cmdtype=readonly)
4685 4685 def root(ui, repo):
4686 4686 """print the root (top) of the current working directory
4687 4687
4688 4688 Print the root directory of the current repository.
4689 4689
4690 4690 Returns 0 on success.
4691 4691 """
4692 4692 ui.write(repo.root + "\n")
4693 4693
4694 4694 @command('^serve',
4695 4695 [('A', 'accesslog', '', _('name of access log file to write to'),
4696 4696 _('FILE')),
4697 4697 ('d', 'daemon', None, _('run server in background')),
4698 4698 ('', 'daemon-postexec', [], _('used internally by daemon mode')),
4699 4699 ('E', 'errorlog', '', _('name of error log file to write to'), _('FILE')),
4700 4700 # use string type, then we can check if something was passed
4701 4701 ('p', 'port', '', _('port to listen on (default: 8000)'), _('PORT')),
4702 4702 ('a', 'address', '', _('address to listen on (default: all interfaces)'),
4703 4703 _('ADDR')),
4704 4704 ('', 'prefix', '', _('prefix path to serve from (default: server root)'),
4705 4705 _('PREFIX')),
4706 4706 ('n', 'name', '',
4707 4707 _('name to show in web pages (default: working directory)'), _('NAME')),
4708 4708 ('', 'web-conf', '',
4709 4709 _("name of the hgweb config file (see 'hg help hgweb')"), _('FILE')),
4710 4710 ('', 'webdir-conf', '', _('name of the hgweb config file (DEPRECATED)'),
4711 4711 _('FILE')),
4712 4712 ('', 'pid-file', '', _('name of file to write process ID to'), _('FILE')),
4713 4713 ('', 'stdio', None, _('for remote clients (ADVANCED)')),
4714 4714 ('', 'cmdserver', '', _('for remote clients (ADVANCED)'), _('MODE')),
4715 4715 ('t', 'templates', '', _('web templates to use'), _('TEMPLATE')),
4716 4716 ('', 'style', '', _('template style to use'), _('STYLE')),
4717 4717 ('6', 'ipv6', None, _('use IPv6 in addition to IPv4')),
4718 4718 ('', 'certificate', '', _('SSL certificate file'), _('FILE'))]
4719 4719 + subrepoopts,
4720 4720 _('[OPTION]...'),
4721 4721 optionalrepo=True)
4722 4722 def serve(ui, repo, **opts):
4723 4723 """start stand-alone webserver
4724 4724
4725 4725 Start a local HTTP repository browser and pull server. You can use
4726 4726 this for ad-hoc sharing and browsing of repositories. It is
4727 4727 recommended to use a real web server to serve a repository for
4728 4728 longer periods of time.
4729 4729
4730 4730 Please note that the server does not implement access control.
4731 4731 This means that, by default, anybody can read from the server and
4732 4732 nobody can write to it by default. Set the ``web.allow-push``
4733 4733 option to ``*`` to allow everybody to push to the server. You
4734 4734 should use a real web server if you need to authenticate users.
4735 4735
4736 4736 By default, the server logs accesses to stdout and errors to
4737 4737 stderr. Use the -A/--accesslog and -E/--errorlog options to log to
4738 4738 files.
4739 4739
4740 4740 To have the server choose a free port number to listen on, specify
4741 4741 a port number of 0; in this case, the server will print the port
4742 4742 number it uses.
4743 4743
4744 4744 Returns 0 on success.
4745 4745 """
4746 4746
4747 4747 opts = pycompat.byteskwargs(opts)
4748 4748 if opts["stdio"] and opts["cmdserver"]:
4749 4749 raise error.Abort(_("cannot use --stdio with --cmdserver"))
4750 4750
4751 4751 if opts["stdio"]:
4752 4752 if repo is None:
4753 4753 raise error.RepoError(_("there is no Mercurial repository here"
4754 4754 " (.hg not found)"))
4755 4755 s = wireprotoserver.sshserver(ui, repo)
4756 4756 s.serve_forever()
4757 4757
4758 4758 service = server.createservice(ui, repo, opts)
4759 4759 return server.runservice(opts, initfn=service.init, runfn=service.run)
4760 4760
4761 4761 @command('^status|st',
4762 4762 [('A', 'all', None, _('show status of all files')),
4763 4763 ('m', 'modified', None, _('show only modified files')),
4764 4764 ('a', 'added', None, _('show only added files')),
4765 4765 ('r', 'removed', None, _('show only removed files')),
4766 4766 ('d', 'deleted', None, _('show only deleted (but tracked) files')),
4767 4767 ('c', 'clean', None, _('show only files without changes')),
4768 4768 ('u', 'unknown', None, _('show only unknown (not tracked) files')),
4769 4769 ('i', 'ignored', None, _('show only ignored files')),
4770 4770 ('n', 'no-status', None, _('hide status prefix')),
4771 4771 ('t', 'terse', '', _('show the terse output (EXPERIMENTAL)')),
4772 4772 ('C', 'copies', None, _('show source of copied files')),
4773 4773 ('0', 'print0', None, _('end filenames with NUL, for use with xargs')),
4774 4774 ('', 'rev', [], _('show difference from revision'), _('REV')),
4775 4775 ('', 'change', '', _('list the changed files of a revision'), _('REV')),
4776 4776 ] + walkopts + subrepoopts + formatteropts,
4777 4777 _('[OPTION]... [FILE]...'),
4778 4778 inferrepo=True, cmdtype=readonly)
4779 4779 def status(ui, repo, *pats, **opts):
4780 4780 """show changed files in the working directory
4781 4781
4782 4782 Show status of files in the repository. If names are given, only
4783 4783 files that match are shown. Files that are clean or ignored or
4784 4784 the source of a copy/move operation, are not listed unless
4785 4785 -c/--clean, -i/--ignored, -C/--copies or -A/--all are given.
4786 4786 Unless options described with "show only ..." are given, the
4787 4787 options -mardu are used.
4788 4788
4789 4789 Option -q/--quiet hides untracked (unknown and ignored) files
4790 4790 unless explicitly requested with -u/--unknown or -i/--ignored.
4791 4791
4792 4792 .. note::
4793 4793
4794 4794 :hg:`status` may appear to disagree with diff if permissions have
4795 4795 changed or a merge has occurred. The standard diff format does
4796 4796 not report permission changes and diff only reports changes
4797 4797 relative to one merge parent.
4798 4798
4799 4799 If one revision is given, it is used as the base revision.
4800 4800 If two revisions are given, the differences between them are
4801 4801 shown. The --change option can also be used as a shortcut to list
4802 4802 the changed files of a revision from its first parent.
4803 4803
4804 4804 The codes used to show the status of files are::
4805 4805
4806 4806 M = modified
4807 4807 A = added
4808 4808 R = removed
4809 4809 C = clean
4810 4810 ! = missing (deleted by non-hg command, but still tracked)
4811 4811 ? = not tracked
4812 4812 I = ignored
4813 4813 = origin of the previous file (with --copies)
4814 4814
4815 4815 .. container:: verbose
4816 4816
4817 4817 The -t/--terse option abbreviates the output by showing only the directory
4818 4818 name if all the files in it share the same status. The option takes an
4819 4819 argument indicating the statuses to abbreviate: 'm' for 'modified', 'a'
4820 4820 for 'added', 'r' for 'removed', 'd' for 'deleted', 'u' for 'unknown', 'i'
4821 4821 for 'ignored' and 'c' for clean.
4822 4822
4823 4823 It abbreviates only those statuses which are passed. Note that clean and
4824 4824 ignored files are not displayed with '--terse ic' unless the -c/--clean
4825 4825 and -i/--ignored options are also used.
4826 4826
4827 4827 The -v/--verbose option shows information when the repository is in an
4828 4828 unfinished merge, shelve, rebase state etc. You can have this behavior
4829 4829 turned on by default by enabling the ``commands.status.verbose`` option.
4830 4830
4831 4831 You can skip displaying some of these states by setting
4832 4832 ``commands.status.skipstates`` to one or more of: 'bisect', 'graft',
4833 4833 'histedit', 'merge', 'rebase', or 'unshelve'.
4834 4834
4835 4835 Examples:
4836 4836
4837 4837 - show changes in the working directory relative to a
4838 4838 changeset::
4839 4839
4840 4840 hg status --rev 9353
4841 4841
4842 4842 - show changes in the working directory relative to the
4843 4843 current directory (see :hg:`help patterns` for more information)::
4844 4844
4845 4845 hg status re:
4846 4846
4847 4847 - show all changes including copies in an existing changeset::
4848 4848
4849 4849 hg status --copies --change 9353
4850 4850
4851 4851 - get a NUL separated list of added files, suitable for xargs::
4852 4852
4853 4853 hg status -an0
4854 4854
4855 4855 - show more information about the repository status, abbreviating
4856 4856 added, removed, modified, deleted, and untracked paths::
4857 4857
4858 4858 hg status -v -t mardu
4859 4859
4860 4860 Returns 0 on success.
4861 4861
4862 4862 """
4863 4863
4864 4864 opts = pycompat.byteskwargs(opts)
4865 4865 revs = opts.get('rev')
4866 4866 change = opts.get('change')
4867 4867 terse = opts.get('terse')
4868 4868
4869 4869 if revs and change:
4870 4870 msg = _('cannot specify --rev and --change at the same time')
4871 4871 raise error.Abort(msg)
4872 4872 elif revs and terse:
4873 4873 msg = _('cannot use --terse with --rev')
4874 4874 raise error.Abort(msg)
4875 4875 elif change:
4876 4876 repo = scmutil.unhidehashlikerevs(repo, [change], 'nowarn')
4877 4877 node2 = scmutil.revsingle(repo, change, None).node()
4878 4878 node1 = repo[node2].p1().node()
4879 4879 else:
4880 4880 repo = scmutil.unhidehashlikerevs(repo, revs, 'nowarn')
4881 4881 node1, node2 = scmutil.revpair(repo, revs)
4882 4882
4883 4883 if pats or ui.configbool('commands', 'status.relative'):
4884 4884 cwd = repo.getcwd()
4885 4885 else:
4886 4886 cwd = ''
4887 4887
4888 4888 if opts.get('print0'):
4889 4889 end = '\0'
4890 4890 else:
4891 4891 end = '\n'
4892 4892 copy = {}
4893 4893 states = 'modified added removed deleted unknown ignored clean'.split()
4894 4894 show = [k for k in states if opts.get(k)]
4895 4895 if opts.get('all'):
4896 4896 show += ui.quiet and (states[:4] + ['clean']) or states
4897 4897
4898 4898 if not show:
4899 4899 if ui.quiet:
4900 4900 show = states[:4]
4901 4901 else:
4902 4902 show = states[:5]
4903 4903
4904 4904 m = scmutil.match(repo[node2], pats, opts)
4905 4905 if terse:
4906 4906 # we need to compute clean and unknown to terse
4907 4907 stat = repo.status(node1, node2, m,
4908 4908 'ignored' in show or 'i' in terse,
4909 4909 True, True, opts.get('subrepos'))
4910 4910
4911 4911 stat = cmdutil.tersedir(stat, terse)
4912 4912 else:
4913 4913 stat = repo.status(node1, node2, m,
4914 4914 'ignored' in show, 'clean' in show,
4915 4915 'unknown' in show, opts.get('subrepos'))
4916 4916
4917 4917 changestates = zip(states, pycompat.iterbytestr('MAR!?IC'), stat)
4918 4918
4919 4919 if (opts.get('all') or opts.get('copies')
4920 4920 or ui.configbool('ui', 'statuscopies')) and not opts.get('no_status'):
4921 4921 copy = copies.pathcopies(repo[node1], repo[node2], m)
4922 4922
4923 4923 ui.pager('status')
4924 4924 fm = ui.formatter('status', opts)
4925 4925 fmt = '%s' + end
4926 4926 showchar = not opts.get('no_status')
4927 4927
4928 4928 for state, char, files in changestates:
4929 4929 if state in show:
4930 4930 label = 'status.' + state
4931 4931 for f in files:
4932 4932 fm.startitem()
4933 4933 fm.condwrite(showchar, 'status', '%s ', char, label=label)
4934 4934 fm.write('path', fmt, repo.pathto(f, cwd), label=label)
4935 4935 if f in copy:
4936 4936 fm.write("copy", ' %s' + end, repo.pathto(copy[f], cwd),
4937 4937 label='status.copied')
4938 4938
4939 4939 if ((ui.verbose or ui.configbool('commands', 'status.verbose'))
4940 4940 and not ui.plain()):
4941 4941 cmdutil.morestatus(repo, fm)
4942 4942 fm.end()
4943 4943
4944 4944 @command('^summary|sum',
4945 4945 [('', 'remote', None, _('check for push and pull'))],
4946 4946 '[--remote]', cmdtype=readonly)
4947 4947 def summary(ui, repo, **opts):
4948 4948 """summarize working directory state
4949 4949
4950 4950 This generates a brief summary of the working directory state,
4951 4951 including parents, branch, commit status, phase and available updates.
4952 4952
4953 4953 With the --remote option, this will check the default paths for
4954 4954 incoming and outgoing changes. This can be time-consuming.
4955 4955
4956 4956 Returns 0 on success.
4957 4957 """
4958 4958
4959 4959 opts = pycompat.byteskwargs(opts)
4960 4960 ui.pager('summary')
4961 4961 ctx = repo[None]
4962 4962 parents = ctx.parents()
4963 4963 pnode = parents[0].node()
4964 4964 marks = []
4965 4965
4966 4966 ms = None
4967 4967 try:
4968 4968 ms = mergemod.mergestate.read(repo)
4969 4969 except error.UnsupportedMergeRecords as e:
4970 4970 s = ' '.join(e.recordtypes)
4971 4971 ui.warn(
4972 4972 _('warning: merge state has unsupported record types: %s\n') % s)
4973 4973 unresolved = []
4974 4974 else:
4975 4975 unresolved = list(ms.unresolved())
4976 4976
4977 4977 for p in parents:
4978 4978 # label with log.changeset (instead of log.parent) since this
4979 4979 # shows a working directory parent *changeset*:
4980 4980 # i18n: column positioning for "hg summary"
4981 4981 ui.write(_('parent: %d:%s ') % (p.rev(), p),
4982 4982 label=logcmdutil.changesetlabels(p))
4983 4983 ui.write(' '.join(p.tags()), label='log.tag')
4984 4984 if p.bookmarks():
4985 4985 marks.extend(p.bookmarks())
4986 4986 if p.rev() == -1:
4987 4987 if not len(repo):
4988 4988 ui.write(_(' (empty repository)'))
4989 4989 else:
4990 4990 ui.write(_(' (no revision checked out)'))
4991 4991 if p.obsolete():
4992 4992 ui.write(_(' (obsolete)'))
4993 4993 if p.isunstable():
4994 4994 instabilities = (ui.label(instability, 'trouble.%s' % instability)
4995 4995 for instability in p.instabilities())
4996 4996 ui.write(' ('
4997 4997 + ', '.join(instabilities)
4998 4998 + ')')
4999 4999 ui.write('\n')
5000 5000 if p.description():
5001 5001 ui.status(' ' + p.description().splitlines()[0].strip() + '\n',
5002 5002 label='log.summary')
5003 5003
5004 5004 branch = ctx.branch()
5005 5005 bheads = repo.branchheads(branch)
5006 5006 # i18n: column positioning for "hg summary"
5007 5007 m = _('branch: %s\n') % branch
5008 5008 if branch != 'default':
5009 5009 ui.write(m, label='log.branch')
5010 5010 else:
5011 5011 ui.status(m, label='log.branch')
5012 5012
5013 5013 if marks:
5014 5014 active = repo._activebookmark
5015 5015 # i18n: column positioning for "hg summary"
5016 5016 ui.write(_('bookmarks:'), label='log.bookmark')
5017 5017 if active is not None:
5018 5018 if active in marks:
5019 5019 ui.write(' *' + active, label=bookmarks.activebookmarklabel)
5020 5020 marks.remove(active)
5021 5021 else:
5022 5022 ui.write(' [%s]' % active, label=bookmarks.activebookmarklabel)
5023 5023 for m in marks:
5024 5024 ui.write(' ' + m, label='log.bookmark')
5025 5025 ui.write('\n', label='log.bookmark')
5026 5026
5027 5027 status = repo.status(unknown=True)
5028 5028
5029 5029 c = repo.dirstate.copies()
5030 5030 copied, renamed = [], []
5031 5031 for d, s in c.iteritems():
5032 5032 if s in status.removed:
5033 5033 status.removed.remove(s)
5034 5034 renamed.append(d)
5035 5035 else:
5036 5036 copied.append(d)
5037 5037 if d in status.added:
5038 5038 status.added.remove(d)
5039 5039
5040 5040 subs = [s for s in ctx.substate if ctx.sub(s).dirty()]
5041 5041
5042 5042 labels = [(ui.label(_('%d modified'), 'status.modified'), status.modified),
5043 5043 (ui.label(_('%d added'), 'status.added'), status.added),
5044 5044 (ui.label(_('%d removed'), 'status.removed'), status.removed),
5045 5045 (ui.label(_('%d renamed'), 'status.copied'), renamed),
5046 5046 (ui.label(_('%d copied'), 'status.copied'), copied),
5047 5047 (ui.label(_('%d deleted'), 'status.deleted'), status.deleted),
5048 5048 (ui.label(_('%d unknown'), 'status.unknown'), status.unknown),
5049 5049 (ui.label(_('%d unresolved'), 'resolve.unresolved'), unresolved),
5050 5050 (ui.label(_('%d subrepos'), 'status.modified'), subs)]
5051 5051 t = []
5052 5052 for l, s in labels:
5053 5053 if s:
5054 5054 t.append(l % len(s))
5055 5055
5056 5056 t = ', '.join(t)
5057 5057 cleanworkdir = False
5058 5058
5059 5059 if repo.vfs.exists('graftstate'):
5060 5060 t += _(' (graft in progress)')
5061 5061 if repo.vfs.exists('updatestate'):
5062 5062 t += _(' (interrupted update)')
5063 5063 elif len(parents) > 1:
5064 5064 t += _(' (merge)')
5065 5065 elif branch != parents[0].branch():
5066 5066 t += _(' (new branch)')
5067 5067 elif (parents[0].closesbranch() and
5068 5068 pnode in repo.branchheads(branch, closed=True)):
5069 5069 t += _(' (head closed)')
5070 5070 elif not (status.modified or status.added or status.removed or renamed or
5071 5071 copied or subs):
5072 5072 t += _(' (clean)')
5073 5073 cleanworkdir = True
5074 5074 elif pnode not in bheads:
5075 5075 t += _(' (new branch head)')
5076 5076
5077 5077 if parents:
5078 5078 pendingphase = max(p.phase() for p in parents)
5079 5079 else:
5080 5080 pendingphase = phases.public
5081 5081
5082 5082 if pendingphase > phases.newcommitphase(ui):
5083 5083 t += ' (%s)' % phases.phasenames[pendingphase]
5084 5084
5085 5085 if cleanworkdir:
5086 5086 # i18n: column positioning for "hg summary"
5087 5087 ui.status(_('commit: %s\n') % t.strip())
5088 5088 else:
5089 5089 # i18n: column positioning for "hg summary"
5090 5090 ui.write(_('commit: %s\n') % t.strip())
5091 5091
5092 5092 # all ancestors of branch heads - all ancestors of parent = new csets
5093 5093 new = len(repo.changelog.findmissing([pctx.node() for pctx in parents],
5094 5094 bheads))
5095 5095
5096 5096 if new == 0:
5097 5097 # i18n: column positioning for "hg summary"
5098 5098 ui.status(_('update: (current)\n'))
5099 5099 elif pnode not in bheads:
5100 5100 # i18n: column positioning for "hg summary"
5101 5101 ui.write(_('update: %d new changesets (update)\n') % new)
5102 5102 else:
5103 5103 # i18n: column positioning for "hg summary"
5104 5104 ui.write(_('update: %d new changesets, %d branch heads (merge)\n') %
5105 5105 (new, len(bheads)))
5106 5106
5107 5107 t = []
5108 5108 draft = len(repo.revs('draft()'))
5109 5109 if draft:
5110 5110 t.append(_('%d draft') % draft)
5111 5111 secret = len(repo.revs('secret()'))
5112 5112 if secret:
5113 5113 t.append(_('%d secret') % secret)
5114 5114
5115 5115 if draft or secret:
5116 5116 ui.status(_('phases: %s\n') % ', '.join(t))
5117 5117
5118 5118 if obsolete.isenabled(repo, obsolete.createmarkersopt):
5119 5119 for trouble in ("orphan", "contentdivergent", "phasedivergent"):
5120 5120 numtrouble = len(repo.revs(trouble + "()"))
5121 5121 # We write all the possibilities to ease translation
5122 5122 troublemsg = {
5123 5123 "orphan": _("orphan: %d changesets"),
5124 5124 "contentdivergent": _("content-divergent: %d changesets"),
5125 5125 "phasedivergent": _("phase-divergent: %d changesets"),
5126 5126 }
5127 5127 if numtrouble > 0:
5128 5128 ui.status(troublemsg[trouble] % numtrouble + "\n")
5129 5129
5130 5130 cmdutil.summaryhooks(ui, repo)
5131 5131
5132 5132 if opts.get('remote'):
5133 5133 needsincoming, needsoutgoing = True, True
5134 5134 else:
5135 5135 needsincoming, needsoutgoing = False, False
5136 5136 for i, o in cmdutil.summaryremotehooks(ui, repo, opts, None):
5137 5137 if i:
5138 5138 needsincoming = True
5139 5139 if o:
5140 5140 needsoutgoing = True
5141 5141 if not needsincoming and not needsoutgoing:
5142 5142 return
5143 5143
5144 5144 def getincoming():
5145 5145 source, branches = hg.parseurl(ui.expandpath('default'))
5146 5146 sbranch = branches[0]
5147 5147 try:
5148 5148 other = hg.peer(repo, {}, source)
5149 5149 except error.RepoError:
5150 5150 if opts.get('remote'):
5151 5151 raise
5152 5152 return source, sbranch, None, None, None
5153 5153 revs, checkout = hg.addbranchrevs(repo, other, branches, None)
5154 5154 if revs:
5155 5155 revs = [other.lookup(rev) for rev in revs]
5156 5156 ui.debug('comparing with %s\n' % util.hidepassword(source))
5157 5157 repo.ui.pushbuffer()
5158 5158 commoninc = discovery.findcommonincoming(repo, other, heads=revs)
5159 5159 repo.ui.popbuffer()
5160 5160 return source, sbranch, other, commoninc, commoninc[1]
5161 5161
5162 5162 if needsincoming:
5163 5163 source, sbranch, sother, commoninc, incoming = getincoming()
5164 5164 else:
5165 5165 source = sbranch = sother = commoninc = incoming = None
5166 5166
5167 5167 def getoutgoing():
5168 5168 dest, branches = hg.parseurl(ui.expandpath('default-push', 'default'))
5169 5169 dbranch = branches[0]
5170 5170 revs, checkout = hg.addbranchrevs(repo, repo, branches, None)
5171 5171 if source != dest:
5172 5172 try:
5173 5173 dother = hg.peer(repo, {}, dest)
5174 5174 except error.RepoError:
5175 5175 if opts.get('remote'):
5176 5176 raise
5177 5177 return dest, dbranch, None, None
5178 5178 ui.debug('comparing with %s\n' % util.hidepassword(dest))
5179 5179 elif sother is None:
5180 5180 # there is no explicit destination peer, but source one is invalid
5181 5181 return dest, dbranch, None, None
5182 5182 else:
5183 5183 dother = sother
5184 5184 if (source != dest or (sbranch is not None and sbranch != dbranch)):
5185 5185 common = None
5186 5186 else:
5187 5187 common = commoninc
5188 5188 if revs:
5189 5189 revs = [repo.lookup(rev) for rev in revs]
5190 5190 repo.ui.pushbuffer()
5191 5191 outgoing = discovery.findcommonoutgoing(repo, dother, onlyheads=revs,
5192 5192 commoninc=common)
5193 5193 repo.ui.popbuffer()
5194 5194 return dest, dbranch, dother, outgoing
5195 5195
5196 5196 if needsoutgoing:
5197 5197 dest, dbranch, dother, outgoing = getoutgoing()
5198 5198 else:
5199 5199 dest = dbranch = dother = outgoing = None
5200 5200
5201 5201 if opts.get('remote'):
5202 5202 t = []
5203 5203 if incoming:
5204 5204 t.append(_('1 or more incoming'))
5205 5205 o = outgoing.missing
5206 5206 if o:
5207 5207 t.append(_('%d outgoing') % len(o))
5208 5208 other = dother or sother
5209 5209 if 'bookmarks' in other.listkeys('namespaces'):
5210 5210 counts = bookmarks.summary(repo, other)
5211 5211 if counts[0] > 0:
5212 5212 t.append(_('%d incoming bookmarks') % counts[0])
5213 5213 if counts[1] > 0:
5214 5214 t.append(_('%d outgoing bookmarks') % counts[1])
5215 5215
5216 5216 if t:
5217 5217 # i18n: column positioning for "hg summary"
5218 5218 ui.write(_('remote: %s\n') % (', '.join(t)))
5219 5219 else:
5220 5220 # i18n: column positioning for "hg summary"
5221 5221 ui.status(_('remote: (synced)\n'))
5222 5222
5223 5223 cmdutil.summaryremotehooks(ui, repo, opts,
5224 5224 ((source, sbranch, sother, commoninc),
5225 5225 (dest, dbranch, dother, outgoing)))
5226 5226
5227 5227 @command('tag',
5228 5228 [('f', 'force', None, _('force tag')),
5229 5229 ('l', 'local', None, _('make the tag local')),
5230 5230 ('r', 'rev', '', _('revision to tag'), _('REV')),
5231 5231 ('', 'remove', None, _('remove a tag')),
5232 5232 # -l/--local is already there, commitopts cannot be used
5233 5233 ('e', 'edit', None, _('invoke editor on commit messages')),
5234 5234 ('m', 'message', '', _('use text as commit message'), _('TEXT')),
5235 5235 ] + commitopts2,
5236 5236 _('[-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] NAME...'))
5237 5237 def tag(ui, repo, name1, *names, **opts):
5238 5238 """add one or more tags for the current or given revision
5239 5239
5240 5240 Name a particular revision using <name>.
5241 5241
5242 5242 Tags are used to name particular revisions of the repository and are
5243 5243 very useful to compare different revisions, to go back to significant
5244 5244 earlier versions or to mark branch points as releases, etc. Changing
5245 5245 an existing tag is normally disallowed; use -f/--force to override.
5246 5246
5247 5247 If no revision is given, the parent of the working directory is
5248 5248 used.
5249 5249
5250 5250 To facilitate version control, distribution, and merging of tags,
5251 5251 they are stored as a file named ".hgtags" which is managed similarly
5252 5252 to other project files and can be hand-edited if necessary. This
5253 5253 also means that tagging creates a new commit. The file
5254 5254 ".hg/localtags" is used for local tags (not shared among
5255 5255 repositories).
5256 5256
5257 5257 Tag commits are usually made at the head of a branch. If the parent
5258 5258 of the working directory is not a branch head, :hg:`tag` aborts; use
5259 5259 -f/--force to force the tag commit to be based on a non-head
5260 5260 changeset.
5261 5261
5262 5262 See :hg:`help dates` for a list of formats valid for -d/--date.
5263 5263
5264 5264 Since tag names have priority over branch names during revision
5265 5265 lookup, using an existing branch name as a tag name is discouraged.
5266 5266
5267 5267 Returns 0 on success.
5268 5268 """
5269 5269 opts = pycompat.byteskwargs(opts)
5270 5270 wlock = lock = None
5271 5271 try:
5272 5272 wlock = repo.wlock()
5273 5273 lock = repo.lock()
5274 5274 rev_ = "."
5275 5275 names = [t.strip() for t in (name1,) + names]
5276 5276 if len(names) != len(set(names)):
5277 5277 raise error.Abort(_('tag names must be unique'))
5278 5278 for n in names:
5279 5279 scmutil.checknewlabel(repo, n, 'tag')
5280 5280 if not n:
5281 5281 raise error.Abort(_('tag names cannot consist entirely of '
5282 5282 'whitespace'))
5283 5283 if opts.get('rev') and opts.get('remove'):
5284 5284 raise error.Abort(_("--rev and --remove are incompatible"))
5285 5285 if opts.get('rev'):
5286 5286 rev_ = opts['rev']
5287 5287 message = opts.get('message')
5288 5288 if opts.get('remove'):
5289 5289 if opts.get('local'):
5290 5290 expectedtype = 'local'
5291 5291 else:
5292 5292 expectedtype = 'global'
5293 5293
5294 5294 for n in names:
5295 5295 if not repo.tagtype(n):
5296 5296 raise error.Abort(_("tag '%s' does not exist") % n)
5297 5297 if repo.tagtype(n) != expectedtype:
5298 5298 if expectedtype == 'global':
5299 5299 raise error.Abort(_("tag '%s' is not a global tag") % n)
5300 5300 else:
5301 5301 raise error.Abort(_("tag '%s' is not a local tag") % n)
5302 5302 rev_ = 'null'
5303 5303 if not message:
5304 5304 # we don't translate commit messages
5305 5305 message = 'Removed tag %s' % ', '.join(names)
5306 5306 elif not opts.get('force'):
5307 5307 for n in names:
5308 5308 if n in repo.tags():
5309 5309 raise error.Abort(_("tag '%s' already exists "
5310 5310 "(use -f to force)") % n)
5311 5311 if not opts.get('local'):
5312 5312 p1, p2 = repo.dirstate.parents()
5313 5313 if p2 != nullid:
5314 5314 raise error.Abort(_('uncommitted merge'))
5315 5315 bheads = repo.branchheads()
5316 5316 if not opts.get('force') and bheads and p1 not in bheads:
5317 5317 raise error.Abort(_('working directory is not at a branch head '
5318 5318 '(use -f to force)'))
5319 5319 r = scmutil.revsingle(repo, rev_).node()
5320 5320
5321 5321 if not message:
5322 5322 # we don't translate commit messages
5323 5323 message = ('Added tag %s for changeset %s' %
5324 5324 (', '.join(names), short(r)))
5325 5325
5326 5326 date = opts.get('date')
5327 5327 if date:
5328 5328 date = util.parsedate(date)
5329 5329
5330 5330 if opts.get('remove'):
5331 5331 editform = 'tag.remove'
5332 5332 else:
5333 5333 editform = 'tag.add'
5334 5334 editor = cmdutil.getcommiteditor(editform=editform,
5335 5335 **pycompat.strkwargs(opts))
5336 5336
5337 5337 # don't allow tagging the null rev
5338 5338 if (not opts.get('remove') and
5339 5339 scmutil.revsingle(repo, rev_).rev() == nullrev):
5340 5340 raise error.Abort(_("cannot tag null revision"))
5341 5341
5342 5342 tagsmod.tag(repo, names, r, message, opts.get('local'),
5343 5343 opts.get('user'), date, editor=editor)
5344 5344 finally:
5345 5345 release(lock, wlock)
5346 5346
5347 5347 @command('tags', formatteropts, '', cmdtype=readonly)
5348 5348 def tags(ui, repo, **opts):
5349 5349 """list repository tags
5350 5350
5351 5351 This lists both regular and local tags. When the -v/--verbose
5352 5352 switch is used, a third column "local" is printed for local tags.
5353 5353 When the -q/--quiet switch is used, only the tag name is printed.
5354 5354
5355 5355 Returns 0 on success.
5356 5356 """
5357 5357
5358 5358 opts = pycompat.byteskwargs(opts)
5359 5359 ui.pager('tags')
5360 5360 fm = ui.formatter('tags', opts)
5361 5361 hexfunc = fm.hexfunc
5362 5362 tagtype = ""
5363 5363
5364 5364 for t, n in reversed(repo.tagslist()):
5365 5365 hn = hexfunc(n)
5366 5366 label = 'tags.normal'
5367 5367 tagtype = ''
5368 5368 if repo.tagtype(t) == 'local':
5369 5369 label = 'tags.local'
5370 5370 tagtype = 'local'
5371 5371
5372 5372 fm.startitem()
5373 5373 fm.write('tag', '%s', t, label=label)
5374 5374 fmt = " " * (30 - encoding.colwidth(t)) + ' %5d:%s'
5375 5375 fm.condwrite(not ui.quiet, 'rev node', fmt,
5376 5376 repo.changelog.rev(n), hn, label=label)
5377 5377 fm.condwrite(ui.verbose and tagtype, 'type', ' %s',
5378 5378 tagtype, label=label)
5379 5379 fm.plain('\n')
5380 5380 fm.end()
5381 5381
5382 5382 @command('tip',
5383 5383 [('p', 'patch', None, _('show patch')),
5384 5384 ('g', 'git', None, _('use git extended diff format')),
5385 5385 ] + templateopts,
5386 5386 _('[-p] [-g]'))
5387 5387 def tip(ui, repo, **opts):
5388 5388 """show the tip revision (DEPRECATED)
5389 5389
5390 5390 The tip revision (usually just called the tip) is the changeset
5391 5391 most recently added to the repository (and therefore the most
5392 5392 recently changed head).
5393 5393
5394 5394 If you have just made a commit, that commit will be the tip. If
5395 5395 you have just pulled changes from another repository, the tip of
5396 5396 that repository becomes the current tip. The "tip" tag is special
5397 5397 and cannot be renamed or assigned to a different changeset.
5398 5398
5399 5399 This command is deprecated, please use :hg:`heads` instead.
5400 5400
5401 5401 Returns 0 on success.
5402 5402 """
5403 5403 opts = pycompat.byteskwargs(opts)
5404 5404 displayer = logcmdutil.changesetdisplayer(ui, repo, opts)
5405 5405 displayer.show(repo['tip'])
5406 5406 displayer.close()
5407 5407
5408 5408 @command('unbundle',
5409 5409 [('u', 'update', None,
5410 5410 _('update to new branch head if changesets were unbundled'))],
5411 5411 _('[-u] FILE...'))
5412 5412 def unbundle(ui, repo, fname1, *fnames, **opts):
5413 5413 """apply one or more bundle files
5414 5414
5415 5415 Apply one or more bundle files generated by :hg:`bundle`.
5416 5416
5417 5417 Returns 0 on success, 1 if an update has unresolved files.
5418 5418 """
5419 5419 fnames = (fname1,) + fnames
5420 5420
5421 5421 with repo.lock():
5422 5422 for fname in fnames:
5423 5423 f = hg.openpath(ui, fname)
5424 5424 gen = exchange.readbundle(ui, f, fname)
5425 5425 if isinstance(gen, streamclone.streamcloneapplier):
5426 5426 raise error.Abort(
5427 5427 _('packed bundles cannot be applied with '
5428 5428 '"hg unbundle"'),
5429 5429 hint=_('use "hg debugapplystreamclonebundle"'))
5430 5430 url = 'bundle:' + fname
5431 5431 try:
5432 5432 txnname = 'unbundle'
5433 5433 if not isinstance(gen, bundle2.unbundle20):
5434 5434 txnname = 'unbundle\n%s' % util.hidepassword(url)
5435 5435 with repo.transaction(txnname) as tr:
5436 5436 op = bundle2.applybundle(repo, gen, tr, source='unbundle',
5437 5437 url=url)
5438 5438 except error.BundleUnknownFeatureError as exc:
5439 5439 raise error.Abort(
5440 5440 _('%s: unknown bundle feature, %s') % (fname, exc),
5441 5441 hint=_("see https://mercurial-scm.org/"
5442 5442 "wiki/BundleFeature for more "
5443 5443 "information"))
5444 5444 modheads = bundle2.combinechangegroupresults(op)
5445 5445
5446 5446 return postincoming(ui, repo, modheads, opts.get(r'update'), None, None)
5447 5447
5448 5448 @command('^update|up|checkout|co',
5449 5449 [('C', 'clean', None, _('discard uncommitted changes (no backup)')),
5450 5450 ('c', 'check', None, _('require clean working directory')),
5451 5451 ('m', 'merge', None, _('merge uncommitted changes')),
5452 5452 ('d', 'date', '', _('tipmost revision matching date'), _('DATE')),
5453 5453 ('r', 'rev', '', _('revision'), _('REV'))
5454 5454 ] + mergetoolopts,
5455 5455 _('[-C|-c|-m] [-d DATE] [[-r] REV]'))
5456 5456 def update(ui, repo, node=None, rev=None, clean=False, date=None, check=False,
5457 5457 merge=None, tool=None):
5458 5458 """update working directory (or switch revisions)
5459 5459
5460 5460 Update the repository's working directory to the specified
5461 5461 changeset. If no changeset is specified, update to the tip of the
5462 5462 current named branch and move the active bookmark (see :hg:`help
5463 5463 bookmarks`).
5464 5464
5465 5465 Update sets the working directory's parent revision to the specified
5466 5466 changeset (see :hg:`help parents`).
5467 5467
5468 5468 If the changeset is not a descendant or ancestor of the working
5469 5469 directory's parent and there are uncommitted changes, the update is
5470 5470 aborted. With the -c/--check option, the working directory is checked
5471 5471 for uncommitted changes; if none are found, the working directory is
5472 5472 updated to the specified changeset.
5473 5473
5474 5474 .. container:: verbose
5475 5475
5476 5476 The -C/--clean, -c/--check, and -m/--merge options control what
5477 5477 happens if the working directory contains uncommitted changes.
5478 5478 At most of one of them can be specified.
5479 5479
5480 5480 1. If no option is specified, and if
5481 5481 the requested changeset is an ancestor or descendant of
5482 5482 the working directory's parent, the uncommitted changes
5483 5483 are merged into the requested changeset and the merged
5484 5484 result is left uncommitted. If the requested changeset is
5485 5485 not an ancestor or descendant (that is, it is on another
5486 5486 branch), the update is aborted and the uncommitted changes
5487 5487 are preserved.
5488 5488
5489 5489 2. With the -m/--merge option, the update is allowed even if the
5490 5490 requested changeset is not an ancestor or descendant of
5491 5491 the working directory's parent.
5492 5492
5493 5493 3. With the -c/--check option, the update is aborted and the
5494 5494 uncommitted changes are preserved.
5495 5495
5496 5496 4. With the -C/--clean option, uncommitted changes are discarded and
5497 5497 the working directory is updated to the requested changeset.
5498 5498
5499 5499 To cancel an uncommitted merge (and lose your changes), use
5500 5500 :hg:`merge --abort`.
5501 5501
5502 5502 Use null as the changeset to remove the working directory (like
5503 5503 :hg:`clone -U`).
5504 5504
5505 5505 If you want to revert just one file to an older revision, use
5506 5506 :hg:`revert [-r REV] NAME`.
5507 5507
5508 5508 See :hg:`help dates` for a list of formats valid for -d/--date.
5509 5509
5510 5510 Returns 0 on success, 1 if there are unresolved files.
5511 5511 """
5512 5512 if rev and node:
5513 5513 raise error.Abort(_("please specify just one revision"))
5514 5514
5515 5515 if ui.configbool('commands', 'update.requiredest'):
5516 5516 if not node and not rev and not date:
5517 5517 raise error.Abort(_('you must specify a destination'),
5518 5518 hint=_('for example: hg update ".::"'))
5519 5519
5520 5520 if rev is None or rev == '':
5521 5521 rev = node
5522 5522
5523 5523 if date and rev is not None:
5524 5524 raise error.Abort(_("you can't specify a revision and a date"))
5525 5525
5526 5526 if len([x for x in (clean, check, merge) if x]) > 1:
5527 5527 raise error.Abort(_("can only specify one of -C/--clean, -c/--check, "
5528 5528 "or -m/--merge"))
5529 5529
5530 5530 updatecheck = None
5531 5531 if check:
5532 5532 updatecheck = 'abort'
5533 5533 elif merge:
5534 5534 updatecheck = 'none'
5535 5535
5536 5536 with repo.wlock():
5537 5537 cmdutil.clearunfinished(repo)
5538 5538
5539 5539 if date:
5540 5540 rev = cmdutil.finddate(ui, repo, date)
5541 5541
5542 5542 # if we defined a bookmark, we have to remember the original name
5543 5543 brev = rev
5544 5544 if rev:
5545 5545 repo = scmutil.unhidehashlikerevs(repo, [rev], 'nowarn')
5546 5546 ctx = scmutil.revsingle(repo, rev, rev)
5547 5547 rev = ctx.rev()
5548 5548 if ctx.hidden():
5549 5549 ctxstr = ctx.hex()[:12]
5550 5550 ui.warn(_("updating to a hidden changeset %s\n") % ctxstr)
5551 5551
5552 5552 if ctx.obsolete():
5553 5553 obsfatemsg = obsutil._getfilteredreason(repo, ctxstr, ctx)
5554 5554 ui.warn("(%s)\n" % obsfatemsg)
5555 5555
5556 5556 repo.ui.setconfig('ui', 'forcemerge', tool, 'update')
5557 5557
5558 5558 return hg.updatetotally(ui, repo, rev, brev, clean=clean,
5559 5559 updatecheck=updatecheck)
5560 5560
5561 5561 @command('verify', [])
5562 5562 def verify(ui, repo):
5563 5563 """verify the integrity of the repository
5564 5564
5565 5565 Verify the integrity of the current repository.
5566 5566
5567 5567 This will perform an extensive check of the repository's
5568 5568 integrity, validating the hashes and checksums of each entry in
5569 5569 the changelog, manifest, and tracked files, as well as the
5570 5570 integrity of their crosslinks and indices.
5571 5571
5572 5572 Please see https://mercurial-scm.org/wiki/RepositoryCorruption
5573 5573 for more information about recovery from corruption of the
5574 5574 repository.
5575 5575
5576 5576 Returns 0 on success, 1 if errors are encountered.
5577 5577 """
5578 5578 return hg.verify(repo)
5579 5579
5580 5580 @command('version', [] + formatteropts, norepo=True, cmdtype=readonly)
5581 5581 def version_(ui, **opts):
5582 5582 """output version and copyright information"""
5583 5583 opts = pycompat.byteskwargs(opts)
5584 5584 if ui.verbose:
5585 5585 ui.pager('version')
5586 5586 fm = ui.formatter("version", opts)
5587 5587 fm.startitem()
5588 5588 fm.write("ver", _("Mercurial Distributed SCM (version %s)\n"),
5589 5589 util.version())
5590 5590 license = _(
5591 5591 "(see https://mercurial-scm.org for more information)\n"
5592 5592 "\nCopyright (C) 2005-2018 Matt Mackall and others\n"
5593 5593 "This is free software; see the source for copying conditions. "
5594 5594 "There is NO\nwarranty; "
5595 5595 "not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n"
5596 5596 )
5597 5597 if not ui.quiet:
5598 5598 fm.plain(license)
5599 5599
5600 5600 if ui.verbose:
5601 5601 fm.plain(_("\nEnabled extensions:\n\n"))
5602 5602 # format names and versions into columns
5603 5603 names = []
5604 5604 vers = []
5605 5605 isinternals = []
5606 5606 for name, module in extensions.extensions():
5607 5607 names.append(name)
5608 5608 vers.append(extensions.moduleversion(module) or None)
5609 5609 isinternals.append(extensions.ismoduleinternal(module))
5610 5610 fn = fm.nested("extensions")
5611 5611 if names:
5612 5612 namefmt = " %%-%ds " % max(len(n) for n in names)
5613 5613 places = [_("external"), _("internal")]
5614 5614 for n, v, p in zip(names, vers, isinternals):
5615 5615 fn.startitem()
5616 5616 fn.condwrite(ui.verbose, "name", namefmt, n)
5617 5617 if ui.verbose:
5618 5618 fn.plain("%s " % places[p])
5619 5619 fn.data(bundled=p)
5620 5620 fn.condwrite(ui.verbose and v, "ver", "%s", v)
5621 5621 if ui.verbose:
5622 5622 fn.plain("\n")
5623 5623 fn.end()
5624 5624 fm.end()
5625 5625
5626 5626 def loadcmdtable(ui, name, cmdtable):
5627 5627 """Load command functions from specified cmdtable
5628 5628 """
5629 5629 overrides = [cmd for cmd in cmdtable if cmd in table]
5630 5630 if overrides:
5631 5631 ui.warn(_("extension '%s' overrides commands: %s\n")
5632 5632 % (name, " ".join(overrides)))
5633 5633 table.update(cmdtable)
@@ -1,946 +1,940 b''
1 1 # logcmdutil.py - utility for log-like commands
2 2 #
3 3 # Copyright 2005-2007 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 from __future__ import absolute_import
9 9
10 10 import itertools
11 11 import os
12 12
13 13 from .i18n import _
14 14 from .node import (
15 15 hex,
16 16 nullid,
17 17 )
18 18
19 19 from . import (
20 20 dagop,
21 21 encoding,
22 22 error,
23 23 formatter,
24 24 graphmod,
25 25 match as matchmod,
26 26 mdiff,
27 27 patch,
28 28 pathutil,
29 29 pycompat,
30 30 revset,
31 31 revsetlang,
32 32 scmutil,
33 33 smartset,
34 34 templatekw,
35 35 templater,
36 36 util,
37 37 )
38 38
39 39 def getlimit(opts):
40 40 """get the log limit according to option -l/--limit"""
41 41 limit = opts.get('limit')
42 42 if limit:
43 43 try:
44 44 limit = int(limit)
45 45 except ValueError:
46 46 raise error.Abort(_('limit must be a positive integer'))
47 47 if limit <= 0:
48 48 raise error.Abort(_('limit must be positive'))
49 49 else:
50 50 limit = None
51 51 return limit
52 52
53 53 def diffordiffstat(ui, repo, diffopts, node1, node2, match,
54 54 changes=None, stat=False, fp=None, prefix='',
55 55 root='', listsubrepos=False, hunksfilterfn=None):
56 56 '''show diff or diffstat.'''
57 57 if fp is None:
58 58 write = ui.write
59 59 else:
60 60 def write(s, **kw):
61 61 fp.write(s)
62 62
63 63 if root:
64 64 relroot = pathutil.canonpath(repo.root, repo.getcwd(), root)
65 65 else:
66 66 relroot = ''
67 67 if relroot != '':
68 68 # XXX relative roots currently don't work if the root is within a
69 69 # subrepo
70 70 uirelroot = match.uipath(relroot)
71 71 relroot += '/'
72 72 for matchroot in match.files():
73 73 if not matchroot.startswith(relroot):
74 74 ui.warn(_('warning: %s not inside relative root %s\n') % (
75 75 match.uipath(matchroot), uirelroot))
76 76
77 77 if stat:
78 78 diffopts = diffopts.copy(context=0, noprefix=False)
79 79 width = 80
80 80 if not ui.plain():
81 81 width = ui.termwidth()
82 82
83 83 chunks = patch.diff(repo, node1, node2, match, changes, opts=diffopts,
84 84 prefix=prefix, relroot=relroot,
85 85 hunksfilterfn=hunksfilterfn)
86 86
87 87 if fp is not None or ui.canwritewithoutlabels():
88 88 if stat:
89 89 chunks = patch.diffstat(util.iterlines(chunks), width=width)
90 90 for chunk in util.filechunkiter(util.chunkbuffer(chunks)):
91 91 write(chunk)
92 92 else:
93 93 if stat:
94 94 chunks = patch.diffstatui(util.iterlines(chunks), width=width)
95 95 else:
96 96 chunks = patch.difflabel(lambda chunks, **kwargs: chunks, chunks,
97 97 opts=diffopts)
98 98 if ui.canbatchlabeledwrites():
99 99 def gen():
100 100 for chunk, label in chunks:
101 101 yield ui.label(chunk, label=label)
102 102 for chunk in util.filechunkiter(util.chunkbuffer(gen())):
103 103 write(chunk)
104 104 else:
105 105 for chunk, label in chunks:
106 106 write(chunk, label=label)
107 107
108 108 if listsubrepos:
109 109 ctx1 = repo[node1]
110 110 ctx2 = repo[node2]
111 111 for subpath, sub in scmutil.itersubrepos(ctx1, ctx2):
112 112 tempnode2 = node2
113 113 try:
114 114 if node2 is not None:
115 115 tempnode2 = ctx2.substate[subpath][1]
116 116 except KeyError:
117 117 # A subrepo that existed in node1 was deleted between node1 and
118 118 # node2 (inclusive). Thus, ctx2's substate won't contain that
119 119 # subpath. The best we can do is to ignore it.
120 120 tempnode2 = None
121 121 submatch = matchmod.subdirmatcher(subpath, match)
122 122 sub.diff(ui, diffopts, tempnode2, submatch, changes=changes,
123 123 stat=stat, fp=fp, prefix=prefix)
124 124
125 125 def changesetlabels(ctx):
126 126 labels = ['log.changeset', 'changeset.%s' % ctx.phasestr()]
127 127 if ctx.obsolete():
128 128 labels.append('changeset.obsolete')
129 129 if ctx.isunstable():
130 130 labels.append('changeset.unstable')
131 131 for instability in ctx.instabilities():
132 132 labels.append('instability.%s' % instability)
133 133 return ' '.join(labels)
134 134
135 135 class changesetprinter(object):
136 136 '''show changeset information when templating not requested.'''
137 137
138 138 def __init__(self, ui, repo, makefilematcher=None, makehunksfilter=None,
139 139 diffopts=None, buffered=False):
140 140 self.ui = ui
141 141 self.repo = repo
142 142 self.buffered = buffered
143 143 self._makefilematcher = makefilematcher or (lambda ctx: None)
144 144 self._makehunksfilter = makehunksfilter or (lambda ctx: None)
145 145 self.diffopts = diffopts or {}
146 146 self.header = {}
147 147 self.hunk = {}
148 148 self.lastheader = None
149 149 self.footer = None
150 150 self._columns = templatekw.getlogcolumns()
151 151
152 152 def flush(self, ctx):
153 153 rev = ctx.rev()
154 154 if rev in self.header:
155 155 h = self.header[rev]
156 156 if h != self.lastheader:
157 157 self.lastheader = h
158 158 self.ui.write(h)
159 159 del self.header[rev]
160 160 if rev in self.hunk:
161 161 self.ui.write(self.hunk[rev])
162 162 del self.hunk[rev]
163 163
164 164 def close(self):
165 165 if self.footer:
166 166 self.ui.write(self.footer)
167 167
168 168 def show(self, ctx, copies=None, **props):
169 169 props = pycompat.byteskwargs(props)
170 170 if self.buffered:
171 171 self.ui.pushbuffer(labeled=True)
172 172 self._show(ctx, copies, props)
173 173 self.hunk[ctx.rev()] = self.ui.popbuffer()
174 174 else:
175 175 self._show(ctx, copies, props)
176 176
177 177 def _show(self, ctx, copies, props):
178 178 '''show a single changeset or file revision'''
179 179 changenode = ctx.node()
180 180 rev = ctx.rev()
181 181
182 182 if self.ui.quiet:
183 183 self.ui.write("%s\n" % scmutil.formatchangeid(ctx),
184 184 label='log.node')
185 185 return
186 186
187 187 columns = self._columns
188 188 self.ui.write(columns['changeset'] % scmutil.formatchangeid(ctx),
189 189 label=changesetlabels(ctx))
190 190
191 191 # branches are shown first before any other names due to backwards
192 192 # compatibility
193 193 branch = ctx.branch()
194 194 # don't show the default branch name
195 195 if branch != 'default':
196 196 self.ui.write(columns['branch'] % branch, label='log.branch')
197 197
198 198 for nsname, ns in self.repo.names.iteritems():
199 199 # branches has special logic already handled above, so here we just
200 200 # skip it
201 201 if nsname == 'branches':
202 202 continue
203 203 # we will use the templatename as the color name since those two
204 204 # should be the same
205 205 for name in ns.names(self.repo, changenode):
206 206 self.ui.write(ns.logfmt % name,
207 207 label='log.%s' % ns.colorname)
208 208 if self.ui.debugflag:
209 209 self.ui.write(columns['phase'] % ctx.phasestr(), label='log.phase')
210 210 for pctx in scmutil.meaningfulparents(self.repo, ctx):
211 211 label = 'log.parent changeset.%s' % pctx.phasestr()
212 212 self.ui.write(columns['parent'] % scmutil.formatchangeid(pctx),
213 213 label=label)
214 214
215 215 if self.ui.debugflag and rev is not None:
216 216 mnode = ctx.manifestnode()
217 217 mrev = self.repo.manifestlog._revlog.rev(mnode)
218 218 self.ui.write(columns['manifest']
219 219 % scmutil.formatrevnode(self.ui, mrev, mnode),
220 220 label='ui.debug log.manifest')
221 221 self.ui.write(columns['user'] % ctx.user(), label='log.user')
222 222 self.ui.write(columns['date'] % util.datestr(ctx.date()),
223 223 label='log.date')
224 224
225 225 if ctx.isunstable():
226 226 instabilities = ctx.instabilities()
227 227 self.ui.write(columns['instability'] % ', '.join(instabilities),
228 228 label='log.instability')
229 229
230 230 elif ctx.obsolete():
231 231 self._showobsfate(ctx)
232 232
233 233 self._exthook(ctx)
234 234
235 235 if self.ui.debugflag:
236 236 files = ctx.p1().status(ctx)[:3]
237 237 for key, value in zip(['files', 'files+', 'files-'], files):
238 238 if value:
239 239 self.ui.write(columns[key] % " ".join(value),
240 240 label='ui.debug log.files')
241 241 elif ctx.files() and self.ui.verbose:
242 242 self.ui.write(columns['files'] % " ".join(ctx.files()),
243 243 label='ui.note log.files')
244 244 if copies and self.ui.verbose:
245 245 copies = ['%s (%s)' % c for c in copies]
246 246 self.ui.write(columns['copies'] % ' '.join(copies),
247 247 label='ui.note log.copies')
248 248
249 249 extra = ctx.extra()
250 250 if extra and self.ui.debugflag:
251 251 for key, value in sorted(extra.items()):
252 252 self.ui.write(columns['extra'] % (key, util.escapestr(value)),
253 253 label='ui.debug log.extra')
254 254
255 255 description = ctx.description().strip()
256 256 if description:
257 257 if self.ui.verbose:
258 258 self.ui.write(_("description:\n"),
259 259 label='ui.note log.description')
260 260 self.ui.write(description,
261 261 label='ui.note log.description')
262 262 self.ui.write("\n\n")
263 263 else:
264 264 self.ui.write(columns['summary'] % description.splitlines()[0],
265 265 label='log.summary')
266 266 self.ui.write("\n")
267 267
268 268 self._showpatch(ctx)
269 269
270 270 def _showobsfate(self, ctx):
271 271 obsfate = templatekw.showobsfate(repo=self.repo, ctx=ctx, ui=self.ui)
272 272
273 273 if obsfate:
274 274 for obsfateline in obsfate:
275 275 self.ui.write(self._columns['obsolete'] % obsfateline,
276 276 label='log.obsfate')
277 277
278 278 def _exthook(self, ctx):
279 279 '''empty method used by extension as a hook point
280 280 '''
281 281
282 282 def _showpatch(self, ctx):
283 283 matchfn = self._makefilematcher(ctx)
284 284 hunksfilterfn = self._makehunksfilter(ctx)
285 285 if not matchfn:
286 286 return
287 287 stat = self.diffopts.get('stat')
288 288 diff = self.diffopts.get('patch')
289 289 diffopts = patch.diffallopts(self.ui, self.diffopts)
290 290 node = ctx.node()
291 291 prev = ctx.p1().node()
292 292 if stat:
293 293 diffordiffstat(self.ui, self.repo, diffopts, prev, node,
294 294 match=matchfn, stat=True,
295 295 hunksfilterfn=hunksfilterfn)
296 296 if stat and diff:
297 297 self.ui.write("\n")
298 298 if diff:
299 299 diffordiffstat(self.ui, self.repo, diffopts, prev, node,
300 300 match=matchfn, stat=False,
301 301 hunksfilterfn=hunksfilterfn)
302 302 if stat or diff:
303 303 self.ui.write("\n")
304 304
305 305 class jsonchangeset(changesetprinter):
306 306 '''format changeset information.'''
307 307
308 308 def __init__(self, ui, repo, makefilematcher=None, makehunksfilter=None,
309 309 diffopts=None, buffered=False):
310 310 changesetprinter.__init__(self, ui, repo, makefilematcher,
311 311 makehunksfilter, diffopts, buffered)
312 312 self.cache = {}
313 313 self._first = True
314 314
315 315 def close(self):
316 316 if not self._first:
317 317 self.ui.write("\n]\n")
318 318 else:
319 319 self.ui.write("[]\n")
320 320
321 321 def _show(self, ctx, copies, props):
322 322 '''show a single changeset or file revision'''
323 323 rev = ctx.rev()
324 324 if rev is None:
325 325 jrev = jnode = 'null'
326 326 else:
327 327 jrev = '%d' % rev
328 328 jnode = '"%s"' % hex(ctx.node())
329 329 j = encoding.jsonescape
330 330
331 331 if self._first:
332 332 self.ui.write("[\n {")
333 333 self._first = False
334 334 else:
335 335 self.ui.write(",\n {")
336 336
337 337 if self.ui.quiet:
338 338 self.ui.write(('\n "rev": %s') % jrev)
339 339 self.ui.write((',\n "node": %s') % jnode)
340 340 self.ui.write('\n }')
341 341 return
342 342
343 343 self.ui.write(('\n "rev": %s') % jrev)
344 344 self.ui.write((',\n "node": %s') % jnode)
345 345 self.ui.write((',\n "branch": "%s"') % j(ctx.branch()))
346 346 self.ui.write((',\n "phase": "%s"') % ctx.phasestr())
347 347 self.ui.write((',\n "user": "%s"') % j(ctx.user()))
348 348 self.ui.write((',\n "date": [%d, %d]') % ctx.date())
349 349 self.ui.write((',\n "desc": "%s"') % j(ctx.description()))
350 350
351 351 self.ui.write((',\n "bookmarks": [%s]') %
352 352 ", ".join('"%s"' % j(b) for b in ctx.bookmarks()))
353 353 self.ui.write((',\n "tags": [%s]') %
354 354 ", ".join('"%s"' % j(t) for t in ctx.tags()))
355 355 self.ui.write((',\n "parents": [%s]') %
356 356 ", ".join('"%s"' % c.hex() for c in ctx.parents()))
357 357
358 358 if self.ui.debugflag:
359 359 if rev is None:
360 360 jmanifestnode = 'null'
361 361 else:
362 362 jmanifestnode = '"%s"' % hex(ctx.manifestnode())
363 363 self.ui.write((',\n "manifest": %s') % jmanifestnode)
364 364
365 365 self.ui.write((',\n "extra": {%s}') %
366 366 ", ".join('"%s": "%s"' % (j(k), j(v))
367 367 for k, v in ctx.extra().items()))
368 368
369 369 files = ctx.p1().status(ctx)
370 370 self.ui.write((',\n "modified": [%s]') %
371 371 ", ".join('"%s"' % j(f) for f in files[0]))
372 372 self.ui.write((',\n "added": [%s]') %
373 373 ", ".join('"%s"' % j(f) for f in files[1]))
374 374 self.ui.write((',\n "removed": [%s]') %
375 375 ", ".join('"%s"' % j(f) for f in files[2]))
376 376
377 377 elif self.ui.verbose:
378 378 self.ui.write((',\n "files": [%s]') %
379 379 ", ".join('"%s"' % j(f) for f in ctx.files()))
380 380
381 381 if copies:
382 382 self.ui.write((',\n "copies": {%s}') %
383 383 ", ".join('"%s": "%s"' % (j(k), j(v))
384 384 for k, v in copies))
385 385
386 386 matchfn = self._makefilematcher(ctx)
387 387 stat = self.diffopts.get('stat')
388 388 diff = self.diffopts.get('patch')
389 389 diffopts = patch.difffeatureopts(self.ui, self.diffopts, git=True)
390 390 node, prev = ctx.node(), ctx.p1().node()
391 391 if matchfn and stat:
392 392 self.ui.pushbuffer()
393 393 diffordiffstat(self.ui, self.repo, diffopts, prev, node,
394 394 match=matchfn, stat=True)
395 395 self.ui.write((',\n "diffstat": "%s"')
396 396 % j(self.ui.popbuffer()))
397 397 if matchfn and diff:
398 398 self.ui.pushbuffer()
399 399 diffordiffstat(self.ui, self.repo, diffopts, prev, node,
400 400 match=matchfn, stat=False)
401 401 self.ui.write((',\n "diff": "%s"') % j(self.ui.popbuffer()))
402 402
403 403 self.ui.write("\n }")
404 404
405 405 class changesettemplater(changesetprinter):
406 406 '''format changeset information.
407 407
408 408 Note: there are a variety of convenience functions to build a
409 409 changesettemplater for common cases. See functions such as:
410 410 maketemplater, changesetdisplayer, buildcommittemplate, or other
411 411 functions that use changesest_templater.
412 412 '''
413 413
414 414 # Arguments before "buffered" used to be positional. Consider not
415 415 # adding/removing arguments before "buffered" to not break callers.
416 416 def __init__(self, ui, repo, tmplspec, makefilematcher=None,
417 417 makehunksfilter=None, diffopts=None, buffered=False):
418 418 changesetprinter.__init__(self, ui, repo, makefilematcher,
419 419 makehunksfilter, diffopts, buffered)
420 420 tres = formatter.templateresources(ui, repo)
421 421 self.t = formatter.loadtemplater(ui, tmplspec,
422 422 defaults=templatekw.keywords,
423 423 resources=tres,
424 424 cache=templatekw.defaulttempl)
425 425 self._counter = itertools.count()
426 426 self.cache = tres['cache'] # shared with _graphnodeformatter()
427 427
428 428 self._tref = tmplspec.ref
429 429 self._parts = {'header': '', 'footer': '',
430 430 tmplspec.ref: tmplspec.ref,
431 431 'docheader': '', 'docfooter': '',
432 432 'separator': ''}
433 433 if tmplspec.mapfile:
434 434 # find correct templates for current mode, for backward
435 435 # compatibility with 'log -v/-q/--debug' using a mapfile
436 436 tmplmodes = [
437 437 (True, ''),
438 438 (self.ui.verbose, '_verbose'),
439 439 (self.ui.quiet, '_quiet'),
440 440 (self.ui.debugflag, '_debug'),
441 441 ]
442 442 for mode, postfix in tmplmodes:
443 443 for t in self._parts:
444 444 cur = t + postfix
445 445 if mode and cur in self.t:
446 446 self._parts[t] = cur
447 447 else:
448 448 partnames = [p for p in self._parts.keys() if p != tmplspec.ref]
449 449 m = formatter.templatepartsmap(tmplspec, self.t, partnames)
450 450 self._parts.update(m)
451 451
452 452 if self._parts['docheader']:
453 453 self.ui.write(templater.stringify(self.t(self._parts['docheader'])))
454 454
455 455 def close(self):
456 456 if self._parts['docfooter']:
457 457 if not self.footer:
458 458 self.footer = ""
459 459 self.footer += templater.stringify(self.t(self._parts['docfooter']))
460 460 return super(changesettemplater, self).close()
461 461
462 462 def _show(self, ctx, copies, props):
463 463 '''show a single changeset or file revision'''
464 464 props = props.copy()
465 465 props['ctx'] = ctx
466 466 props['index'] = index = next(self._counter)
467 467 props['revcache'] = {'copies': copies}
468 468 props = pycompat.strkwargs(props)
469 469
470 470 # write separator, which wouldn't work well with the header part below
471 471 # since there's inherently a conflict between header (across items) and
472 472 # separator (per item)
473 473 if self._parts['separator'] and index > 0:
474 474 self.ui.write(templater.stringify(self.t(self._parts['separator'])))
475 475
476 476 # write header
477 477 if self._parts['header']:
478 478 h = templater.stringify(self.t(self._parts['header'], **props))
479 479 if self.buffered:
480 480 self.header[ctx.rev()] = h
481 481 else:
482 482 if self.lastheader != h:
483 483 self.lastheader = h
484 484 self.ui.write(h)
485 485
486 486 # write changeset metadata, then patch if requested
487 487 key = self._parts[self._tref]
488 488 self.ui.write(templater.stringify(self.t(key, **props)))
489 489 self._showpatch(ctx)
490 490
491 491 if self._parts['footer']:
492 492 if not self.footer:
493 493 self.footer = templater.stringify(
494 494 self.t(self._parts['footer'], **props))
495 495
496 496 def templatespec(tmpl, mapfile):
497 497 if mapfile:
498 498 return formatter.templatespec('changeset', tmpl, mapfile)
499 499 else:
500 500 return formatter.templatespec('', tmpl, None)
501 501
502 502 def _lookuptemplate(ui, tmpl, style):
503 503 """Find the template matching the given template spec or style
504 504
505 505 See formatter.lookuptemplate() for details.
506 506 """
507 507
508 508 # ui settings
509 509 if not tmpl and not style: # template are stronger than style
510 510 tmpl = ui.config('ui', 'logtemplate')
511 511 if tmpl:
512 512 return templatespec(templater.unquotestring(tmpl), None)
513 513 else:
514 514 style = util.expandpath(ui.config('ui', 'style'))
515 515
516 516 if not tmpl and style:
517 517 mapfile = style
518 518 if not os.path.split(mapfile)[0]:
519 519 mapname = (templater.templatepath('map-cmdline.' + mapfile)
520 520 or templater.templatepath(mapfile))
521 521 if mapname:
522 522 mapfile = mapname
523 523 return templatespec(None, mapfile)
524 524
525 525 if not tmpl:
526 526 return templatespec(None, None)
527 527
528 528 return formatter.lookuptemplate(ui, 'changeset', tmpl)
529 529
530 530 def maketemplater(ui, repo, tmpl, buffered=False):
531 531 """Create a changesettemplater from a literal template 'tmpl'
532 532 byte-string."""
533 533 spec = templatespec(tmpl, None)
534 534 return changesettemplater(ui, repo, spec, buffered=buffered)
535 535
536 536 def changesetdisplayer(ui, repo, opts, makefilematcher=None,
537 537 makehunksfilter=None, buffered=False):
538 538 """show one changeset using template or regular display.
539 539
540 540 Display format will be the first non-empty hit of:
541 541 1. option 'template'
542 542 2. option 'style'
543 543 3. [ui] setting 'logtemplate'
544 544 4. [ui] setting 'style'
545 545 If all of these values are either the unset or the empty string,
546 546 regular display via changesetprinter() is done.
547 547 """
548 548 # options
549 549 if not makefilematcher and (opts.get('patch') or opts.get('stat')):
550 550 def makefilematcher(ctx):
551 551 return scmutil.matchall(repo)
552 552
553 553 postargs = (makefilematcher, makehunksfilter, opts, buffered)
554 554 if opts.get('template') == 'json':
555 555 return jsonchangeset(ui, repo, *postargs)
556 556
557 557 spec = _lookuptemplate(ui, opts.get('template'), opts.get('style'))
558 558
559 559 if not spec.ref and not spec.tmpl and not spec.mapfile:
560 560 return changesetprinter(ui, repo, *postargs)
561 561
562 562 return changesettemplater(ui, repo, spec, *postargs)
563 563
564 564 def _makematcher(repo, revs, pats, opts):
565 565 """Build matcher and expanded patterns from log options
566 566
567 567 If --follow, revs are the revisions to follow from.
568 568
569 569 Returns (match, pats, slowpath) where
570 570 - match: a matcher built from the given pats and -I/-X opts
571 571 - pats: patterns used (globs are expanded on Windows)
572 572 - slowpath: True if patterns aren't as simple as scanning filelogs
573 573 """
574 574 # pats/include/exclude are passed to match.match() directly in
575 575 # _matchfiles() revset but walkchangerevs() builds its matcher with
576 576 # scmutil.match(). The difference is input pats are globbed on
577 577 # platforms without shell expansion (windows).
578 578 wctx = repo[None]
579 579 match, pats = scmutil.matchandpats(wctx, pats, opts)
580 580 slowpath = match.anypats() or (not match.always() and opts.get('removed'))
581 581 if not slowpath:
582 582 follow = opts.get('follow') or opts.get('follow_first')
583 583 startctxs = []
584 584 if follow and opts.get('rev'):
585 585 startctxs = [repo[r] for r in revs]
586 586 for f in match.files():
587 587 if follow and startctxs:
588 588 # No idea if the path was a directory at that revision, so
589 589 # take the slow path.
590 590 if any(f not in c for c in startctxs):
591 591 slowpath = True
592 592 continue
593 593 elif follow and f not in wctx:
594 594 # If the file exists, it may be a directory, so let it
595 595 # take the slow path.
596 596 if os.path.exists(repo.wjoin(f)):
597 597 slowpath = True
598 598 continue
599 599 else:
600 600 raise error.Abort(_('cannot follow file not in parent '
601 601 'revision: "%s"') % f)
602 602 filelog = repo.file(f)
603 603 if not filelog:
604 604 # A zero count may be a directory or deleted file, so
605 605 # try to find matching entries on the slow path.
606 606 if follow:
607 607 raise error.Abort(
608 608 _('cannot follow nonexistent file: "%s"') % f)
609 609 slowpath = True
610 610
611 611 # We decided to fall back to the slowpath because at least one
612 612 # of the paths was not a file. Check to see if at least one of them
613 613 # existed in history - in that case, we'll continue down the
614 614 # slowpath; otherwise, we can turn off the slowpath
615 615 if slowpath:
616 616 for path in match.files():
617 617 if path == '.' or path in repo.store:
618 618 break
619 619 else:
620 620 slowpath = False
621 621
622 622 return match, pats, slowpath
623 623
624 624 def _fileancestors(repo, revs, match, followfirst):
625 625 fctxs = []
626 626 for r in revs:
627 627 ctx = repo[r]
628 628 fctxs.extend(ctx[f].introfilectx() for f in ctx.walk(match))
629 629
630 630 # When displaying a revision with --patch --follow FILE, we have
631 631 # to know which file of the revision must be diffed. With
632 632 # --follow, we want the names of the ancestors of FILE in the
633 633 # revision, stored in "fcache". "fcache" is populated as a side effect
634 634 # of the graph traversal.
635 635 fcache = {}
636 636 def filematcher(ctx):
637 637 return scmutil.matchfiles(repo, fcache.get(ctx.rev(), []))
638 638
639 639 def revgen():
640 640 for rev, cs in dagop.filectxancestors(fctxs, followfirst=followfirst):
641 641 fcache[rev] = [c.path() for c in cs]
642 642 yield rev
643 643 return smartset.generatorset(revgen(), iterasc=False), filematcher
644 644
645 645 def _makenofollowfilematcher(repo, pats, opts):
646 646 '''hook for extensions to override the filematcher for non-follow cases'''
647 647 return None
648 648
649 649 _opt2logrevset = {
650 650 'no_merges': ('not merge()', None),
651 651 'only_merges': ('merge()', None),
652 652 '_matchfiles': (None, '_matchfiles(%ps)'),
653 653 'date': ('date(%s)', None),
654 654 'branch': ('branch(%s)', '%lr'),
655 655 '_patslog': ('filelog(%s)', '%lr'),
656 656 'keyword': ('keyword(%s)', '%lr'),
657 657 'prune': ('ancestors(%s)', 'not %lr'),
658 658 'user': ('user(%s)', '%lr'),
659 659 }
660 660
661 661 def _makerevset(repo, match, pats, slowpath, opts):
662 662 """Return a revset string built from log options and file patterns"""
663 663 opts = dict(opts)
664 664 # follow or not follow?
665 665 follow = opts.get('follow') or opts.get('follow_first')
666 666
667 667 # branch and only_branch are really aliases and must be handled at
668 668 # the same time
669 669 opts['branch'] = opts.get('branch', []) + opts.get('only_branch', [])
670 670 opts['branch'] = [repo.lookupbranch(b) for b in opts['branch']]
671 671
672 672 if slowpath:
673 673 # See walkchangerevs() slow path.
674 674 #
675 675 # pats/include/exclude cannot be represented as separate
676 676 # revset expressions as their filtering logic applies at file
677 677 # level. For instance "-I a -X b" matches a revision touching
678 678 # "a" and "b" while "file(a) and not file(b)" does
679 679 # not. Besides, filesets are evaluated against the working
680 680 # directory.
681 681 matchargs = ['r:', 'd:relpath']
682 682 for p in pats:
683 683 matchargs.append('p:' + p)
684 684 for p in opts.get('include', []):
685 685 matchargs.append('i:' + p)
686 686 for p in opts.get('exclude', []):
687 687 matchargs.append('x:' + p)
688 688 opts['_matchfiles'] = matchargs
689 689 elif not follow:
690 690 opts['_patslog'] = list(pats)
691 691
692 692 expr = []
693 693 for op, val in sorted(opts.iteritems()):
694 694 if not val:
695 695 continue
696 696 if op not in _opt2logrevset:
697 697 continue
698 698 revop, listop = _opt2logrevset[op]
699 699 if revop and '%' not in revop:
700 700 expr.append(revop)
701 701 elif not listop:
702 702 expr.append(revsetlang.formatspec(revop, val))
703 703 else:
704 704 if revop:
705 705 val = [revsetlang.formatspec(revop, v) for v in val]
706 706 expr.append(revsetlang.formatspec(listop, val))
707 707
708 708 if expr:
709 709 expr = '(' + ' and '.join(expr) + ')'
710 710 else:
711 711 expr = None
712 712 return expr
713 713
714 714 def _initialrevs(repo, opts):
715 715 """Return the initial set of revisions to be filtered or followed"""
716 716 follow = opts.get('follow') or opts.get('follow_first')
717 717 if opts.get('rev'):
718 718 revs = scmutil.revrange(repo, opts['rev'])
719 719 elif follow and repo.dirstate.p1() == nullid:
720 720 revs = smartset.baseset()
721 721 elif follow:
722 722 revs = repo.revs('.')
723 723 else:
724 724 revs = smartset.spanset(repo)
725 725 revs.reverse()
726 726 return revs
727 727
728 728 def getrevs(repo, pats, opts):
729 729 """Return (revs, filematcher) where revs is a smartset
730 730
731 731 filematcher is a callable taking a changectx and returning a match
732 732 objects filtering the files to be detailed when displaying the revision.
733 733 """
734 734 follow = opts.get('follow') or opts.get('follow_first')
735 735 followfirst = opts.get('follow_first')
736 736 limit = getlimit(opts)
737 737 revs = _initialrevs(repo, opts)
738 738 if not revs:
739 739 return smartset.baseset(), None
740 740 match, pats, slowpath = _makematcher(repo, revs, pats, opts)
741 741 filematcher = None
742 742 if follow:
743 743 if slowpath or match.always():
744 744 revs = dagop.revancestors(repo, revs, followfirst=followfirst)
745 745 else:
746 746 revs, filematcher = _fileancestors(repo, revs, match, followfirst)
747 747 revs.reverse()
748 748 if filematcher is None:
749 749 filematcher = _makenofollowfilematcher(repo, pats, opts)
750 750 if filematcher is None:
751 751 def filematcher(ctx):
752 752 return match
753 753
754 754 expr = _makerevset(repo, match, pats, slowpath, opts)
755 755 if opts.get('graph') and opts.get('rev'):
756 756 # User-specified revs might be unsorted, but don't sort before
757 757 # _makerevset because it might depend on the order of revs
758 758 if not (revs.isdescending() or revs.istopo()):
759 759 revs.sort(reverse=True)
760 760 if expr:
761 761 matcher = revset.match(None, expr)
762 762 revs = matcher(repo, revs)
763 763 if limit is not None:
764 764 revs = revs.slice(0, limit)
765 765 return revs, filematcher
766 766
767 767 def _parselinerangeopt(repo, opts):
768 768 """Parse --line-range log option and return a list of tuples (filename,
769 769 (fromline, toline)).
770 770 """
771 771 linerangebyfname = []
772 772 for pat in opts.get('line_range', []):
773 773 try:
774 774 pat, linerange = pat.rsplit(',', 1)
775 775 except ValueError:
776 776 raise error.Abort(_('malformatted line-range pattern %s') % pat)
777 777 try:
778 778 fromline, toline = map(int, linerange.split(':'))
779 779 except ValueError:
780 780 raise error.Abort(_("invalid line range for %s") % pat)
781 781 msg = _("line range pattern '%s' must match exactly one file") % pat
782 782 fname = scmutil.parsefollowlinespattern(repo, None, pat, msg)
783 783 linerangebyfname.append(
784 784 (fname, util.processlinerange(fromline, toline)))
785 785 return linerangebyfname
786 786
787 787 def getlinerangerevs(repo, userrevs, opts):
788 788 """Return (revs, filematcher, hunksfilter).
789 789
790 790 "revs" are revisions obtained by processing "line-range" log options and
791 791 walking block ancestors of each specified file/line-range.
792 792
793 793 "filematcher(ctx) -> match" is a factory function returning a match object
794 794 for a given revision for file patterns specified in --line-range option.
795 If neither --stat nor --patch options are passed, "filematcher" is None.
796 795
797 796 "hunksfilter(ctx) -> filterfn(fctx, hunks)" is a factory function
798 797 returning a hunks filtering function.
799 If neither --stat nor --patch options are passed, "filterhunks" is None.
800 798 """
801 799 wctx = repo[None]
802 800
803 801 # Two-levels map of "rev -> file ctx -> [line range]".
804 802 linerangesbyrev = {}
805 803 for fname, (fromline, toline) in _parselinerangeopt(repo, opts):
806 804 if fname not in wctx:
807 805 raise error.Abort(_('cannot follow file not in parent '
808 806 'revision: "%s"') % fname)
809 807 fctx = wctx.filectx(fname)
810 808 for fctx, linerange in dagop.blockancestors(fctx, fromline, toline):
811 809 rev = fctx.introrev()
812 810 if rev not in userrevs:
813 811 continue
814 812 linerangesbyrev.setdefault(
815 813 rev, {}).setdefault(
816 814 fctx.path(), []).append(linerange)
817 815
818 filematcher = None
819 hunksfilter = None
820 if opts.get('patch') or opts.get('stat'):
816 def nofilterhunksfn(fctx, hunks):
817 return hunks
821 818
822 def nofilterhunksfn(fctx, hunks):
823 return hunks
824
825 def hunksfilter(ctx):
826 fctxlineranges = linerangesbyrev.get(ctx.rev())
827 if fctxlineranges is None:
828 return nofilterhunksfn
819 def hunksfilter(ctx):
820 fctxlineranges = linerangesbyrev.get(ctx.rev())
821 if fctxlineranges is None:
822 return nofilterhunksfn
829 823
830 def filterfn(fctx, hunks):
831 lineranges = fctxlineranges.get(fctx.path())
832 if lineranges is not None:
833 for hr, lines in hunks:
834 if hr is None: # binary
835 yield hr, lines
836 continue
837 if any(mdiff.hunkinrange(hr[2:], lr)
838 for lr in lineranges):
839 yield hr, lines
840 else:
841 for hunk in hunks:
842 yield hunk
824 def filterfn(fctx, hunks):
825 lineranges = fctxlineranges.get(fctx.path())
826 if lineranges is not None:
827 for hr, lines in hunks:
828 if hr is None: # binary
829 yield hr, lines
830 continue
831 if any(mdiff.hunkinrange(hr[2:], lr)
832 for lr in lineranges):
833 yield hr, lines
834 else:
835 for hunk in hunks:
836 yield hunk
843 837
844 return filterfn
838 return filterfn
845 839
846 def filematcher(ctx):
847 files = list(linerangesbyrev.get(ctx.rev(), []))
848 return scmutil.matchfiles(repo, files)
840 def filematcher(ctx):
841 files = list(linerangesbyrev.get(ctx.rev(), []))
842 return scmutil.matchfiles(repo, files)
849 843
850 844 revs = sorted(linerangesbyrev, reverse=True)
851 845
852 846 return revs, filematcher, hunksfilter
853 847
854 848 def _graphnodeformatter(ui, displayer):
855 849 spec = ui.config('ui', 'graphnodetemplate')
856 850 if not spec:
857 851 return templatekw.showgraphnode # fast path for "{graphnode}"
858 852
859 853 spec = templater.unquotestring(spec)
860 854 tres = formatter.templateresources(ui)
861 855 if isinstance(displayer, changesettemplater):
862 856 tres['cache'] = displayer.cache # reuse cache of slow templates
863 857 templ = formatter.maketemplater(ui, spec, defaults=templatekw.keywords,
864 858 resources=tres)
865 859 def formatnode(repo, ctx):
866 860 props = {'ctx': ctx, 'repo': repo, 'revcache': {}}
867 861 return templ.render(props)
868 862 return formatnode
869 863
870 864 def displaygraph(ui, repo, dag, displayer, edgefn, getrenamed=None, props=None):
871 865 props = props or {}
872 866 formatnode = _graphnodeformatter(ui, displayer)
873 867 state = graphmod.asciistate()
874 868 styles = state['styles']
875 869
876 870 # only set graph styling if HGPLAIN is not set.
877 871 if ui.plain('graph'):
878 872 # set all edge styles to |, the default pre-3.8 behaviour
879 873 styles.update(dict.fromkeys(styles, '|'))
880 874 else:
881 875 edgetypes = {
882 876 'parent': graphmod.PARENT,
883 877 'grandparent': graphmod.GRANDPARENT,
884 878 'missing': graphmod.MISSINGPARENT
885 879 }
886 880 for name, key in edgetypes.items():
887 881 # experimental config: experimental.graphstyle.*
888 882 styles[key] = ui.config('experimental', 'graphstyle.%s' % name,
889 883 styles[key])
890 884 if not styles[key]:
891 885 styles[key] = None
892 886
893 887 # experimental config: experimental.graphshorten
894 888 state['graphshorten'] = ui.configbool('experimental', 'graphshorten')
895 889
896 890 for rev, type, ctx, parents in dag:
897 891 char = formatnode(repo, ctx)
898 892 copies = None
899 893 if getrenamed and ctx.rev():
900 894 copies = []
901 895 for fn in ctx.files():
902 896 rename = getrenamed(fn, ctx.rev())
903 897 if rename:
904 898 copies.append((fn, rename[0]))
905 899 edges = edgefn(type, char, state, rev, parents)
906 900 firstedge = next(edges)
907 901 width = firstedge[2]
908 902 displayer.show(ctx, copies=copies,
909 903 _graphwidth=width, **pycompat.strkwargs(props))
910 904 lines = displayer.hunk.pop(rev).split('\n')
911 905 if not lines[-1]:
912 906 del lines[-1]
913 907 displayer.flush(ctx)
914 908 for type, char, width, coldata in itertools.chain([firstedge], edges):
915 909 graphmod.ascii(ui, state, type, char, lines, coldata)
916 910 lines = []
917 911 displayer.close()
918 912
919 913 def graphlog(ui, repo, revs, filematcher, opts):
920 914 # Parameters are identical to log command ones
921 915 revdag = graphmod.dagwalker(repo, revs)
922 916
923 917 getrenamed = None
924 918 if opts.get('copies'):
925 919 endrev = None
926 920 if opts.get('rev'):
927 921 endrev = scmutil.revrange(repo, opts.get('rev')).max() + 1
928 922 getrenamed = templatekw.getrenamedfn(repo, endrev=endrev)
929 923
930 924 ui.pager('log')
931 925 displayer = changesetdisplayer(ui, repo, opts, makefilematcher=filematcher,
932 926 buffered=True)
933 927 displaygraph(ui, repo, revdag, displayer, graphmod.asciiedges, getrenamed)
934 928
935 929 def checkunsupportedgraphflags(pats, opts):
936 930 for op in ["newest_first"]:
937 931 if op in opts and opts[op]:
938 932 raise error.Abort(_("-G/--graph option is incompatible with --%s")
939 933 % op.replace("_", "-"))
940 934
941 935 def graphrevs(repo, nodes, opts):
942 936 limit = getlimit(opts)
943 937 nodes.reverse()
944 938 if limit is not None:
945 939 nodes = nodes[:limit]
946 940 return graphmod.nodes(repo, nodes)
General Comments 0
You need to be logged in to leave comments. Login now