~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/commands.py

- ignore .swp files from upload

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2004, 2005 by Martin Pool
2
 
# Copyright (C) 2005 by Canonical Ltd
3
 
 
 
1
# Copyright (C) 2004, 2005 by Canonical Ltd
4
2
 
5
3
# This program is free software; you can redistribute it and/or modify
6
4
# it under the terms of the GNU General Public License as published by
16
14
# along with this program; if not, write to the Free Software
17
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
18
16
 
19
 
"""Bazaar-NG -- a free distributed version-control tool
20
 
http://bazaar-ng.org/
21
 
 
22
 
**WARNING: THIS IS AN UNSTABLE DEVELOPMENT VERSION**
23
 
 
24
 
* Metadata format is not stable yet -- you may need to
25
 
  discard history in the future.
26
 
 
27
 
* Many commands unimplemented or partially implemented.
28
 
 
29
 
* Space-inefficient storage.
30
 
 
31
 
* No merge operators yet.
32
 
 
33
 
Interesting commands:
34
 
 
35
 
  bzr help [COMMAND]
36
 
      Show help screen
37
 
  bzr version
38
 
      Show software version/licence/non-warranty.
39
 
  bzr init
40
 
      Start versioning the current directory
41
 
  bzr add FILE...
42
 
      Make files versioned.
43
 
  bzr log
44
 
      Show revision history.
45
 
  bzr rename FROM TO
46
 
      Rename one file.
47
 
  bzr move FROM... DESTDIR
48
 
      Move one or more files to a different directory.
49
 
  bzr diff [FILE...]
50
 
      Show changes from last revision to working copy.
51
 
  bzr commit -m 'MESSAGE'
52
 
      Store current state as new revision.
53
 
  bzr export REVNO DESTINATION
54
 
      Export the branch state at a previous version.
55
 
  bzr status
56
 
      Show summary of pending changes.
57
 
  bzr remove FILE...
58
 
      Make a file not versioned.
59
 
  bzr info
60
 
      Show statistics about this branch.
61
 
  bzr check
62
 
      Verify history is stored safely. 
63
 
  (for more type 'bzr help commands')
64
 
"""
65
 
 
66
 
 
67
 
 
68
 
 
69
 
import sys, os, time, types, shutil, tempfile, fnmatch, difflib, os.path
70
 
from sets import Set
71
 
from pprint import pprint
72
 
from stat import *
73
 
from glob import glob
 
17
 
 
18
# TODO: probably should say which arguments are candidates for glob
 
19
# expansion on windows and do that at the command level.
 
20
 
 
21
# TODO: Help messages for options.
 
22
 
 
23
# TODO: Define arguments by objects, rather than just using names.
 
24
# Those objects can specify the expected type of the argument, which
 
25
# would help with validation and shell completion.
 
26
 
 
27
# TODO: "--profile=cum", to change sort order.  Is there any value in leaving
 
28
# the profile output behind so it can be interactively examined?
 
29
 
 
30
import sys
 
31
import os
 
32
from warnings import warn
74
33
from inspect import getdoc
75
34
 
76
35
import bzrlib
77
 
from bzrlib.store import ImmutableStore
78
 
from bzrlib.trace import mutter, note, log_error
79
 
from bzrlib.errors import bailout, BzrError, BzrCheckError
80
 
from bzrlib.osutils import quotefn, pumpfile, isdir, isfile
81
 
from bzrlib.tree import RevisionTree, EmptyTree, WorkingTree, Tree
82
 
from bzrlib.revision import Revision
83
 
from bzrlib import Branch, Inventory, InventoryEntry, ScratchBranch, BZRDIR, \
84
 
     format_date
85
 
 
86
 
BZR_DIFF_FORMAT = "## Bazaar-NG diff, format 0 ##\n"
87
 
BZR_PATCHNAME_FORMAT = 'cset:sha1:%s'
88
 
 
89
 
## standard representation
90
 
NONE_STRING = '(none)'
91
 
EMPTY = 'empty'
92
 
 
93
 
 
94
 
## TODO: Perhaps a different version of inventory commands that
95
 
## returns iterators...
96
 
 
97
 
## TODO: Perhaps an AtomicFile class that writes to a temporary file and then renames.
98
 
 
99
 
## TODO: Some kind of locking on branches.  Perhaps there should be a
100
 
## parameter to the branch object saying whether we want a read or
101
 
## write lock; release it from destructor.  Perhaps don't even need a
102
 
## read lock to look at immutable objects?
103
 
 
104
 
## TODO: Perhaps make UUIDs predictable in test mode to make it easier
105
 
## to compare output?
106
 
 
107
 
## TODO: Some kind of global code to generate the right Branch object
108
 
## to work on.  Almost, but not quite all, commands need one, and it
109
 
## can be taken either from their parameters or their working
110
 
## directory.
111
 
 
112
 
 
113
 
 
114
 
cmd_aliases = {
115
 
    '?':         'help',
116
 
    'ci':        'commit',
117
 
    'checkin':   'commit',
118
 
    'di':        'diff',
119
 
    'st':        'status',
120
 
    'stat':      'status',
121
 
    }
122
 
 
123
 
 
124
 
def get_cmd_handler(cmd):
125
 
    cmd = str(cmd)
126
 
    
127
 
    cmd = cmd_aliases.get(cmd, cmd)
128
 
    
129
 
    try:
130
 
        cmd_handler = globals()['cmd_' + cmd.replace('-', '_')]
131
 
    except KeyError:
132
 
        raise BzrError("unknown command %r" % cmd)
133
 
 
134
 
    return cmd, cmd_handler
135
 
 
136
 
 
137
 
 
138
 
def cmd_status(all=False):
139
 
    """Display status summary.
140
 
 
141
 
    For each file there is a single line giving its file state and name.
142
 
    The name is that in the current revision unless it is deleted or
143
 
    missing, in which case the old name is shown.
144
 
    """
145
 
    #import bzrlib.status
146
 
    #bzrlib.status.tree_status(Branch('.'))
147
 
    Branch('.').show_status(show_all=all)
148
 
 
149
 
 
150
 
 
151
 
######################################################################
152
 
# examining history
153
 
def cmd_get_revision(revision_id):
154
 
    Branch('.').get_revision(revision_id).write_xml(sys.stdout)
155
 
 
156
 
 
157
 
def cmd_get_file_text(text_id):
158
 
    """Get contents of a file by hash."""
159
 
    sf = Branch('.').text_store[text_id]
160
 
    pumpfile(sf, sys.stdout)
161
 
 
162
 
 
163
 
 
164
 
######################################################################
165
 
# commands
166
 
    
167
 
 
168
 
def cmd_revno():
169
 
    """Show number of revisions on this branch"""
170
 
    print Branch('.').revno()
171
 
    
172
 
 
173
 
    
174
 
def cmd_add(file_list, verbose=False):
175
 
    """Add specified files or directories.
176
 
 
177
 
    In non-recursive mode, all the named items are added, regardless
178
 
    of whether they were previously ignored.  A warning is given if
179
 
    any of the named files are already versioned.
180
 
 
181
 
    In recursive mode (the default), files are treated the same way
182
 
    but the behaviour for directories is different.  Directories that
183
 
    are already versioned do not give a warning.  All directories,
184
 
    whether already versioned or not, are searched for files or
185
 
    subdirectories that are neither versioned or ignored, and these
186
 
    are added.  This search proceeds recursively into versioned
187
 
    directories.
188
 
 
189
 
    Therefore simply saying 'bzr add .' will version all files that
190
 
    are currently unknown.
191
 
 
192
 
    TODO: Perhaps adding a file whose directly is not versioned should
193
 
    recursively add that parent, rather than giving an error?
194
 
    """
195
 
    bzrlib.add.smart_add(file_list, verbose)
196
 
    
197
 
 
198
 
def cmd_relpath(filename):
199
 
    """Show path of file relative to root"""
200
 
    print Branch(filename).relpath(filename)
