pluginfactory 1.0.4 → 1.0.5

data/rake/packaging.rb

@@ -1,12 +1,15 @@
 # 
 # Packaging Rake Tasks
-# $Id: packaging.rb 21 2008-08-07 23:45:52Z deveiant $
+
 # 
 
 require 'rbconfig'
+require 'pathname'
 require 'rake/packagetask'
 require 'rake/gempackagetask'
 
+require Pathname( __FILE__ ).dirname.expand_path + 'hg.rb'
+
 include Config
 
 ### Task: gem
@@ -16,8 +19,7 @@ Rake::PackageTask.new( PKG_NAME, PKG_VERSION ) do |task|
 	task.need_tar_bz2  = true
 	task.need_zip      = true
 	task.package_dir   = PKGDIR.to_s
-  	task.package_files = RELEASE_FILES.
-		collect {|f| f.relative_path_from(BASEDIR).to_s }
+  	task.package_files = RELEASE_FILES.collect {|f| f.to_s }
 end
 task :package => [:gem]
 
@@ -36,14 +38,31 @@ file gempath.to_s => [PKGDIR.to_s] + GEMSPEC.files do
 	end
 end
 
+
+prerelease_gempath = PKGDIR + SNAPSHOT_GEM_NAME
+
+desc "Build a pre-release RubyGem package"
+task :prerelease_gem => prerelease_gempath.to_s
+file prerelease_gempath.to_s => [PKGDIR.to_s] + GEMSPEC.files do
+	when_writing( "Creating prerelease GEM" ) do
+		gemspec = GEMSPEC.clone
+		gemspec.version = Gem::Version.create( "%s.%s" % [GEMSPEC.version, PKG_BUILD] )
+		Gem::Builder.new( gemspec ).build
+		verbose( true ) do
+			mv SNAPSHOT_GEM_NAME, prerelease_gempath
+		end
+	end
+end
+
+
 ### Task: install
 desc "Install #{PKG_NAME} as a conventional library"
-task :install do
+task :install => "spec:quiet" do
 	log "Installing #{PKG_NAME} as a conventional library"
 	sitelib = Pathname.new( CONFIG['sitelibdir'] )
 	sitearch = Pathname.new( CONFIG['sitearchdir'] )
 	Dir.chdir( LIBDIR ) do
-		LIB_FILES.each do |libfile|
+		LIB_FILES.collect {|path| Pathname(path) }.each do |libfile|
 			relpath = libfile.relative_path_from( LIBDIR )
 			target = sitelib + relpath
 			FileUtils.mkpath target.dirname,
@@ -53,8 +72,10 @@ task :install do
 		end
 	end
 	if EXTDIR.exist?
+		trace "  looking for a binary extension (%s)" % [ EXTDIR + "*.#{Config::CONFIG['DLEXT']}" ]
 		Dir.chdir( EXTDIR ) do
-			Pathname.glob( EXTDIR + Config::CONFIG['DLEXT'] ) do |dl|
+			Pathname.glob( "*.#{Config::CONFIG['DLEXT']}" ) do |dl|
+				trace "    found: #{dl}"
 				target = sitearch + dl.basename
 				FileUtils.install dl, target, 
 					:mode => 0755, :verbose => true, :noop => $dryrun
@@ -82,7 +103,7 @@ task :uninstall do
 	sitearch = Pathname.new( CONFIG['sitearchdir'] )
 
 	Dir.chdir( LIBDIR ) do
-		LIB_FILES.each do |libfile|
+		LIB_FILES.collect {|path| Pathname(path) }.each do |libfile|
 			relpath = libfile.relative_path_from( LIBDIR )
 			target = sitelib + relpath
 			FileUtils.rm_f target, :verbose => true, :noop => $dryrun
@@ -91,8 +112,10 @@ task :uninstall do
 		end
 	end
 	if EXTDIR.exist?
+		trace "  looking for a binary extension (%s)" % [ EXTDIR + "*.#{Config::CONFIG['DLEXT']}" ]
 		Dir.chdir( EXTDIR ) do
-			Pathname.glob( EXTDIR + Config::CONFIG['DLEXT'] ) do |dl|
+			Pathname.glob( "*.#{Config::CONFIG['DLEXT']}" ) do |dl|
+				trace "    found: #{dl}"
 				target = sitearch + dl.basename
 				FileUtils.rm target, :verbose => true, :noop => $dryrun
 			end
@@ -110,3 +133,12 @@ end
 
 
 
+desc "Add development depdendencies to the gemspec -- this is meant to be chained " +
+     "together with :gem"
+task :include_dev_dependencies do
+	DEVELOPMENT_DEPENDENCIES.each do |name, version|
+		version = '>= 0' if version.length.zero?
+		GEMSPEC.add_development_dependency( name, version )
+	end
+end
+

data/rake/publishing.rb

@@ -26,8 +26,8 @@ class Net::SMTP
 			return self
 		end
 	end
-	
-	
+
+
 	#######
 	private
 	#######
@@ -100,7 +100,7 @@ begin
 
 
 	namespace :release do
-		task :default => [ 'svn:release', :upload, :publish, :announce ]
+		task :default => [ :prep_release, :upload, :publish, :announce ]
 
 		desc "Re-publish the release with the current version number"
 		task :rerelease => [  :upload, :publish, :announce ]
@@ -111,31 +111,28 @@ begin
 			$publish_privately = true
 			Rake::Task['release:rerelease'].invoke
 		end
-		
+
 
 		desc "Generate the release notes"
 		task :notes => [RELEASE_NOTES_FILE]
 		file RELEASE_NOTES_FILE do |task|
-			last_rel_tag = get_latest_release_tag() or
-				fail ">>> No releases tagged! Try running 'rake svn:release' first"
-			trace "Last release tag is: %p" % [ last_rel_tag ]
-			start = get_last_changed_rev( last_rel_tag ) || 1
-			trace "Starting rev is: %p" % [ start ]
-			log_output = make_svn_log( '.', start, 'HEAD' )
+			last_tag = MercurialHelpers.get_tags.grep( /\d+\.\d+\.\d+/ ).
+				collect {|ver| vvec(ver) }.sort.last.unpack( 'N*' ).join('.')
 
 			File.open( task.name, File::WRONLY|File::TRUNC|File::CREAT ) do |fh|
-				fh.print( log_output )
+				fh.puts "Release Notes for #{PKG_VERSION}",
+				        "--------------------------------", '', ''
 			end
 
 			edit task.name
 		end
 		CLOBBER.include( RELEASE_NOTES_FILE )
-		
-		
+
+
 		desc "Upload project documentation and packages to #{PROJECT_HOST}"
 		task :upload => [ :upload_docs, :upload_packages ]
 		task :project => :upload # the old name
-		
+
 		desc "Publish the project docs to #{PROJECT_HOST}"
 		task :upload_docs => [ :rdoc ] do
 			when_writing( "Publishing docs to #{PROJECT_SCPDOCURL}" ) do
@@ -172,7 +169,7 @@ begin
 				== Installation
 
 				Via gems:
-				
+
 				  $ sudo gem install #{GEMSPEC.name}
 
 				or from source:
@@ -185,7 +182,7 @@ begin
 				== Changes
 				#{relnotes}
 			}.gsub( /^\t+/, '' )
-			
+
 			File.open( task.name, File::WRONLY|File::TRUNC|File::CREAT ) do |fh|
 				fh.print( announce_body )
 			end
@@ -193,8 +190,8 @@ begin
 			edit task.name
 		end
 		CLOBBER.include( RELEASE_ANNOUNCE_FILE )
