aboutsummaryrefslogtreecommitdiff
path: root/kde-modules/KDEGitCommitHooks.cmake
diff options
context:
space:
mode:
Diffstat (limited to 'kde-modules/KDEGitCommitHooks.cmake')
-rw-r--r--kde-modules/KDEGitCommitHooks.cmake66
1 files changed, 66 insertions, 0 deletions
diff --git a/kde-modules/KDEGitCommitHooks.cmake b/kde-modules/KDEGitCommitHooks.cmake
new file mode 100644
index 00000000..90f53844
--- /dev/null
+++ b/kde-modules/KDEGitCommitHooks.cmake
@@ -0,0 +1,66 @@
+#.rst:
+# KDEGitCommitHooks
+# --------------------
+#
+# This module provides a functionality to enforce formatting
+# or in the future other QS checks.
+#
+# This module provides the following function:
+#
+# ::
+#
+# kde_configure_pre_commit_hook(GIR_DIR <dir> CHECKS <checks...>)
+#
+# This function will create a pre-commit hook which contains all the given checks.
+# In case the source dir does not contain the .git folder, the GIT_DIR
+# parameter can be passed in.
+#
+# Example usage:
+#
+# .. code-block:: cmake
+#
+# include(KDEGitCommitHooks)
+# kde_configure_git_pre_commit_hook(CHECKS CLANG_FORMAT)
+#
+# Since 5.79
+
+#=============================================================================
+# SPDX-FileCopyrightText: 2020 Alexander Lohnau <alexander.lohnau@gmx.de>
+#
+# SPDX-License-Identifier: BSD-3-Clause
+
+# try to find clang-format in path
+find_program(KDE_CLANG_FORMAT_EXECUTABLE clang-format)
+include(CMakeParseArguments)
+set(PRE_COMMIT_HOOK_UNIX "${CMAKE_CURRENT_LIST_DIR}/kde-git-commit-hooks/pre-commit.in")
+set(CLANG_FORMAT_UNIX "${CMAKE_CURRENT_LIST_DIR}/kde-git-commit-hooks/clang-format.sh")
+
+function(KDE_CONFIGURE_GIT_PRE_COMMIT_HOOK)
+ set(_oneValueArgs GIT_DIR)
+ set(_multiValueArgs CHECKS)
+ cmake_parse_arguments(ARG "" "${_oneValueArgs}" "${_multiValueArgs}" ${ARGN} )
+
+ if(NOT ARG_CHECKS)
+ message(FATAL_ERROR "No checks were specified")
+ endif()
+ if(NOT ARG_GIT_DIR)
+ set(ARG_GIT_DIR "${CMAKE_SOURCE_DIR}/.git")
+ endif()
+
+ # In case of tarballs there is no .git directory
+ if (EXISTS ${ARG_GIT_DIR})
+ # The pre-commit hook is a bash script, consequently it won't work on non-unix platforms
+ if (UNIX)
+ if(KDE_CLANG_FORMAT_EXECUTABLE)
+ list(FIND ARG_CHECKS "CLANG_FORMAT" _index)
+ if (${_index} GREATER -1)
+ set(CLANG_FORMAT_SCRIPT ${CLANG_FORMAT_UNIX})
+ endif()
+ else()
+ message(WARNING "No clang-format executable was found, skipping the formatting pre-commit hook")
+ endif()
+
+ configure_file(${PRE_COMMIT_HOOK_UNIX} "${ARG_GIT_DIR}/hooks/pre-commit")
+ endif()
+ endif()
+endfunction()