201
 
 
202
 
 
203
 
 
204
 
def cmd_inventory(revision=None):
205
 
    """Show inventory of the current working copy."""
206
 
    ## TODO: Also optionally show a previous inventory
207
 
    ## TODO: Format options
208
 
    b = Branch('.')
209
 
    if revision == None:
210
 
        inv = b.read_working_inventory()
211
 
    else:
212
 
        inv = b.get_revision_inventory(b.lookup_revision(revision))
213
 
        
214
 
    for path, entry in inv.iter_entries():
215
 
        print '%-50s %s' % (entry.file_id, path)
216
 
 
217
 
 
218
 
 
219
 
# TODO: Maybe a 'mv' command that has the combined move/rename
220
 
# special behaviour of Unix?
221
 
 
222
 
def cmd_move(source_list, dest):
223
 
    b = Branch('.')
224
 
 
225
 
    b.move([b.relpath(s) for s in source_list], b.relpath(dest))
226
 
 
227
 
 
228
 
 
229
 
def cmd_rename(from_name, to_name):
230
 
    """Change the name of an entry.
231
 
 
232
 
    usage: bzr rename FROM_NAME TO_NAME
233
 
 
234
 
    examples:
235
 
      bzr rename frob.c frobber.c
236
 
      bzr rename src/frob.c lib/frob.c
237
 
 
238
 
    It is an error if the destination name exists.
239
 
 
240
 
    See also the 'move' command, which moves files into a different
241
 
    directory without changing their name.
242
 
 
243
 
    TODO: Some way to rename multiple files without invoking bzr for each
244
 
    one?"""
245
 
    b = Branch('.')
246
 
    b.rename_one(b.relpath(from_name), b.relpath(to_name))
247
 
    
248
 
 
249
 
 
250
 
 
251
 
def cmd_renames(dir='.'):
252
 
    """Show list of renamed files.
253
 
 
254
 
    usage: bzr renames [BRANCH]
255
 
 
256
 
    TODO: Option to show renames between two historical versions.
257
 
 
258
 
    TODO: Only show renames under dir, rather than in the whole branch.
259
 
    """
260
 
    b = Branch(dir)
261
 
    old_inv = b.basis_tree().inventory
262
 
    new_inv = b.read_working_inventory()
263
 
    
264
 
    renames = list(bzrlib.tree.find_renames(old_inv, new_inv))
265
 
    renames.sort()
266
 
    for old_name, new_name in renames:
267
 
        print "%s => %s" % (old_name, new_name)        
268
 
 
269
 
 
270
 
 
271
 
def cmd_info():
272
 
    """info: Show statistical information for this branch
273
 
 
274
 
    usage: bzr info"""
275
 
    import info
276
 
    info.show_info(Branch('.'))        
277
 
    
278
 
 
279
 
 
280
 
def cmd_remove(file_list, verbose=False):
281
 
    b = Branch(file_list[0])
282
 
    b.remove([b.relpath(f) for f in file_list], verbose=verbose)
283
 
 
284
 
 
285
 
 
286
 
def cmd_file_id(filename):
287
 
    """Print file_id of a particular file or directory.
288
 
 
289
 
    usage: bzr file-id FILE
290
 
 
291
 
    The file_id is assigned when the file is first added and remains the
292
 
    same through all revisions where the file exists, even when it is
293
 
    moved or renamed.
294
 
    """
295
 
    b = Branch(filename)
296
 
    i = b.inventory.path2id(b.relpath(filename))
297
 
    if i == None:
298
 
        bailout("%r is not a versioned file" % filename)
299
 
    else:
300
 
        print i
301
 
 
302
 
 
303
 
def cmd_file_id_path(filename):
304
 
    """Print path of file_ids to a file or directory.
305
 
 
306
 
    usage: bzr file-id-path FILE
307
 
 
308
 
    This prints one line for each directory down to the target,
309
 
    starting at the branch root."""
310
 
    b = Branch(filename)
311
 
    inv = b.inventory
312
 
    fid = inv.path2id(b.relpath(filename))
313
 
    if fid == None:
314
 
        bailout("%r is not a versioned file" % filename)
315
 
    for fip in inv.get_idpath(fid):
316
 
        print fip
317
 
 
318
 
 
319
 
def cmd_revision_history():
320
 
    for patchid in Branch('.').revision_history():
321
 
        print patchid
322
 
 
323
 
 
324
 
def cmd_directories():
325
 
    for name, ie in Branch('.').read_working_inventory().directories():
326
 
        if name == '':
327
 
            print '.'
328
 
        else:
329
 
            print name
330
 
 
331
 
 
332
 
def cmd_missing():
333
 
    for name, ie in Branch('.').working_tree().missing():
334
 
        print name
335
 
 
336
 
 
337
 
def cmd_init():
338
 
    # TODO: Check we're not already in a working directory?  At the
339
 
    # moment you'll get an ugly error.
340
 
    
341
 
    # TODO: What if we're in a subdirectory of a branch?  Would like
342
 
    # to allow that, but then the parent may need to understand that
343
 
    # the children have disappeared, or should they be versioned in
344
 
    # both?
345
 
 
346
 
    # TODO: Take an argument/option for branch name.
347
 
    Branch('.', init=True)
348
 
 
349
 
 
350
 
def cmd_diff(revision=None, file_list=None):
351
 
    """bzr diff: Show differences in working tree.
352
 
    
353
 
    usage: bzr diff [-r REV] [FILE...]
354
 
 
355
 
    --revision REV
356
 
         Show changes since REV, rather than predecessor.
357
 
 
358
 
    If files are listed, only the changes in those files are listed.
359
 
    Otherwise, all changes for the tree are listed.
360
 
 
361
 
    TODO: Given two revision arguments, show the difference between them.
362
 
 
363
 
    TODO: Allow diff across branches.
364
 
 
365
 
    TODO: Option to use external diff command; could be GNU diff, wdiff,
366
 
          or a graphical diff.
367
 
 
368
 
    TODO: Python difflib is not exactly the same as unidiff; should
369
 
          either fix it up or prefer to use an external diff.
370
 
 
371
 
    TODO: If a directory is given, diff everything under that.
372
 
 
373
 
    TODO: Selected-file diff is inefficient and doesn't show you
374
 
          deleted files.
375
 
 
376
 
    TODO: This probably handles non-Unix newlines poorly.
377
 
"""
378
 
 
379
 
    ## TODO: Shouldn't be in the cmd function.
380
 
 
381
 
    b = Branch('.')
382
 
 
383
 
    if revision == None:
384
 
        old_tree = b.basis_tree()
385
 
    else:
386
 
        old_tree = b.revision_tree(b.lookup_revision(revision))
387
 
        
388
 
    new_tree = b.working_tree()
389
 
 
390
 
    # TODO: Options to control putting on a prefix or suffix, perhaps as a format string
391
 
    old_label = ''
392
 
    new_label = ''
393
 
 
394
 
    DEVNULL = '/dev/null'
395
 
    # Windows users, don't panic about this filename -- it is a
396
 
    # special signal to GNU patch that the file should be created or
397
 
    # deleted respectively.
398
 
 
399
 
    # TODO: Generation of pseudo-diffs for added/deleted files could
400
 
    # be usefully made into a much faster special case.
401
 
 
402
 
    # TODO: Better to return them in sorted order I think.
403
 
 
404
 
    if file_list:
405
 
        file_list = [b.relpath(f) for f in file_list]
406
 
 
407
 
    # FIXME: If given a file list, compare only those files rather
408
 
    # than comparing everything and then throwing stuff away.
409
 
    
410
 
    for file_state, fid, old_name, new_name, kind in bzrlib.diff_trees(old_tree, new_tree):
411
 
 
412
 
        if file_list and (new_name not in file_list):
413
 
            continue
414
 
        
415
 
        # Don't show this by default; maybe do it if an option is passed
416
 
        # idlabel = '      {%s}' % fid
417
 
        idlabel = ''