-		
-		
+
+
 		desc 'Send out a release announcement'
 		task :announce => [RELEASE_ANNOUNCE_FILE] do
 			email         = TMail::Mail.new
@@ -217,13 +214,13 @@ begin
 			puts '---',
 			     email.to_s,
 			     '---'
-			
+
 				ask_for_confirmation( "Will send via #{SMTP_HOST}." ) do
 				pwent = Etc.getpwuid( Process.euid )
 				curuser = pwent ? pwent.name : 'unknown'
 				username = prompt_with_default( "SMTP user", curuser )
 				password = prompt_for_password()
-			
+
 				trace "Creating SMTP connection to #{SMTP_HOST}:#{SMTP_PORT}"
 				smtp = Net::SMTP.new( SMTP_HOST, SMTP_PORT )
 				smtp.set_debug_output( $stdout )
@@ -237,73 +234,77 @@ begin
 				trace "done."
 			end
 		end
-		
-	
+
+
 		desc 'Publish the new release to RubyForge'
 		task :publish => [:clean, :package, :notes] do |task|
 			project = GEMSPEC.rubyforge_project
 
-			rf = RubyForge.new
-			log "Loading RubyForge config"
-			rf.configure
-
-			group_id = rf.autoconfig['group_ids'][RUBYFORGE_GROUP] or
-				fail "Your configuration doesn't have a group id for '#{RUBYFORGE_GROUP}'"
-
-			# If this project doesn't yet exist, create it
-			unless rf.autoconfig['package_ids'].key?( project )
-				ask_for_confirmation( "Package '#{project}' doesn't exist on RubyForge. Create it?" ) do
-					log "Creating new package '#{project}'"
-					rf.create_package( group_id, project )
-				end
-			end
-			
-			package_id = rf.autoconfig['package_ids'][ project ]
-     
-			# Make sure this release doesn't already exist
-			releases = rf.autoconfig['release_ids']
-			if releases.key?( GEMSPEC.name ) && releases[ GEMSPEC.name ].key?( PKG_VERSION )
-				log "Rubyforge seems to already have #{ PKG_FILE_NAME }"
+			if $publish_privately
+				log "Skipping push of release files to RubyForge"
 			else
-				config = rf.userconfig or
-					fail "You apparently haven't set up your RubyForge credentials on this machine."
-				config['release_notes'] = GEMSPEC.description
-				config['release_changes'] = File.read( RELEASE_NOTES_FILE )
-
-				files = FileList[ PKGDIR + GEM_FILE_NAME ]
-				files.include PKGDIR + "#{PKG_FILE_NAME}.tar.gz"
-				files.include PKGDIR + "#{PKG_FILE_NAME}.tar.bz2"
-				files.include PKGDIR + "#{PKG_FILE_NAME}.zip"
-
-				log "Releasing #{PKG_FILE_NAME}"
-				when_writing do
-					log "Publishing to RubyForge: \n",
-						"\tproject: #{RUBYFORGE_GROUP}\n",
-						"\tpackage: #{PKG_NAME.downcase}\n",
-						"\tpackage version: #{PKG_VERSION}\n",
-						"\tfiles: " + files.collect {|f| f.to_s }.join(', ') + "\n"
-
-					ask_for_confirmation( "Publish to RubyForge?" ) do
-						log 'Logging in...'
-						rf.login
-						log "Adding the new release to the '#{project}' project"
-						rf.add_release( group_id, package_id, PKG_VERSION, *files )
+				rf = RubyForge.new
+				log "Loading RubyForge config"
+				rf.configure
+
+				group_id = rf.autoconfig['group_ids'][RUBYFORGE_GROUP] or
+					fail "Your configuration doesn't have a group id for '#{RUBYFORGE_GROUP}'"
+
+				# If this project doesn't yet exist, create it
+				unless rf.autoconfig['package_ids'].key?( project )
+					ask_for_confirmation( "Package '#{project}' doesn't exist on RubyForge. Create it?" ) do
+						log "Creating new package '#{project}'"
+						rf.create_package( group_id, project )
+					end
+				end
+
+				package_id = rf.autoconfig['package_ids'][ project ]
+
+				# Make sure this release doesn't already exist
+				releases = rf.autoconfig['release_ids']
+				if releases.key?( GEMSPEC.name ) && releases[ GEMSPEC.name ].key?( PKG_VERSION )
+					log "Rubyforge seems to already have #{ PKG_FILE_NAME }"
+				else
+					config = rf.userconfig or
+						fail "You apparently haven't set up your RubyForge credentials on this machine."
+					config['release_notes'] = GEMSPEC.description
+					config['release_changes'] = File.read( RELEASE_NOTES_FILE )
+
+					files = FileList[ PKGDIR + GEM_FILE_NAME ]
+					files.include PKGDIR + "#{PKG_FILE_NAME}.tar.gz"
+					files.include PKGDIR + "#{PKG_FILE_NAME}.tar.bz2"
+					files.include PKGDIR + "#{PKG_FILE_NAME}.zip"
+
+					log "Releasing #{PKG_FILE_NAME}"
+					when_writing do
+						log "Publishing to RubyForge: \n",
+							"\tproject: #{RUBYFORGE_GROUP}\n",
+							"\tpackage: #{PKG_NAME.downcase}\n",
+							"\tpackage version: #{PKG_VERSION}\n",
+							"\tfiles: " + files.collect {|f| f.to_s }.join(', ') + "\n"
+
+						ask_for_confirmation( "Publish to RubyForge?" ) do
+							log 'Logging in...'
+							rf.login
+							log "Adding the new release to the '#{project}' project"
+							rf.add_release( group_id, package_id, PKG_VERSION, *files )
+						end
 					end
 				end
 			end
 		end
 	end
-	
+
 rescue LoadError => err
 	if !Object.const_defined?( :Gem )
 		require 'rubygems'
 		retry
 	end
-	
+
 	task :no_release_tasks do
 		fail "Release tasks not defined: #{err.message}"
 	end
-	
+
 	task :release => :no_release_tasks
 	task "release:announce" => :no_release_tasks
 	task "release:publish" => :no_release_tasks

data/rake/rdoc.rb

@@ -1,45 +1,30 @@
 # 
 # RDoc Rake tasks
-# $Id: rdoc.rb 86 2009-02-23 06:38:40Z deveiant $
+
 # 
 
+gem 'rdoc', '>= 2.4.3'
+
+require 'rubygems'
 require 'rdoc/rdoc'
 require 'rake/clean'
-
-
-if RDoc::RDoc::GENERATORS.key?( 'darkfish' )
-	$have_darkfish = true
-else
-	trace "No darkfish generator."
-	$have_darkfish = false
-end
-
+require 'rdoc/task'
 
 # Append docs/lib to the load path if it exists for a locally-installed Darkfish
 DOCSLIB = DOCSDIR + 'lib'
 $LOAD_PATH.unshift( DOCSLIB.to_s ) if DOCSLIB.exist?
 
 # Make relative string paths of all the stuff we need to generate docs for
-DOCFILES = LIB_FILES + EXT_FILES + GEMSPEC.extra_rdoc_files
+DOCFILES = Rake::FileList[ LIB_FILES + EXT_FILES + GEMSPEC.extra_rdoc_files ]
 
 
 directory RDOCDIR.to_s
 CLOBBER.include( RDOCDIR )
 
 desc "Build API documentation in #{RDOCDIR}"
