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