418
 
 
419
 
        # FIXME: Something about the diff format makes patch unhappy
420
 
        # with newly-added files.
421
 
 
422
 
        def diffit(oldlines, newlines, **kw):
423
 
            
424
 
            # FIXME: difflib is wrong if there is no trailing newline.
425
 
            # The syntax used by patch seems to be "\ No newline at
426
 
            # end of file" following the last diff line from that
427
 
            # file.  This is not trivial to insert into the
428
 
            # unified_diff output and it might be better to just fix
429
 
            # or replace that function.
430
 
 
431
 
            # In the meantime we at least make sure the patch isn't
432
 
            # mangled.
433
 
            
434
 
 
435
 
            # Special workaround for Python2.3, where difflib fails if
436
 
            # both sequences are empty.
437
 
            if not oldlines and not newlines:
438
 
                return
439
 
 
440
 
            nonl = False
441
 
 
442
 
            if oldlines and (oldlines[-1][-1] != '\n'):
443
 
                oldlines[-1] += '\n'
444
 
                nonl = True
445
 
            if newlines and (newlines[-1][-1] != '\n'):
446
 
                newlines[-1] += '\n'
447
 
                nonl = True
448
 
 
449
 
            ud = difflib.unified_diff(oldlines, newlines, **kw)
450
 
            sys.stdout.writelines(ud)
451
 
            if nonl:
452
 
                print "\\ No newline at end of file"
453
 
            sys.stdout.write('\n')
454
 
        
455
 
        if file_state in ['.', '?', 'I']:
456
 
            continue
457
 
        elif file_state == 'A':
458
 
            print '*** added %s %r' % (kind, new_name)
459
 
            if kind == 'file':
460
 
                diffit([],
461
 
                       new_tree.get_file(fid).readlines(),
462
 
                       fromfile=DEVNULL,
463
 
                       tofile=new_label + new_name + idlabel)
464
 
        elif file_state == 'D':
465
 
            assert isinstance(old_name, types.StringTypes)
466
 
            print '*** deleted %s %r' % (kind, old_name)
467
 
            if kind == 'file':
468
 
                diffit(old_tree.get_file(fid).readlines(), [],
469
 
                       fromfile=old_label + old_name + idlabel,
470
 
                       tofile=DEVNULL)
471
 
        elif file_state in ['M', 'R']:
472
 
            if file_state == 'M':
473
 
                assert kind == 'file'
474
 
                assert old_name == new_name
475
 
                print '*** modified %s %r' % (kind, new_name)
476
 
            elif file_state == 'R':
477
 
                print '*** renamed %s %r => %r' % (kind, old_name, new_name)
478
 
 
479
 
            if kind == 'file':
480
 
                diffit(old_tree.get_file(fid).readlines(),
481
 
                       new_tree.get_file(fid).readlines(),
482
 
                       fromfile=old_label + old_name + idlabel,
483
 
                       tofile=new_label + new_name)
484
 
        else:
485
 
            bailout("can't represent state %s {%s}" % (file_state, fid))
486
 
 
487
 
 
488
 
 
489
 
def cmd_deleted(show_ids=False):
490
 
    """List files deleted in the working tree.
491
 
 
492
 
    TODO: Show files deleted since a previous revision, or between two revisions.
493
 
    """
494
 
    b = Branch('.')
495
 
    old = b.basis_tree()
496
 
    new = b.working_tree()
497
 
 
498
 
    ## TODO: Much more efficient way to do this: read in new
499
 
    ## directories with readdir, rather than stating each one.  Same
500
 
    ## level of effort but possibly much less IO.  (Or possibly not,
501
 
    ## if the directories are very large...)
502
 
 
503
 
    for path, ie in old.inventory.iter_entries():
504
 
        if not new.has_id(ie.file_id):
505
 
            if show_ids:
506
 
                print '%-50s %s' % (path, ie.file_id)
507
 
            else:
508
 
                print path
509
 
 
510
 
 
511
 
 
512
 
def cmd_parse_inventory():
513
 
    import cElementTree
514
 
    
515
 
    cElementTree.ElementTree().parse(file('.bzr/inventory'))
516
 
 
517
 
 
518
 
 
519
 
def cmd_load_inventory():
520
 
    """Load inventory for timing purposes"""
521
 
    Branch('.').basis_tree().inventory
522
 
 
523
 
 
524
 
def cmd_dump_inventory():
525
 
    Branch('.').read_working_inventory().write_xml(sys.stdout)
526
 
 
527
 
 
528
 
def cmd_dump_new_inventory():
529
 
    import bzrlib.newinventory
530
 
    inv = Branch('.').basis_tree().inventory
531
 
    bzrlib.newinventory.write_inventory(inv, sys.stdout)
532
 
 
533
 
 
534
 
def cmd_load_new_inventory():
535
 
    import bzrlib.newinventory
536
 
    bzrlib.newinventory.read_new_inventory(sys.stdin)
537
 
                
538
 
    
539
 
def cmd_dump_slacker_inventory():
540
 
    import bzrlib.newinventory
541
 
    inv = Branch('.').basis_tree().inventory
542
 
    bzrlib.newinventory.write_slacker_inventory(inv, sys.stdout)
543
 
 
544
 
 
545
 
 
546
 
def cmd_dump_text_inventory():
547
 
    import bzrlib.textinv
548
 
    inv = Branch('.').basis_tree().inventory
549
 
    bzrlib.textinv.write_text_inventory(inv, sys.stdout)
550
 
 
551
 
 
552
 
def cmd_load_text_inventory():
553
 
    import bzrlib.textinv
554
 
    inv = bzrlib.textinv.read_text_inventory(sys.stdin)
555
 
    print 'loaded %d entries' % len(inv)
556
 
    
557
 
    
558
 
 
559
 
def cmd_root(filename=None):
560
 
    """Print the branch root."""
561
 
    print bzrlib.branch.find_branch_root(filename)
562
 
    
563
 
 
564
 
def cmd_log(timezone='original', verbose=False):
565
 
    """Show log of this branch.
566
 
 
567
 
    TODO: Options for utc; to show ids; to limit range; etc.
568
 
    """
569
 
    Branch('.').write_log(show_timezone=timezone, verbose=verbose)
570
 
 
571
 
 
572
 
def cmd_ls(revision=None, verbose=False):
573
 
    """List files in a tree.
574
 
 
575
 
    TODO: Take a revision or remote path and list that tree instead.
576
 
    """
577
 
    b = Branch('.')
578
 
    if revision == None:
579
 
        tree = b.working_tree()
580
 
    else:
581
 
        tree = b.revision_tree(b.lookup_revision(revision))
582
 
        
583
 
    for fp, fc, kind, fid in tree.list_files():
584
 
        if verbose:
585
 
            if kind == 'directory':
586
 
                kindch = '/'
587
 
            elif kind == 'file':
588
 
                kindch = ''
589
 
            else:
590
 
                kindch = '???'
591
 
                
592
 
            print '%-8s %s%s' % (fc, fp, kindch)
593
 
        else:
594
 
            print fp
595
 
    
596
 
    
597
 
 
598
 
def cmd_unknowns():
599
 
    """List unknown files"""
600
 
    for f in Branch('.').unknowns():
601
 
        print quotefn(f)
602
 
 
603
 
 
604
 
 
605
 
def cmd_ignored():
606
 
    """List ignored files and the patterns that matched them.
607
 
      """
608
 
    tree = Branch('.').working_tree()
609
 
    for path, file_class, kind, file_id in tree.list_files():
610
 
        if file_class != 'I':
611
 
            continue
612
 
        ## XXX: Slightly inefficient since this was already calculated
613
 
        pat = tree.is_ignored(path)
614
 
        print '%-50s %s' % (path, pat)
615
 
 
616
 
 
617
 
def cmd_lookup_revision(revno):
618
 
    try:
619
 
        revno = int(revno)
620
 
    except ValueError:
