1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208
|
#!/usr/bin/env bash
# Copyright (c) 2015, David Martin. All rights reserved.
# Copyright (c) 2017-2025. The SimGrid team. All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# * Redistributions of source code must retain the above copyright notice, this
# list of conditions and the following disclaimer.
#
# * Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
# git pre-commit hook that runs a clang-format stylecheck.
# Features:
# - abort commit when commit does not comply with the style guidelines
# - create a patch of the proposed style changes
# Modifications for clang-format by rene.milk@wwu.de
# This file is part of a set of unofficial pre-commit hooks available
# at github.
# Link: https://github.com/githubbrowser/Pre-commit-hooks
# Modifications for modern clang formats and other improvements as part of the SimGrid project.
# See git logs for the detail of changes.
##################################################################
# Settings
# remove any older patches from previous commits. Set to true or false.
DELETE_OLD_PATCHES=true
# only parse files with the extensions in FILE_EXTS. Set to true or false.
# if false every changed file in the commit will be parsed with clang-format.
# if true only files matching one of the extensions are parsed with clang-format.
PARSE_EXTS=true
# file types to parse. Only effective when PARSE_EXTS is true.
# FILE_EXTS=".c .h .cpp .hpp"
FILE_EXTS=".c .h .cpp .hpp .cc .hh .cxx .java"
##################################################################
# Potential names for clang-format (debian...)
CLANG_FMT_PNAMES=(clang-format clang-format-5.0 clang-format-4.0)
CLANG_FMT_CMD="NOT-FOUND"
GIT_CLANG_FMT_CMD="NOT-FOUND"
# Find which clang-format should be used
for name in ${CLANG_FMT_PNAMES[*]}
do
where=$(which ${name} 2> /dev/null)
if [ x != "x${where}" ]
then
echo "clang-format found: ${where}"
CLANG_FMT_CMD=${where}
break
fi
done
if [[ "${CLANG_FMT_CMD}" == NOT-FOUND ]]
then
echo "Unable to find clang-format! Please install it:"
echo "- debian(-like): apt-get install clang-format[-VERSION]"
echo "- arch(-like): pacman -S clang"
echo "- ..."
exit 1
fi
# Find which git-clang-format should be used
for name in ${CLANG_FMT_PNAMES[*]}
do
where=$(which "git-${name}" 2> /dev/null)
if [ x != "x${where}" ]
then
echo "git-clang-format found: ${where}"
GIT_CLANG_FMT_CMD=${where}
break
fi
done
if [[ "${GIT_CLANG_FMT_CMD}" == NOT-FOUND ]]
then
echo "Unable to find git-clang-format! Please install it:"
echo "- debian(-like): apt-get install clang-format[-VERSION]"
echo "- arch(-like): pacman -S clang"
echo "- ..."
exit 1
fi
# error on unset variable expansion
set -u
# exit on error
set -e
# There should be no need to change anything below this line.
# Reference: http://stackoverflow.com/questions/1055671/how-can-i-get-the-behavior-of-gnus-readlink-f-on-a-mac
canonicalize_filename () {
local target_file=${1}
local physical_directory=""
local result=""
# Need to restore the working directory after work.
pushd $(pwd) > /dev/null
cd "$(dirname "${target_file}")"
target_file=$(basename ${target_file})
# Iterate down a (possible) chain of symlinks
while [ -L "${target_file}" ]
do
target_file=$(readlink "${target_file}")
cd "$(dirname "${target_file}")"
target_file=$(basename "${target_file}")
done
# Compute the canonicalized name by finding the physical path
# for the directory we're in and appending the target file.
physical_directory=$(pwd -P)
result="${physical_directory}"/"${target_file}"
# restore the working directory after work.
popd > /dev/null
echo "${result}"
}
# check whether the given file matches any of the set extensions
matches_extension() {
local filename=$(basename "${1}")
local extension=".${filename##*.}"
local ext
for ext in ${FILE_EXTS}; do [[ "${ext}" == "${extension}" ]] && return 0; done
return 1
}
# necessary check for initial commit
if git rev-parse --verify HEAD >/dev/null 2>&1 ; then
against=HEAD
else
# Initial commit: diff against an empty tree object
against=foobaridonotexist
fi
# create a random filename to store our generated patch
prefix="pre-commit-clang-format"
suffix="$(date +%s)"
patch="/tmp/${prefix}-${suffix}.patch"
# clean up any older clang-format patches
${DELETE_OLD_PATCHES} && rm -f /tmp/${prefix}*.patch
# create one patch containing all changes to the files
git diff-index --cached --diff-filter=ACMR --name-only ${against} -- | while read file;
do
# ignore file if we do check for file extensions and the file
# does not match any of the extensions specified in $FILE_EXTS
if ${PARSE_EXTS} && ! matches_extension "${file}"; then
continue;
fi
# clang-format our sourcefile, create a patch with diff and append it to our $patch
# The sed call is necessary to transform the patch from
# --- $file timestamp
# +++ - timestamp
# to both lines working on the same file and having a a/ and b/ prefix.
# Else it can not be applied with 'git apply'.
${GIT_CLANG_FMT_CMD} --binary ${CLANG_FMT_CMD} --diff -q "${file}" \
| (grep -v "no modified files to format"||true) \
>> "${patch}"
#"${CLANG_FMT_CMD}" -style=file "${file}" | \
#diff -u "${file}" - | \
#sed -e "1s|--- |--- a/|" -e "2s|+++ -|+++ b/${file}|" >> "${patch}"
done
# if no patch has been generated all is ok, clean up the file stub and exit
if [ ! -s "${patch}" ] ; then
printf "Files in this commit comply with the clang-format rules.\n"
rm -f "${patch}"
exit 0
fi
# a patch has been created, notify the user and exit
printf "\nThe following differences were found between the code to commit "
printf "and the clang-format rules:\n\n"
cat "${patch}"
printf "\nYou can apply these changes and read the files with:\n"
printf " git apply ${patch} && git apply --cached ${patch}\n"
printf "(call this command from the root directory of your repository)\n"
printf "\n\n\n"
printf "Aborting commit. Apply changes and commit again.\n"
# printf "Skip checking with: --no-verify (not recommended).\n"
exit 1
|