-task :rdoc => [ Rake.application.rakefile, *DOCFILES ] do
-	args = RDOC_OPTIONS 
-	args += [ '-o', RDOCDIR.to_s ]
-	args += [ '-f', 'darkfish' ] if $have_darkfish
-	args += DOCFILES.collect {|pn| pn.to_s }
-
-	trace "Building docs with arguments: %s" % [ args.join(' ') ]
-	RDoc::RDoc.new.document( args ) rescue nil
-end
-
-desc "Rebuild API documentation in #{RDOCDIR}"
-task :rerdoc do
-	rm_r( RDOCDIR ) if RDOCDIR.exist?
-	Rake::Task[ :rdoc ].invoke
+RDoc::Task.new do |task|
+	task.main = "README"
+	task.rdoc_files.include( DOCFILES )
+	task.rdoc_dir = RDOCDIR.to_s
+	task.options = RDOC_OPTIONS
 end
-

data/rake/style.rb

@@ -1,6 +1,6 @@
 # 
 # Style Fixup Rake Tasks
-# $Id: style.rb 10 2008-07-18 15:52:48Z deveiant $
+
 # 
 # Authors:
 # * Michael Granger <ged@FaerieMUD.org>

data/rake/svn.rb

@@ -1,6 +1,6 @@
 # 
 # Subversion Rake Tasks
-# $Id: svn.rb 86 2009-02-23 06:38:40Z deveiant $
+
 # 
 # Authors:
 # * Michael Granger <ged@FaerieMUD.org>
@@ -10,593 +10,659 @@ require 'pp'
 require 'yaml'
 require 'date'
 require 'time'
+require 'abbrev'
+
+unless defined?( SVN_DOTDIR )
+
+	# Subversion constants -- directory names for releases and tags
+	SVN_TRUNK_DIR    = 'trunk'
+	SVN_RELEASES_DIR = 'releases'
+	SVN_BRANCHES_DIR = 'branches'
+	SVN_TAGS_DIR     = 'tags'
+
+	SVN_DOTDIR       = BASEDIR + '.svn'
+	SVN_ENTRIES      = SVN_DOTDIR + 'entries'
+
+	# Ignore .svn directories in the various FileLists used by the main Rakefile
+	[
+		BIN_FILES,
+		LIB_FILES,
+		EXT_FILES,
+		DATA_FILES,
+		SPEC_FILES,
+		TEST_FILES,
+		EXTRA_PKGFILES,
+	].each {|filelist| filelist.exclude(/\.svn/) }
+
+	# Strftime format for tags/releases
+	TAG_TIMESTAMP_FORMAT = '%Y%m%d-%H%M%S'
+	TAG_TIMESTAMP_PATTERN = /\d{4}\d{2}\d{2}-\d{6}/
+
+	RELEASE_VERSION_PATTERN = /\d+\.\d+\.\d+/
+
+	DEFAULT_KEYWORDS = %w[Date Rev Author URL Id]
+	KEYWORDED_FILEDIRS = %w[applets spec bin etc ext experiments examples lib misc docs]
+	KEYWORDED_FILEPATTERN = /
+		^(?:
+			(?:meta)?rakefile.*									# Rakefiles
+			|
+			.*\.(?:rb|c|h|js|html|css|template|erb|page)		# Source file extensions
+			|
+			readme|install|todo
+		)$/ix
+
+
+
+	###
+	### Subversion-specific Helpers
+	###
+	module SubversionHelpers
+
+		###############
+		module_function
+		###############
+
+		### Return a new tag for the given time
+		def make_new_tag( time=Time.now )
+			return time.strftime( TAG_TIMESTAMP_FORMAT )
+		end
 
-# Strftime format for tags/releases
-TAG_TIMESTAMP_FORMAT = '%Y%m%d-%H%M%S'
-TAG_TIMESTAMP_PATTERN = /\d{4}\d{2}\d{2}-\d{6}/
-
-RELEASE_VERSION_PATTERN = /\d+\.\d+\.\d+/
-
-DEFAULT_EDITOR = 'vi'
-DEFAULT_KEYWORDS = %w[Date Rev Author URL Id]
-KEYWORDED_FILEDIRS = %w[applets spec bin etc ext experiments examples lib misc docs]
-KEYWORDED_FILEPATTERN = /
-	^(?:
-		(?:meta)?rakefile.*									# Rakefiles
-		|
-		.*\.(?:rb|c|h|js|html|css|template|erb|page)		# Source file extensions
-		|
-		readme|install|todo
-	)$/ix
-
-COMMIT_MSG_FILE = 'commit-msg.txt'
-
-SVN_TRUNK_DIR    = 'trunk' unless defined?( SVN_TRUNK_DIR )
-SVN_RELEASES_DIR = 'branches' unless defined?( SVN_RELEASES_DIR )
-SVN_BRANCHES_DIR = 'branches' unless defined?( SVN_BRANCHES_DIR )
-SVN_TAGS_DIR     = 'tags' unless defined?( SVN_TAGS_DIR )
-
-FILE_INDENT = " " * 12
-LOG_INDENT = " " * 3
-
-
-
-###
-### Subversion-specific Helpers
-###
-
-### Return a new tag for the given time
-def make_new_tag( time=Time.now )
-	return time.strftime( TAG_TIMESTAMP_FORMAT )
-end
-
-
-### Get the subversion information for the current working directory as
-### a hash.
-def get_svn_info( dir='.' )
-	return {} unless File.directory?( File.join(dir, '.svn') )
-	info = IO.read( '|-' ) or exec 'svn', 'info', dir
-	return YAML.load( info ) # 'svn info' outputs valid YAML! Yay!
-rescue NotImplementedError
-	trace "No fork(), proceeding without svn info..."
-	return {}
-end
-
-
-### Get a list of the objects registered with subversion under the specified directory and
-### return them as an Array of Pathame objects.
-def get_svn_filelist( dir='.' )
-	list = IO.read( '|-' ) or exec 'svn', 'st', '-v', '--ignore-externals', dir
-
-	# Split into lines, filter out the unknowns, and grab the filenames as Pathnames
-	# :FIXME: This will break if we ever put in a file with spaces in its name. This
-	# will likely be the least of our worries if we do so, however, so it's not worth
-	# the additional complexity to make it handle that case. If we do need that, there's
-	# always the --xml output for 'svn st'...
-	return list.split( $/ ).
-		reject {|line| line =~ /^(\?|(\s*|--- .*)$)/ }.
-		collect {|fn| Pathname(fn[/\S+$/]) }
-end
-
-### Return the URL to the repository root for the specified +dir+.
-def get_svn_repo_root( dir='.' )
-	info = get_svn_info( dir )
-	return info['Repository Root']
-end
-
-
-### Return the Subversion URL to the given +dir+.
-def get_svn_url( dir='.' )
-	info = get_svn_info( dir )
-	return info['URL']
-end
-
-
-### Return the path of the specified +dir+ under the svn root of the 
-### checkout.
-def get_svn_path( dir='.' )
-	root = get_svn_repo_root( dir )
-	url = get_svn_url( dir )
-	
-	return url.sub( root + '/', '' )
-end
-
-
-### Return the keywords for the specified array of +files+ as a Hash keyed by filename.
-def get_svn_keyword_map( *files )
-	files.flatten!
-	files.push( '.' ) if files.empty?
-
-	cmd = ['svn', 'pg', 'svn:keywords', *files]
-
-	# trace "Executing: svn pg svn:keywords " + files.join(' ')
-	output = IO.read( '|-' ) or exec( 'svn', 'pg', 'svn:keywords', *files )
-	
-	kwmap = {}
-	output.split( "\n" ).each do |line|
-		next if line !~ /\s+-\s+/
-		path, keywords = line.split( /\s+-\s+/, 2 )
-		kwmap[ path ] = keywords.split
-	end
-	
-	return kwmap
-end
-
-
-### Return the latest revision number of the specified +dir+ as an Integer.
-def get_svn_rev( dir='.' )
-	info = get_svn_info( dir )
-	return info['Revision']
-end
-
-
-### Return the latest revision number of the specified +dir+ as an Integer.
-def get_last_changed_rev( dir='.' )
-	info = get_svn_info( dir )
-	return info['Last Changed Rev']
-end
-
-
-### Return a list of the entries at the specified Subversion url. If
-### no +url+ is specified, it will default to the list in the URL
-### corresponding to the current working directory.
-def svn_ls( url=nil )
-	url ||= get_svn_url()
-	list = IO.read( '|-' ) or exec 'svn', 'ls', url
-
-	trace 'svn ls of %s: %p' % [url, list] if $trace
-	
-	return [] if list.nil? || list.empty?
-	return list.split( $INPUT_RECORD_SEPARATOR )
-end
-
-
-### Return the URL of the latest timestamp in the tags directory.
-def get_latest_svn_timestamp_tag
-	rooturl = get_svn_repo_root()
-	tagsurl = rooturl + "/#{SVN_TAGS_DIR}"
-	
-	tags = svn_ls( tagsurl ).grep( TAG_TIMESTAMP_PATTERN ).sort
-	return nil if tags.nil? || tags.empty?
-	return tagsurl + '/' + tags.last
-end
-
-
-### Get a subversion diff of the specified targets and return it. If no targets are
-### specified, the current directory will be diffed instead.
-def get_svn_diff( *targets )
-	targets << BASEDIR if targets.empty?
-	trace "Getting svn diff for targets: %p" % [targets]
-	log = IO.read( '|-' ) or exec 'svn', 'diff', *(targets.flatten)
-
-	return log
-end
-
-
-### Get a subversion status as an Array of tuples of the form:
-###   [ <status>, <path> ]
-def get_svn_status( *targets )
-	targets << BASEDIR if targets.empty?
-	trace "Getting svn status for targets: %p" % [targets]
-	status = IO.read( '|-' ) or exec 'svn', 'st', '--ignore-externals', *(targets.flatten)
-	entries = status.split( /\n/ ).
-		select {|line| line !~ /^(\s*|--- .*)$/ }.
-		collect do |line|
-			flag, path = line.strip.split( /\s+/, 2 )
-			[ flag, Pathname.new(path) ]
-		end
-
-	return entries
-end
-
-
-### Return the URL of the latest timestamp in the tags directory.
-def get_latest_release_tag
-	rooturl    = get_svn_repo_root()
-	releaseurl = rooturl + "/#{SVN_RELEASES_DIR}"
-	
-	tags = svn_ls( releaseurl ).grep( RELEASE_VERSION_PATTERN ).sort_by do |tag|
-		tag[RELEASE_VERSION_PATTERN].split('.').collect {|i| Integer(i) }
-	end
-	return nil if tags.empty?
 