621
 
        bailout("usage: lookup-revision REVNO",
622
 
                ["REVNO is a non-negative revision number for this branch"])
623
 
 
624
 
    print Branch('.').lookup_revision(revno) or NONE_STRING
625
 
 
626
 
 
627
 
 
628
 
def cmd_export(revno, dest):
629
 
    """Export past revision to destination directory."""
630
 
    b = Branch('.')
631
 
    rh = b.lookup_revision(int(revno))
632
 
    t = b.revision_tree(rh)
633
 
    t.export(dest)
634
 
 
635
 
def cmd_cat(revision, filename):
636
 
    """Print file to stdout."""
637
 
    b = Branch('.')
638
 
    b.print_file(b.relpath(filename), int(revision))
639
 
 
640
 
 
641
 
######################################################################
642
 
# internal/test commands
643
 
 
644
 
 
645
 
def cmd_uuid():
646
 
    """Print a newly-generated UUID."""
647
 
    print bzrlib.osutils.uuid()
648
 
 
649
 
 
650
 
 
651
 
def cmd_local_time_offset():
652
 
    print bzrlib.osutils.local_time_offset()
653
 
 
654
 
 
655
 
 
656
 
def cmd_commit(message=None, verbose=False):
657
 
    """Commit changes to a new revision.
658
 
 
659
 
    --message MESSAGE
660
 
        Description of changes in this revision; free form text.
661
 
        It is recommended that the first line be a single-sentence
662
 
        summary.
663
 
    --verbose
664
 
        Show status of changed files,
665
 
 
666
 
    TODO: Commit only selected files.
667
 
 
668
 
    TODO: Run hooks on tree to-be-committed, and after commit.
669
 
 
670
 
    TODO: Strict commit that fails if there are unknown or deleted files.
671
 
    """
672
 
 
673
 
    if not message:
674
 
        bailout("please specify a commit message")
675
 
    Branch('.').commit(message, verbose=verbose)
676
 
 
677
 
 
678
 
def cmd_check(dir='.'):
679
 
    """check: Consistency check of branch history.
680
 
 
681
 
    usage: bzr check [-v] [BRANCH]
682
 
 
683
 
    options:
684
 
      --verbose, -v         Show progress of checking.
685
 
 
686
 
    This command checks various invariants about the branch storage to
687
 
    detect data corruption or bzr bugs.
688
 
    """
689
 
    import bzrlib.check
690
 
    bzrlib.check.check(Branch(dir, find_root=False))
691
 
 
692
 
 
693
 
def cmd_is(pred, *rest):
694
 
    """Test whether PREDICATE is true."""
695
 
    try:
696
 
        cmd_handler = globals()['assert_' + pred.replace('-', '_')]
697
 
    except KeyError:
698
 
        bailout("unknown predicate: %s" % quotefn(pred))
699
 
        
700
 
    try:
701
 
        cmd_handler(*rest)
702
 
    except BzrCheckError:
703
 
        # by default we don't print the message so that this can
704
 
        # be used from shell scripts without producing noise
705
 
        sys.exit(1)
706
 
 
707
 
 
708
 
def cmd_whoami(email=False):
709
 
    """Show bzr user id.
710
 
 
711
 
    usage: bzr whoami
712
 
 
713
 
    options:
714
 
        --email             Show only the email address.
715
 
    
716
 
    """
717
 
    if email:
718
 
        print bzrlib.osutils.user_email()
719
 
    else:
720
 
        print bzrlib.osutils.username()
721
 
        
722
 
        
723
 
def cmd_gen_revision_id():
724
 
    print bzrlib.branch._gen_revision_id(time.time())
725
 
 
726
 
 
727
 
def cmd_selftest():
728
 
    """Run internal test suite"""
729
 
    ## -v, if present, is seen by doctest; the argument is just here
730
 
    ## so our parser doesn't complain
731
 
 
732
 
    ## TODO: --verbose option
733
 
 
734
 
    failures, tests = 0, 0
735
 
    
736
 
    import doctest, bzrlib.store, bzrlib.tests
737
 
    bzrlib.trace.verbose = False
738
 
 
739
 
    for m in bzrlib.store, bzrlib.inventory, bzrlib.branch, bzrlib.osutils, \
740
 
        bzrlib.tree, bzrlib.tests, bzrlib.commands, bzrlib.add:
741
 
        mf, mt = doctest.testmod(m)
742
 
        failures += mf
743
 
        tests += mt
744
 
        print '%-40s %3d tests' % (m.__name__, mt),
745
 
        if mf:
746
 
            print '%3d FAILED!' % mf
747
 
        else:
748
 
            print
749
 
 
750
 
    print '%-40s %3d tests' % ('total', tests),
751
 
    if failures:
752
 
        print '%3d FAILED!' % failures
753
 
    else:
754
 
        print
755
 
 
756
 
 
757
 
 
758
 
# deprecated
759
 
cmd_doctest = cmd_selftest
760
 
 
761
 
 
762
 
######################################################################
763
 
# help
764
 
 
765
 
 
766
 
def cmd_help(topic=None):
767
 
    if topic == None:
768
 
        print __doc__
769
 
    elif topic == 'commands':
770
 
        help_commands()
771
 
    else:
772
 
        # otherwise, maybe the name of a command?
773
 
        topic, cmdfn = get_cmd_handler(topic)
774
 
 
775
 
        doc = getdoc(cmdfn)
776
 
        if doc == None:
777
 
            bailout("sorry, no detailed help yet for %r" % topic)
778
 
 
779
 
        print doc
780
 
 
781
 
 
782
 
def help_commands():
783
 
    """List all commands"""
784
 
    accu = []
785
 
    for k in globals().keys():
786
 
        if k.startswith('cmd_'):
787
 
            accu.append(k[4:].replace('_','-'))
788
 
    accu.sort()
789
 
    print "bzr commands: "
790
 
    for x in accu:
791
 
        print "   " + x
792
 
    print "note: some of these commands are internal-use or obsolete"
793
 
    # TODO: Some kind of marker for internal-use commands?
794
 
    # TODO: Show aliases?
795
 
        
796
 
 
797
 
 
798
 
 
799
 
def cmd_version():
800
 
    print "bzr (bazaar-ng) %s" % bzrlib.__version__
801
 
    print bzrlib.__copyright__
802
 
    print "http://bazaar-ng.org/"
803
 
    print
804
 
    print \
805
 
"""bzr comes with ABSOLUTELY NO WARRANTY.  bzr is free software, and
806
 
you may use, modify and redistribute it under the terms of the GNU 
807
 
General Public License version 2 or later."""
808
 
 
809
 
 
810
 
def cmd_rocks():
811
 
    """Statement of optimism."""
812
 
    print "it sure does!"
813
 
 
814
 
 
815
 
 
816
 
######################################################################
817
 
# main routine
 
36
import bzrlib.trace
 
37
from bzrlib.trace import mutter, note, log_error, warning
 
38
from bzrlib.errors import BzrError, BzrCheckError, BzrCommandError, NotBranchError
 
39
from bzrlib.revisionspec import RevisionSpec
 
40
from bzrlib import BZRDIR
 
41
 
 
42
plugin_cmds = {}
 
43
 
 
44
 
 
45
def register_command(cmd):
 
46
    "Utility function to help register a command"
 
47
    global plugin_cmds
 
48
    k = cmd.__name__
 
49
    if k.startswith("cmd_"):
 
50
        k_unsquished = _unsquish_command_name(k)
 
51
    else:
 
52
        k_unsquished = k
 
53
    if not plugin_cmds.has_key(k_unsquished):
 
54
        plugin_cmds[k_unsquished] = cmd
 
55
        mutter('registered plugin command %s', k_unsquished)      
 
56
    else:
 
57
        log_error('Two plugins defined the same command: %r' % k)
 
58
        log_error('Not loading the one in %r' % sys.modules[cmd.__module__])
 
59
 
 
60
 
 
61
def _squish_command_name(cmd):
 
62
    return 'cmd_' + cmd.replace('-', '_')
 
