-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
53030a0
commit ec4102f
Showing
6 changed files
with
682 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
# Git hooks for Godot Engine | ||
|
||
This folder contains Git hooks meant to be installed locally by Godot Engine | ||
contributors to make sure they comply with our requirements. | ||
|
||
## List of hooks | ||
|
||
- Pre-commit hook for `clang-format`: Applies `clang-format` to the staged | ||
files before accepting a commit; blocks the commit and generates a patch if | ||
the style is not respected. | ||
You may need to edit the file if your `clang-format` binary is not in the | ||
`PATH`, or if you want to enable colored output with `pygmentize`. | ||
- Pre-commit hook for `black`: Applies `black` to the staged Python files | ||
before accepting a commit. | ||
- Pre-commit hook for `make_rst`: Checks the class reference syntax using | ||
`make_rst.py`. | ||
|
||
## Installation | ||
|
||
Copy all the files from this folder into your `.git/hooks` folder, and make | ||
sure the hooks and helper scripts are executable. | ||
|
||
#### Linux/MacOS | ||
|
||
The hooks rely on bash scripts and tools which should be in the system `PATH`, | ||
so they should work out of the box on Linux/macOS. | ||
|
||
#### Windows | ||
|
||
##### clang-format | ||
- Download LLVM for Windows (version 13 or later) from | ||
<https://releases.llvm.org/download.html> | ||
- Make sure LLVM is added to the `PATH` during installation | ||
|
||
##### black | ||
- Python installation: make sure Python is added to the `PATH` | ||
- Install `black` - in any console: `pip3 install black` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,48 @@ | ||
#!/bin/sh | ||
|
||
# Provide the canonicalize filename (physical filename with out any symlinks) | ||
# like the GNU version readlink with the -f option regardless of the version of | ||
# readlink (GNU or BSD). | ||
|
||
# This file is part of a set of unofficial pre-commit hooks available | ||
# at github. | ||
# Link: https://github.com/githubbrowser/Pre-commit-hooks | ||
# Contact: David Martin, david.martin.mailbox@googlemail.com | ||
|
||
########################################################### | ||
# There should be no need to change anything below this line. | ||
|
||
# Canonicalize by recursively following every symlink in every component of the | ||
# specified filename. This should reproduce the results of the GNU version of | ||
# readlink with the -f option. | ||
# | ||
# Reference: https://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. | ||
local working_dir="`pwd`" | ||
|
||
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. | ||
cd -- "$working_dir" | ||
|
||
echo "$result" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
#!/bin/sh | ||
# Git pre-commit hook that runs multiple hooks specified in $HOOKS. | ||
# Make sure this script is executable. Bypass hooks with git commit --no-verify. | ||
|
||
# This file is part of a set of unofficial pre-commit hooks available | ||
# at github. | ||
# Link: https://github.com/githubbrowser/Pre-commit-hooks | ||
# Contact: David Martin, david.martin.mailbox@googlemail.com | ||
|
||
|
||
########################################################### | ||
# CONFIGURATION: | ||
# pre-commit hooks to be executed. They should be in the same .git/hooks/ folder | ||
# as this script. Hooks should return 0 if successful and nonzero to cancel the | ||
# commit. They are executed in the order in which they are listed. | ||
#HOOKS="pre-commit-compile pre-commit-uncrustify" | ||
HOOKS="pre-commit-clang-format pre-commit-black" | ||
########################################################### | ||
# There should be no need to change anything below this line. | ||
|
||
. "$(dirname -- "$0")/canonicalize_filename.sh" | ||
|
||
# exit on error | ||
set -e | ||
|
||
# Absolute path to this script, e.g. /home/user/bin/foo.sh | ||
SCRIPT="$(canonicalize_filename "$0")" | ||
|
||
# Absolute path this script is in, thus /home/user/bin | ||
SCRIPTPATH="$(dirname -- "$SCRIPT")" | ||
|
||
|
||
for hook in $HOOKS | ||
do | ||
echo "Running hook: $hook" | ||
# run hook if it exists | ||
# if it returns with nonzero exit with 1 and thus abort the commit | ||
if [ -f "$SCRIPTPATH/$hook" ]; then | ||
"$SCRIPTPATH/$hook" | ||
if [ $? != 0 ]; then | ||
exit 1 | ||
fi | ||
else | ||
echo "Error: file $hook not found." | ||
echo "Aborting commit. Make sure the hook is in $SCRIPTPATH and executable." | ||
echo "You can disable it by removing it from the list in $SCRIPT." | ||
echo "You can skip all pre-commit hooks with --no-verify (not recommended)." | ||
exit 1 | ||
fi | ||
done |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,202 @@ | ||
#!/usr/bin/env bash | ||
|
||
# git pre-commit hook that runs a black stylecheck. | ||
# Based on pre-commit-clang-format. | ||
|
||
################################################################## | ||
# SETTINGS | ||
# Set path to black binary. | ||
BLACK=`which black 2>/dev/null` | ||
BLACK_OPTIONS="-l 120" | ||
|
||
# Remove any older patches from previous commits. Set to true or false. | ||
DELETE_OLD_PATCHES=false | ||
|
||
# File types to parse. | ||
FILE_NAMES="SConstruct SCsub" | ||
FILE_EXTS=".py" | ||
|
||
# Use pygmentize instead of cat to parse diff with highlighting. | ||
# Install it with `pip install pygments` (Linux) or `easy_install Pygments` (Mac) | ||
PYGMENTIZE=`which pygmentize 2>/dev/null` | ||
if [ ! -z "$PYGMENTIZE" ]; then | ||
READER="pygmentize -l diff" | ||
else | ||
READER=cat | ||
fi | ||
|
||
# Path to zenity | ||
ZENITY=`which zenity 2>/dev/null` | ||
|
||
# Path to xmessage | ||
XMSG=`which xmessage 2>/dev/null` | ||
|
||
# Path to powershell (Windows only) | ||
PWSH=`which powershell 2>/dev/null` | ||
|
||
################################################################## | ||
# There should be no need to change anything below this line. | ||
|
||
. "$(dirname -- "$0")/canonicalize_filename.sh" | ||
|
||
# exit on error | ||
set -e | ||
|
||
# check whether the given file matches any of the set extensions | ||
matches_name_or_extension() { | ||
local filename=$(basename "$1") | ||
local extension=".${filename##*.}" | ||
|
||
for name in $FILE_NAMES; do [[ "$name" == "$filename" ]] && return 0; done | ||
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=4b825dc642cb6eb9a060e54bf8d69288fbee4904 | ||
fi | ||
|
||
if [ ! -x "$BLACK" ] ; then | ||
if [ ! -t 1 ] ; then | ||
if [ -x "$ZENITY" ] ; then | ||
$ZENITY --error --title="Error" --text="Error: black executable not found." | ||
exit 1 | ||
elif [ -x "$XMSG" ] ; then | ||
$XMSG -center -title "Error" "Error: black executable not found." | ||
exit 1 | ||
elif [ \( \( "$OSTYPE" = "msys" \) -o \( "$OSTYPE" = "win32" \) \) -a \( -x "$PWSH" \) ]; then | ||
winmessage="$(canonicalize_filename "./.git/hooks/winmessage.ps1")" | ||
$PWSH -noprofile -executionpolicy bypass -file "$winmessage" -center -title "Error" --text "Error: black executable not found." | ||
exit 1 | ||
fi | ||
fi | ||
printf "Error: black executable not found.\n" | ||
printf "Set the correct path in $(canonicalize_filename "$0").\n" | ||
exit 1 | ||
fi | ||
|
||
# create a random filename to store our generated patch | ||
prefix="pre-commit-black" | ||
suffix="$(date +%s)" | ||
patch="/tmp/$prefix-$suffix.patch" | ||
|
||
# clean up any older black 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 thirdparty files | ||
if grep -q "thirdparty" <<< $file; then | ||
continue; | ||
fi | ||
|
||
# ignore file if not one of the names or extensions we handle | ||
if ! matches_name_or_extension "$file"; then | ||
continue; | ||
fi | ||
|
||
# format our file with black, create a patch with diff and append it to our $patch | ||
# The sed call is necessary to transform the patch from | ||
# --- $file timestamp | ||
# +++ $file timestamp | ||
# to both lines working on the same file and having a/ and b/ prefix. | ||
# Else it can not be applied with 'git apply'. | ||
"$BLACK" "$BLACK_OPTIONS" --diff "$file" | \ | ||
sed -e "1s|--- |--- a/|" -e "2s|+++ |+++ b/|" >> "$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 black formatter 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 black formatter rules:\n\n" | ||
|
||
if [ -t 1 ] ; then | ||
$READER "$patch" | ||
printf "\n" | ||
# Allows us to read user input below, assigns stdin to keyboard | ||
exec < /dev/tty | ||
terminal="1" | ||
else | ||
cat "$patch" | ||
printf "\n" | ||
# Allows non zero zenity/powershell output | ||
set +e | ||
terminal="0" | ||
fi | ||
|
||
while true; do | ||
if [ $terminal = "0" ] ; then | ||
if [ -x "$ZENITY" ] ; then | ||
choice=$($ZENITY --text-info --filename="$patch" --width=800 --height=600 --title="Do you want to apply that patch?" --ok-label="Apply" --cancel-label="Do not apply" --extra-button="Apply and stage") | ||
if [ "$?" = "0" ] ; then | ||
yn="Y" | ||
else | ||
if [ "$choice" = "Apply and stage" ] ; then | ||
yn="S" | ||
else | ||
yn="N" | ||
fi | ||
fi | ||
elif [ -x "$XMSG" ] ; then | ||
$XMSG -file "$patch" -buttons "Apply":100,"Apply and stage":200,"Do not apply":0 -center -default "Do not apply" -geometry 800x600 -title "Do you want to apply that patch?" | ||
choice=$? | ||
if [ "$choice" = "100" ] ; then | ||
yn="Y" | ||
elif [ "$choice" = "200" ] ; then | ||
yn="S" | ||
else | ||
yn="N" | ||
fi | ||
elif [ \( \( "$OSTYPE" = "msys" \) -o \( "$OSTYPE" = "win32" \) \) -a \( -x "$PWSH" \) ]; then | ||
winmessage="$(canonicalize_filename "./.git/hooks/winmessage.ps1")" | ||
$PWSH -noprofile -executionpolicy bypass -file "$winmessage" -file "$patch" -buttons "Apply":100,"Apply and stage":200,"Do not apply":0 -center -default "Do not apply" -geometry 800x600 -title "Do you want to apply that patch?" | ||
choice=$? | ||
if [ "$choice" = "100" ] ; then | ||
yn="Y" | ||
elif [ "$choice" = "200" ] ; then | ||
yn="S" | ||
else | ||
yn="N" | ||
fi | ||
else | ||
printf "Error: zenity, xmessage, or powershell executable not found.\n" | ||
exit 1 | ||
fi | ||
else | ||
read -p "Do you want to apply that patch (Y - Apply, N - Do not apply, S - Apply and stage files)? [Y/N/S] " yn | ||
fi | ||
case $yn in | ||
[Yy] ) git apply $patch; | ||
printf "The patch was applied. You can now stage the changes and commit again.\n\n"; | ||
break | ||
;; | ||
[Nn] ) printf "\nYou can apply these changes with:\n git apply $patch\n"; | ||
printf "(may need to be called from the root directory of your repository)\n"; | ||
printf "Aborting commit. Apply changes and commit again or skip checking with"; | ||
printf " --no-verify (not recommended).\n\n"; | ||
break | ||
;; | ||
[Ss] ) git apply $patch; | ||
git diff-index --cached --diff-filter=ACMR --name-only $against -- | while read file; | ||
do git add $file; | ||
done | ||
printf "The patch was applied and the changed files staged. You can now commit.\n\n"; | ||
break | ||
;; | ||
* ) echo "Please answer yes or no." | ||
;; | ||
esac | ||
done | ||
exit 1 # we don't commit in any case |
Oops, something went wrong.