-	return releaseurl + '/' + tags.last
-end
+		### Get the subversion information for the current working directory as
+		### a hash.
+		def get_svn_info( dir='.' )
+			return {} unless File.directory?( File.join(dir, '.svn') )
+			info = IO.read( '|-' ) or exec 'svn', 'info', dir.to_s
+			return YAML.load( info ) # 'svn info' outputs valid YAML! Yay!
+		rescue NotImplementedError
+			trace "No fork(), proceeding without svn info..."
+			return {}
+		end
+
+
+		### Get a list of the objects registered with subversion under the specified directory and
+		### return them as an Array of Pathame objects.
+		def get_svn_filelist( dir='.' )
+			list = IO.read( '|-' ) or exec 'svn', 'st', '-v', '--ignore-externals', dir
+
+			# Split into lines, filter out the unknowns, and grab the filenames as Pathnames
+			# :FIXME: This will break if we ever put in a file with spaces in its name. This
+			# will likely be the least of our worries if we do so, however, so it's not worth
+			# the additional complexity to make it handle that case. If we do need that, there's
+			# always the --xml output for 'svn st'...
+			return list.split( $/ ).
+				reject {|line| line =~ /^(\?|(\s*|--- .*)$)/ }.
+				collect {|fn| Pathname(fn[/\S+$/]) }
+		end
+
+		### Return the URL to the repository root for the specified +dir+.
+		def get_svn_repo_root( dir='.' )
+			info = get_svn_info( dir )
+			return info['Repository Root']
+		end
+
 
+		### Return the Subversion URL to the given +dir+.
+		def get_svn_url( dir='.' )
+			info = get_svn_info( dir )
+			return info['URL']
+		end
 
-### Extract a diff from the specified subversion working +dir+ and return it.
-def make_svn_commit_log( dir='.' )
-	diff = IO.read( '|-' ) or exec 'svn', 'diff'
-	fail "No differences." if diff.empty?
 
-	return diff
-end
+		### Return the path of the specified +dir+ under the svn root of the 
+		### checkout.
+		def get_svn_path( dir='.' )
+			root = get_svn_repo_root( dir )
+			url = get_svn_url( dir )
+
+			return url.sub( root + '/', '' )
+		end
 
 
-### Extract the svn log from the specified subversion working +dir+, 
-### starting from rev +start+ and ending with rev +finish+, and return it.
-def make_svn_log( dir='.', start='PREV', finish='HEAD' )
-	trace "svn log -r#{start}:#{finish} #{dir}"
-	log = IO.read( '|-' ) or exec 'svn', 'log', "-r#{start}:#{finish}", dir
-	fail "No log between #{start} and #{finish}." if log.empty?
+		### Return the keywords for the specified array of +files+ as a Hash keyed by filename.
+		def get_svn_keyword_map( *files )
+			files.flatten!
+			files.push( '.' ) if files.empty?
 
-	return log
-end
+			cmd = ['svn', 'pg', 'svn:keywords', *files]
 
+			# trace "Executing: svn pg svn:keywords " + files.join(' ')
+			output = IO.read( '|-' ) or exec( 'svn', 'pg', 'svn:keywords', *files )
 
-### Extract the verbose XML svn log from the specified subversion working +dir+, 
-### starting from rev +start+ and ending with rev +finish+, and return it.
-def make_xml_svn_log( dir='.', start='PREV', finish='HEAD' )
-	trace "svn log --xml --verbose -r#{start}:#{finish} #{dir}"
-	log = IO.read( '|-' ) or exec 'svn', 'log', '--verbose', '--xml', "-r#{start}:#{finish}", dir
-	fail "No log between #{start} and #{finish}." if log.empty?
+			kwmap = {}
+			output.split( "\n" ).each do |line|
+				next if line !~ /\s+-\s+/
+				path, keywords = line.split( /\s+-\s+/, 2 )
+				kwmap[ path ] = keywords.split
+			end
 
-	return log
-end
+			return kwmap
+		end
 
 
-### Create a changelog from the subversion log of the specified +dir+ and return it.
-def make_svn_changelog( dir='.' )
-	require 'xml/libxml'
+		### Return the latest revision number of the specified +dir+ as an Integer.
+		def get_svn_rev( dir='.' )
+			info = get_svn_info( dir )
+			return info['Revision']
+		end
+		alias get_vcs_rev get_svn_rev
 
-	changelog = ''
-	path_prefix = '/' + get_svn_path( dir ) + '/'
 
-	xmllog = make_xml_svn_log( dir, 0 )
+		### Return the latest revision number of the specified +dir+ as an Integer.
+		def get_last_changed_rev( dir='.' )
+			info = get_svn_info( dir )
+			return info['Last Changed Rev']
+		end
 
