hoe-mercurial 1.1.0

data/ChangeLog

@@ -0,0 +1,143 @@
+2010-12-21  Michael Granger  <ged@FaerieMUD.org>
+
+	* .hgtags:
+	Added tag v1.1.0 for changeset b5258eedbb47
+	[e9bdf9672799] [master, tip]
+
+	* .hgsigs:
+	Added signature for changeset 6d0d956a3ada
+	[b5258eedbb47] [v1.1.0]
+
+	* README.md, Rakefile:
+	Markdown fixes, README updates, turn on tag-signing.
+	[6d0d956a3ada] [github/master]
+
+	* .hgignore, CHANGELOG.rdoc, History.md, Manifest.txt, README.md,
+	README.rdoc, Rakefile, lib/hoe/hg.rb, lib/hoe/mercurial.rb:
+	Tabify, finish name-change, split history and changelog, rdoc ->
+	Markdown
+	[500441aaf812]
+
+	* README.rdoc, Rakefile, lib/hoe/hg.rb:
+	Update the README with fork info, gem name change to hoe-mercurial,
+	bugfixes.
+	[3aebc113ee1c]
+
+2010-12-14  Michael Granger  <ged@FaerieMUD.org>
+
+	* Rakefile:
+	Require the local hoe/hg before loading plugins.
+	[66f734138092]
+
+2010-12-13  Michael Granger  <ged@FaerieMUD.org>
+
+	* Rakefile, lib/hoe/hg.rb:
+	Hoespec update,
+	* Add myself to the developers list, as 'hg churn' says 56% of the
+	code is my fault.
+	* Move the 'ci' task into the plugin
+	* Add a :pre task for making prerelease gems so I can eat my own food
+	* Bump hoe dependency to 2.8.0
+	* Make the hoe depedency a pessimistic
+	* Change versioning to use the semantic versioning standard for tags
+	[757913bd6273]
+
+2010-12-10  Michael Granger  <ged@FaerieMUD.org>
+
+	* lib/hoe/hg.rb:
+	Only sign if hg_sign_tags is true
+	[9401777a9ead]
+
+2010-12-08  Michael Granger  <ged@FaerieMUD.org>
+
+	* Rakefile:
+	Default ENV['VERSION']
+	[78b1b7a07509]
+
+	* lib/hoe/hg.rb:
+	Fix the tag-extractor function
+	[08eb1bdc0a57]
+
+	* .hgignore, Rakefile, lib/hoe/hg.rb:
+	Merging in my Mercurial rake task library.
+	* Fixes for 1.9.2
+	* Adding tasks for checkin, pull, push, and a (IMO) cleaner release-
+	check task, hooked on 'prerelease' instead of 'release_sanity', as
+	there are circumstances in which you might want to release with
+	outstanding changes (e.g., preprelease gems)
+	[e875bbbdfc06]
+
+2010-01-15  mml  <mml>
+
+	* .hgtags:
+	tagging r1.0.5 for release
+	[0f0b88dd5cba]
+
+	* CHANGELOG.rdoc, Rakefile, lib/hoe/hg.rb:
+	updated changelog & bumprev
+	[385c3a28eb3d] [r1.0.5]
+
+	* CHANGELOG.rdoc, README.rdoc:
+	bumped rev
+	[0a9a4b6d25c9]
+
+	* lib/hoe/hg.rb:
+	bumped rev
+	[1e6d706b5749]
+
+	* Rakefile:
+	removed auto-set of VER
+	[02a6bde36a66]
+
+	* .hgtags:
+	tagging r1.0.3 for release
+	[e44ecb58aeee]
+
+	* CHANGELOG.rdoc, lib/hoe/hg.rb:
+	fixie
+	[18c33e15c18b] [r1.0.3]
+
+	* Rakefile, lib/hoe/hg.rb:
+	more updates
+	[ced484fa5698]
+
+	* .hgtags:
+	tagging r1.0.1 for release
+	[af15ccec537a]
+
+	* .hgtags:
+	tagging r1.0.0 for release
+	[4597b7507145] [r1.0.1]
+
+	* README.rdoc, lib/hoe/hg.rb:
+	fixed sanity check
+	[b687d8a8393e] [r1.0.0]
+
+	* CHANGELOG.rdoc:
+	changelog update
+	[c9ab41f8f4f3]
+
+	* CHANGELOG.rdoc, lib/hoe/hg.rb:
+	removed changelog generation stuff.
+	[1da95eeab61b]
+
+	* .hgignore, Manifest.txt, Rakefile, lib/hoe/hg.rb:
+	removed some comments, ported sanity
+	[64235fa1b635]
+
+	* Manifest.txt, lib/hoe/hg.rb:
+	ported to use hg
+	[44e73e6cc634]
+
+	* .hgtags:
+	Removed tag bar
+	[48ae61cd50eb]
+
+	* .hgtags:
+	Added tag bar for changeset 5163b27315b4
+	[c2cd50b7e784]
+
+	* .hgignore, CHANGELOG.rdoc, Manifest.txt, README.rdoc, Rakefile,
+	lib/hoe/hg.rb:
+	r1
+	[5163b27315b4]

