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