-	parser = XML::Parser.string( xmllog )
-	root = parser.parse.root
-	root.find( '//log/logentry' ).to_a.reverse.each do |entry|
-		trace "Making a changelog entry for r%s" % [ entry['revision'] ]
 
-		added   = []
-		deleted = []
-		changed = []
+		### Return a list of the entries at the specified Subversion url. If
+		### no +url+ is specified, it will default to the list in the URL
+		### corresponding to the current working directory.
+		def svn_ls( url=nil )
+			url ||= get_svn_url()
+			list = IO.read( '|-' ) or exec 'svn', 'ls', url
 
-		entry.find( 'paths/path').each do |path|
-			pathname = path.content
-			pathname.sub!( path_prefix , '' ) if pathname.count('/') > 1
+			trace 'svn ls of %s: %p' % [url, list] if $trace
 
-			case path['action']
-			when 'A', 'R'
-				if path['copyfrom-path']
-					verb = path['action'] == 'A' ? 'renamed' : 'copied'
-					added << "%s\n#{FILE_INDENT}-> #{verb} from %s@r%s" % [
-						pathname,
-						path['copyfrom-path'],
-						path['copyfrom-rev'],
-					]
-				else
-					added << "%s (new)" % [ pathname ]
+			return [] if list.nil? || list.empty?
+			return list.split( $INPUT_RECORD_SEPARATOR )
+		end
+
+
+		### Return the URL of the latest timestamp in the tags directory.
+		def get_latest_svn_timestamp_tag
+			rooturl = get_svn_repo_root()
+			tagsurl = rooturl + "/#{SVN_TAGS_DIR}"
+
+			tags = svn_ls( tagsurl ).grep( TAG_TIMESTAMP_PATTERN ).sort
+			return nil if tags.nil? || tags.empty?
+			return tagsurl + '/' + tags.last
+		end
+
+
+		### Get a subversion diff of the specified targets and return it. If no targets are
+		### specified, the current directory will be diffed instead.
+		def get_svn_diff( *targets )
+			targets << BASEDIR if targets.empty?
+			trace "Getting svn diff for targets: %p" % [targets]
+			log = IO.read( '|-' ) or exec 'svn', 'diff', *(targets.flatten)
+
+			return log
+		end
+
+
+		### Generate a commit log and invoke the user's editor on it.
+		def edit_commit_log
+			diff = make_commit_log()
+
+			File.open( COMMIT_MSG_FILE, File::WRONLY|File::TRUNC|File::CREAT ) do |fh|
+				fh.print( diff )
+			end
+
+			edit( COMMIT_MSG_FILE )
+		end
+
+
+		### Get a subversion status as an Array of tuples of the form:
+		###   [ <status>, <path> ]
+		def get_svn_status( *targets )
+			targets << BASEDIR if targets.empty?
+			trace "Getting svn status for targets: %p" % [targets]
+			status = IO.read( '|-' ) or exec 'svn', 'st', '--ignore-externals', *(targets.flatten)
+			entries = status.split( /\n/ ).
+				select {|line| line !~ /^(\s*|--- .*)$/ }.
+				collect do |line|
+					flag, path = line.strip.split( /\s+/, 2 )
+					[ flag, Pathname.new(path) ]
 				end
-			
-			when 'M'
-				changed << pathname
-			
-			when 'D'
-				deleted << pathname
-			
-			else
-				log "Unknown action %p in rev %d" % [ path['action'], entry['revision'] ]
+
+			return entries
+		end
+
+
+		### Return the URL of the latest timestamp in the tags directory.
+		def get_latest_release_tag
+			rooturl    = get_svn_repo_root()
+			releaseurl = rooturl + "/#{SVN_RELEASES_DIR}"
+
+			tags = svn_ls( releaseurl ).grep( RELEASE_VERSION_PATTERN ).sort_by do |tag|
+				tag[RELEASE_VERSION_PATTERN].split('.').collect {|i| Integer(i) }
 			end
-		
-		end
-
-		date = Time.parse( entry.find_first('date').content )
-
-		# cvs2svn doesn't set 'author'
-		author = 'unknown'
-		if entry.find_first( 'author' )
-			author = entry.find_first( 'author' ).content
-		end
-		              
-		msg = entry.find_first( 'msg' ).content
-		rev = entry['revision']
-
-		changelog << "-- #{date.rfc2822} by #{author} (r#{rev}) -----\n"
-		changelog << "   Added:   " << humanize_file_list(added)   << "\n" unless added.empty?
-		changelog << "   Changed: " << humanize_file_list(changed) << "\n" unless changed.empty?
-		changelog << "   Deleted: " << humanize_file_list(deleted) << "\n" unless deleted.empty?
-		changelog << "\n"
-		
-		indent = msg[/^(\s*)/] + LOG_INDENT
-		
-		changelog << indent << msg.strip.gsub(/\n\s*/m, "\n#{indent}")
-		changelog << "\n\n\n"
-	end
-	
-	return changelog
-end
+			return nil if tags.empty?
 
+			return releaseurl + '/' + tags.last
+		end
 
-### Returns a human-scannable file list by joining and truncating the list if it's too long.
-def humanize_file_list( list, indent=FILE_INDENT )
-	listtext = list[0..5].join( "\n#{indent}" )
-	if list.length > 5
-		listtext << " (and %d other/s)" % [ list.length - 5 ]
-	end
-	
-	return listtext
-end
 
+		### Return the names of all existing branches.
+		def get_branch_names
+			rooturl     = get_svn_repo_root()
+			branchesurl = rooturl + "/#{SVN_BRANCHES_DIR}"
 
-### Add the list of +pathnames+ to the svn:ignore list.
-def svn_ignore_files( *pathnames )
-	pathnames.flatten!
+			return svn_ls( branchesurl )
+		end
 
-	map = pathnames.inject({}) do |map,path|
-		map[ path.dirname ] ||= []
-		map[ path.dirname ] << path.basename
-		map
-	end
 
-	trace "Ignoring %d files in %d directories." % [ pathnames.length, map.length ]
+		### Extract a diff from the specified subversion working +dir+ and return it.
+		def make_svn_commit_log( dir='.' )
+			diff = IO.read( '|-' ) or exec 'svn', 'diff'
+			fail "No differences." if diff.empty?
 
-	map.each do |dir, files|
-		trace "  %s: %p" % [ dir, files ]
-		io = open( '|-' ) or exec 'svn', 'pg', 'svn:ignore', dir
-		ignorelist = io.read.strip
-		ignorelist << "\n" << files.join("\n")
-		system 'svn', 'ps', 'svn:ignore', ignorelist, dir
-	end
-end
+			return diff
+		end
 
 
-### Delete the files in the given +filelist+ after confirming with the user.
-def delete_extra_files( filelist )
-	description = humanize_file_list( filelist, '  ' )
-	log "Files to delete:\n ", description
-	ask_for_confirmation( "Really delete them?", false ) do
-		filelist.each do |f|
-			rm_rf( f, :verbose => true )
+		### Extract the svn log from the specified subversion working +dir+, 
+		### starting from rev +start+ and ending with rev +finish+, and return it.
+		def make_svn_log( dir='.', start='PREV', finish='HEAD' )
+			trace "svn log -r#{start}:#{finish} #{dir}"
+			log = IO.read( '|-' ) or exec 'svn', 'log', "-r#{start}:#{finish}", dir
+			fail "No log between #{start} and #{finish}." if log.empty?
+
+			return log
 		end
