[dragonfly.git] / post-receive-email

#!/bin/sh
#
# Copyright (c) 2007 Andy Parkins
#
# An example hook script to mail out commit update information.  This hook
# sends emails listing new revisions to the repository introduced by the
# change being reported.  The rule is that (for branch updates) each commit
# will appear on one email and one email only.
#
# This hook is stored in the contrib/hooks directory.  Your distribution
# will have put this somewhere standard.  You should make this script
# executable then link to it in the repository you would like to use it in.
# For example, on debian the hook is stored in
# /usr/share/doc/git-core/contrib/hooks/post-receive-email:
#
#  chmod a+x post-receive-email
#  cd /path/to/your/repository.git
#  ln -sf /usr/share/doc/git-core/contrib/hooks/post-receive-email hooks/post-receive
#
# This hook script assumes it is enabled on the central repository of a
# project, with all users pushing only to it and not between each other.  It
# will still work if you don't operate in that style, but it would become
# possible for the email to be from someone other than the person doing the
# push.
#
# Config
# ------
# hooks.mailinglist
#   This is the list that all pushes will go to; leave it blank to not send
#   emails for every ref update.
# hooks.announcelist
#   This is the list that all pushes of annotated tags will go to.  Leave it
#   blank to default to the mailinglist field.  The announce emails lists
#   the short log summary of the changes since the last annotated tag.
# hooks.envelopesender
#   If set then the -f option is passed to sendmail to allow the envelope
#   sender address to be set
# hooks.emailprefix
#   All emails have their subjects prefixed with this prefix, or "[SCM]"
#   if emailprefix is unset, to aid filtering
#
# Notes
# -----
# All emails include the headers "X-Git-Refname", "X-Git-Oldrev",
# "X-Git-Newrev", and "X-Git-Reftype" to enable fine tuned filtering and
# give information for debugging.
#

# ---------------------------- Functions

