templates/hooks--update.sample

   1 #!/bin/sh
   2 #
   3 # An example hook script to blocks unannotated tags from entering.
   4 # Called by git-receive-pack with arguments: refname sha1-old sha1-new
   5 #
   6 # To enable this hook, rename this file to "update".
   7 #
   8 # Config
   9 # ------
  10 # hooks.allowunannotated
  11 #   This boolean sets whether unannotated tags will be allowed into the
  12 #   repository.  By default they won't be.
  13 # hooks.allowdeletetag
  14 #   This boolean sets whether deleting tags will be allowed in the
  15 #   repository.  By default they won't be.
  16 # hooks.allowdeletebranch
  17 #   This boolean sets whether deleting branches will be allowed in the
  18 #   repository.  By default they won't be.
  19 # hooks.denycreatebranch
  20 #   This boolean sets whether remotely creating branches will be denied
  21 #   in the repository.  By default this is allowed.
  22 #
  23
  24 # --- Command line
  25 refname="$1"
  26 oldrev="$2"
  27 newrev="$3"
  28
  29 # --- Safety check
  30 if [ -z "$GIT_DIR" ]; then
  31         echo "Don't run this script from the command line." >&2
  32         echo " (if you want, you could supply GIT_DIR then run" >&2
  33         echo "  $0 <ref> <oldrev> <newrev>)" >&2
  34         exit 1
  35 fi
  36
  37 if [ -z "$refname" -o -z "$oldrev" -o -z "$newrev" ]; then
  38         echo "Usage: $0 <ref> <oldrev> <newrev>" >&2
  39         exit 1
  40 fi
  41
  42 # --- Config
  43 allowunannotated=$(git config --bool hooks.allowunannotated)
  44 allowdeletebranch=$(git config --bool hooks.allowdeletebranch)
  45 denycreatebranch=$(git config --bool hooks.denycreatebranch)
  46 allowdeletetag=$(git config --bool hooks.allowdeletetag)
  47
  48 # check for no description
  49 projectdesc=$(sed -e '1q' "$GIT_DIR/description")
  50 case "$projectdesc" in
  51 "Unnamed repository"* | "")
  52         echo "*** Project description file hasn't been set" >&2
  53         exit 1
  54         ;;
  55 esac
  56
  57 # --- Check types
  58 # if $newrev is 0000...0000, it's a commit to delete a ref.
  59 zero="0000000000000000000000000000000000000000"
  60 if [ "$newrev" = "$zero" ]; then
  61         newrev_type=delete
  62 else
  63         newrev_type=$(git-cat-file -t $newrev)
  64 fi
  65
  66 case "$refname","$newrev_type" in
  67         refs/tags/*,commit)
  68                 # un-annotated tag
  69                 short_refname=${refname##refs/tags/}
  70                 if [ "$allowunannotated" != "true" ]; then
  71                         echo "*** The un-annotated tag, $short_refname, is not allowed in this repository" >&2
  72                         echo "*** Use 'git tag [ -a | -s ]' for tags you want to propagate." >&2
  73                         exit 1
  74                 fi
  75                 ;;
  76         refs/tags/*,delete)
  77                 # delete tag
  78                 if [ "$allowdeletetag" != "true" ]; then
  79                         echo "*** Deleting a tag is not allowed in this repository" >&2
  80                         exit 1
  81                 fi
  82                 ;;
  83         refs/tags/*,tag)
  84                 # annotated tag
  85                 ;;
  86         refs/heads/*,commit)
  87                 # branch
  88                 if [ "$oldrev" = "$zero" -a "$denycreatebranch" = "true" ]; then
  89                         echo "*** Creating a branch is not allowed in this repository" >&2
  90                         exit 1
  91                 fi
  92                 ;;
  93         refs/heads/*,delete)
  94                 # delete branch
  95                 if [ "$allowdeletebranch" != "true" ]; then
  96                         echo "*** Deleting a branch is not allowed in this repository" >&2
  97                         exit 1
  98                 fi
  99                 ;;
 100         refs/remotes/*,commit)
 101                 # tracking branch
 102                 ;;
 103         refs/remotes/*,delete)
 104                 # delete tracking branch
 105                 if [ "$allowdeletebranch" != "true" ]; then
 106                         echo "*** Deleting a tracking branch is not allowed in this repository" >&2
 107                         exit 1
 108                 fi
 109                 ;;
 110         *)
 111                 # Anything else (is there anything else?)
 112                 echo "*** Update hook: unknown type of update to ref $refname of type $newrev_type" >&2
 113                 exit 1
 114                 ;;
 115 esac
 116
 117 # --- Finished
 118 exit 0