-	end
-end
 
 
+		### Extract the verbose XML svn log from the specified subversion working +dir+, 
+		### starting from rev +start+ and ending with rev +finish+, and return it.
+		def make_xml_svn_log( dir='.', start='PREV', finish='HEAD' )
+			trace "svn log --xml --verbose -r#{start}:#{finish} #{dir}"
+			log = IO.read( '|-' ) or exec 'svn', 'log', '--verbose', '--xml', "-r#{start}:#{finish}", dir
+			fail "No log between #{start} and #{finish}." if log.empty?
+
+			return log
+		end
+
+
+		### Create a changelog from the subversion log of the specified +dir+ and return it.
+		def make_svn_changelog( dir='.' )
+			require 'xml/libxml'
+
+			changelog = ''
+			path_prefix = '/' + get_svn_path( dir ) + '/'
+
+			xmllog = make_xml_svn_log( dir, 0 )
+
+			parser = XML::Parser.string( xmllog )
+			root = parser.parse.root
+			root.find( '//log/logentry' ).to_a.reverse.each do |entry|
+				trace "Making a changelog entry for r%s" % [ entry['revision'] ]
 
-###
-### Tasks
-###
+				added   = []
+				deleted = []
+				changed = []
 
-desc "Subversion tasks"
-namespace :svn do
+				entry.find( 'paths/path').each do |path|
+					pathname = path.content
+					pathname.sub!( path_prefix , '' ) if pathname.count('/') > 1
 
-	desc "Copy the HEAD revision of the current #{SVN_TRUNK_DIR}/ to #{SVN_TAGS_DIR}/ with a " +
-		 "current timestamp."
-	task :tag do
-		svninfo   = get_svn_info()
-		tag       = make_new_tag()
-		svntrunk  = svninfo['Repository Root'] + "/#{SVN_TRUNK_DIR}"
-		svntagdir = svninfo['Repository Root'] + "/#{SVN_TAGS_DIR}"
-		svntag    = svntagdir + '/' + tag
+					case path['action']
+					when 'A', 'R'
+						if path['copyfrom-path']
+							verb = path['action'] == 'A' ? 'renamed' : 'copied'
+							added << "%s\n#{FILE_INDENT}-> #{verb} from %s@r%s" % [
+								pathname,
+								path['copyfrom-path'],
+								path['copyfrom-rev'],
+							]
+						else
+							added << "%s (new)" % [ pathname ]
+						end
 
-		desc = "Tagging trunk as #{svntag}"
-		ask_for_confirmation( desc ) do
-			msg = prompt_with_default( "Commit log: ", "Tagging for code push" )
-			run 'svn', 'cp', '-m', msg, svntrunk, svntag
+					when 'M'
+						changed << pathname
+
+					when 'D'
+						deleted << pathname
+
+					else
+						log "Unknown action %p in rev %d" % [ path['action'], entry['revision'] ]
+					end
+
+				end
+
+				date = Time.parse( entry.find_first('date').content )
+
+				# cvs2svn doesn't set 'author'
+				author = 'unknown'
+				if entry.find_first( 'author' )
+					author = entry.find_first( 'author' ).content
+				end
+
+				msg = entry.find_first( 'msg' ).content
+				rev = entry['revision']
+
+				changelog << "-- #{date.rfc2822} by #{author} (r#{rev}) -----\n"
+				changelog << "   Added:   " << humanize_file_list(added)   << "\n" unless added.empty?
+				changelog << "   Changed: " << humanize_file_list(changed) << "\n" unless changed.empty?
+				changelog << "   Deleted: " << humanize_file_list(deleted) << "\n" unless deleted.empty?
+				changelog << "\n"
+
+				indent = msg[/^(\s*)/] + LOG_INDENT
+
+				changelog << indent << msg.strip.gsub(/\n\s*/m, "\n#{indent}")
+				changelog << "\n\n\n"
+			end
+
+			return changelog
 		end
-	end
 
 
-	desc "Copy the HEAD revision of the current #{SVN_TRUNK_DIR}/ to #{SVN_BRANCHES_DIR} with a " +
-	     "user-specified name."
-	task :branch, [:name] do |task, args|
-		unless args.name
-			args.name = prompt( "Branch name" ) or abort
-		end
-		
-		svninfo      = get_svn_info()
-		svntrunk     = Pathname.new( svninfo['Repository Root'] ) + SVN_TRUNK_DIR
-		svnbranchdir = Pathname.new( svninfo['Repository Root'] ) + SVN_BRANCHES_DIR
-		svnbranch    = svnbranchdir + args.name
-
-		desc = "Making a new branch: #{svnbranch}"
-		ask_for_confirmation( desc ) do
-			msg = prompt_with_default( "Commit log: ", "Making a '#{args.name}' branch" )
-			run 'svn', 'cp', '-m', msg, svntrunk, svnbranch
-			ask_for_confirmation( "Switch to the new branch?", false ) do
-				run 'svn', 'sw', svnbranch
+		### Returns a human-scannable file list by joining and truncating the list if it's too long.
+		def humanize_file_list( list, indent=FILE_INDENT )
+			listtext = list[0..5].join( "\n#{indent}" )
+			if list.length > 5
+				listtext << " (and %d other/s)" % [ list.length - 5 ]
 			end
+
+			return listtext
 		end
-	end
-	
-
-	desc "Switch to the trunk if the working copy isn't there already."
-	task :trunk do
-		svninfo      = get_svn_info()
-		svntrunk     = Pathname.new( svninfo['Repository Root'] ) + SVN_TRUNK_DIR
-		
-		if svninfo['URL'] != svntrunk.to_s
-			log "Switching to #{svntrunk}"
-			run 'svn', 'sw', svntrunk
-		else
-			log "You are already on trunk (#{svntrunk})"
+
+
+		### Add the list of +pathnames+ to the svn:ignore list.
+		def svn_ignore_files( *pathnames )
+			pathnames.flatten!
+
+			map = pathnames.inject({}) do |map,path|
+				map[ path.dirname ] ||= []
+				map[ path.dirname ] << path.basename
+				map
+			end
+
+			trace "Ignoring %d files in %d directories." % [ pathnames.length, map.length ]
+
+			map.each do |dir, files|
+				trace "  %s: %p" % [ dir, files ]
+				io = open( '|-' ) or exec 'svn', 'pg', 'svn:ignore', dir
+				ignorelist = io.read.strip
+				ignorelist << "\n" << files.join("\n")
+				system 'svn', 'ps', 'svn:ignore', ignorelist, dir
+			end
 		end
-	end
-	
-
-	desc "Copy the most recent tag to #{SVN_RELEASES_DIR}/#{PKG_VERSION}"
-	task :release do
-		last_tag    = get_latest_svn_timestamp_tag()
-		svninfo     = get_svn_info()
-		svnroot     = Pathname.new( svninfo['Repository Root'] )
-		svntrunk    = svnroot + SVN_TRUNK_DIR
-		svnrel      = svnroot + SVN_RELEASES_DIR
-		release     = PKG_VERSION
-		svnrelease  = svnrel + release
-
-		unless svn_ls( svnrel.dirname ).include?( svnrel.basename.to_s + '/' )
-			log "Releases path #{svnrel} does not exist."
-			ask_for_confirmation( "To continue I'll need to create it." ) do
-				run 'svn', 'mkdir', svnrel, '-m', 'Creating releases/ directory'
+
+
+		### Delete the files in the given +filelist+ after confirming with the user.
+		def delete_extra_files( filelist )
+			description = humanize_file_list( filelist, '  ' )
+			log "Files to delete:\n ", description
+			ask_for_confirmation( "Really delete them?", false ) do
+				filelist.each do |f|
+					rm_rf( f, :verbose => true )
+				end
 			end
-		else
-			trace "Found release dir #{svnrel}"
 		end
 
