19
19
# along with this program. If not, see <http://www.gnu.org/licenses/>.
22
import os, sys, getopt
24
from .config import Config
25
from .vcs.vcs import Vcs
31
29
def __init__( self, version ):
32
self.name = os.path.basename( sys.argv[ 0 ] )
33
30
self.version = version
36
def die( self, error_message ):
37
prefix = self.name + ( ' ' + the.command if the.command else '' )
38
print('%s: %s' % ( prefix, error_message ), file=sys.stderr)
31
self.program = os.path.basename( sys.argv[ 0 ] )
34
def print_usage( self, error_message ):
35
print >> sys.stderr, self.program + ": " + error_message
36
print >> sys.stderr, "Try '" + self.program + " --help' for more information."
42
def print_usage( self, error_message ):
43
command = ' ' + the.command if the.command else ''
44
self.die( error_message + \
45
"\nTry '%s%s --help' for more information." % \
46
( self.name, command ) )
49
40
def print_help( self ):
50
print("Usage: " + self.name + " COMMAND [OPTION]...")
41
print "Usage: " + self.program + " COMMAND [OPTION]..."
52
43
# 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).")
57
print("Global options (for all commands):")
58
print(" --help display help and exit")
59
print(" --version output version information and exit")
62
print(" init initialise a local copy of your repository")
63
print(" update merge remote changes in to your home directory")
64
print(" resolve try to finish an update (that had conflicts)")
65
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")
71
print("Manual staging commands:")
72
print(" stage-add add (but don't commit) files/changes to local repository")
73
# print(" stage-remove delete *but don't comit) files from the local repository")
74
print(" stage-revert revert changes in the local repository")
75
print(" stage-status show status of local repository")
76
# print(" stage-diff shows changes in local repository")
77
print(" stage-commit commit changes in the local repository")
79
print("For help about a particular command (including the additional options that the")
80
print("command accepts) try typing:")
81
print(" $ " + self.name + " COMMAND --help")
44
print "Manage your home directories, across multiple computers, similar to how you"
45
print "would software under version control."
47
print "Global options (for all commands):"
48
print " --help display help and exit"
49
print " --version output version information and exit"
52
print " init initialise a local copy of your repositories"
53
print " update update files in your home directory"
54
print " resolve try to finish an update (that had conflicts)"
55
print " add add local files/changes to the repository"
56
print " remove remove a local file from the repository"
57
print " revert undo changes made to a local file"
58
print " stage-add stage local files/changes"
59
print " stage-remove stage the removal of files"
60
print " stage-revert revert staged changes"
61
print " stage-status show status of staging area"
62
print " stage-commit commit staged changes to repository"
64
print "For help about a particular command (including the additional options that the"
65
print "command accepts) try typing:"
66
print " $ " + self.program + " COMMAND --help"
85
70
def print_version( self ):
86
print("stdhome " + self.version)
88
print("Copyright (C) 2013 to 2014 Tim Marston")
71
print "stdhome " + self.version
73
print "Copyright (C) 2013 Tim Marston"
90
75
# 01234567890123456789012345678901234567890123456789012345678901234567890123456789
91
print("This program is free software, and you may use, modify and redistribute it")
92
print("under the terms of the GNU General Public License version 3 or later. This")
93
print("program comes with ABSOLUTELY NO WARRANTY, to the extent permitted by law.")
95
print("For more information, including documentation, please see the project website")
96
print("at http://ed.am/dev/stdhome.")
98
print("Please report bugs to <tim@ed.am>.")
76
print "This program is free software, and you may use, modify and redistribute it"
77
print "under the terms of the GNU General Public License version 3 or later. This"
78
print "program comes with ABSOLUTELY NO WARRANTY, to the extent permitted by law."
80
print "For more information, including documentation, please see the project website"
81
print "at http://ed.am/dev/stdhome."
83
print "Please report bugs to <tim@ed.am>."
102
87
def check_command( self, command ):
103
"""Check that the given command is valid and return the full name of the
106
@param command the given command
89
Check that the given command is valid and return the full name of the command.
92
- `command`: the given command
110
if [ 'init', 'update', 'resolve', 'add', 'remove', 'revert', 'status',
111
'diff', 'stage-add', 'stage-remove', 'stage-revert',
112
'stage-status', 'stage-diff', 'stage-commit'
113
].count( command ) == 1:
95
if [ 'init', 'update', 'resolve', 'add', 'remove', 'revert',
96
'stage-add', 'stage-remove', 'stage-revert', 'stage-status',
97
'stage-commit' ].count( command ) == 1:
123
'stst': 'stage-status',
124
'stadd': 'stage-add',
125
'strm': 'stage-remove',
126
'stci': 'stage-commit',
127
}.get( command, False )
128
if alias: return alias
101
elif command == 'up':
103
elif command == 'rm':
134
111
def get_command_argument( self, args ):
135
"""Find the first program argument what isn't an option argument.
137
@param args the program arguments
113
Find the first program argument what isn't an option argument.
116
- `args`: the program arguments
141
119
if args[ 0 ] == '--':
142
120
return args[ 1 ] if len( args ) > 1 else None
165
142
self.print_version()
167
144
except getopt.GetoptError as e:
168
# ignore errors -- we aren't parsing the command line properly yet
145
# ignore any errors -- we aren't parsing the command line properly
171
# read program configuration
172
the.config = Config()
174
# find the command by grabbing the first program argument that doesn't
175
# look like an option (note: the first argument that doesn't look like
176
# an option may actually be an argument to an option, so this is far
177
# from perfect, but, provided the user is mindful, this is preferable to
178
# forcing the user to always specify options after the command)
179
the.command = self.get_command_argument( sys.argv[ 1: ] )
180
if the.command == None:
148
# find the first non-option argument (the command)
149
self.command = self.get_command_argument( sys.argv[ 1: ] )
150
if self.command == None:
181
151
self.print_usage( "missing command" )
183
153
# check command is valid
184
the.command = self.check_command( the.command )
185
if the.command == None:
154
self.command = self.check_command( self.command )
155
if self.command == None:
186
156
self.print_usage( "bad command" )
188
# calculate module and class name
189
class_name = module_name = ''
190
bits = the.command.split( '-' )
158
# calculate class name
159
bits = self.command.split( '-' )
160
class_name = 'Command'
192
162
class_name += bit[ 0 ].upper() + bit[ 1 : ]
193
if module_name: module_name += '_'
195
class_name += 'Command'
197
# import module and instantiate the class
198
module = __import__( 'stdhome.command.' + module_name,
199
fromlist = [ class_name ] )
200
instance = getattr( module, class_name )()
202
# fully parse the command line, as per the command
204
instance.parse_command_line()
205
except( getopt.GetoptError, self.UsageError ) as e:
206
self.print_usage( e.msg )
207
except self.FatalError as e:
210
# do late initialisation
216
except Vcs.VcsError as e:
217
message = e.msg.rstrip() + '\n\nVCS OUTPUT:\n' + e.output.rstrip()
219
except self.FatalError as e:
223
class UsageError( Exception ):
225
def __init__( self, error_message ):
226
self.msg = error_message
229
class FatalError( Exception ):
231
def __init__( self, message ):
164
# instantiate and run the command class
165
module = __import__( 'stdhome.command_' + self.command )
166
the_class = getattr( module, class_name )
167
instance = the_class()