42
40
def print_usage( self, error_message ):
43
command = ' ' + the.command if the.command else ''
41
suffix = ' ' + the.command if the.command else ''
44
42
self.die( error_message + \
45
43
"\nTry '%s%s --help' for more information." % \
46
( self.name, command ) )
44
( self.name, suffix ) )
49
47
def print_help( self ):
50
48
print "Usage: " + self.name + " COMMAND [OPTION]..."
52
50
# 01234567890123456789012345678901234567890123456789012345678901234567890123456789
53
print "Tool to manage a set of files in your home directory and distribute them across"
54
print "multiple computers, merging local changes (in the same way as you would manage"
55
print "source code under version control)."
51
print "Manage your home directories, across multiple computers, similar to how you"
52
print "would software under version control."
57
54
print "Global options (for all commands):"
58
55
print " --help display help and exit"
63
60
print " update update files in your home directory"
64
61
print " resolve try to finish an update (that had conflicts)"
65
62
print " add add local files/changes to the repository"
66
# print " remove remove a local file from the repository"
67
print " status list files that have changed locally"
68
print " diff shows changes made to local files"
69
print " revert undo changes made to local files"
70
# print " stage-add add (but don't commit) files/changes to local repository"
71
# print " stage-remove delete *but don't comit) files from the local repository"
72
print " stage-revert revert changes in the local repository"
73
# print " stage-status show status of local repository"
74
# print " stage-diff shows changes in local repository"
75
# print " stage-commit commit changes in the local repository"
63
print " remove remove a local file from the repository"
64
print " revert undo changes made to a local file"
65
print " stage-add stage local files/changes"
66
print " stage-remove stage the removal of files"
67
print " stage-revert revert staged changes"
68
print " stage-status show status of staging area"
69
print " stage-commit commit staged changes to repository"
77
71
print "For help about a particular command (including the additional options that the"
78
72
print "command accepts) try typing:"
83
77
def print_version( self ):
84
78
print "stdhome " + self.version
86
print "Copyright (C) 2013 to 2014 Tim Marston"
80
print "Copyright (C) 2013 Tim Marston"
88
82
# 01234567890123456789012345678901234567890123456789012345678901234567890123456789
89
83
print "This program is free software, and you may use, modify and redistribute it"
100
94
def check_command( self, command ):
101
"""Check that the given command is valid and return the full name of the
104
@param command the given command
96
Check that the given command is valid and return the full name of the command.
99
- `command`: the given command
108
if [ 'init', 'update', 'resolve', 'add', 'remove', 'revert', 'status',
109
'diff', 'stage-add', 'stage-remove', 'stage-revert',
110
'stage-status', 'stage-diff', 'stage-commit'
111
].count( command ) == 1:
102
if [ 'init', 'update', 'resolve', 'add', 'remove', 'revert',
103
'stage-add', 'stage-remove', 'stage-revert', 'stage-status',
104
'stage-commit' ].count( command ) == 1:
114
107
# resolve aliases
120
}.get( command, False )
121
if alias: return alias
108
elif command == 'up':
110
elif command == 'rm':
127
118
def get_command_argument( self, args ):
128
"""Find the first program argument what isn't an option argument.
130
@param args the program arguments
120
Find the first program argument what isn't an option argument.
123
- `args`: the program arguments
134
126
if args[ 0 ] == '--':
135
127
return args[ 1 ] if len( args ) > 1 else None
143
135
# make an initial attempt to parse the command line, looking only for
144
# --help and --version so that they have the chance to run without a
136
# --help and --version, so that they have the chance to run without a
145
137
# command being specified
147
139
opts, args = getopt.gnu_getopt(
161
153
# ignore errors -- we aren't parsing the command line properly yet
164
# read program configuration
165
the.config = Config()
167
# find the command by grabbing the first program argument that doesn't
168
# look like an option (note: the first argument that doesn't look like
169
# an option may actually be an argument to an option, so this is far
170
# from perfect, but, provided the user is mindful, this is preferable to
171
# forcing the user to always specify options after the command)
156
# find the first non-option argument (the command)
172
157
the.command = self.get_command_argument( sys.argv[ 1: ] )
173
158
if the.command == None:
174
159
self.print_usage( "missing command" )
178
163
if the.command == None:
179
164
self.print_usage( "bad command" )
181
# calculate module and class name
182
class_name = module_name = ''
166
# calculate class name
183
167
bits = the.command.split( '-' )
168
class_name = 'Command'
185
170
class_name += bit[ 0 ].upper() + bit[ 1 : ]
186
if module_name: module_name += '_'
188
class_name += 'Command'
190
# import module and instantiate the class
191
module = __import__( 'stdhome.command.' + module_name,
172
# instantiate the command class
173
module = __import__( 'stdhome.command_' + the.command,
192
174
fromlist = [ class_name ] )
193
175
instance = getattr( module, class_name )()
195
# fully parse the command line, as per the command
197
179
instance.parse_command_line()
198
except( getopt.GetoptError, self.UsageError ) as e:
181
except ( getopt.GetoptError, self.UsageError ) as e:
199
182
self.print_usage( e.msg )
200
183
except self.FatalError as e:
203
# do late initialisation
209
except Vcs.VcsError as e:
210
message = e.msg.rstrip()
212
message += '\n\nOUTPUT:\n' + e.output.rstrip()
185
if the.verbose and e.output:
186
message += '\n\nOUTPUT:\n' + e.output
213
187
self.die( message )
214
except self.FatalError as e:
218
190
class UsageError( Exception ):
224
196
class FatalError( Exception ):
226
def __init__( self, message ):
198
def __init__( self, message, output = None ):
227
199
self.msg = message