-		releases = svn_ls( svnrel ).collect {|name| name.sub(%r{/$}, '') }
-		trace "Releases: %p" % [releases]
-		if releases.include?( release )
-			error "Version #{release} already has a branch (#{svnrelease}). Did you mean " +
-				"to increment the version in #{VERSION_FILE}?"
-			fail
-		else
-			trace "No #{release} version currently exists"
+	end # module SubversionHelpers
+
+
+	###
+	### Tasks
+	###
+
+	desc "Subversion tasks"
+	namespace :svn do
+		include SubversionHelpers
+
+		desc "Copy the HEAD revision of the current #{SVN_TRUNK_DIR}/ to #{SVN_TAGS_DIR}/ with a " +
+			 "current timestamp."
+		task :tag do
+			svninfo   = get_svn_info()
+			tag       = make_new_tag()
+			svntrunk  = svninfo['Repository Root'] + "/#{SVN_TRUNK_DIR}"
+			svntagdir = svninfo['Repository Root'] + "/#{SVN_TAGS_DIR}"
+			svntag    = svntagdir + '/' + tag
+
+			desc = "Tagging trunk as #{svntag}"
+			ask_for_confirmation( desc ) do
+				msg = prompt_with_default( "Commit log: ", "Tagging for code push" )
+				run 'svn', 'cp', '-m', msg, svntrunk, svntag
+			end
 		end
-		
-		desc = "Tagging trunk as #{svnrelease}..."
-		ask_for_confirmation( desc ) do
-			msg = prompt_with_default( "Commit log: ", "Branching for release" )
-			run 'svn', 'cp', '-m', msg, svntrunk, svnrelease
+
+
+		desc "Copy the HEAD revision of the current #{SVN_TRUNK_DIR}/ to #{SVN_BRANCHES_DIR} with a " +
+		     "user-specified name."
+		task :branch, [:name] do |task, args|
+			branchname = args.name
+			unless branchname
+				branchname = prompt( "Branch name" ) or abort
+			end
+
+			svninfo      = get_svn_info()
+			svntrunk     = Pathname.new( svninfo['Repository Root'] ) + SVN_TRUNK_DIR
+			svnbranchdir = Pathname.new( svninfo['Repository Root'] ) + SVN_BRANCHES_DIR
+			svnbranch    = svnbranchdir + branchname
+
+			desc = "Making a new branch: #{svnbranch}"
+			ask_for_confirmation( desc ) do
+				msg = prompt_with_default( "Commit log: ", "Making a '#{args.name}' branch" )
+				run 'svn', 'cp', '-m', msg, svntrunk, svnbranch
+				ask_for_confirmation( "Switch to the new branch?", false ) do
+					run 'svn', 'sw', svnbranch
+				end
+			end
 		end
-	end
 
-	### Task for debugging the #get_target_args helper
-	task :show_targets do
-		$stdout.puts "Targets from ARGV (%p): %p" % [ARGV, get_target_args()]
-	end
 
+		desc "Switch the working copy to the named branch"
+		task :switch, [:name] do |task, args|
+			branches = get_branch_names().collect {|name| name.chomp('/') }
 
-	desc "Generate a commit log"
-	task :commitlog => [COMMIT_MSG_FILE]
-	
-	desc "Show the (pre-edited) commit log for the current directory"
-	task :show_commitlog do
-		puts make_svn_commit_log()
-	end
-	
+			unless args.name
+				log "Branches are:\n" + branches.collect {|br| "  #{br}" }.join( "\n" )
 
-	file COMMIT_MSG_FILE do
-		diff = make_svn_commit_log()
-		
-		File.open( COMMIT_MSG_FILE, File::WRONLY|File::EXCL|File::CREAT ) do |fh|
-			fh.print( diff )
-		end
+				begin
+					oldproc = Readline.completion_proc
+					abbrev = branches.abbrev 
+					Readline.completion_proc = lambda{|string| abbrev[string] }
+
+					name = prompt( "Branch to switch to" ) or abort
+					args.with_defaults( :name => name )
+				ensure
+					Readline.completion_proc = oldproc unless oldproc.nil?
+				end
+			end
 
-		editor = ENV['EDITOR'] || ENV['VISUAL'] || DEFAULT_EDITOR
-		system editor, COMMIT_MSG_FILE
-		unless $?.success?
-			fail "Editor exited uncleanly."
+			svninfo = get_svn_info()
+			abort "Branch '#{args.name}' does not exist" unless branches.include?( args.name )
+			branchuri = Pathname.new( svninfo['Repository Root'] ) + SVN_BRANCHES_DIR + args.name
+			run 'svn', 'sw', branchuri
 		end
-	end
+		task :sw => :switch
 
 
-	desc "Update from Subversion"
-	task :update do
-		run 'svn', 'up', '--ignore-externals'
-	end
+		desc "Switch to the trunk if the working copy isn't there already."
+		task :trunk do
+			svninfo      = get_svn_info()
+			svntrunk     = Pathname.new( svninfo['Repository Root'] ) + SVN_TRUNK_DIR
+
+			if svninfo['URL'] != svntrunk.to_s
+				log "Switching to #{svntrunk}"
+				run 'svn', 'sw', svntrunk
+			else
+				log "You are already on trunk (#{svntrunk})"
+			end
+		end
 
 
-	desc "Add/ignore any files that are unknown in the working copy"
-	task :newfiles do
-		log "Checking for new files..."
-		entries = get_svn_status()
-		
-		unless entries.empty?
-			files_to_add = []
-			files_to_ignore = []
-			files_to_delete = []
-
-			entries.find_all {|entry| entry[0] == '?'}.each do |entry|
-				action = prompt_with_default( "  #{entry[1]}: (a)dd, (i)gnore, (s)kip (d)elete", 's' )
-				case action
-				when 'a'
-					files_to_add << entry[1]
-				when 'i'
-					files_to_ignore << entry[1]
-				when 'd'
-					files_to_delete << entry[1]
+		desc "Copy the most recent tag to #{SVN_RELEASES_DIR}/#{PKG_VERSION}"
+		task :prep_release do
+			last_tag    = get_latest_svn_timestamp_tag()
+			svninfo     = get_svn_info()
+			svnroot     = Pathname.new( svninfo['Repository Root'] )
+			svntrunk    = svnroot + SVN_TRUNK_DIR
+			svnrel      = svnroot + SVN_RELEASES_DIR
+			release     = PKG_VERSION
+			svnrelease  = svnrel + release
+
+			unless svn_ls( svnrel.dirname ).include?( svnrel.basename.to_s + '/' )
+				log "Releases path #{svnrel} does not exist."
+				ask_for_confirmation( "To continue I'll need to create it." ) do
+					run 'svn', 'mkdir', svnrel, '-m', 'Creating releases/ directory'
 				end
+			else
+				trace "Found release dir #{svnrel}"
 			end
-			
-			unless files_to_add.empty?
-				run 'svn', 'add', *files_to_add
+
+			releases = svn_ls( svnrel ).collect {|name| name.sub(%r{/$}, '') }
+			trace "Releases: %p" % [releases]
+			if releases.include?( release )
+				error "Version #{release} already has a branch (#{svnrelease}). Did you mean " +
+					"to increment the version in #{VERSION_FILE}?"
+				fail
+			else
+				trace "No #{release} version currently exists"
 			end
-		
-			unless files_to_ignore.empty?
-				svn_ignore_files( *files_to_ignore )
+
+			desc = "Tagging trunk as #{svnrelease}..."
+			ask_for_confirmation( desc ) do
+				msg = prompt_with_default( "Commit log: ", "Branching for release" )
+				run 'svn', 'cp', '-m', msg, svntrunk, svnrelease
 			end