63
 
 
64
 
 
65
def _unsquish_command_name(cmd):
 
66
    assert cmd.startswith("cmd_")
 
67
    return cmd[4:].replace('_','-')
 
68
 
 
69
 
 
70
def _parse_revision_str(revstr):
 
71
    """This handles a revision string -> revno.
 
72
 
 
73
    This always returns a list.  The list will have one element for
 
74
    each revision specifier supplied.
 
75
 
 
76
    >>> _parse_revision_str('234')
 
77
    [<RevisionSpec_int 234>]
 
78
    >>> _parse_revision_str('234..567')
 
79
    [<RevisionSpec_int 234>, <RevisionSpec_int 567>]
 
80
    >>> _parse_revision_str('..')
 
81
    [<RevisionSpec None>, <RevisionSpec None>]
 
82
    >>> _parse_revision_str('..234')
 
83
    [<RevisionSpec None>, <RevisionSpec_int 234>]
 
84
    >>> _parse_revision_str('234..')
 
85
    [<RevisionSpec_int 234>, <RevisionSpec None>]
 
86
    >>> _parse_revision_str('234..456..789') # Maybe this should be an error
 
87
    [<RevisionSpec_int 234>, <RevisionSpec_int 456>, <RevisionSpec_int 789>]
 
88
    >>> _parse_revision_str('234....789') #Error ?
 
89
    [<RevisionSpec_int 234>, <RevisionSpec None>, <RevisionSpec_int 789>]
 
90
    >>> _parse_revision_str('revid:test@other.com-234234')
 
91
    [<RevisionSpec_revid revid:test@other.com-234234>]
 
92
    >>> _parse_revision_str('revid:test@other.com-234234..revid:test@other.com-234235')
 
93
    [<RevisionSpec_revid revid:test@other.com-234234>, <RevisionSpec_revid revid:test@other.com-234235>]
 
94
    >>> _parse_revision_str('revid:test@other.com-234234..23')
 
95
    [<RevisionSpec_revid revid:test@other.com-234234>, <RevisionSpec_int 23>]
 
96
    >>> _parse_revision_str('date:2005-04-12')
 
97
    [<RevisionSpec_date date:2005-04-12>]
 
98
    >>> _parse_revision_str('date:2005-04-12 12:24:33')
 
99
    [<RevisionSpec_date date:2005-04-12 12:24:33>]
 
100
    >>> _parse_revision_str('date:2005-04-12T12:24:33')
 
101
    [<RevisionSpec_date date:2005-04-12T12:24:33>]
 
102
    >>> _parse_revision_str('date:2005-04-12,12:24:33')
 
103
    [<RevisionSpec_date date:2005-04-12,12:24:33>]
 
104
    >>> _parse_revision_str('-5..23')
 
105
    [<RevisionSpec_int -5>, <RevisionSpec_int 23>]
 
106
    >>> _parse_revision_str('-5')
 
107
    [<RevisionSpec_int -5>]
 
108
    >>> _parse_revision_str('123a')
 
109
    Traceback (most recent call last):
 
110
      ...
 
111
    BzrError: No namespace registered for string: '123a'
 
112
    >>> _parse_revision_str('abc')
 
113
    Traceback (most recent call last):
 
114
      ...
 
115
    BzrError: No namespace registered for string: 'abc'
 
116
    >>> _parse_revision_str('branch:../branch2')
 
117
    [<RevisionSpec_branch branch:../branch2>]
 
118
    """
 
119
    import re
 
120
    old_format_re = re.compile('\d*:\d*')
 
121
    m = old_format_re.match(revstr)
 
122
    revs = []
 
123
    if m:
 
124
        warning('Colon separator for revision numbers is deprecated.'
 
125
                ' Use .. instead')
 
126
        for rev in revstr.split(':'):
 
127
            if rev:
 
128
                revs.append(RevisionSpec(int(rev)))
 
129
            else:
 
130
                revs.append(RevisionSpec(None))
 
131
    else:
 
132
        next_prefix = None
 
133
        for x in revstr.split('..'):
 
134
            if not x:
 
135
                revs.append(RevisionSpec(None))
 
136
            elif x[-1] == ':':
 
137
                # looks like a namespace:.. has happened
 
138
                next_prefix = x + '..'
 
139
            else:
 
140
                if next_prefix is not None:
 
141
                    x = next_prefix + x
 
142
                revs.append(RevisionSpec(x))
 
143
                next_prefix = None
 
144
        if next_prefix is not None:
 
145
            revs.append(RevisionSpec(next_prefix))
 
146
    return revs
 
147
 
 
148
 
 
149
def _builtin_commands():
 
150
    import bzrlib.builtins
 
151
    r = {}
 
152
    builtins = bzrlib.builtins.__dict__
 
153
    for name in builtins:
 
154
        if name.startswith("cmd_"):
 
155
            real_name = _unsquish_command_name(name)        
 
156
            r[real_name] = builtins[name]
 
157
    return r
 
158
 
 
159
            
 
160
 
 
161
def builtin_command_names():
 
162
    """Return list of builtin command names."""
 
163
    return _builtin_commands().keys()
 
164
    
 
165
 
 
166
def plugin_command_names():
 
167
    return plugin_cmds.keys()
 
168
 
 
169
 
 
170
def _get_cmd_dict(plugins_override=True):
 
171
    """Return name->class mapping for all commands."""
 
172
    d = _builtin_commands()
 
173
    if plugins_override:
 
174
        d.update(plugin_cmds)
 
175
    return d
 
176
 
 
177
    
 
178
def get_all_cmds(plugins_override=True):
 
179
    """Return canonical name and class for all registered commands."""
 
180
    for k, v in _get_cmd_dict(plugins_override=plugins_override).iteritems():
 
181
        yield k,v
 
182
 
 
183
 
 
184
def get_cmd_object(cmd_name, plugins_override=True):
 
185
    """Return the canonical name and command class for a command.
 
186
 
 
187
    plugins_override
 
188
        If true, plugin commands can override builtins.
 
189
    """
 
190
    from bzrlib.externalcommand import ExternalCommand
 
191
 
 
192
    cmd_name = str(cmd_name)            # not unicode
 
193
 
 
194
    # first look up this command under the specified name
 
195
    cmds = _get_cmd_dict(plugins_override=plugins_override)
 
196
    try:
 
197
        return cmds[cmd_name]()
 
198
    except KeyError:
 
199
        pass
 
200
 
 
201
    # look for any command which claims this as an alias
 
202
    for real_cmd_name, cmd_class in cmds.iteritems():
 
203
        if cmd_name in cmd_class.aliases:
 
204
            return cmd_class()
 
205
 
 
206
    cmd_obj = ExternalCommand.find_command(cmd_name)
 
207
    if cmd_obj:
 
208
        return cmd_obj
 
209
 
 
210
    raise BzrCommandError("unknown command %r" % cmd_name)
 
211
 
 
212
 
 
213
class Command(object):
 
214
    """Base class for commands.
 
215
 
 
216
    Commands are the heart of the command-line bzr interface.
 
217
 
 
218
    The command object mostly handles the mapping of command-line
 
219
    parameters into one or more bzrlib operations, and of the results
 
220
    into textual output.
 
221
 
 
222
    Commands normally don't have any state.  All their arguments are
 
223
    passed in to the run method.  (Subclasses may take a different
 
224
    policy if the behaviour of the instance needs to depend on e.g. a
 
225
    shell plugin and not just its Python class.)
 
226
 
 
227
    The docstring for an actual command should give a single-line
 
228
    summary, then a complete description of the command.  A grammar
 
229
    description will be inserted.
 
230
 
 
231
    aliases
 
232
        Other accepted names for this command.
 
233
 
 
234
    takes_args
 
235
        List of argument forms, marked with whether they are optional,
 
236
        repeated, etc.
 
237
 
 
238
    takes_options
 
239
        List of options that may be given for this command.
 
240
 
 
241
    hidden
 
242
        If true, this command isn't advertised.  This is typically
 
243
        for commands intended for expert users.
 
244
    """
 
