1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
|
#!/usr/bin/env ruby
#
# svnshell.rb : a Ruby-based shell interface for cruising 'round in
# the filesystem.
#
# Usage: ruby svnshell.rb REPOS_PATH, where REPOS_PATH is a path to
# a repository on your local filesystem.
#
# NOTE: This program requires the Ruby readline extension.
# See http://wiki.rubyonrails.com/rails/show/ReadlineLibrary
# for details on how to install readline for Ruby.
#
######################################################################
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
######################################################################
#
require "readline"
require "shellwords"
require "svn/fs"
require "svn/core"
require "svn/repos"
# SvnShell: a Ruby-based shell interface for cruising 'round in
# the filesystem.
class SvnShell
# A list of potential commands. This list is populated by
# the 'method_added' function (see below).
WORDS = []
# Check for methods that start with "do_"
# and list them as potential commands
class << self
def method_added(name)
if /^do_(.*)$/ =~ name.to_s
WORDS << $1
end
end
end
# Constructor for SvnShell
#
# path: The path to a Subversion repository
def initialize(path)
@repos_path = path
@path = "/"
self.rev = youngest_rev
@exited = false
end
# Run the shell
def run
# While the user hasn't typed 'exit' and there is still input to be read
while !@exited and buf = Readline.readline(prompt, true)
# Parse the command line into a single command and arguments
cmd, *args = Shellwords.shellwords(buf)
# Skip empty lines
next if /\A\s*\z/ =~ cmd.to_s
# Open a new connection to the repo
@fs = Svn::Repos.open(@repos_path).fs
setup_root
# Execute the specified command
dispatch(cmd, *args)
# Find a path that exists in the current revision
@path = find_available_path
# Close the connection to the repo
@root.close
end
end
# Private functions
private
# Get the current prompt string
def prompt
# Gather data for the prompt string
if rev_mode?
mode = "rev"
info = @rev
else
mode = "txn"
info = @txn
end
# Return the prompt string
"<#{mode}: #{info} #{@path}>$ "
end
# Dispatch a command to the appropriate do_* subroutine
def dispatch(cmd, *args)
# Dispatch cmd to the appropriate do_* function
if respond_to?("do_#{cmd}", true)
begin
__send__("do_#{cmd}", *args)
rescue ArgumentError
# puts $!.message
# puts $@
puts("Invalid argument for #{cmd}: #{args.join(' ')}")
end
else
puts("Unknown command: #{cmd}")
puts("Try one of these commands: ", WORDS.sort.join(" "))
end
end
# Output the contents of a file from the repository
def do_cat(path)
# Normalize the path to an absolute path
normalized_path = normalize_path(path)
# Check what type of node exists at the specified path
case @root.check_path(normalized_path)
when Svn::Core::NODE_NONE
puts "Path '#{normalized_path}' does not exist."
when Svn::Core::NODE_DIR
puts "Path '#{normalized_path}' is not a file."
else
# Output the file to standard out
@root.file_contents(normalized_path) do |stream|
puts stream.read(@root.file_length(normalized_path))
end
end
end
# Set the current directory
def do_cd(path="/")
# Normalize the path to an absolute path
normalized_path = normalize_path(path)
# If it's a valid directory, then set the directory
if @root.check_path(normalized_path) == Svn::Core::NODE_DIR
@path = normalized_path
else
puts "Path '#{normalized_path}' is not a valid filesystem directory."
end
end
# List the contents of the current directory or provided paths
def do_ls(*paths)
# Default to listing the contents of the current directory
paths << @path if paths.empty?
# Foreach path
paths.each do |path|
# Normalize the path to an absolute path
normalized_path = normalize_path(path)
# Is it a directory or file?
case @root.check_path(normalized_path)
when Svn::Core::NODE_DIR
# Output the contents of the directory
parent = normalized_path
entries = @root.dir_entries(parent)
when Svn::Core::NODE_FILE
# Split the path into directory and filename components
parts = path_to_parts(normalized_path)
name = parts.pop
parent = parts_to_path(parts)
# Output the filename
puts "#{parent}:#{name}"
# Double check that the file exists
# inside the parent directory
parent_entries = @root.dir_entries(parent)
if parent_entries[name].nil?
# Hmm. We found the file, but it doesn't exist inside
# the parent directory. That's a bit unusual.
puts "No directory entry found for '#{normalized_path}'"
next
else
# Save the path so it can be output in detail
entries = {name => parent_entries[name]}
end
else
# Path is not a directory or a file,
# so it must not exist
puts "Path '#{normalized_path}' not found."
next
end
# Output a detailed listing of the files we found
puts " REV AUTHOR NODE-REV-ID SIZE DATE NAME"
puts "-" * 76
# For each entry we found...
entries.keys.sort.each do |entry|
# Calculate the full path to the directory entry
fullpath = parent + '/' + entry
if @root.dir?(fullpath)
# If it's a directory, output an extra slash
size = ''
name = entry + '/'
else
# If it's a file, output the size of the file
size = @root.file_length(fullpath).to_i.to_s
name = entry
end
# Output the entry
node_id = entries[entry].id.to_s
created_rev = @root.node_created_rev(fullpath)
author = @fs.prop(Svn::Core::PROP_REVISION_AUTHOR, created_rev).to_s
date = @fs.prop(Svn::Core::PROP_REVISION_DATE, created_rev)
args = [
created_rev, author[0,8],
node_id, size, date.strftime("%b %d %H:%M(%Z)"), name
]
puts "%6s %8s <%10s> %8s %17s %s" % args
end
end
end
# List all currently open transactions available for browsing
def do_lstxns
# Get a sorted list of open transactions
txns = @fs.transactions
txns.sort
counter = 0
# Output the open transactions
txns.each do |txn|
counter = counter + 1
puts "%8s " % txn
# Every six transactions, output an extra newline
if counter == 6
puts
counter = 0
end
end
puts
end
# Output the properties of a particular path
def do_pcat(path=nil)
# Default to the current directory
catpath = path ? normalize_path(path) : @path
# Make sure that the specified path exists
if @root.check_path(catpath) == Svn::Core::NODE_NONE
puts "Path '#{catpath}' does not exist."
return
end
# Get the list of properties
plist = @root.node_proplist(catpath)
return if plist.nil?
# Output each property
plist.each do |key, value|
puts "K #{key.size}"
puts key
puts "P #{value.size}"
puts value
end
# That's all folks!
puts 'PROPS-END'
end
# Set the current revision to view
def do_setrev(rev)
# Make sure the specified revision exists
begin
@fs.root(Integer(rev)).close
rescue Svn::Error
puts "Error setting the revision to '#{rev}': #{$!.message}"
return
end
# Set the revision
self.rev = Integer(rev)
end
# Open an existing transaction to view
def do_settxn(name)
# Make sure the specified transaction exists
begin
txn = @fs.open_txn(name)
txn.root.close
rescue Svn::Error
puts "Error setting the transaction to '#{name}': #{$!.message}"
return
end
# Set the transaction
self.txn = name
end
# List the youngest revision available for browsing
def do_youngest
rev = @fs.youngest_rev
puts rev
end
# Exit this program
def do_exit
@exited = true
end
# Find the youngest revision
def youngest_rev
Svn::Repos.open(@repos_path).fs.youngest_rev
end
# Set the current revision
def rev=(new_value)
@rev = new_value
@txn = nil
reset_root
end
# Set the current transaction
def txn=(new_value)
@txn = new_value
reset_root
end
# Check whether we are in 'revision-mode'
def rev_mode?
@txn.nil?
end
# Close the current root and setup a new one
def reset_root
if @root
@root.close
setup_root
end
end
# Setup a new root
def setup_root
if rev_mode?
@root = @fs.root(@rev)
else
@root = @fs.open_txn(name).root
end
end
# Convert a path into its component parts
def path_to_parts(path)
path.split(/\/+/)
end
# Join the component parts of a path into a string
def parts_to_path(parts)
normalized_parts = parts.reject{|part| part.empty?}
"/#{normalized_parts.join('/')}"
end
# Convert a path to a normalized, absolute path
def normalize_path(path)
# Convert the path to an absolute path
if path[0,1] != "/" and @path != "/"
path = "#{@path}/#{path}"
end
# Split the path into its component parts
parts = path_to_parts(path)
# Build a list of the normalized parts of the path
normalized_parts = []
parts.each do |part|
case part
when "."
# ignore
when ".."
normalized_parts.pop
else
normalized_parts << part
end
end
# Join the normalized parts together into a string
parts_to_path(normalized_parts)
end
# Find the parent directory of a specified path
def parent_dir(path)
normalize_path("#{path}/..")
end
# Try to land on the specified path as a directory.
# If the specified path does not exist, look for
# an ancestor path that does exist.
def find_available_path(path=@path)
if @root.check_path(path) == Svn::Core::NODE_DIR
path
else
find_available_path(parent_dir(path))
end
end
end
# Autocomplete commands
Readline.completion_proc = Proc.new do |word|
SvnShell::WORDS.grep(/^#{Regexp.quote(word)}/)
end
# Output usage information if necessary
if ARGV.size != 1
puts "Usage: #{$0} REPOS_PATH"
exit(1)
end
# Create a new SvnShell with the command-line arguments and run it
SvnShell.new(ARGV.shift).run
|