#
# Top level email generation function.  This decides what type of update
# this is and calls the appropriate body-generation routine after outputting
# the common header
#
# Note this function doesn't actually generate any email output, that is
# taken care of by the functions it calls:
#  - generate_email_header
#  - generate_create_XXXX_email
#  - generate_update_XXXX_email
#  - generate_delete_XXXX_email
#  - generate_email_footer
#
generate_email()
{
	# --- Arguments
	oldrev=$(git rev-parse $1)
	newrev=$(git rev-parse $2)
	refname="$3"

	# --- Interpret
	# 0000->1234 (create)
	# 1234->2345 (update)
	# 2345->0000 (delete)
	if expr "$oldrev" : '0*$' >/dev/null
	then
		change_type="create"
	else
		if expr "$newrev" : '0*$' >/dev/null
		then
			change_type="delete"
		else
			change_type="update"
		fi
	fi

	# --- Get the revision types
	newrev_type=$(git cat-file -t $newrev 2> /dev/null)
	oldrev_type=$(git cat-file -t "$oldrev" 2> /dev/null)
	case "$change_type" in
	create|update)
		rev="$newrev"
		rev_type="$newrev_type"
		;;
	delete)
		rev="$oldrev"
		rev_type="$oldrev_type"
		;;
	esac

	# The revision type tells us what type the commit is, combined with
	# the location of the ref we can decide between
	#  - working branch
	#  - tracking branch
	#  - unannoted tag
	#  - annotated tag
	case "$refname","$rev_type" in
		refs/tags/*,commit)
			# un-annotated tag
			refname_type="tag"
			short_refname=${refname##refs/tags/}
			;;
		refs/tags/*,tag)
			# annotated tag
			refname_type="annotated tag"
			short_refname=${refname##refs/tags/}
			# change recipients
			if [ -n "$announcerecipients" ]; then
				recipients="$announcerecipients"
			fi
			;;
		refs/heads/*,commit)
			# branch
			refname_type="branch"
			short_refname=${refname##refs/heads/}
			;;
		refs/remotes/*,commit)
			# tracking branch
			refname_type="tracking branch"
			short_refname=${refname##refs/remotes/}
			echo >&2 "*** Push-update of tracking branch, $refname"
			echo >&2 "***  - no email generated."
			exit 0
			;;
		*)
			# Anything else (is there anything else?)
			echo >&2 "*** Unknown type of update to $refname ($rev_type)"
			echo >&2 "***  - no email generated"
			exit 1
			;;
	esac

	# Check if we've got anyone to send to
	if [ -z "$recipients" ]; then
		case "$refname_type" in
			"annotated tag")
				config_name="hooks.announcelist"
				;;
			*)
				config_name="hooks.mailinglist"
				;;
		esac
		echo >&2 "*** $config_name is not set so no email will be sent"
		echo >&2 "*** for $refname update $oldrev->$newrev"
		exit 0
	fi

	# The email subject will contain the best description of the ref
	# that we can build from the parameters
	set_describe $rev

	# Call the correct body generation function
	fn_name=general
	case "$refname_type" in
	"tracking branch"|branch)
		fn_name=branch
		;;
	"annotated tag")
		fn_name=atag
		;;
	esac

	case "$fn_name" in
	branch)
		split=""
		revs=$(list_${change_type}_branch_revs 2>/dev/null)
		if [ "$(echo "$revs" | wc -l)" -gt 1 ]
		then
			split=1
		fi

		if [ "$change_type" != "update" ]
		then
			set_update_branch_subject
			{
			generate_email_header
			generate_${change_type}_branch_email
			generate_email_footer
			} | $send_mail
		fi

		for rev in $revs
		do
			change_type=update
			oldrev=
			newrev=$rev

			# set_update_branch_subject will return false if the
			# commit is boring (no change).  Then we don't even
			# send a mail.
			set_update_branch_subject || continue
			{
			generate_email_header
			print_change_info $newrev
			summarize_branch_revs
			generate_email_footer
			} | $send_mail
		done
		;;

	*)
		{
		generate_email_header
		generate_${change_type}_${fn_name}_email
		generate_email_footer
		} | $send_mail
		;;
	esac
}

set_describe()
{
	describe=$(git describe --abbrev=4 $1 2>/dev/null || git rev-parse --short $1)
	describe=$(echo "$describe" | sed -e 's/-/./g;s/^v//;')
}

generate_email_header()
{
	# --- Email (all stdout will be the email)
	# Generate header
	print_change_type=" ${change_type}d"
	case "$change_type" in
	"update")
		print_change_type=""
		;;
	esac

	print_refname="$refname_type "
	case "$refname_type" in
	"branch")
		print_refname=""
		;;
	esac

	cat <<-EOF
	To: $recipients
	Subject: ${emailprefix}$describe $print_refname$short_refname${print_change_type}$detail
	X-Git-Refname: $refname
	X-Git-Reftype: $refname_type
	X-Git-Newrev: $newrev

	EOF
}

generate_email_footer()
{
	SPACE=" "
	cat <<-EOF

	--${SPACE}
	$projectdesc
	EOF
}

# --------------- Branches

#
# Called for the creation of a branch
#
generate_create_branch_email()
{
	# This is a new branch and so oldrev is not valid
	echo "        at  $newrev ($newrev_type)"
	echo ""
}

list_create_branch_revs()
{
	# We want to list all revs that are reachable now, but
	# were not before.
	# All revs that were reachable before are git rev-parse --branches.
	# However, this includes $refname.  The naive | grep -v $branchtip
	# will not work, because another branch might already have been on
	# $branchtip.  In this case we shouldn't list any rev.
	# As git rev-parse --branches might list a given rev multiple times
	# if there are multiple branches at this rev, we simply drop this
	# $branchtip rev once, and pass all subsequent ones through.

	branchtip=$(git rev-parse $refname)

	git rev-parse --not --branches | sed -e "1,/$branchtip/{/$branchtip/d;}" |
	git rev-list --reverse --stdin $newrev
}

#
# Called for the change of a pre-existing branch
#
generate_update_branch_email()
{
	# XXX only valid for fast forwards

	# List all the revisions from baserev to newrev in a kind of
	# "table-of-contents"; note this list can include revisions that
	# have already had notification emails and is present to show the
	# full detail of the change from rolling back the old revision to
	# the base revision and then forward to the new revision
	for rev in $(git rev-list $oldrev..$newrev)
	do
		revtype=$(git cat-file -t "$rev")
		echo "       via  $rev ($revtype)"
	done

	echo "      from  $oldrev ($oldrev_type)"

	echo ""
	echo $LOGBEGIN
}

skip_diff_tree_parent()
{
	if [ -n "$oldrev" ]
	then
		cat
	else
		tail +2
	fi
}

set_update_branch_subject()
{
	set_describe $newrev

	detail=$(git diff-tree -r -c --name-only $oldrev${oldrev:+..}$newrev |
			skip_diff_tree_parent |
			sed -E -e 's#/([^/]*)$# \1#' |
			awk 'pos > 74 {
				printf "\n";
				pos = 0;
			}
			$1 != lastdir {
				printf " %s", $1;
				pos += length($1) + 1;
				lastdir = $1;
			}
			$2 != "" {
				printf " %s", $2;
				pos += length($2) + 1;
			}')
	[ -n "$(git diff-tree -r --name-only --cc $oldrev${oldrev:+..}$newrev |
		skip_diff_tree_parent)" ]
}

list_update_branch_revs()
{
	git rev-parse --not --branches | grep -v $(git rev-parse $refname) |
	git rev-list --reverse --stdin $oldrev..$newrev
}

summarize_branch_revs()
{
	echo "Summary of changes:"
	git diff-tree --stat --summary --find-copies-harder $oldrev${oldrev:+..}$newrev | skip_diff_tree_parent

	if [ -n "$gitweburl" ]
	then
		echo ""
		echo "$gitweburl/$reponame/commitdiff/$oldrev${oldrev:+..}$newrev"
	fi
	echo $LOGEND
}

print_change_info()
{
	echo $LOGBEGIN
	git rev-list -n 1 --pretty $1
}

#
# Called for the deletion of a branch
#
generate_delete_branch_email()
{
	echo "       was  $oldrev"
	echo ""
	echo $LOGEND
	git show -s --pretty=oneline $oldrev
	echo $LOGEND
}

# --------------- Annotated tags

#
# Called for the creation of an annotated tag
#
generate_create_atag_email()
{
	echo "        at  $newrev ($newrev_type)"

	generate_atag_email
}

#
# Called for the update of an annotated tag (this is probably a rare event
# and may not even be allowed)
#
generate_update_atag_email()
{
	echo "        to  $newrev ($newrev_type)"
	echo "      from  $oldrev (which is now obsolete)"

	generate_atag_email
}

#
# Called when an annotated tag is created or changed
#
generate_atag_email()
{
	# Use git for-each-ref to pull out the individual fields from the
	# tag
	eval $(git for-each-ref --shell --format='
	tagobject=%(*objectname)
	tagtype=%(*objecttype)
	tagger=%(taggername)
	tagged=%(taggerdate)' $refname
	)

	echo "   tagging  $tagobject ($tagtype)"
	case "$tagtype" in
	commit)

		# If the tagged object is a commit, then we assume this is a
		# release, and so we calculate which tag this tag is
		# replacing
		prevtag=$(git describe --abbrev=0 $newrev^ 2>/dev/null)

		if [ -n "$prevtag" ]; then
			echo "  replaces  $prevtag"
		fi
		;;
	*)
		echo "    length  $(git cat-file -s $tagobject) bytes"
		;;
	esac
	echo " tagged by  $tagger"
	echo "        on  $tagged"

	echo ""
	echo $LOGBEGIN

	# Show the content of the tag message; this might contain a change
	# log or release notes so is worth displaying.
	git cat-file tag $newrev | sed -e '1,/^$/d'

	echo ""
	case "$tagtype" in
	commit)
		# Only commit tags make sense to have rev-list operations
		# performed on them
		if [ -n "$prevtag" ]; then
			# Show changes since the previous release
			git rev-list --pretty=short "$prevtag..$newrev" | git shortlog
		else
			# No previous tag, show all the changes since time
			# began, but only summarize due to the possibly large size.
			git rev-list --pretty=short $newrev | git shortlog -s
		fi
		;;
	*)
		# XXX: Is there anything useful we can do for non-commit
		# objects?
		;;
	esac

	echo $LOGEND
}

#
# Called for the deletion of an annotated tag
#
generate_delete_atag_email()
{
	echo "       was  $oldrev"
	echo ""
	echo $LOGEND
	git show -s --pretty=oneline $oldrev
	echo $LOGEND
}

# --------------- General references

#
# Called when any other type of reference is created (most likely a
# non-annotated tag)
#
generate_create_general_email()
{
	echo "        at  $newrev ($newrev_type)"

	generate_general_email
}

#
# Called when any other type of reference is updated (most likely a
# non-annotated tag)
#
generate_update_general_email()
{
	echo "        to  $newrev ($newrev_type)"
	echo "      from  $oldrev"

	generate_general_email
}

#
# Called for creation or update of any other type of reference
#
generate_general_email()
{
	# Unannotated tags are more about marking a point than releasing a
	# version; therefore we don't do the shortlog summary that we do for
	# annotated tags above - we simply show that the point has been
	# marked, and print the log message for the marked point for
	# reference purposes
	#
	# Note this section also catches any other reference type (although
	# there aren't any) and deals with them in the same way.

	echo ""
	if [ "$newrev_type" = "commit" ]; then
		echo $LOGBEGIN
		git show --no-color --root -s --pretty=medium $newrev
		echo $LOGEND
	else
		# What can we do here?  The tag marks an object that is not
		# a commit, so there is no log for us to display.  It's
		# probably not wise to output git cat-file as it could be a
		# binary blob.  We'll just say how big it is
		echo "$newrev is a $newrev_type, and is $(git cat-file -s $newrev) bytes long."
	fi
}

#
# Called for the deletion of any other type of reference
#
generate_delete_general_email()
{
	echo "       was  $oldrev"
	echo ""
	echo $LOGEND
	git show -s --pretty=oneline $oldrev
	echo $LOGEND
}

send_mail()
{
	if [ -n "$envelopesender" ]; then
		/usr/sbin/sendmail -t -f "$envelopesender"
	else
		/usr/sbin/sendmail -t
	fi
}

# ---------------------------- main()

# --- Constants
LOGBEGIN=""
LOGEND=""

# --- Config
# Set GIT_DIR either from the working directory, or from the environment
# variable.
GIT_DIR=$(git rev-parse --git-dir 2>/dev/null)
if [ -z "$GIT_DIR" ]; then
	echo >&2 "fatal: post-receive: GIT_DIR not set"
	exit 1
fi

projectdesc=$(sed -ne '1p' "$GIT_DIR/description")
# Check if the description is unchanged from it's default, and shorten it to
# a more manageable length if it is
if expr "$projectdesc" : "Unnamed repository.*$" >/dev/null
then
	projectdesc="UNNAMED PROJECT"
fi

recipients=$(git config hooks.mailinglist)
announcerecipients=$(git config hooks.announcelist)
envelopesender=$(git config hooks.envelopesender)
emailprefix=$(git config hooks.emailprefix || echo '[SCM] ')
gitweburl=$(git config hooks.gitweburl)
reponame=$(git config hooks.reponame || basename $(realpath $GIT_DIR))

# --- Main loop
# Allow dual mode: run from the command line just like the update hook, or
# if no arguments are given then run as a hook script
if [ -n "$1" -a -n "$2" -a -n "$3" ]; then
	# Output to the terminal in command line mode - if someone wanted to
	# resend an email; they could redirect the output to sendmail
	# themselves
	send_mail=cat
	generate_email $2 $3 $1
else
	while read oldrev newrev refname
	do
		send_mail=send_mail
		generate_email $oldrev $newrev $refname
	done
fi
Commit	Line	Data
7726cba3 SS	1	#!/bin/sh
	2	#
	3	# Copyright (c) 2007 Andy Parkins
	4	#
	5	# An example hook script to mail out commit update information. This hook
	6	# sends emails listing new revisions to the repository introduced by the
	7	# change being reported. The rule is that (for branch updates) each commit
	8	# will appear on one email and one email only.
	9	#
	10	# This hook is stored in the contrib/hooks directory. Your distribution
	11	# will have put this somewhere standard. You should make this script
	12	# executable then link to it in the repository you would like to use it in.
	13	# For example, on debian the hook is stored in
	14	# /usr/share/doc/git-core/contrib/hooks/post-receive-email:
	15	#
	16	# chmod a+x post-receive-email
	17	# cd /path/to/your/repository.git
	18	# ln -sf /usr/share/doc/git-core/contrib/hooks/post-receive-email hooks/post-receive
	19	#
	20	# This hook script assumes it is enabled on the central repository of a
	21	# project, with all users pushing only to it and not between each other. It
	22	# will still work if you don't operate in that style, but it would become
	23	# possible for the email to be from someone other than the person doing the
	24	# push.
	25	#
	26	# Config
	27	# ------
	28	# hooks.mailinglist
	29	# This is the list that all pushes will go to; leave it blank to not send
	30	# emails for every ref update.
	31	# hooks.announcelist
	32	# This is the list that all pushes of annotated tags will go to. Leave it
	33	# blank to default to the mailinglist field. The announce emails lists
	34	# the short log summary of the changes since the last annotated tag.
	35	# hooks.envelopesender
	36	# If set then the -f option is passed to sendmail to allow the envelope
	37	# sender address to be set
	38	# hooks.emailprefix
	39	# All emails have their subjects prefixed with this prefix, or "[SCM]"
	40	# if emailprefix is unset, to aid filtering
	41	#
	42	# Notes
	43	# -----
	44	# All emails include the headers "X-Git-Refname", "X-Git-Oldrev",
	45	# "X-Git-Newrev", and "X-Git-Reftype" to enable fine tuned filtering and
	46	# give information for debugging.
	47	#
	48
	49	# ---------------------------- Functions
	50
	51	#
	52	# Top level email generation function. This decides what type of update
	53	# this is and calls the appropriate body-generation routine after outputting
	54	# the common header
	55	#
	56	# Note this function doesn't actually generate any email output, that is
	57	# taken care of by the functions it calls:
	58	# - generate_email_header
	59	# - generate_create_XXXX_email
	60	# - generate_update_XXXX_email
	61	# - generate_delete_XXXX_email
	62	# - generate_email_footer
	63	#
	64	generate_email()
65	{
66	# --- Arguments
67	oldrev=$(git rev-parse $1)
68	newrev=$(git rev-parse $2)
69	refname="$3"
70
71	# --- Interpret
72	# 0000->1234 (create)
73	# 1234->2345 (update)
74	# 2345->0000 (delete)
75	if expr "$oldrev" : '0*$' >/dev/null
76	then
77	change_type="create"
78	else
79	if expr "$newrev" : '0*$' >/dev/null
80	then
81	change_type="delete"
82	else
83	change_type="update"
84	fi
85	fi
86
87	# --- Get the revision types
88	newrev_type=$(git cat-file -t $newrev 2> /dev/null)
89	oldrev_type=$(git cat-file -t "$oldrev" 2> /dev/null)
90	case "$change_type" in
91	create\|update)
92	rev="$newrev"
93	rev_type="$newrev_type"
94	;;
95	delete)
96	rev="$oldrev"
97	rev_type="$oldrev_type"
98	;;
99	esac
100
101	# The revision type tells us what type the commit is, combined with
102	# the location of the ref we can decide between
103	# - working branch
104	# - tracking branch
105	# - unannoted tag
106	# - annotated tag
107	case "$refname","$rev_type" in
108	refs/tags/*,commit)
109	# un-annotated tag
110	refname_type="tag"
111	short_refname=${refname##refs/tags/}
112	;;
113	refs/tags/*,tag)
114	# annotated tag
115	refname_type="annotated tag"
116	short_refname=${refname##refs/tags/}
117	# change recipients
118	if [ -n "$announcerecipients" ]; then
119	recipients="$announcerecipients"
120	fi
121	;;
122	refs/heads/*,commit)
123	# branch
124	refname_type="branch"
125	short_refname=${refname##refs/heads/}
126	;;
127	refs/remotes/*,commit)
128	# tracking branch
129	refname_type="tracking branch"
130	short_refname=${refname##refs/remotes/}
131	echo >&2 "*** Push-update of tracking branch, $refname"
132	echo >&2 "*** - no email generated."
133	exit 0
134	;;
135	*)
136	# Anything else (is there anything else?)
137	echo >&2 "*** Unknown type of update to $refname ($rev_type)"
138	echo >&2 "*** - no email generated"
139	exit 1
140	;;
141	esac
142
143	# Check if we've got anyone to send to
144	if [ -z "$recipients" ]; then
145	case "$refname_type" in
146	"annotated tag")
147	config_name="hooks.announcelist"
148	;;
149	*)
150	config_name="hooks.mailinglist"
151	;;
152	esac
153	echo >&2 "*** $config_name is not set so no email will be sent"
154	echo >&2 "*** for $refname update $oldrev->$newrev"
155	exit 0
156	fi
157
7726cba3 SS	158	# The email subject will contain the best description of the ref
7726cba3 SS	159	# that we can build from the parameters
fc324e4b	160	set_describe $rev
7726cba3	161
7726cba3 SS	162	# Call the correct body generation function
	163	fn_name=general
	164	case "$refname_type" in
	165	"tracking branch"\|branch)
	166	fn_name=branch
	167	;;
	168	"annotated tag")
	169	fn_name=atag
	170	;;
	171	esac
7726cba3	172
a7d368ad SS	173	case "$fn_name" in
	174	branch)
	175	split=""
	176	revs=$(list_${change_type}_branch_revs 2>/dev/null)
	177	if [ "$(echo "$revs" \| wc -l)" -gt 1 ]
	178	then
	179	split=1
	180	fi
	181
ab62daec	182	if [ "$change_type" != "update" ]
a7d368ad	183	then
a7d368ad	184	set_update_branch_subject
ab62daec	185	{
a7d368ad	186	generate_email_header
ab62daec	187	generate_${change_type}_branch_email
a7d368ad SS	188	generate_email_footer
a7d368ad SS	189	} \| $send_mail
ab62daec SS	190	fi
	191
	192	for rev in $revs
	193	do
648e8ca0	194	change_type=update
ab62daec SS	195	oldrev=
	196	newrev=$rev
	197
	198	# set_update_branch_subject will return false if the
	199	# commit is boring (no change). Then we don't even
	200	# send a mail.
	201	set_update_branch_subject \|\| continue
a7d368ad	202	{
a7d368ad	203	generate_email_header
ab62daec	204	print_change_info $newrev
a7d368ad SS	205	summarize_branch_revs
	206	generate_email_footer
	207	} \| $send_mail
ab62daec	208	done
a7d368ad SS	209	;;
	210
	211	*)
	212	{
	213	generate_email_header
	214	generate_${change_type}_${fn_name}_email
	215	generate_email_footer
	216	} \| $send_mail
	217	;;
	218	esac
7726cba3 SS	219	}
7726cba3 SS	220
fc324e4b SS	221	set_describe()
fc324e4b SS	222	{
06b96d6c SS	223	describe=$(git describe --abbrev=4 $1 2>/dev/null \|\| git rev-parse --short $1)
06b96d6c SS	224	describe=$(echo "$describe" \| sed -e 's/-/./g;s/^v//;')
fc324e4b SS	225	}
fc324e4b SS	226
7726cba3 SS	227	generate_email_header()
	228	{
	229	# --- Email (all stdout will be the email)
	230	# Generate header
a7d368ad SS	231	print_change_type=" ${change_type}d"
	232	case "$change_type" in
	233	"update")
	234	print_change_type=""
	235	;;
	236	esac
	237
5505d794 SS	238	print_refname="$refname_type "
	239	case "$refname_type" in
	240	"branch")
	241	print_refname=""
	242	;;
	243	esac
	244
7726cba3 SS	245	cat <<-EOF
7726cba3 SS	246	To: $recipients
06b96d6c	247	Subject: ${emailprefix}$describe $print_refname$short_refname${print_change_type}$detail
7726cba3 SS	248	X-Git-Refname: $refname
7726cba3 SS	249	X-Git-Reftype: $refname_type
7726cba3 SS	250	X-Git-Newrev: $newrev
7726cba3 SS	251
7726cba3 SS	252	EOF
	253	}
	254
	255	generate_email_footer()
	256	{
	257	SPACE=" "
	258	cat <<-EOF
	259
7726cba3 SS	260	--${SPACE}
	261	$projectdesc
	262	EOF
	263	}
	264
	265	# --------------- Branches
	266
	267	#
	268	# Called for the creation of a branch
	269	#
	270	generate_create_branch_email()
	271	{
	272	# This is a new branch and so oldrev is not valid
	273	echo " at $newrev ($newrev_type)"
a7b83ec0	274	echo ""
a7d368ad	275	}
7726cba3	276
a7d368ad SS	277	list_create_branch_revs()
a7d368ad SS	278	{
a7b83ec0 SS	279	# We want to list all revs that are reachable now, but
	280	# were not before.
	281	# All revs that were reachable before are git rev-parse --branches.
	282	# However, this includes $refname. The naive \| grep -v $branchtip
	283	# will not work, because another branch might already have been on
	284	# $branchtip. In this case we shouldn't list any rev.
	285	# As git rev-parse --branches might list a given rev multiple times
	286	# if there are multiple branches at this rev, we simply drop this
	287	# $branchtip rev once, and pass all subsequent ones through.
	288
	289	branchtip=$(git rev-parse $refname)
	290
	291	git rev-parse --not --branches \| sed -e "1,/$branchtip/{/$branchtip/d;}" \|
a7d368ad	292	git rev-list --reverse --stdin $newrev
7726cba3 SS	293	}
	294
	295	#
	296	# Called for the change of a pre-existing branch
	297	#
	298	generate_update_branch_email()
	299	{
a7d368ad	300	# XXX only valid for fast forwards
7726cba3 SS	301
	302	# List all the revisions from baserev to newrev in a kind of
	303	# "table-of-contents"; note this list can include revisions that
	304	# have already had notification emails and is present to show the
	305	# full detail of the change from rolling back the old revision to
	306	# the base revision and then forward to the new revision
	307	for rev in $(git rev-list $oldrev..$newrev)
	308	do
	309	revtype=$(git cat-file -t "$rev")
	310	echo " via $rev ($revtype)"
	311	done
	312
a7d368ad	313	echo " from $oldrev ($oldrev_type)"
7726cba3 SS	314
7726cba3 SS	315	echo ""
c87e8713	316	echo $LOGBEGIN
a7d368ad	317	}
7726cba3	318
ab62daec SS	319	skip_diff_tree_parent()
	320	{
	321	if [ -n "$oldrev" ]
	322	then
	323	cat
	324	else
	325	tail +2
	326	fi
	327	}
	328
a7d368ad SS	329	set_update_branch_subject()
a7d368ad SS	330	{
fc324e4b SS	331	set_describe $newrev
fc324e4b SS	332
06b96d6c SS	333	detail=$(git diff-tree -r -c --name-only $oldrev${oldrev:+..}$newrev \|
	334	skip_diff_tree_parent \|
	335	sed -E -e 's#/([^/]*)$# \1#' \|
	336	awk 'pos > 74 {
	337	printf "\n";
	338	pos = 0;
	339	}
	340	$1 != lastdir {
	341	printf " %s", $1;
	342	pos += length($1) + 1;
	343	lastdir = $1;
	344	}
	345	$2 != "" {
	346	printf " %s", $2;
	347	pos += length($2) + 1;
	348	}')
ab62daec SS	349	[ -n "$(git diff-tree -r --name-only --cc $oldrev${oldrev:+..}$newrev \|
ab62daec SS	350	skip_diff_tree_parent)" ]
a7d368ad	351	}
7726cba3	352
a7d368ad SS	353	list_update_branch_revs()
	354	{
	355	git rev-parse --not --branches \| grep -v $(git rev-parse $refname) \|
	356	git rev-list --reverse --stdin $oldrev..$newrev
	357	}
7726cba3	358
a7d368ad SS	359	summarize_branch_revs()
a7d368ad SS	360	{
7726cba3	361	echo "Summary of changes:"
ab62daec	362	git diff-tree --stat --summary --find-copies-harder $oldrev${oldrev:+..}$newrev \| skip_diff_tree_parent
d245d3ad SS	363
	364	if [ -n "$gitweburl" ]
	365	then
	366	echo ""
45175900	367	echo "$gitweburl/$reponame/commitdiff/$oldrev${oldrev:+..}$newrev"
d245d3ad	368	fi
c87e8713	369	echo $LOGEND
7726cba3 SS	370	}
7726cba3 SS	371
a7d368ad SS	372	print_change_info()
a7d368ad SS	373	{
c87e8713	374	echo $LOGBEGIN
a7d368ad SS	375	git rev-list -n 1 --pretty $1
	376	}
	377
7726cba3 SS	378	#
	379	# Called for the deletion of a branch
	380	#
	381	generate_delete_branch_email()
	382	{
	383	echo " was $oldrev"
	384	echo ""
	385	echo $LOGEND
	386	git show -s --pretty=oneline $oldrev
	387	echo $LOGEND
	388	}
	389
	390	# --------------- Annotated tags
	391
	392	#
	393	# Called for the creation of an annotated tag
	394	#
	395	generate_create_atag_email()
	396	{
	397	echo " at $newrev ($newrev_type)"
	398
	399	generate_atag_email
	400	}
	401
	402	#
	403	# Called for the update of an annotated tag (this is probably a rare event
	404	# and may not even be allowed)
	405	#
	406	generate_update_atag_email()
	407	{
	408	echo " to $newrev ($newrev_type)"
	409	echo " from $oldrev (which is now obsolete)"
	410
	411	generate_atag_email
	412	}
	413
	414	#
	415	# Called when an annotated tag is created or changed
	416	#
	417	generate_atag_email()
	418	{
	419	# Use git for-each-ref to pull out the individual fields from the
	420	# tag
	421	eval $(git for-each-ref --shell --format='
	422	tagobject=%(*objectname)
	423	tagtype=%(*objecttype)
	424	tagger=%(taggername)
	425	tagged=%(taggerdate)' $refname
	426	)
	427
	428	echo " tagging $tagobject ($tagtype)"
	429	case "$tagtype" in
	430	commit)
	431
	432	# If the tagged object is a commit, then we assume this is a
	433	# release, and so we calculate which tag this tag is
	434	# replacing
	435	prevtag=$(git describe --abbrev=0 $newrev^ 2>/dev/null)
	436
	437	if [ -n "$prevtag" ]; then
	438	echo " replaces $prevtag"
	439	fi
	440	;;
	441	*)
442	echo " length $(git cat-file -s $tagobject) bytes"
443	;;
444	esac
445	echo " tagged by $tagger"
446	echo " on $tagged"
447
448	echo ""
449	echo $LOGBEGIN
450
451	# Show the content of the tag message; this might contain a change
452	# log or release notes so is worth displaying.
453	git cat-file tag $newrev \| sed -e '1,/^$/d'
454
455	echo ""
456	case "$tagtype" in
457	commit)
458	# Only commit tags make sense to have rev-list operations
459	# performed on them
460	if [ -n "$prevtag" ]; then
461	# Show changes since the previous release
462	git rev-list --pretty=short "$prevtag..$newrev" \| git shortlog
463	else
464	# No previous tag, show all the changes since time
c87e8713 SS	465	# began, but only summarize due to the possibly large size.
c87e8713 SS	466	git rev-list --pretty=short $newrev \| git shortlog -s
7726cba3 SS	467	fi
	468	;;
	469	*)
	470	# XXX: Is there anything useful we can do for non-commit
	471	# objects?
	472	;;
	473	esac
	474
	475	echo $LOGEND
	476	}
	477
	478	#
	479	# Called for the deletion of an annotated tag
	480	#
	481	generate_delete_atag_email()
	482	{
	483	echo " was $oldrev"
	484	echo ""
	485	echo $LOGEND
	486	git show -s --pretty=oneline $oldrev
	487	echo $LOGEND
	488	}
	489
	490	# --------------- General references
	491
	492	#
	493	# Called when any other type of reference is created (most likely a
	494	# non-annotated tag)
	495	#
	496	generate_create_general_email()
	497	{
	498	echo " at $newrev ($newrev_type)"
	499
	500	generate_general_email
	501	}
	502
	503	#
	504	# Called when any other type of reference is updated (most likely a
	505	# non-annotated tag)
	506	#
	507	generate_update_general_email()
	508	{
	509	echo " to $newrev ($newrev_type)"
	510	echo " from $oldrev"
	511
	512	generate_general_email
	513	}
	514
	515	#
	516	# Called for creation or update of any other type of reference
	517	#
	518	generate_general_email()
	519	{
	520	# Unannotated tags are more about marking a point than releasing a
	521	# version; therefore we don't do the shortlog summary that we do for
	522	# annotated tags above - we simply show that the point has been
	523	# marked, and print the log message for the marked point for
	524	# reference purposes
	525	#
	526	# Note this section also catches any other reference type (although
	527	# there aren't any) and deals with them in the same way.
	528
	529	echo ""
	530	if [ "$newrev_type" = "commit" ]; then
531	echo $LOGBEGIN
532	git show --no-color --root -s --pretty=medium $newrev
533	echo $LOGEND
534	else
535	# What can we do here? The tag marks an object that is not
536	# a commit, so there is no log for us to display. It's
537	# probably not wise to output git cat-file as it could be a
538	# binary blob. We'll just say how big it is
539	echo "$newrev is a $newrev_type, and is $(git cat-file -s $newrev) bytes long."
540	fi
541	}
542
543	#
544	# Called for the deletion of any other type of reference
545	#
546	generate_delete_general_email()
547	{
548	echo " was $oldrev"
549	echo ""
550	echo $LOGEND
551	git show -s --pretty=oneline $oldrev
552	echo $LOGEND
553	}
554
555	send_mail()
556	{
557	if [ -n "$envelopesender" ]; then
558	/usr/sbin/sendmail -t -f "$envelopesender"
559	else
560	/usr/sbin/sendmail -t
561	fi
562	}
563
564	# ---------------------------- main()
565
566	# --- Constants
c87e8713 SS	567	LOGBEGIN=""
c87e8713 SS	568	LOGEND=""
7726cba3 SS	569
	570	# --- Config
	571	# Set GIT_DIR either from the working directory, or from the environment
	572	# variable.
	573	GIT_DIR=$(git rev-parse --git-dir 2>/dev/null)
	574	if [ -z "$GIT_DIR" ]; then
	575	echo >&2 "fatal: post-receive: GIT_DIR not set"
	576	exit 1
	577	fi
	578
	579	projectdesc=$(sed -ne '1p' "$GIT_DIR/description")
	580	# Check if the description is unchanged from it's default, and shorten it to
	581	# a more manageable length if it is
	582	if expr "$projectdesc" : "Unnamed repository.*$" >/dev/null
	583	then
	584	projectdesc="UNNAMED PROJECT"
	585	fi
	586
	587	recipients=$(git config hooks.mailinglist)
	588	announcerecipients=$(git config hooks.announcelist)
	589	envelopesender=$(git config hooks.envelopesender)
	590	emailprefix=$(git config hooks.emailprefix \|\| echo '[SCM] ')
d245d3ad SS	591	gitweburl=$(git config hooks.gitweburl)
d245d3ad SS	592	reponame=$(git config hooks.reponame \|\| basename $(realpath $GIT_DIR))
7726cba3 SS	593
	594	# --- Main loop
	595	# Allow dual mode: run from the command line just like the update hook, or
	596	# if no arguments are given then run as a hook script
	597	if [ -n "$1" -a -n "$2" -a -n "$3" ]; then
	598	# Output to the terminal in command line mode - if someone wanted to
	599	# resend an email; they could redirect the output to sendmail
	600	# themselves
a7d368ad SS	601	send_mail=cat
a7d368ad SS	602	generate_email $2 $3 $1
7726cba3 SS	603	else
	604	while read oldrev newrev refname
	605	do
a7d368ad SS	606	send_mail=send_mail
a7d368ad SS	607	generate_email $oldrev $newrev $refname
7726cba3 SS	608	done
7726cba3 SS	609	fi