245
    aliases = []
 
246
    
 
247
    takes_args = []
 
248
    takes_options = []
 
249
 
 
250
    hidden = False
 
251
    
 
252
    def __init__(self):
 
253
        """Construct an instance of this command."""
 
254
        if self.__doc__ == Command.__doc__:
 
255
            warn("No help message set for %r" % self)
 
256
 
 
257
 
 
258
    def run_argv(self, argv):
 
259
        """Parse command line and run."""
 
260
        args, opts = parse_args(argv)
 
261
 
 
262
        if 'help' in opts:  # e.g. bzr add --help
 
263
            from bzrlib.help import help_on_command
 
264
            help_on_command(self.name())
 
265
            return 0
 
266
 
 
267
        # check options are reasonable
 
268
        allowed = self.takes_options
 
269
        for oname in opts:
 
270
            if oname not in allowed:
 
271
                raise BzrCommandError("option '--%s' is not allowed for command %r"
 
272
                                      % (oname, self.name()))
 
273
 
 
274
        # mix arguments and options into one dictionary
 
275
        cmdargs = _match_argform(self.name(), self.takes_args, args)
 
276
        cmdopts = {}
 
277
        for k, v in opts.items():
 
278
            cmdopts[k.replace('-', '_')] = v
 
279
 
 
280
        all_cmd_args = cmdargs.copy()
 
281
        all_cmd_args.update(cmdopts)
 
282
 
 
283
        return self.run(**all_cmd_args)
 
284
 
 
285
    
 
286
    def run(self):
 
287
        """Actually run the command.
 
288
 
 
289
        This is invoked with the options and arguments bound to
 
290
        keyword parameters.
 
291
 
 
292
        Return 0 or None if the command was successful, or a non-zero
 
293
        shell error code if not.  It's OK for this method to allow
 
294
        an exception to raise up.
 
295
        """
 
296
        raise NotImplementedError()
 
297
 
 
298
 
 
299
    def help(self):
 
300
        """Return help message for this class."""
 
301
        if self.__doc__ is Command.__doc__:
 
302
            return None
 
303
        return getdoc(self)
 
304
 
 
305
    def name(self):
 
306
        return _unsquish_command_name(self.__class__.__name__)
 
307
 
 
308
 
 
309
def parse_spec(spec):
 
310
    """
 
311
    >>> parse_spec(None)
 
312
    [None, None]
 
313
    >>> parse_spec("./")
 
314
    ['./', None]
 
315
    >>> parse_spec("../@")
 
316
    ['..', -1]
 
317
    >>> parse_spec("../f/@35")
 
318
    ['../f', 35]
 
319
    >>> parse_spec('./@revid:john@arbash-meinel.com-20050711044610-3ca0327c6a222f67')
 
320
    ['.', 'revid:john@arbash-meinel.com-20050711044610-3ca0327c6a222f67']
 
321
    """
 
322
    if spec is None:
 
323
        return [None, None]
 
324
    if '/@' in spec:
 
325
        parsed = spec.split('/@')
 
326
        assert len(parsed) == 2
 
327
        if parsed[1] == "":
 
328
            parsed[1] = -1
 
329
        else:
 
330
            try:
 
331
                parsed[1] = int(parsed[1])
 
332
            except ValueError:
 
333
                pass # We can allow stuff like ./@revid:blahblahblah
 
334
            else:
 
335
                assert parsed[1] >=0
 
336
    else:
 
337
        parsed = [spec, None]
 
338
    return parsed
818
339
 
819
340
 
820
341
# list of all available options; the rhs can be either None for an
822
343
# the type.
823
344
OPTIONS = {
824
345
    'all':                    None,
 
346
    'basis':                  str,
 
347
    'diff-options':           str,
825
348
    'help':                   None,
 
349
    'file':                   unicode,
 
350
    'force':                  None,
 
351
    'format':                 unicode,
 
352
    'forward':                None,
 
353
    'quiet':                  None,
826
354
    'message':                unicode,
 
355
    'no-recurse':             None,
827
356
    'profile':                None,
828
 
    'revision':               int,
 
357
    'revision':               _parse_revision_str,
 
358
    'short':                  None,
829
359
    'show-ids':               None,
830
360
    'timezone':               str,
831
361
    'verbose':                None,
832
362
    'version':                None,
833
363
    'email':                  None,
 
364
    'unchanged':              None,
 
365
    'update':                 None,
 
366
    'long':                   None,
 
367
    'root':                   str,
 
368
    'no-backup':              None,
 
369
    'pattern':                str,
 
370
    'remember':               None,
834
371
    }
835
372
 
836
373
SHORT_OPTIONS = {
 
374
    'F':                      'file', 
 
375
    'h':                      'help',
837
376
    'm':                      'message',
838
377
    'r':                      'revision',
839
378
    'v':                      'verbose',
 
379
    'l':                      'long',
 
380
    'q':                      'quiet',
840
381
}
841
382
 
842
 
# List of options that apply to particular commands; commands not
843
 
# listed take none.
844
 
cmd_options = {
845
 
    'add':                    ['verbose'],
846
 
    'cat':                    ['revision'],
847
 
    'commit':                 ['message', 'verbose'],
848
 
    'deleted':                ['show-ids'],
849
 
    'diff':                   ['revision'],
850
 
    'inventory':              ['revision'],
851
 
    'log':                    ['timezone', 'verbose'],
852
 
    'ls':                     ['revision', 'verbose'],
853
 
    'remove':                 ['verbose'],
854
 
    'status':                 ['all'],
855
 
    'whoami':                 ['email'],
856
 
    }
857
 
 
858
 
 
859
 
cmd_args = {
860
 
    'add':                    ['file+'],
861
 
    'cat':                    ['filename'],
862
 
    'commit':                 [],
863
 
    'diff':                   ['file*'],
864
 
    'export':                 ['revno', 'dest'],
865
 
    'file-id':                ['filename'],
866
 
    'file-id-path':           ['filename'],
867
 
    'get-file-text':          ['text_id'],
868
 
    'get-inventory':          ['inventory_id'],
869
 
    'get-revision':           ['revision_id'],
870
 
    'get-revision-inventory': ['revision_id'],
871
 
    'help':                   ['topic?'],
872
 
    'init':                   [],
873
 
    'log':                    [],
874
 
    'lookup-revision':        ['revno'],
875
 
    'move':                   ['source$', 'dest'],
876
 
    'relpath':                ['filename'],
877
 
    'remove':                 ['file+'],
878
 
    'rename':                 ['from_name', 'to_name'],
879
 
    'renames':                ['dir?'],
880
 
    'root':                   ['filename?'],
881
 
    'status':                 [],
882
 
    }
883
 
 
884
383
 
885
384
def parse_args(argv):
886
385
    """Parse command line.
892
391
 
893
392
    >>> parse_args('--help'.split())
894
393
    ([], {'help': True})
 
394
    >>> parse_args('help -- --invalidcmd'.split())
 
395
    (['help', '--invalidcmd'], {})
895
396
    >>> parse_args('--version'.split())
896
397
    ([], {'version': True})
897
398
    >>> parse_args('status --all'.split())
898
399
    (['status'], {'all': True})
899
400
    >>> parse_args('commit --message=biter'.split())
900
401
    (['commit'], {'message': u'biter'})
 
402
    >>> parse_args('log -r 500'.split())
 
403
    (['log'], {'revision': [<RevisionSpec_int 500>]})
 
404
    >>> parse_args('log -r500..600'.split())
 
405
    (['log'], {'revision': [<RevisionSpec_int 500>, <RevisionSpec_int 600>]})
 
406
    >>> parse_args('log -vr500..600'.split())
 
407
    (['log'], {'verbose': True, 'revision': [<RevisionSpec_int 500>, <RevisionSpec_int 600>]})
 
408
    >>> parse_args('log -rrevno:500..600'.split()) #the r takes an argument
 
409
    (['log'], {'revision': [<RevisionSpec_revno revno:500>, <RevisionSpec_int 600>]})
901
410
    """