+		end
 
-			unless files_to_delete.empty?
-				delete_extra_files( files_to_delete )
+		### Task for debugging the #get_target_args helper
+		task :show_targets do
+			$stdout.puts "Targets from ARGV (%p): %p" % [ARGV, get_target_args()]
+		end
+
+
+		desc "Update from Subversion"
+		task :update do
+			run 'svn', 'up', '--ignore-externals'
+		end
+
+
+		desc "Add/ignore any files that are unknown in the working copy"
+		task :newfiles do
+			log "Checking for new files..."
+			entries = get_svn_status()
+
+			unless entries.empty?
+				files_to_add = []
+				files_to_ignore = []
+				files_to_delete = []
+
+				entries.find_all {|entry| entry[0] == '?'}.each do |entry|
+					action = prompt_with_default( "  #{entry[1]}: (a)dd, (i)gnore, (s)kip (d)elete", 's' )
+					case action
+					when 'a'
+						files_to_add << entry[1]
+					when 'i'
+						files_to_ignore << entry[1]
+					when 'd'
+						files_to_delete << entry[1]
+					end
+				end
+
+				unless files_to_add.empty?
+					run 'svn', 'add', *files_to_add
+				end
+
+				unless files_to_ignore.empty?
+					svn_ignore_files( *files_to_ignore )
+				end
+
+				unless files_to_delete.empty?
+					delete_extra_files( files_to_delete )
+				end
 			end
 		end
-	end
-	task :add => :newfiles
-	
-
-	desc "Check in all the changes in your current working copy"
-	task :checkin => ['svn:update', 'svn:newfiles', 'test', 'svn:fix_keywords', COMMIT_MSG_FILE] do
-		targets = get_target_args()
-		$stderr.puts '---', File.read( COMMIT_MSG_FILE ), '---'
-		ask_for_confirmation( "Continue with checkin?" ) do
-			run 'svn', 'ci', '-F', COMMIT_MSG_FILE, targets
+		task :add => :newfiles
+
+
+		desc "Check in all the changes in your current working copy"
+		task :checkin => ['svn:update', 'svn:newfiles', 'test', 'svn:fix_keywords', COMMIT_MSG_FILE] do
+			targets = get_target_args()
+			$stderr.puts '---', File.read( COMMIT_MSG_FILE ), '---'
+			ask_for_confirmation( "Continue with checkin?" ) do
+				run 'svn', 'ci', '-F', COMMIT_MSG_FILE, targets
+				rm_f COMMIT_MSG_FILE
+			end
+		end
+		task :commit => :checkin
+		task :ci => :checkin
+
+
+		task :clean do
 			rm_f COMMIT_MSG_FILE
 		end
-	end
-	task :commit => :checkin
-	task :ci => :checkin
-	
-	
-	task :clean do
-		rm_f COMMIT_MSG_FILE
-	end
 
-	
-	desc "Check and fix any missing keywords for any files in the project which need them"
-	task :fix_keywords do
-		log "Checking subversion keywords..."
-		paths = get_svn_filelist( BASEDIR ).
-			select {|path| path.file? && path.to_s =~ KEYWORDED_FILEPATTERN }
-
-		trace "Looking at %d paths for keywords:\n  %p" % [paths.length, paths]
-		kwmap = get_svn_keyword_map( paths )
-
-		buf = ''
-		PP.pp( kwmap, buf, 132 )
-		trace "keyword map is: %s" % [buf]
-		
-		files_needing_fixups = paths.find_all do |path|
-			(kwmap[path.to_s] & DEFAULT_KEYWORDS) != DEFAULT_KEYWORDS
-		end
-		
-		unless files_needing_fixups.empty?
-			$stderr.puts "Files needing keyword fixes: ",
-				files_needing_fixups.collect {|f|
-					"  %s: %s" % [f, kwmap[f] ? kwmap[f].join(' ') : "(no keywords)"]
-				}
-			ask_for_confirmation( "Will add default keywords to these files." ) do
-				run 'svn', 'ps', 'svn:keywords', DEFAULT_KEYWORDS.join(' '), *files_needing_fixups
+
+		desc "Check and fix any missing keywords for any files in the project which need them"
+		task :fix_keywords do
+			log "Checking subversion keywords..."
+			paths = get_svn_filelist( BASEDIR ).
+				select {|path| path.file? && path.to_s =~ KEYWORDED_FILEPATTERN }
+
+			trace "Looking at %d paths for keywords:\n  %p" % [paths.length, paths]
+			kwmap = get_svn_keyword_map( paths )
+
+			buf = ''
+			PP.pp( kwmap, buf, 132 )
+			trace "keyword map is: %s" % [buf]
+
+			files_needing_fixups = paths.find_all do |path|
+				(kwmap[path.to_s] & DEFAULT_KEYWORDS) != DEFAULT_KEYWORDS
+			end
+
+			unless files_needing_fixups.empty?
+				$stderr.puts "Files needing keyword fixes: ",
+					files_needing_fixups.collect {|f|
+						"  %s: %s" % [f, kwmap[f] ? kwmap[f].join(' ') : "(no keywords)"]
+					}
+				ask_for_confirmation( "Will add default keywords to these files." ) do
+					run 'svn', 'ps', 'svn:keywords', DEFAULT_KEYWORDS.join(' '), *files_needing_fixups
+				end
+			else
+				log "Keywords are all up to date."
 			end
-		else
-			log "Keywords are all up to date."
 		end
+
+
+		task :debug_helpers do
+			methods = [
+				:get_last_changed_rev,
+				:get_latest_release_tag,
+				:get_latest_svn_timestamp_tag,
+				:get_svn_diff,
+				:get_svn_filelist,
+				:get_svn_info,
+				:get_svn_keyword_map,
+				:get_svn_path,
+				:get_svn_repo_root,
+				:get_svn_rev,
+				:get_svn_status,
+				:get_svn_url,
+				:svn_ls,
+			]
+			maxlen = methods.collect {|sym| sym.to_s.length }.max
+
+			methods.each do |meth|
+				res = send( meth )
+				puts "%*s => %p" % [ maxlen, colorize(meth.to_s, :cyan), res ]
+			end
+		end
+
 	end
 
-	
-	task :debug_helpers do
-		methods = [
-			:get_last_changed_rev,
-			:get_latest_release_tag,
-			:get_latest_svn_timestamp_tag,
-			:get_svn_diff,
-			:get_svn_filelist,
-			:get_svn_info,
-			:get_svn_keyword_map,
-			:get_svn_path,
-			:get_svn_repo_root,
-			:get_svn_rev,
-			:get_svn_status,
-			:get_svn_url,
-			:svn_ls,
-		]
-		maxlen = methods.collect {|sym| sym.to_s.length }.max
-		
-		methods.each do |meth|
-			res = send( meth )
-			puts "%*s => %p" % [ maxlen, colorize(meth.to_s, :cyan), res ]
+	if SVN_DOTDIR.exist?
+		trace "Defining subversion VCS tasks"
+
+		desc "Check in all the changes in your current working copy"
+		task :ci => 'svn:ci'
+		desc "Check in all the changes in your current working copy"
+		task :checkin => 'svn:ci'
+
+		desc "Tag a release"
+		task :prep_release => 'svn:prep_release'
+
+		file COMMIT_MSG_FILE do
+			edit_commit_log()
 		end
+	else
+		trace "Not defining subversion tasks: no #{SVN_DOTDIR}"
 	end
-end
+
+end # unless defined?( SVN_DOTDIR )