data/History.md

@@ -0,0 +1,5 @@
+
+## 1.1.0 [2010-12-14] Michael Granger <ged@FaerieMUD.org>
+
+Initial release after forking from hoe-hg.
+

data/README.md

@@ -0,0 +1,107 @@
+# (Another) Mercurial Plugin for hoe
+
+* http://bitbucket.org/ged/hoe-mercurial
+
+
+## Description
+
+This is a fork of the [hoe-hg](https://bitbucket.org/mml/hoe-hg) 
+plugin. I forked it because I use quite a few additional Mercurial 
+tasks for my development workflow than are provided by the original, 
+and I thought they'd possibly be useful to someone else.
+
+I've offered to push my changes back up to the original, but I gave
+up waiting for a response.
+
+
+## Examples
+
+	# in your Rakefile
+	Hoe.plugin :mercurial
+
+If there isn't a '.hg' directory at the root of your project, it won't 
+be activated.
+
+
+### Committing
+
+	$ rake hg:checkin
+
+-or-
+
+	$ rake ci
+
+This will offer to pull and merge from the default repo (if there is one), 
+check for any unregistered files and offer to add/ignore/delete or 
+temporarily skip them, run the **:precheckin** task (which you can use to
+run tests, lint, or whatever before checking in), builds a commit message
+file out of the diff that's being committed and invokes your editor on it, 
+does the checkin, then offers to push back to the default repo.
+
+### Pre-Release Hook
+
+This plugin also hooks Hoe's **prerelease** task to tag and (optionally) sign 
+the rev being released, then push to the default repo. If there are any 
+uncommitted files, it also verifies that you want to release with 
+uncommitted changes, and ensures you've bumped the version number by 
+checking for an existing tag with the same version.
+
+To sign tagged revisions using 'hg sign', do this in your hoespec:
+
+	self.hg_sign_tags = true
+
+This requires that 'hg sign' work on its own, of course.
+
+
+### Other Tasks
+
+It also provides other tasks for pulling, updating, pushing, etc. These
+aren't very useful on their own, as it's usually just as easy to do the
+same thing yourself with 'hg', but they're intended to be used as 
+dependencies in other tasks. 
+
+A 'rake -T' will show them all; they're all in the 'hg' namespace.
+
+
+## Dependencies
+
+Hoe and Mercurial, obviously. I haven't tested these tasks with Mercurial
+versions earlier than 1.6 or so.
+
+
+## Installation
+
+	$ gem install hoe-mercurial
+
+
+## License
+
+The original is used under the terms of the following license:
+
+	Copyright 2009 McClain Looney (m@loonsoft.com)
+	
+	Permission is hereby granted, free of charge, to any person obtaining
+	a copy of this software and associated documentation files (the
+	'Software'), to deal in the Software without restriction, including
+	without limitation the rights to use, copy, modify, merge, publish,
+	distribute, sublicense, and/or sell copies of the Software, and to
+	permit persons to whom the Software is furnished to do so, subject to
+	the following conditions:
+	
+	The above copyright notice and this permission notice shall be
+	included in all copies or substantial portions of the Software.
+	
+	THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+	EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+	IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+	CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+	TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+	SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+My modifications are:
+
+	Copyright © 2010 Michael Granger <ged@FaerieMUD.org>
+
+and are licensed under the same terms as the original.
+

data/Rakefile

@@ -0,0 +1,67 @@
+#!rake
+#encoding: utf-8
+
+require 'hoe'
+require 'rake/clean'
+
+# 1.9.2 and later require explicit relative require
+if defined?( require_relative )
+	$stderr.puts "Requiring relative lib/hoe/mercurial..."
+	require_relative "lib/hoe/mercurial"
+	$stderr.puts "	require done."
+else
+	$LOAD_PATH.unshift( 'lib' )
+	require 'hoe/mercurial'
+end
+
+
+Hoe.plugin :mercurial
+Hoe.plugin :signing
+
+Hoe.plugins.delete :rubyforge
+
+### Main spec
+hoespec = Hoe.spec "hoe-mercurial" do
+	developer "Michael Granger", "ged@FaerieMUD.org"
+
+	self.extra_rdoc_files = FileList["*.rdoc"]
+	self.history_file     = "History.md"
+	self.readme_file      = "README.md"
+
+	self.hg_sign_tags     = true
+
+	extra_deps << ["hoe", "~> 2.8.0"]
+end
+
+
+include Hoe::MercurialHelpers
+
+### Task: prerelease
+desc "Append the package build number to package versions"
+task :pre do
+	rev = get_numeric_rev()
+	trace "Current rev is: %p" % [ rev ]
+	hoespec.spec.version.version << "pre#{rev}"
+	Rake::Task[:gem].clear
+
+	Gem::PackageTask.new( hoespec.spec ) do |pkg|
+		pkg.need_zip = true
+		pkg.need_tar = true
+	end
+end
+
+
+### Make the ChangeLog update if the repo has changed since it was last built
+file '.hg/branch'
+file 'ChangeLog' => '.hg/branch' do |task|
+	log "Updating the changelog..."
+	content = make_changelog()
+	File.open( task.name, 'w', 0644 ) do |fh|
+		fh.print( content )
+	end
+end
+
+# Rebuild the ChangeLog immediately before release
+task :prerelease => 'ChangeLog'
+
+

data/lib/hoe/mercurial.rb

@@ -0,0 +1,626 @@
+#!/usr/bin/env ruby
+#coding: utf-8
+
+require 'pathname'
+require 'shellwords'
+require 'fileutils'
+require 'rake/clean'
+
+begin
+	require 'readline'
+	include Readline
+rescue LoadError
+	# Fall back to a plain prompt
+	def readline( text )
+		$stderr.print( text.chomp )
+		return $stdin.gets
+	end
+end
+
+class Hoe
+
+	### Prompting, command-execution, and other utility functions
+	module RakeHelpers
+
+		# The editor to invoke if ENV['EDITOR'] and ENV['VISUAL'] aren't set.
+		DEFAULT_EDITOR = 'vi'
+
+		# Set some ANSI escape code constants (Shamelessly stolen from Perl's
+		# Term::ANSIColor by Russ Allbery <rra@stanford.edu> and Zenin <zenin@best.com>
+		ANSI_ATTRIBUTES = {
+			'clear'			 => 0,
+			'reset'			 => 0,
+			'bold'			 => 1,
+			'dark'			 => 2,
+			'underline'	 => 4,
+			'underscore' => 4,
+			'blink'			 => 5,
+			'reverse'		 => 7,
+			'concealed'	 => 8,
+
+			'black'			 => 30,		'on_black'	 => 40, 
+			'red'				 => 31,		'on_red'		 => 41, 
+			'green'			 => 32,		'on_green'	 => 42, 
+			'yellow'		 => 33,		'on_yellow'	 => 43, 
+			'blue'			 => 34,		'on_blue'		 => 44, 
+			'magenta'		 => 35,		'on_magenta' => 45, 
+			'cyan'			 => 36,		'on_cyan'		 => 46, 
+			'white'			 => 37,		'on_white'	 => 47
+		}
+
+		# Prompt for multiline input
+		MULTILINE_PROMPT = <<-'EOF'
+		Enter one or more values for '%s'.
+		A blank line finishes input.
+		EOF
+
+		# ANSI escapes for clearing to the end of the line and the entire line
+		CLEAR_TO_EOL			 = "\e[K"
+		CLEAR_CURRENT_LINE = "\e[2K"
+
+
+		###############
+		module_function
+		###############
+
+		### Create a string that contains the ANSI codes specified and return it
+		def ansi_code( *attributes )
+			attributes.flatten!
+			attributes.collect! {|at| at.to_s }
+			# $stderr.puts "Returning ansicode for TERM = %p: %p" %
+			#		[ ENV['TERM'], attributes ]
+			return '' unless /(?:vt10[03]|xterm(?:-color)?|linux|screen)/i =~ ENV['TERM']
+			attributes = ANSI_ATTRIBUTES.values_at( *attributes ).compact.join(';')
+
+			# $stderr.puts "	attr is: %p" % [attributes]
+			if attributes.empty? 
+				return ''
+			else
+				return "\e[%sm" % attributes
+			end
+		end
+
+
+		### Colorize the given +string+ with the specified +attributes+ and return it, handling 
+		### line-endings, color reset, etc.
+		def colorize( *args )
+			string = ''
+
+			if block_given?
+				string = yield
+			else
+				string = args.shift
+			end
+
+			ending = string[/(\s)$/] || ''
+			string = string.rstrip
+
+			return ansi_code( args.flatten ) + string + ansi_code( 'reset' ) + ending
+		end
+
+
+		### Output the specified <tt>msg</tt> as an ANSI-colored error message
+		### (white on red).
+		def error_message( msg, details='' )
+			$stderr.puts colorize( 'bold', 'white', 'on_red' ) { msg } + details
+		end
+		alias :error :error_message
+
+
+		### Make a prompt string that will always appear flush left.
+		def make_prompt_string( string )
+			return CLEAR_CURRENT_LINE + colorize( 'bold', 'green' ) { string + ' ' }
+		end
+
+
+		### Output the specified <tt>prompt_string</tt> as a prompt (in green) and
+		### return the user's input with leading and trailing spaces removed.	 If a
+		### test is provided, the prompt will repeat until the test returns true.
+		### An optional failure message can also be passed in.
+		def prompt( prompt_string, failure_msg="Try again." ) # :yields: response
+			prompt_string.chomp!
+			prompt_string << ":" unless /\W$/.match( prompt_string )
+			response = nil
+
+			begin
+				prompt = make_prompt_string( prompt_string )
+				response = readline( prompt ) || ''
+				response.strip!
+				if block_given? && ! yield( response ) 
+					error_message( failure_msg + "\n\n" )
+					response = nil
+				end
+			end while response.nil?
+
+			return response
+		end
+
+
+		### Prompt the user with the given <tt>prompt_string</tt> via #prompt,
+		### substituting the given <tt>default</tt> if the user doesn't input
+		### anything.	 If a test is provided, the prompt will repeat until the test
+		### returns true.	 An optional failure message can also be passed in.
+		def prompt_with_default( prompt_string, default, failure_msg="Try again." )
+			response = nil
+
+			begin
+				default ||= '~'
+				response = prompt( "%s [%s]" % [ prompt_string, default ] )
+				response = default.to_s if !response.nil? && response.empty? 
+
+				trace "Validating response %p" % [ response ]
+
+				# the block is a validator.	 We need to make sure that the user didn't
+				# enter '~', because if they did, it's nil and we should move on.	 If
+				# they didn't, then call the block.
+				if block_given? && response != '~' && ! yield( response )
+					error_message( failure_msg + "\n\n" )
+					response = nil
+				end
+			end while response.nil?
+
+			return nil if response == '~'
+			return response
+		end
+
+
+		### Prompt for an array of values
+		def prompt_for_multiple_values( label, default=nil )
+			$stderr.puts( MULTILINE_PROMPT % [label] )
+			if default
+				$stderr.puts "Enter a single blank line to keep the default:\n	%p" % [ default ]
+			end
+
+			results = []
+			result = nil
+
+			begin
+				result = readline( make_prompt_string("> ") )
+				if result.nil? || result.empty?
+					results << default if default && results.empty?
+				else
+					results << result 
+				end
+			end until result.nil? || result.empty?
+
+			return results.flatten
+		end
+
+
+		### Display a description of a potentially-dangerous task, and prompt
+		### for confirmation. If the user answers with anything that begins
+		### with 'y', yield to the block. If +abort_on_decline+ is +true+,
+		### any non-'y' answer will fail with an error message.
+		def ask_for_confirmation( description, abort_on_decline=true )
+			prompt = 'Continue?'
+
+			# If the description looks like a question, use it for the prompt. Otherwise,
+			# print it out and 
+			if description.strip.rindex( '?' )
+				prompt = description
+			else
+				log description
+			end
+
+			answer = prompt_with_default( prompt, 'n' ) do |input|
+				input =~ /^[yn]/i
+			end
+
+			if answer =~ /^y/i
+				return yield
+			elsif abort_on_decline
+				error "Aborted."
+				fail
+			end
+
+			return false
+		end
+		alias :prompt_for_confirmation :ask_for_confirmation
+
+
+		### Output a logging message
+		def log( *msg )
+			output = colorize( msg.flatten.join(' '), 'cyan' )
+			$stderr.puts( output )
+		end
+
+
+		### Output a logging message if tracing is on
+		def trace( *msg )
+			return unless Rake.application.options.trace
+			output = colorize( msg.flatten.join(' '), 'yellow' )
+			$stderr.puts( output )
+		end
+
+
+		### Return the specified args as a string, quoting any that have a space.
+		def quotelist( *args )
+			return args.flatten.collect {|part| part =~ /\s/ ? part.inspect : part}
+		end
+
+
+		### Run the specified command +cmd+ with system(), failing if the execution
+		### fails. Doesn't invoke a subshell (unlike 'sh').
+		def run( *cmd )
+			cmd.flatten!
+
+			if cmd.length > 1
+				trace( "Running:", quotelist(*cmd) )
+			else
+				trace( "Running:", cmd )
+			end
+
+			if Rake.application.options.dryrun
+				log "(dry run mode)"
+			else
+				system( *cmd )
+				unless $?.success?
+					fail "Command failed: [%s]" % [cmd.join(' ')]
+				end
+			end
+		end
+
+
+		### Invoke the user's editor on the given +filename+ and return the exit code
+		### from doing so.
+		def edit( filename )
+			editor = ENV['EDITOR'] || ENV['VISUAL'] || DEFAULT_EDITOR
+			system editor, filename
+			unless $?.success? || editor =~ /vim/i
+				fail "Editor exited uncleanly."
+			end
+		end
+
+
+		### Run the given +cmd+ with the specified +args+ without interpolation by the shell and
+		### return anything written to its STDOUT.
+		def read_command_output( cmd, *args )
+			# output = IO.read( '|-' ) or exec cmd, *args # No popen on some platforms. :(
+			argstr = Shellwords.join( args )
+			output = `#{cmd} #{argstr}`.chomp
+			return output
+		end
+
+
+		### Extract all the non Rake-target arguments from ARGV and return them.
+		def get_target_args
+			args = ARGV.reject {|arg| arg =~ /^-/ || Rake::Task.task_defined?(arg) }
+			return args
+		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
+
+	end # module RakeHelpers
+
+
+	### Mercurial command wrapper functions.
+	module MercurialHelpers
+		include FileUtils,
+		        Hoe::RakeHelpers
+		include FileUtils::DryRun if Rake.application.options.dryrun
+
+		# The name of the ignore file
+		IGNORE_FILE = Pathname( '.hgignore' )
+
+
+		### Generate a commit log from a diff and return it as a String. At the moment it just
+		### returns the diff as-is, but will (someday) do something better.
+		def make_commit_log
+			diff = read_command_output( 'hg', 'diff' )
+			fail "No differences." if diff.empty?
+
+			return diff
+		end
+
+
+		### Generate a commit log and invoke the user's editor on it.
+		def edit_commit_log( logfile )
+			diff = make_commit_log()
+
+			File.open( logfile, 'w' ) do |fh|
+				fh.print( diff )
+			end
+
+			edit( logfile )
+		end
+
+
+		### Generate a changelog.
+		def make_changelog
+			log = read_command_output( 'hg', 'log', '--style', 'changelog' )
+			return log
+		end
+
+
+		def get_manifest
+			raw = read_command_output( 'hg', 'manifest' )
+			return raw.split( $/ )
+		end
+
+
+		### Get the 'tip' info and return it as a Hash
+		def get_tip_info
+			data = read_command_output( 'hg', 'tip' )
+			return YAML.load( data )
+		end
+
+
+		### Return the ID for the current rev
+		def get_current_rev
+			id = read_command_output( 'hg', '-q', 'identify' )
+			return id.chomp
+		end
+
+
+		### Return the current numeric (local) rev number
+		def get_numeric_rev
+			id = read_command_output( 'hg', '-q', 'identify', '-n' )
+			return id.chomp[ /^(\d+)/, 1 ] || '0'
+		end
+
+
+		### Read the list of existing tags and return them as an Array
+		def get_tags
+			taglist = read_command_output( 'hg', 'tags' )
+			return taglist.split( /\n/ ).collect {|tag| tag[/^\S+/] }
+		end
+
+
+		### Read any remote repo paths known by the current repo and return them as a hash.
+		def get_repo_paths
+			paths = {}
+			pathspec = read_command_output( 'hg', 'paths' )
+			pathspec.split.each_slice( 3 ) do |name, _, url|
+				paths[ name ] = url
+			end
+			return paths
+		end
+
+
+		### Return the list of files which are not of status 'clean'
+		def get_uncommitted_files
+			list = read_command_output( 'hg', 'status', '-n', '--color', 'never' )
+			list = list.split( /\n/ )
+
+			trace "Changed files: %p" % [ list ]
+			return list
+		end
+
+
+		### Return the list of files which are of status 'unknown'
+		def get_unknown_files
+			list = read_command_output( 'hg', 'status', '-un', '--color', 'never' )
+			list = list.split( /\n/ )
+
+			trace "New files: %p" % [ list ]
+			return list
+		end
+
+
+		### Add the list of +pathnames+ to the .hgignore list.
+		def hg_ignore_files( *pathnames )
+			patterns = pathnames.flatten.collect do |path|
+				'^' + Regexp.escape(path) + '$'
+			end
+			trace "Ignoring %d files." % [ pathnames.length ]
+
+			IGNORE_FILE.open( File::CREAT|File::WRONLY|File::APPEND, 0644 ) do |fh|
+				fh.puts( patterns )
+			end
+		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 )
+				end
+			end
+		end
+
+	end # module MercurialHelpers
+
+
+
+	module Mercurial
+		include Hoe::RakeHelpers,
+		        Hoe::MercurialHelpers
+
+		VERSION = "1.1.0"
+
+		# The name of the file to edit for the commit message
+		COMMIT_MSG_FILE = 'commit-msg.txt'
+
+		attr_accessor :hg_release_tag_prefix
+		attr_accessor :hg_repo, :hg_release_branch
+		attr_accessor :hg_sign_tags
+
+
+		### Set up defaults
+		def initialize_mercurial
+			# Follow semantic versioning tagging specification (http://semver.org/)
+			self.hg_release_tag_prefix = "v"
+			self.hg_release_branch     = "default"
+			self.hg_sign_tags          = false
+		end
+
+
+		### Hoe hook -- Define Rake tasks when the plugin is loaded.
+		def define_mercurial_tasks
+			return unless File.exist? ".hg"
+
+			file COMMIT_MSG_FILE do |task|
+				edit_commit_log( task.name )
+			end
+
+			namespace :hg do
+
+				desc "Prepare for a new release"
+				task :prep_release do
+					uncommitted_files = get_uncommitted_files()
+					unless uncommitted_files.empty?
+						log "Uncommitted files:\n",
+							*uncommitted_files.map {|fn| "	#{fn}\n" }
+						ask_for_confirmation( "\nRelease anyway?", true ) do
+							log "Okay, releasing with uncommitted versions."
+						end
+					end
+
+					tags = get_tags()
+					rev = get_current_rev()
+					pkg_version_tag = "#{hg_release_tag_prefix}#{version}"
+
+					# Look for a tag for the current release version, and if it exists abort
+					if tags.include?( pkg_version_tag )
+						error "Version #{version} already has a tag."
+						fail
+					end
+
+					# Sign the current rev
+					if self.hg_sign_tags
+						log "Signing rev #{rev}"
+						run 'hg', 'sign'
+					end
+
+					# Tag the current rev
+					log "Tagging rev #{rev} as #{pkg_version_tag}"
+					run 'hg', 'tag', pkg_version_tag
+
+					# Offer to push
+					Rake::Task['hg:push'].invoke
+				end
+
+
+				desc "Check for new files and offer to add/ignore/delete them."
+				task :newfiles do
+					log "Checking for new files..."
+
+					entries = get_unknown_files()
+
+					unless entries.empty?
+						files_to_add = []
+						files_to_ignore = []
+						files_to_delete = []
+
+						entries.each do |entry|
+							action = prompt_with_default( "	 #{entry}: (a)dd, (i)gnore, (s)kip (d)elete", 's' )
+							case action
+							when 'a'
+								files_to_add << entry
+							when 'i'
+								files_to_ignore << entry
+							when 'd'
+								files_to_delete << entry
+							end
+						end
+
+						unless files_to_add.empty?
+							run 'hg', 'add', *files_to_add
+						end
+
+						unless files_to_ignore.empty?
+							hg_ignore_files( *files_to_ignore )
+						end
+
+						unless files_to_delete.empty?
+							delete_extra_files( files_to_delete )
+						end
+					end
+				end
+				task :add => :newfiles
+
+
+				desc "Pull and update from the default repo"
+				task :pull do
+					paths = get_repo_paths()
+					if origin_url = paths['default']
+						ask_for_confirmation( "Pull and update from '#{origin_url}'?", false ) do
+							Rake::Task['hg:pull_without_confirmation'].invoke
+						end
+					else
+						trace "Skipping pull: No 'default' path."
+					end
+				end
+
+
+				desc "Pull and update without confirmation"
+				task :pull_without_confirmation do
+					run 'hg', 'pull', '-u'
+				end
+
+
+				desc "Update to tip"
+				task :update do
+					run 'hg', 'update'
+				end
+
+
+				desc "Clobber all changes (hg up -C)"
+				task :update_and_clobber do
+					run 'hg', 'update', '-C'
+				end
+
+
+				task :precheckin do
+					trace "Pre-checkin hooks"
+				end
+
+
+				desc "Check the current code in if tests pass"
+				task :checkin => ['hg:pull', 'hg:newfiles', :precheckin, COMMIT_MSG_FILE] do
+					targets = get_target_args()
+					$stderr.puts '---', File.read( COMMIT_MSG_FILE ), '---'
+					ask_for_confirmation( "Continue with checkin?" ) do
+						run 'hg', 'ci', '-l', COMMIT_MSG_FILE, targets
+						rm_f COMMIT_MSG_FILE
+					end
+					Rake::Task['hg:push'].invoke
+				end
+				task :commit => :checkin
+				task :ci => :checkin
+
+				CLEAN.include( COMMIT_MSG_FILE )
+
+				desc "Push to the default origin repo (if there is one)"
+				task :push do
+					paths = get_repo_paths()
+					if origin_url = paths['default']
+						ask_for_confirmation( "Push to '#{origin_url}'?", false ) do
+							Rake::Task['hg:push_without_confirmation'].invoke
+						end
+					else
+						trace "Skipping push: No 'default' path."
+					end
+				end
+
+				desc "Push to the default repo without confirmation"
+				task :push_without_confirmation do
+					run 'hg', 'push'
+				end
+			end
+
+			# Add a top-level 'ci' task for checkin
+			task :ci => 'hg:checkin'
+
+			# Hook the release task and prep the repo first
+			task :prerelease => 'hg:prep_release'
+
+		rescue Exception => err
+			$stderr.puts "%s while defining Mercurial tasks: %s" % [ err.class.name, err.message ]
+			raise
+		end
+
+	end
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: hoe-mercurial
+version: !ruby/object:Gem::Version 
+  hash: 19
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 0
+  version: 1.1.0
+platform: ruby
+authors: 
+- Michael Granger
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDLDCCAhSgAwIBAgIBADANBgkqhkiG9w0BAQUFADA8MQwwCgYDVQQDDANnZWQx
+  FzAVBgoJkiaJk/IsZAEZFgdfYWVyaWVfMRMwEQYKCZImiZPyLGQBGRYDb3JnMB4X
+  DTEwMDkxNjE0NDg1MVoXDTExMDkxNjE0NDg1MVowPDEMMAoGA1UEAwwDZ2VkMRcw
+  FQYKCZImiZPyLGQBGRYHX2FlcmllXzETMBEGCgmSJomT8ixkARkWA29yZzCCASIw
+  DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALy//BFxC1f/cPSnwtJBWoFiFrir
+  h7RicI+joq/ocVXQqI4TDWPyF/8tqkvt+rD99X9qs2YeR8CU/YiIpLWrQOYST70J
+  vDn7Uvhb2muFVqq6+vobeTkILBEO6pionWDG8jSbo3qKm1RjKJDwg9p4wNKhPuu8
+  KGue/BFb67KflqyApPmPeb3Vdd9clspzqeFqp7cUBMEpFS6LWxy4Gk+qvFFJBJLB
+  BUHE/LZVJMVzfpC5Uq+QmY7B+FH/QqNndn3tOHgsPadLTNimuB1sCuL1a4z3Pepd
+  TeLBEFmEao5Dk3K/Q8o8vlbIB/jBDTUx6Djbgxw77909x6gI9doU4LD5XMcCAwEA
+  AaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFJeoGkOr9l4B
+  +saMkW/ZXT4UeSvVMA0GCSqGSIb3DQEBBQUAA4IBAQBG2KObvYI2eHyyBUJSJ3jN
+  vEnU3d60znAXbrSd2qb3r1lY1EPDD3bcy0MggCfGdg3Xu54z21oqyIdk8uGtWBPL
+  HIa9EgfFGSUEgvcIvaYqiN4jTUtidfEFw+Ltjs8AP9gWgSIYS6Gr38V0WGFFNzIH
+  aOD2wmu9oo/RffW4hS/8GuvfMzcw7CQ355wFR4KB/nyze+EsZ1Y5DerCAagMVuDQ
+  U0BLmWDFzPGGWlPeQCrYHCr+AcJz+NRnaHCKLZdSKj/RHuTOt+gblRex8FAh8NeA
+  cmlhXe46pZNJgWKbxZah85jIjx95hR8vOI+NAM5iH9kOqK13DrxacTKPhqj5PjwF
+  -----END CERTIFICATE-----
+
+date: 2010-12-21 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 47
+        segments: 
+        - 2
+        - 8
+        - 0
+        version: 2.8.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 47
+        segments: 
+        - 2
+        - 8
+        - 0
+        version: 2.8.0
+  type: :development
+  version_requirements: *id002
+description: |-
+  This is a fork of the [hoe-hg](https://bitbucket.org/mml/hoe-hg) 
+  plugin. I forked it because I use quite a few additional Mercurial 
+  tasks for my development workflow than are provided by the original, 
+  and I thought they'd possibly be useful to someone else.
+  
+  I've offered to push my changes back up to the original, but I gave
+  up waiting for a response.
+email: 
+- ged@FaerieMUD.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/hoe/mercurial.rb
+- ChangeLog
+- History.md
+- README.md
+- Rakefile
+has_rdoc: true
+homepage: http://bitbucket.org/ged/hoe-mercurial
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: hoe-mercurial
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: This is a fork of the [hoe-hg](https://bitbucket.org/mml/hoe-hg)  plugin
+test_files: []
+