902
411
    args = []
903
412
    opts = {}
904
413
 
905
 
    # TODO: Maybe handle '--' to end options?
906
 
 
 
414
    argsover = False
907
415
    while argv:
908
416
        a = argv.pop(0)
909
 
        if a[0] == '-':
 
417
        if not argsover and a[0] == '-':
910
418
            # option names must not be unicode
911
419
            a = str(a)
912
420
            optarg = None
913
421
            if a[1] == '-':
 
422
                if a == '--':
 
423
                    # We've received a standalone -- No more flags
 
424
                    argsover = True
 
425
                    continue
914
426
                mutter("  got option %r" % a)
915
427
                if '=' in a:
916
428
                    optname, optarg = a[2:].split('=', 1)
917
429
                else:
918
430
                    optname = a[2:]
919
431
                if optname not in OPTIONS:
920
 
                    bailout('unknown long option %r' % a)
 
432
                    raise BzrError('unknown long option %r' % a)
921
433
            else:
922
434
                shortopt = a[1:]
923
 
                if shortopt not in SHORT_OPTIONS:
924
 
                    bailout('unknown short option %r' % a)
925
 
                optname = SHORT_OPTIONS[shortopt]
 
435
                if shortopt in SHORT_OPTIONS:
 
436
                    # Multi-character options must have a space to delimit
 
437
                    # their value
 
438
                    optname = SHORT_OPTIONS[shortopt]
 
439
                else:
 
440
                    # Single character short options, can be chained,
 
441
                    # and have their value appended to their name
 
442
                    shortopt = a[1:2]
 
443
                    if shortopt not in SHORT_OPTIONS:
 
444
                        # We didn't find the multi-character name, and we
 
445
                        # didn't find the single char name
 
446
                        raise BzrError('unknown short option %r' % a)
 
447
                    optname = SHORT_OPTIONS[shortopt]
 
448
 
 
449
                    if a[2:]:
 
450
                        # There are extra things on this option
 
451
                        # see if it is the value, or if it is another
 
452
                        # short option
 
453
                        optargfn = OPTIONS[optname]
 
454
                        if optargfn is None:
 
455
                            # This option does not take an argument, so the
 
456
                            # next entry is another short option, pack it back
 
457
                            # into the list
 
458
                            argv.insert(0, '-' + a[2:])
 
459
                        else:
 
460
                            # This option takes an argument, so pack it
 
461
                            # into the array
 
462
                            optarg = a[2:]
926
463
            
927
464
            if optname in opts:
928
465
                # XXX: Do we ever want to support this, e.g. for -r?
929
 
                bailout('repeated option %r' % a)
 
466
                raise BzrError('repeated option %r' % a)
930
467
                
931
468
            optargfn = OPTIONS[optname]
932
469
            if optargfn:
933
470
                if optarg == None:
934
471
                    if not argv:
935
 
                        bailout('option %r needs an argument' % a)
 
472
                        raise BzrError('option %r needs an argument' % a)
936
473
                    else:
937
474
                        optarg = argv.pop(0)
938
475
                opts[optname] = optargfn(optarg)
939
476
            else:
940
477
                if optarg != None:
941
 
                    bailout('option %r takes no argument' % optname)
 
478
                    raise BzrError('option %r takes no argument' % optname)
942
479
                opts[optname] = True
943
480
        else:
944
481
            args.append(a)
947
484
 
948
485
 
949
486
 
950
 
def _match_args(cmd, args):
951
 
    """Check non-option arguments match required pattern.
952
487
 
953
 
    >>> _match_args('status', ['asdasdsadasd'])
954
 
    Traceback (most recent call last):
955
 
    ...
956
 
    BzrError: ("extra arguments to command status: ['asdasdsadasd']", [])
957
 
    >>> _match_args('add', ['asdasdsadasd'])
958
 
    {'file_list': ['asdasdsadasd']}
959
 
    >>> _match_args('add', 'abc def gj'.split())
960
 
    {'file_list': ['abc', 'def', 'gj']}
961
 
    """
962
 
    # match argument pattern
963
 
    argform = cmd_args.get(cmd, [])
 
488
def _match_argform(cmd, takes_args, args):
964
489
    argdict = {}
965
 
    # TODO: Need a way to express 'cp SRC... DEST', where it matches
966
 
    # all but one.
967
490
 
968
 
    # step through args and argform, allowing appropriate 0-many matches
969
 
    for ap in argform:
 
491
    # step through args and takes_args, allowing appropriate 0-many matches
 
492
    for ap in takes_args:
970
493
        argname = ap[:-1]
971
494
        if ap[-1] == '?':
972
495
            if args:
979
502
                argdict[argname + '_list'] = None
980
503
        elif ap[-1] == '+':
981
504
            if not args:
982
 
                bailout("command %r needs one or more %s"
 
505
                raise BzrCommandError("command %r needs one or more %s"
983
506
                        % (cmd, argname.upper()))
984
507
            else:
985
508
                argdict[argname + '_list'] = args[:]
986
509
                args = []
987
510
        elif ap[-1] == '$': # all but one
988
511
            if len(args) < 2:
989
 
                bailout("command %r needs one or more %s"
 
512
                raise BzrCommandError("command %r needs one or more %s"
990
513
                        % (cmd, argname.upper()))
991
514
            argdict[argname + '_list'] = args[:-1]
992
515
            args[:-1] = []                
994
517
            # just a plain arg
995
518
            argname = ap
996
519
            if not args:
997
 
                bailout("command %r requires argument %s"
 
520
                raise BzrCommandError("command %r requires argument %s"
998
521
                        % (cmd, argname.upper()))
999
522
            else:
1000
523
                argdict[argname] = args.pop(0)
1001
524
            
1002
525
    if args:
1003
 
        bailout("extra arguments to command %s: %r"
1004
 
                % (cmd, args))
 
526
        raise BzrCommandError("extra argument to command %s: %s"
 
527
                              % (cmd, args[0]))
1005
528
 
1006
529
    return argdict
1007
530
 
1008
531
 
1009
532
 
 
533
def apply_profiled(the_callable, *args, **kwargs):
 
534
    import hotshot
 
535
    import tempfile
 
536
    import hotshot.stats
 
537
    pffileno, pfname = tempfile.mkstemp()
 
538
    try:
 
539
        prof = hotshot.Profile(pfname)
 
540
        try:
 
541
            ret = prof.runcall(the_callable, *args, **kwargs) or 0
 
542
        finally:
 
543
            prof.close()
 
544
        stats = hotshot.stats.load(pfname)
 
545
        stats.strip_dirs()
 
546
        stats.sort_stats('cum')   # 'time'
 
547
        ## XXX: Might like to write to stderr or the trace file instead but
 
548
        ## print_stats seems hardcoded to stdout
 
549
        stats.print_stats(20)
 
550
        return ret
 
551
    finally:
 
552
        os.close(pffileno)
 
553
        os.remove(pfname)
 
554
 
 
555
 
1010
556
def run_bzr(argv):
1011
557
    """Execute a command.
1012
558
 
1013
559
    This is similar to main(), but without all the trappings for
1014
560
    logging and error handling.  
 
561
    
 
562
    argv
 
563
       The command-line arguments, without the program name from argv[0]
 
564
    
 
565
    Returns a command status or raises an exception.
 
566
 
 
567
    Special master options: these must come before the command because
 
568
    they control how the command is interpreted.
 
569
 
 
570
    --no-plugins
 
571
        Do not load plugin modules at all
 
572
 
 
573
    --builtin
 
574
        Only use builtin commands.  (Plugins are still allowed to change
 
575
        other behaviour.)
 
576
 
 
577
    --profile
 
578
        Run under the Python profiler.
1015
579
    """
1016
 
 
 
580
    # Load all of the transport methods
 
581
    import bzrlib.transport.local, bzrlib.transport.http
 
582
    
1017
583
    argv = [a.decode(bzrlib.user_encoding) for a in argv]
1018
 
    
1019
 
    try:
1020
 
        args, opts = parse_args(argv[1:])
1021
 
        if 'help' in opts:
1022
 
            # TODO: pass down other arguments in case they asked for
1023
 
            # help on a command name?
1024
 
            if args:
1025
 
                cmd_help(args[0])
1026
 
            else:
1027
 
                cmd_help()
1028
 
            return 0
1029
 
        elif 'version' in opts:
1030
 
            cmd_version()
1031
 
            return 0
1032
 
        cmd = str(args.pop(0))
1033
 
    except IndexError:
1034
 
        log_error('usage: bzr COMMAND')
1035
 
        log_error('  try "bzr help"')
1036
 
        return 1
1037
 
 
1038
 
    canonical_cmd, cmd_handler = get_cmd_handler(cmd)
1039
 
 
1040
 
    # global option
1041
 
    if 'profile' in opts:
1042
 
        profile = True
1043
 
        del opts['profile']
1044
 
    else:
1045
 
        profile = False
1046
 
 
1047
 
    # check options are reasonable
1048
 
    allowed = cmd_options.get(canonical_cmd, [])
1049
 
    for oname in opts:
1050
 
        if oname not in allowed:
1051
 
            bailout("option %r is not allowed for command %r"
1052
 
                    % (oname, cmd))
1053
 
 
1054
 
    # TODO: give an error if there are any mandatory options which are
1055
 
    # not specified?  Or maybe there shouldn't be any "mandatory
1056
 
    # options" (it is an oxymoron)
1057
 
 
1058
 
    # mix arguments and options into one dictionary
1059
 
    cmdargs = _match_args(canonical_cmd, args)
1060
 
    for k, v in opts.items():
1061
 
        cmdargs[k.replace('-', '_')] = v
1062
 
 
1063
 
    if profile:
1064
 
        import hotshot
1065
 
        pffileno, pfname = tempfile.mkstemp()
1066
 
        try:
1067
 
            prof = hotshot.Profile(pfname)
1068
 
            ret = prof.runcall(cmd_handler, **cmdargs) or 0
1069
 
            prof.close()
1070
 
 
1071
 
            import hotshot.stats
1072
 
            stats = hotshot.stats.load(pfname)
1073
 
            #stats.strip_dirs()
1074
 
            stats.sort_stats('time')
1075
 
            ## XXX: Might like to write to stderr or the trace file instead but
1076
 
            ## print_stats seems hardcoded to stdout
1077
 
            stats.print_stats(20)
1078
 
            
1079
 
            return ret
1080
 
 
1081
 
        finally:
1082
 
            os.close(pffileno)
1083
 
            os.remove(pfname)
1084
 
    else:
1085
 
        return cmd_handler(**cmdargs) or 0
1086
 
 
1087
 
 
1088
 
 
1089
 
def _report_exception(e, summary):
1090
 
    import traceback
1091
 
    log_error('bzr: ' + summary)
1092
 
    bzrlib.trace.log_exception(e)
1093
 
    tb = sys.exc_info()[2]
1094
 
    exinfo = traceback.extract_tb(tb)
1095
 
    if exinfo:
1096
 
        sys.stderr.write('  at %s:%d in %s()\n' % exinfo[-1][:3])
1097
 
    sys.stderr.write('  see ~/.bzr.log for debug information\n')
1098
 
 
1099
 
 
1100
 
def cmd_assert_fail():
1101
 
    assert False, "always fails"
 
584
 
 
585
    opt_profile = opt_no_plugins = opt_builtin = False
 
586
 
 
587
    # --no-plugins is handled specially at a very early stage. We need
 
588
    # to load plugins before doing other command parsing so that they
 
589
    # can override commands, but this needs to happen first.
 
590
 
 
591
    for a in argv:
 
592
        if a == '--profile':
 
593
            opt_profile = True
 
594
        elif a == '--no-plugins':
 
595
            opt_no_plugins = True
 
596
        elif a == '--builtin':
 
597
            opt_builtin = True
 
598
        else:
 
599
            break
 
600
        argv.remove(a)
 
601
 
 
602
    if (not argv) or (argv[0] == '--help'):
 
603
        from bzrlib.help import help
 
604
        if len(argv) > 1:
 
605
            help(argv[1])
 
606
        else:
 
607
            help()
 
608
        return 0
 
609
 
 
610
    if argv[0] == '--version':
 
611
        from bzrlib.builtins import show_version
 
612
        show_version()
 
613
        return 0
 
614
        
 
615
    if not opt_no_plugins:
 
616
        from bzrlib.plugin import load_plugins
 
617
        load_plugins()
 
618
 
 
619
    cmd = str(argv.pop(0))
 
620
 
 
621
    cmd_obj = get_cmd_object(cmd, plugins_override=not opt_builtin)
 
622
 
 
623
    if opt_profile:
 
624
        ret = apply_profiled(cmd_obj.run_argv, argv)
 
625
    else:
 
626
        ret = cmd_obj.run_argv(argv)
 
627
    return ret or 0
1102
628
 
1103
629
 
1104
630
def main(argv):
1105
 
    bzrlib.trace.create_tracefile(argv)
1106
 
 
 
631
    import bzrlib.ui
 
632
    bzrlib.trace.log_startup(argv)
 
633
    bzrlib.ui.ui_factory = bzrlib.ui.TextUIFactory()
 
634
 
 
635
    return run_bzr_catch_errors(argv[1:])
 
636
 
 
637
 
 
638
def run_bzr_catch_errors(argv):
1107
639
    try:
1108
640
        try:
1109
 
            ret = run_bzr(argv)
1110
 
            return ret
1111
 
        except BzrError, e:
1112
 
            _report_exception(e, 'error: ' + e.args[0])
1113
 
            if len(e.args) > 1:
1114
 
                for h in e.args[1]:
1115
 
                    # some explanation or hints
1116
 
                    log_error('  ' + h)
1117
 
            return 1
1118
 
        except AssertionError, e:
1119
 
            msg = 'assertion failed'
1120
 
            if str(e):
1121
 
                msg += ': ' + str(e)
1122
 
            _report_exception(e, msg)
1123
 
        except Exception, e:
1124
 
            _report_exception(e, 'exception: %s' % str(e).rstrip('\n'))
1125
 
            return 1
1126
 
    finally:
1127
 
        bzrlib.trace.close_trace()
1128
 
 
1129
 
    ## TODO: Trap AssertionError
1130
 
 
1131
 
    # TODO: Maybe nicer handling of IOError especially for broken pipe.
1132
 
 
1133
 
 
 
641
            return run_bzr(argv)
 
642
        finally:
 
643
            # do this here inside the exception wrappers to catch EPIPE
 
644
            sys.stdout.flush()
 
645
    except BzrCommandError, e:
 
646
        # command line syntax error, etc
 
647
        log_error(str(e))
 
648
        return 1
 
649
    except BzrError, e:
 
650
        bzrlib.trace.log_exception()
 
651
        return 1
 
652
    except AssertionError, e:
 
653
        bzrlib.trace.log_exception('assertion failed: ' + str(e))
 
654
        return 3
 
655
    except KeyboardInterrupt, e:
 
656
        bzrlib.trace.log_exception('interrupted')
 
657
        return 2
 
658
    except Exception, e:
 
659
        import errno
 
660
        if (isinstance(e, IOError) 
 
661
            and hasattr(e, 'errno')
 
662
            and e.errno == errno.EPIPE):
 
663
            bzrlib.trace.note('broken pipe')
 
664
            return 2
 
665
        else:
 
666
            ## import pdb
 
667
            ## pdb.pm()
 
668
            bzrlib.trace.log_exception()
 
669
            return 2
1134
670
 
1135
671
if __name__ == '__main__':
1136
672
    sys.exit(main(sys.argv))